⚠️ Disclaimer: Die Richtigkeit dieser Vorlage wird hiermit in Abrede gestellt. Der oder die Autoren übernehmen keine Gewährleistung. Diese Vorlage ist keine offizielle Vorlage einer Prüfungsorganisation.
Informatiklernende (EFZ) schliessen Ihre Ausbildung mit einer individuellen praktischen Abschlussprüfung (IPA) ab. Dabei sind umfangreiche Dokumentationsarbeiten notwendig. Diese Vorlage hilft dabei sich auf die Inhalte und Realisierung konzentrieren zu können und keine Inhalte zu vergessen. Mit dieser Vorlage ist es möglich, innert Minuten mit der produktiven Arbeit am IPA-Bericht zu beginnen.
- Moderne TeX/LaTeX Umgebung Tectonic
- Visual Studio Code mit Remote Containers
- Continuous Integration und Continuous Delivery mit Github Actions
- Integrierte Vorlage für den IPA Bericht
- Konfigurierbar über Variablen in
src/index.tex
- Eigenes Repository von der Vorlage generieren mit
Use this template - Repository klonen
- Ordner in Visual Studio Code mit installierter Erweiterung Remote Containers öffnen
src/index.texöffnen und CTRL+ALT+b oder über CTRL+P das KommandoLaTeX Workshop: Build LaTeX projectaufrufenbuild/default/default.pdföffnen- Dokument ändern, die Vorschau des PDFs aktualisiert sich fortlaufend
- Variablen in
src/index.texanpassen - Commits mit den gemachten Änderungen erstellen
- Commits ins Repository drücken (push)
- Github Actions läuft automatisch und generiert ein Artefakt, welches das aktuelle Dokument enthält. Dieses Video zeigt das Vorgehen:
res_find-artifacts.webm
Für die Realisierung der IPA könnten folgende Werkzeuge und Programme nützlich sein:
- diagrams.net für Diagramme aller Art: UML, ...
- umletino.com oder umlet.com für UML Diagramme
- UMLet Visual Studio Code Extension
Dieser Abschnitt bezieht sich auf den Standardkritierenkatalog und dessen Leitfaden. Unterhalb wird ein Bezug zwischen den Kriterien und dieser Vorlage hergestellt.
Der Status wird durch folgende Symbole definiert:
| Symbol | Bedeutung |
|---|---|
| ✔️ | Dieses Kriterium ist in der Vorlage beispielhaft umgesetzt. |
| ⏳ | Dieses Kriterium wird noch in der Vorlage umgesetzt. |
| ⚡ | Zu diesem Kriterium gibt es Hinweise und Beispiele, welche noch angepasst werden müssen. |
| ❌ | Dieses Kriterium kann nicht oder nur teilweise mit dem IPA-Bericht umgesetzt werden. |
| 🧑🎓 | Dieses Kriterium muss individuell in der Vorlage geprüft oder umgesetzt werden. |
- A1: Projektmanagement und Planung
- A2: Wissensbeschaffung
- A3: Zeitplan
- A4: Konzeptionelle Umsetzung
- A5: Projektumfeld: Systemgrenzen / Schnittstellen zur Aussenwelt
- A6: Testkonzept
- A7: Leistungsfähigkeit
- A8: Selbständiges Arbeiten
- A9: Fachkenntnisse und Anwendungskompetenz
- A10: Anwendung der Fachsprache
- A11: Arbeits- und Fachmethodik
- A12: Organisation der Arbeitsergebnisse
- A13: IPA-Erfüllungsgrad
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A1.1a | "Die gewählte Projektmanagement-Methode ist im Bericht benannt" | src/chapters/inform.tex |
✔️ | |
| A1.1b | "[..] und passt zum Auftrag." | src/chapters/inform.tex |
In den allermeisten Fällen lässt sich IPERKA anwenden und begründen. | 🧑🎓 |
| A1.2 | "Die gewählte Projektmanagement-Methode wurde in der praktischen Arbeit korrekt angewandt." | Dies lässt sich oftmals gut im Zeitplan erkennen, indem geprüft wird, ob die Aufgaben den passenden Phasen zugeordnet sind. | 🧑🎓 | |
| A1.3 | "Die korrekte Anwendung der Projektmanagement-Methode ist im IPA-Bericht ersichtlich." | src/index.tex |
Dies lässt sich gut am Inhaltsverzeichnis ablesen. | ✔️ |
| A1.4 | "Der Auftrag wurde ausgehend von der Aufgabenstellung weiter analysiert und verfeinert." | src/chapters/plan.tex |
⏳ |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A2.1 | "Der Nachweis der Wissensbeschaffung ist durch Arbeitsjournal, Projektbericht oder Protokolle zu Fachgesprächen (HE, VF) dokumentiert." | src/chapters/journal.tex |
✔️ | |
| A2.2 | "Wählte die Informationsquellen aufgabenbezogen aus." | src/sources.bib |
🧑🎓 | |
| A2.3 | "Hat aus den gewählten Informationsquellen die relevanten Informationen identifiziert und genutzt (Transferleistung)." | Mit \cite und dem in src/sources.bib definierten Key kann eine Zitierung eingefügt werden. Das Literaturverzeichnis wird entsprechend nach IEEE automatisch generiert. |
✔️ | |
| A2.4 | "Die referenzierten Quellen sind existent und für Projektinvolvierte rekonstruierbar." | src/sources.bib |
Mit \cite und dem in src/sources.bib definierten Key kann eine Zitierung eingefügt werden. Das Literaturverzeichnis wird entsprechend nach IEEE automatisch generiert. |
🧑🎓 |
Diese Vorlage hilft bei der schnellen Umsetzung des gewünschten Zeitplans. Im Tabellenblatt Variabeln können die IPA-Tage definiert werden. Die SOLL- und IST-Zeiten sind mit einem S bzw. I in den einzelnen 2-Stundenblöcken zu erfassen.
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A3.1 | "Es wurde eine absolute Zeitachse definiert (Datum)." | src/chapters/timeplan.tex |
✔️ | |
| A3.2 | "Die Zeitachse hat eine vernünftige Auflösung (1, 2- oder 4-Stundenblöcke)." | src/chapters/timeplan.tex |
✔️ | |
| A3.3 | "Zweckmässige Tätigkeiten decken die ganze Arbeit ab." | src/chapters/timeplan.tex |
🧑🎓 | |
| A3.4 | "Die Reihenfolge der Tätigkeiten ist sinnvoll." | src/chapters/timeplan.tex |
🧑🎓 | |
| A3.5 | "Die Zeitaufwände für die Tätigkeiten wurden realistisch geplant." | src/chapters/timeplan.tex |
🧑🎓 | |
| A3.6 | "Der Soll/Ist-Vergleich ist transparent und korrekt." | src/chapters/timeplan.tex |
🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A4.1 | "Es wurden Konzepte oder Modelle eingesetzt, um die Aufgabenstellung vereinfacht darzustellen." | src/chapters/inform.tex |
🧑🎓 | |
| A4.2 | "Es wurden Konzepte oder Modelle eingesetzt, um die Lösung vereinfacht darzustellen." | src/chapters/plan.tex |
🧑🎓 | |
| A4.3 | "Teilsysteme sowie deren Abhängigkeiten sind identifiziert und dokumentiert." | src/chapters/plan.tex |
🧑🎓 | |
| A4.4 | "Die Abbildung des Gesamtsystems orientiert sich an den ersten drei Punkten." | src/chapters/plan.tex |
🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A5.1 | "Der Kandidat kennt die Abgrenzung seines Auftrages zum Umfeld" | src/chapters/inform.tex |
🧑🎓 | |
| A5.2 | "[..] Abgrenzung seines Auftrages zum Umfeld und kann dieses beschreiben." | src/chapters/inform.tex |
🧑🎓 | |
| A5.3 | "Allfällige Schnittstellen sind ihm im Detail bekannt" | src/chapters/plan.tex |
🧑🎓 | |
| A5.4 | "Allfällige Schnittstellen sind [..] dokumentiert." | src/chapters/plan.tex |
🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A6.1a | "Das Testkonzept beschreibt das zu testende System" | src/chapters/plan.tex |
⏳ | |
| A6.1b | "Das Testkonzept beschreibt [.. die] Umgebung [des Systems]." | src/chapters/plan.tex |
⏳ | |
| A6.2 | "Das Testkonzept beschreibt die relevanten Testfälle inkl. der zu erwartenden Ergebnisse." | src/chapters/plan.tex |
⏳ | |
| A6.3 | "Das Testkonzept begründet nachvollziehbar, was bewusst nicht getestet wird." | src/chapters/plan.tex |
⏳ | |
| A6.4 | "Das Testkonzept beschreibt die relevanten Testmittel (Hardware, Netzwerk etc.)" | src/chapters/plan.tex |
⏳ | |
| A6.5 | "Das Testkonzept beschreibt die verwendete(n) Testmethode(n)." | src/chapters/plan.tex |
⏳ |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A7.1 | "Der Kandidat arbeitete durchwegs engagiert; es gab keine Zeichen von Gleichgültigkeit." | src/chapters/journal.tex |
❌ | |
| A7.2 | "Der Kandidat geriet nicht in Stresssituationen oder konnte mit diesen souverän umgehen." | src/chapters/journal.tex |
❌ | |
| A7.3 | "Der Kandidat arbeitete zielorientiert." | src/chapters/journal.tex |
❌ | |
| A7.4 | "Der Kandidat berücksichtigte die zeitlichen Vorgaben" | src/chapters/timeplan.tex |
❌ | |
| A7.5 | "Der Kandidat dachte über die Aufgabenstellung hinaus und ergänzte nach Möglichkeit eigenständig fehlende Elemente." | src/chapters/plan.tex |
🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A8.1 | "Kann Wesentliches von Unwesentlichem trennen und Prioritäten setzen." | src/chapters/plan.tex |
❌ | |
| A8.2 | "Kommt durch die ihm zur Verfügung stehenden Mittel selbständig zu den benötigten Informationen. Sucht oder zeigt Lösungsvarianten auf." | src/chapters/evaluate.tex |
⏳ | |
| A8.3 | "Kann die Arbeit gut einteilen und benötigt keine ungerechtfertigte Unterstützung durch andere Fachleute." | src/chapters/journal.tex |
🧑🎓 | |
| A8.4 | "Kann seine Arbeit selbständig organisieren und die gesetzten Ziele werden erreicht auch wenn Probleme auftreten." | src/chapters/journal.tex |
🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A9 | "Der Kandidat hat über die ganze Arbeit gezeigt, dass er die technischen und fachlichen Grundlagen für sein Handeln kennt und situationsgerecht anwendet. Der Kandidat kann die für seine Arbeit benötigten Fähigkeiten der eingesetzten Produkte sicher anwenden und nutzt sie zielgerichtet, routiniert und fehlerfrei." | ❌ |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A10.1 | "Zur Erläuterung spezifischer Sachverhalte setzt der Kandidat die Fachbegriffe konsequent ein." | src/chapters/implement.tex |
🧑🎓 | |
| A10.2 | "Dabei werden die richtigen Fachbegriffe präzise eingesetzt." | src/glossaries.tex |
🧑🎓 | |
| A10.3 | "Die Fachbegriffe werden an den benötigten Stellen eingesetzt und können bei Nachfrage durch den Kandidaten erläutert werden." | ❌ | ||
| A10.4 | "Die Erklärung zu den Fachbegriffen ist fachlich korrekt." | src/glossaries.tex |
🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A11 | "Wählte den Aufgaben entsprechend geeignete Fachmethoden und Arbeitstechniken aus. Diese wurden korrekt angewandt und vollständig umgesetzt." | Betrifft die gesamte IPA. | 🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A12.1 | "Die Arbeitsergebnisse (schliesst die Dokumente ein) sind ihrem Entwicklungsstand angemessen versioniert." | Diese Vorlage unterstützt dieses Kriterium, indem das der IPA-Bericht so einfach in eine Quellcodeversionierungssystem integriert werden kann. | 🧑🎓 | |
| A12.2 | "Auf die Versionen der Arbeitsergebnisse kann jederzeit zugegriffen werden." | Diese Vorlage unterstützt dieses Kriterium, indem das der IPA-Bericht so einfach in eine Quellcodeversionierungssystem integriert werden kann. | 🧑🎓 | |
| A12.3 | "Es besteht eine tägliche Sicherung der Arbeitsergebnisse." | Dazu müsste sichergestellt werden, dass die angehäuften Commits jeden Abend in die entfernte Versionskontrolle geschoben werden. | 🧑🎓 | |
| A12.4 | "Die Wiederherstellung der gesicherten Arbeitsergebnisse ist sichergestellt." | src/chapters/plan.tex |
⏳ | |
| A12.5 | "Punkte 1-4 sind im IPA-Bericht beschrieben und nachvollziehbar." | src/chapters/plan.tex |
⏳ |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| A13.1 | "Das Resultat entspricht den Anforderungen gemäss Aufgabenstellung." | 🧑🎓 | ||
| A13.2 | "Das Resultat entspricht der Arbeit einer Fachperson." | 🧑🎓 | ||
| A13.3 | "Das Potential wurde im Rahmen der vorgegebenen Zeit ausgeschöpft." | 🧑🎓 |
- B1: Kurzfassung des IPA-Berichtes
- B2: Führung des Arbeitsjournals
- B3: Reflexionsfähigkeit
- B4: Gliederung
- B5: Prägnanz
- B6: Formale Vollständigkeit des IPA-Berichts
- B7: Sprachlicher Ausdruck und Stil / Rechtschreibung und Grammatik
- B8: Darstellung
- B9: Grafiken, Bilder, Diagramme und Tabellen
- B10: Durchführung und Auswertung der Tests
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| B1.1 | "Die Kurzfassung richtet sich an die fachlich kompetenten Leser." | src/chapters/summary.tex |
🧑🎓 | |
| B1.2 | "Die Kurzfassung enthält die Punkte: Kurze Ausgangssituation - Umsetzung - Ergebnis." | src/chapters/summary.tex |
✔️ | |
| B1.3 | "Die Kurzfassung enthält zu jedem dieser genannten Punkte die wesentlichen Aspekte." | src/chapters/summary.tex |
🧑🎓 | |
| B1.4 | "Die Kurzfassung ist nicht länger als eine A4-Seite Text und enthält keine Grafik." | src/chapters/summary.tex |
🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| B2.1 | "Die Darstellung ist übersichtlich, klar und verständlich." | src/chapters/journal.tex |
✔️ | |
| B2.2 | "Alle Aktivitäten gemäss Zeitplan sowie Überzeiten und ungeplante Arbeiten sind erwähnt." | src/chapters/journal.tex |
🧑🎓 | |
| B2.3 | "Erfolge und Misserfolge sind erwähnt." | src/chapters/journal.tex |
🧑🎓 | |
| B2.4 | "Alle beanspruchten Hilfestellungen sind erwähnt und begründet." | src/chapters/journal.tex |
🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| B3.1 | "Hat im Arbeitsjournal seine Vorgehensweise und das Ergebnis kritisch hinterfragt." | src/chapters/journal.tex |
🧑🎓 | |
| B3.2 | "Vergleicht mögliche Lösungs-Varianten oder begründet, weshalb es keine Varianten gibt." | src/chapters/decide.tex |
🧑🎓 | |
| B3.3 | "Zieht im Schlusswort nachvollziehbare Schlüsse aus seiner eigenen Reflexion." | src/chapters/evaluate.tex |
🧑🎓 | |
| B3.4 | "Das Schlusswort enthält eine persönliche Bilanz." | src/chapters/evaluate.tex |
🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| B4.1 | "Der IPA-Bericht ist in eine zu den Themen und Schwerpunkten passende Kapitelstruktur unterteilt." | 🧑🎓 | ||
| B4.2 | "Der IPA-Bericht ist übersichtlich gegliedert und eingesetzte Überschriften sind mit entsprechenden Inhalten gefüllt." | 🧑🎓 | ||
| B4.3 | "Die Reihenfolge der Themen im IPA-Bericht ist aufeinander abgestimmt." | src/index.tex |
🧑🎓 | |
| B4.4 | "Die Gestaltung von Überschriften, Texten und Grafiken erleichtert den Lesefluss und behindert ihn nicht." | ✔️ |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| B5 | "Der Text des IPA-Berichtes ist hinsichtlich der Prägnanz bestmöglich gestaltet. Er ist durchgängig oder mit höchstens einer Ausnahme so ausführlich wie für das Verständnis erforderlich und enthält weder Ballast noch unnötige Redundanzen." | 🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| B6.1a | "Der IPA-Bericht ist in Teil 1 (obligatorische Kapitel) und Teil 2(Projekt-Dokumentation) unterteilt." | src/index.tex |
Die Dokumentation wird in Umfeld und Ablauf und Projekt aufgeteilt. |
✔️ |
| B6.1b | "Ein allfälliger Quellcode ist im Anhang vorhanden" | src/appendix/source.tex |
✔️ | |
| B6.2a | "Teil 1 enthält: Projektaufbauorganisation" | src/chapters/organisation.tex |
✔️ | |
| B6.2b | "Teil 1 enthält: [..] Zeitplan" | src/chapters/timeplan.tex |
✔️ | |
| B6.2c | "Teil 1 enthält: [..] Arbeitsjournal" | src/chapters/journal.tex |
✔️ | |
| B6.3 | "Der IPA-Bericht enthält ein aktuelles Inhaltsverzeichnis" | src/index.tex |
Das Inhaltsverzeichnis wird beim Erstellen des Dokuments generiert. | ✔️ |
| B6.4a | "..zu sämtlichen Quellen besteht ein schriftlicher Nachweis" | src/index.tex |
✔️ | |
| B6.4b | "die referenzierten Quellen sind gültig und verlässlich;" | src/sources.bib |
Mit \cite und dem in src/sources.bib definierten Key kann eine Zitierung eingefügt werden. Das Literaturverzeichnis wird entsprechend nach IEEE automatisch generiert. |
🧑🎓 |
| B6.5 | "..auf allen Seiten (optional Titelblatt) eine Kopf- oder Fusszeile mit dem aktuellen Druckdatum und dem Namen des Kandidaten;" | src/index.tex |
✔️ | |
| B6.6 | "...ein alphabetisch sortiertes Glossar mit korrekten Erläuterungen der verwendeten Fachbegriffe und Abkürzungen, welche einer aussenstehenden Fachperson unbekannt sein dürften." | src/glossaries.tex |
Das Glossar wird automatisch mit den benutzten Einträgen alphabetisch erstellt. Ein Glossareintrag kann mit \gls{Eintragsname} benutzt werden. |
✔️ |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| B7.1 | "Die Sprache ist durchgehend klar verständlich (Satzbau, Wortstellungen), in einem flüssigen Stil sowie in vollständigen und ausformulierten Sätzen geschrieben." | 🧑🎓 | ||
| B7.2 | "Fachbegriffe werden korrekt und adressatengerecht eingesetzt." | 🧑🎓 | ||
| B7.3 | "Der IPA-Bericht enthält nur wenige Rechtschreib- oder Grammatikfehler." | 🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| B8.1 | "Die Darstellung enthält eine geeignete Seitennummerierung." | ✔️ | ||
| B8.2 | "Der Seitenumbruch ist sinnvoll oder behindert den Lesefluss nicht." | 🧑🎓 | ||
| B8.3 | "Jede Seite enthält Informationen und nicht nur eine einzelne Textzeile oder Überschrift." | 🧑🎓 | ||
| B8.4 | "Die Darstellung ist zweckmässig und sauber." | 🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| B9.1 | "Es werden an vernünftigen Stellen Grafiken, Bilder, Diagramme oder Tabellen eingesetzt, um die Inhalte im IPA-Bericht besser darzustellen und den Text verständlicher zu machen." | 🧑🎓 | ||
| B9.2 | "Die Wahl der Darstellungen ist durchgehend geeignet." | 🧑🎓 | ||
| B9.3 | "Die Darstellung ist kontrastreich und optisch gut lesbar (als Referenz dient der Ausdruck auf Format A4)." | 🧑🎓 | ||
| B9.4 | "Die Darstellungen sind inhaltlich verständlich." | 🧑🎓 | ||
| B9.5 | "Die Darstellungen sind aussagekräftig." | 🧑🎓 | ||
| B9.6 | "Die Darstellungen sind im Text oder in einer Legende erklärt." | 🧑🎓 | ||
| B9.7 | "Die Darstellungen passen zum Kontext." | 🧑🎓 |
| ID | Anforderung | Referenz | Bemerkungen | Status |
|---|---|---|---|---|
| B10.1 | "Die Testdurchführung basiert auf dem Testkonzept; dies ist entsprechend dokumentiert (inkl. allfälliger Abweichungen davon)." | src/chapters/check.tex |
🧑🎓 | |
| B10.2 | "Alle Testresultate sind korrekt und übersichtlich dokumentiert." | src/chapters/check.tex |
⏳ | |
| B10.3 | "Das Testprotokoll beinhaltet Angaben über den Testzeitpunkt, die Testperson sowie allfällige spezifische Informationen." | src/chapters/check.tex |
⏳ | |
| B10.4 | "Es wird ein aussagekräftiges Fazit zum Testergebnis (pro Testfall) gezogen und es werden allfällige notwendige Massnahmen/Empfehlungen beschrieben" | src/chapters/check.tex |
🧑🎓 |
[1]: https://pk19.ch/wp-content/uploads/2021/11/Kriterienkatalog-Standardkriterien_2022.pdf
[2]: https://pk19.ch/wp-content/uploads/2021/11/QV-Leitfaden_2022.pdf