Zum Hauptinhalt springen

Dry Run

Dry-run-Modus liest die CSV und validiert das Mapping, ohne Daten an die API zu senden. Er gibt außerdem eine begrenzte Vorschau der ersten 5 prüfbaren Zeilen aus, die an die API gesendet würden.

Verwenden Sie ihn, wenn:

  • Sie eine neue Mapping-Datei erstellen.
  • Ein Kunde ein neues CSV-Layout sendet.
  • Sie Trennzeichen, Encodings, Header oder übersprungene Zeilen ändern.
  • Sie prüfen wollen, dass gemappte Spalten existieren, bevor Quote verbraucht wird.
  • Sie bestätigen wollen, dass --no-header oder input.hasHeader: false-Indexmappings die erwarteten Werte auswählen.

Befehl​

optimus check customers.csv --map mapping.yml --standard --dry-run

Dry-run-Modus erfordert weiterhin einen gültigen Prüftyp. Übergeben Sie also --standard, --qualified oder setzen Sie defaults.checkType in YAML.

Was Geprüft Wird​

Dry-run-Modus prüft:

  • Eingabepfad.
  • YAML-Datei kann geladen werden.
  • YAML-Werte sind gültig.
  • Erforderliche Konfiguration ist vorhanden.
  • Gemappte Spalten existieren im CSV-Header.
  • No-Header-Mappings verwenden gültige 1-basierte Indizes.
  • Zeilen können gelesen werden.
  • Skip-Filter können angewendet werden.

API-Vorschau​

Nach der Validierung gibt Dry-run-Modus die ersten 5 prüfbaren Zeilen aus, die an die API gesendet würden.

Die Vorschau wird nach Anwendung der Skip-Filter angezeigt, daher sind übersprungene Zeilen nicht enthalten. Sie enthält die API-Eingabefelder:

  • Quellzeilennummer.
  • USt-IdNr.
  • Unternehmensname.
  • Straße.
  • ZIP.
  • Stadt.

Beispiel:

First 2 rows that would be sent to the API
Row | VAT ID      | Company   | Street        | ZIP   | City
1   | DE123456789 | Acme GmbH | Main Street 1 | 10115 | Berlin
2   | DE987654321 | Beta GmbH | Side Street 2 | 80331 | Munich
No API call executed (dry-run).

Die Vorschau ist nur Terminalausgabe. Dry-run-Modus erstellt kein Support-Log. Verwenden Sie --quiet, um normale Dry-run-Ausgabe zu unterdrücken und nur Fehler auszugeben.

Was Nicht Passiert​

Dry-run-Modus:

  • Benötigt kein Token.
  • Ruft die API nicht auf.
  • Erstellt keine Validierungsoperationen.
  • Erstellt keinen gespeicherten Validierungszustand.
  • Erstellt keine Support-Logs.
  • Lädt keine PDFs herunter.
  • Schreibt keine Ergebnis-CSV.
  • Erstellt im Folder Mode keine Mailbox-Ordner, versucht keine Dateien aus error/ erneut, verschiebt keine Dateien nach processing/, done/ oder error/, schreibt keine .err-Dateien und bereinigt keine alten done/-Dateien.

Typischer Ablauf​

export OPTIMUS_TOKEN="<token>"
optimus check customers.csv --map mapping.yml --standard --dry-run
optimus check customers.csv --map mapping.yml --standard