Nutzung
Quelle: pkr-lab/pkr-lab-docs/ps-data-fixtures/nutzung.md
Nutzung
Als Quelle für DocFlowEngine
Ein Testlauf mit DocFlowEngine, ohne echte Daten zu berühren:
- Das Repo in ein Arbeitsverzeichnis klonen (Kopie, nicht das OneDrive-Original).
- In
config/docflow-config.psd1von DocFlowEnginesources[].pathauf einen Austauschordner zeigen lassen, z. B.ps-data-fixtures/IT-Ausbildung/FI25/Austauschordner, undaufgabenRootauf ein leeres Testverzeichnis setzen. - Zuerst im DryRun laufen lassen:
pwsh -NoProfile -ExecutionPolicy Bypass -File ./scripts/DocFlowEngine.ps1 -DryRun
Details: DocFlowEngine Nutzung.
Fixtures ergänzen
- Neue Dateien nach der Namenskonvention benennen und in den Ordner des passenden Lernenden legen.
- Erfundene Namen verwenden, keine echten Personen.
- Neue Ordner im Verzeichnisindex eintragen.
Debugging und Fehlersuche
Das Repo enthält nur Daten und keinen Code. Fehlerbilder entstehen beim Zusammenspiel mit DocFlowEngine, dessen Meldungen auf der Seite DocFlowEngine: Debugging stehen. Stand der Prüfung (2026-10-21): Das Repo liegt nicht unter ~/gitlab, die folgenden Angaben stützen sich auf die vorhandene Doku und den Code von DocFlowEngine (TODO: prüfen gegen das Repo selbst).
| Symptom | Ursache | Lösung |
|---|---|---|
DocFlowEngine meldet für eine Fixture passt nicht zum Schema … |
Dateiname verletzt die Namenskonvention (Leerzeichen, Bindestrich, Umlaut, fehlender Teil) | Datei umbenennen. Schema: initialen[_v<version>]_praefix_suffix_aufgabennummer |
Präfix '…' ist nicht in der Whitelist … eingetragen oder Suffix '…' ist für Präfix '…' nicht … |
neue Kombination, die config/project-routes.txt von DocFlowEngine nicht kennt |
Whitelist ergänzen (DocFlowEngine: Konfiguration) |
| Fixtures werden nicht kopiert | Datei jünger als minFileAgeMinutes (Standard 2), bereits im Zustand .docflow-state.json |
Zustandsdatei der Testumgebung löschen, kurz warten |
| Lauf ändert echte Daten | sources[].path zeigt auf das OneDrive-Original |
immer auf eine Kopie zeigen, zuerst -DryRun (Nutzung) |
macOS-.DS_Store stört |
versioniert, ohne Bedeutung | ignorieren |
| Unterschiedliche Ergebnisse auf zwei Rechnern | gemeinsamer Zustand fehlt | Multi-Machine-Setup |