sufw-taetigkeitsnachweise/0_application/README.md

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
   • Bei leerem Input-Ordner: „Input-Ordner öffnen“ öffnet den Explorer.
   • Excel-Dateien können per Drag-and-drop hochgeladen werden. Sie werden in den Input-Ordner kopiert; danach wird die Dateiliste automatisch neu eingelesen.
   • Nach manuellem Kopieren im Explorer „Input-Ordner neu einlesen“ anklicken.
   • 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

Update

Liegt eine neuere Version auf dem Laufwerk J:, erscheint oben rechts ein Hinweis.

• „Anwendung ersetzen“ richtet die neue Version in einem eigenen Ordner neben der aktuellen ein (z. B. Tätigkeitsnachweis-Generator v1.4.0), übernimmt input/, output/ und eigene Template-Dateien und startet sie. Das folgende Rückfragefenster mit „Ja“ bestätigen, dann wird die alte Version beendet.
• Die alte Version bleibt als Ordner erhalten und kann gelöscht werden, sobald die neue läuft.
• Wurde settings.ini angepasst, liegt die bisherige Datei als config/settings.vorherige-version.ini daneben.
• Desktop-Verknüpfungen zeigen weiterhin auf den alten Ordner und müssen neu angelegt werden.
• „Update Ordner öffnen“ öffnet das Verzeichnis auf J: für ein manuelles Update.

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