RobandClaude Opus 5.5
cb059ac20d
Der Update-Hinweis bietet neben "Update Ordner öffnen" nun den Button "Anwendung ersetzen". Er kopiert das ZIP vom SMB-Laufwerk lokal, prüft es, entpackt es in einen eigenen Ordner neben der aktuellen Installation, übernimmt input/, output/ und eigene Templates und startet die neue EXE. Die alte Installation bleibt als Rückfallebene erhalten; eine angepasste settings.ini wird als settings.vorherige-version.ini aufbewahrt. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
76 lines
3.6 KiB
Markdown
76 lines
3.6 KiB
Markdown
# 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`
|