sufw-taetigkeitsnachweise/0_application

Tätigkeitsnachweis-Generator

Programm zur automatisierten Erstellung von Tätigkeitsnachweisen aus Excel-Daten. Die aktuellesten Programmversion find sich immer hier: "j:\Fachbereiche\BO\Produktionsschule\Maßnahmeunterlagen\20_Personal\05_Tätigkeitsnachweise ESF\Nachweise-automatisiert-generieren"

Um das Programm zu starten: Doppelklick auf Tätigkeitsnachweis-Generator.exe

Bedienung

1. Input-Datei wählen – Dropdown zeigt alle .xlsx-Dateien aus dem input/-Ordner
   • Nach Auswahl wird die Datei sofort validiert
   • Angezeigt werden: Anzahl Mitarbeiter, Antragsnummern, Einträge pro Monat
2. Template wählen – Dropdown zeigt alle .xlsx-Dateien aus dem template/-Ordner
   • Nach Auswahl wird das Template sofort validiert
   • Angezeigt wird: Anzahl gefundener Zielfelder
3. Mitarbeiter auswählen – Multiselect-Liste aller gefundenen Mitarbeiter
   • Standardmäßig ist keiner ausgewählt
   • Nicht selektierte Mitarbeiter werden bei der Generierung übersprungen
4. Mitarbeitermonate auswählen – Multiselect-Liste aller verfügbaren Monate im Dokument. Vorselektiert sind die aktuell letzten beiden Monate.
5. "Tätigkeitsnachweise generieren" klicken
   • Die generierten Dateien werden im output/-Ordner abgelegt

Konfiguration

Alle Einstellungen liegen im config/-Ordner:

settings.ini

• [paths] – Ordner für Input, Template, Output
• [output] – Dateinamen-Pattern ({first_name}, {last_name})
• [parsing] – Monats-Sheet-Erkennung, Leerzeilen-Verhalten

input-fields.json

Definiert die Spalten der Input-Tabelle:

• column: Spaltenbuchstabe (A, B, C…)
• field_name: Exakte Spaltenüberschrift aus der Excel-Datei
• type: string oder number
• required: true oder false

output-fields.json

Mapping von Input-Feldern auf Template-Zellen:

• source_field: Exakte Spaltenüberschrift aus input-fields.json
• target_cell: Zelladresse im Template (z. B. "C16")
• format: Optionaler Format-String (z. B. "%.2f" für Prozentwerte)

Erwartetes Input-Format

• Eine .xlsx-Datei mit einem Sheet pro Monat (z. B. "Januar 2025", "Februar 2025", …)
• Jedes Sheet hat in Zeile 1 die Spaltenüberschriften (laut input-fields.json)
• Daten beginnen ab Zeile 2
• Jede Zeile entspricht einer Mitarbeiter-Funktion-Kombination für diesen Monat

Output

• Pro selektiertem Mitarbeiter wird eine .xlsx-Datei erstellt
• Jeder Monat wird als eigenes Sheet (Kopie des Templates) eingefügt
• Dateiname: {Nachname}_{Vorname}_Tätigkeitsnachweis.xlsx