Template-Platzhalter Anleitung

Alle verfügbaren Platzhalter für eigene Word-Templates

Template-System

Der Wochennachweis-Generator verwendet Docxtemplater zur Befüllung von Word-Dokumenten. Sie können eigene .docx-Templates erstellen und die unten aufgeführten Platzhalter verwenden.

Syntax: Alle Platzhalter werden in doppelte geschweifte Klammern gesetzt: {{PLATZHALTER}}

Haupt-Platzhalter
Platzhalter Beschreibung Beispiel-Ausgabe
{{NACHNAME}} Nachname des Auszubildenden Mustermann
{{VORNAME}} Vorname des Auszubildenden Max
{{KLASSE}} Klasse oder Kurs FIAE-2023-A
{{WOCHE}} Wochennummer seit Umschulungsbeginn 15
{{KATEGORIE}} Art des Zeitraums Umschulung, Praktikum
Datum-Platzhalter
Platzhalter Beschreibung Beispiel-Ausgabe
{{DATUM}} Montag der Woche (Wochenbeginn) 03.06.2024
{{UDATUM}} Samstag der Woche (Wochenende) 08.06.2024
{{MONTAG}} Datum des Montags 03.06.2024
{{SAMSTAG}} Datum des Samstags 08.06.2024
{{ZEITRAUM}} Kompletter Zeitraum der Woche 03.06.2024 - 08.06.2024
{{MONAT}} Monatsname Juni
{{JAHR}} Aktuelles Jahr 2024
{{KW}} Kalenderwoche 23
{{KALENDERWOCHE}} Kalenderwoche (zweistellig) 23
{{AJ}} Ausbildungsjahr 2024
Tägliche Einträge
Wichtiger Hinweis

Diese Platzhalter enthalten die tagesspezifischen Beschreibungen oder Feiertage. Falls ein Tag nicht von einem Zeitraum abgedeckt ist, bleibt der Platzhalter leer.

Platzhalter Beschreibung Beispiel-Ausgabe
{{EINTRAG1}} Montag - Beschreibung oder Feiertag HTML/CSS Grundlagen
{{EINTRAG2}} Dienstag - Beschreibung oder Feiertag JavaScript Einführung
{{EINTRAG3}} Mittwoch - Beschreibung oder Feiertag Feiertag: Tag der Arbeit
{{EINTRAG4}} Donnerstag - Beschreibung oder Feiertag React Komponenten
{{EINTRAG5}} Freitag - Beschreibung oder Feiertag Projektarbeit
{{EINTRAG6}} Samstag - Beschreibung oder Feiertag (optional) Prüfungsvorbereitung
Zusätzliche Platzhalter
Platzhalter Beschreibung Beispiel-Ausgabe
{{BESCHREIBUNG}} Zusammenfassung aller Beschreibungen der Woche HTML/CSS Grundlagen, Projektarbeit
{{SIGNATUR}} Hochgeladene Signatur (Base64) [Bild der Signatur]
{{BUNDESLAND}} Ausgewähltes Bundesland DE-NW
Signatur-Hinweis

Der {{SIGNATUR}} Platzhalter funktioniert nur mit speziellen Docxtemplater-Modulen für Bilder. Für einfache Templates verwenden Sie stattdessen einen Text-Platzhalter für den Namen.

Eigenes Template erstellen
Schritt 1: Word-Dokument erstellen
  • Öffnen Sie Microsoft Word
  • Erstellen Sie das gewünschte Layout für Ihren Wochennachweis
  • Fügen Sie Tabellen, Kopfzeilen, Logos etc. hinzu
Schritt 2: Platzhalter einfügen
  • Setzen Sie die Platzhalter aus den obigen Tabellen an die gewünschten Stellen
  • Wichtig: Verwenden Sie exakt die Syntax {{PLATZHALTER}}
  • Achten Sie auf korrekte Groß-/Kleinschreibung
Schritt 3: Template speichern
  • Speichern Sie das Dokument als .docx Datei
  • Ersetzen Sie die vorhandene Template-Datei in wwwroot/templates/
  • Dateiname: Wochennachweis_Vorlage.docx
Tipp

Testen Sie Ihr Template, indem Sie den "Docxtemplater testen" Button im Debug-Modus verwenden. So können Sie schnell überprüfen, ob alle Platzhalter korrekt funktionieren.

Beispiel-Template Struktur
WOCHENNACHWEIS

Name: {{VORNAME}} {{NACHNAME}}
Klasse: {{KLASSE}}
Woche: {{WOCHE}} (KW {{KW}})
Zeitraum: {{ZEITRAUM}}

Tätigkeiten:
┌─────────────┬─────────────────────────────────────┐
│ Montag      │ {{EINTRAG1}}                        │
├─────────────┼─────────────────────────────────────┤
│ Dienstag    │ {{EINTRAG2}}                        │
├─────────────┼─────────────────────────────────────┤
│ Mittwoch    │ {{EINTRAG3}}                        │
├─────────────┼─────────────────────────────────────┤
│ Donnerstag  │ {{EINTRAG4}}                        │
├─────────────┼─────────────────────────────────────┤
│ Freitag     │ {{EINTRAG5}}                        │
└─────────────┴─────────────────────────────────────┘

Kategorie: {{KATEGORIE}}
Monat/Jahr: {{MONAT}} {{JAHR}}

Unterschrift: ___________________________
Diese Anleitung bezieht sich auf die aktuelle Version des Generators. Bei Problemen überprüfen Sie zunächst die korrekte Syntax der Platzhalter.