Einen CSV-Import mit einem Probelauf vorab prüfen

Der Probelauf ist eine Vorschau eines CSV-Imports, die nichts in Ihren Daten verändert. Dieser Artikel erläutert, was der Probelauf prüft, wie Sie seine Ergebnisse lesen und wie er sich von der Übernahme unterscheidet, die die Strafmandate tatsächlich anlegt.

Probelauf vs. Übernahme

	Probelauf	Übernahme
Schreibt Daten?	Nein — schreibgeschützte Vorschau	Ja — erstellt Mandate
Idempotency-Key?	Nicht erforderlich	Erforderlich
Duplikaterkennung?	Ja — kennzeichnet Duplikate	Ja — überspringt Duplikate
Fahrerzuordnung?	Nein	Läuft für jedes erstellte Mandat
Ergebnis	Zusammenfassung + zeilenweise Vorschau	Zusammenfassung des Erstellten

Sie können den Probelauf so oft ausführen, wie Sie möchten, während Sie Ihre Datei bereinigen. Nur die Übernahme erstellt Datensätze.

Was der Probelauf prüft

Der Probelauf parst zunächst die CSV-Kopfzeile und bestätigt, dass alle erforderlichen Spalten vorhanden sind. Fehlt eine erforderliche Spalte, schlägt der gesamte Lauf mit einer Meldung fehl, die die fehlenden Spalten benennt, und keine Zeile wird ausgewertet. Ist die Kopfzeile gültig, validiert er jede Datenzeile und vergleicht sie mit Ihren bestehenden Mandaten auf Duplikate.

Die Zusammenfassung lesen

Der Probelauf gibt vier Zählwerte zurück:

Gesamtzeilen — jede Datenzeile in der Datei.
Importierbare Zeilen — Zeilen, die gültig und keine Duplikate sind; dies ist, was eine Übernahme erstellen würde.
Validierungsfehler — Zeilen mit einem oder mehreren Feldfehlern.
Übersprungene Duplikate — Zeilen, deren Aktenzeichen und Fahrzeug bereits vorhanden sind oder die sich weiter oben in der Datei wiederholen.

Die zeilenweise Vorschau lesen

Jede Zeile in der Vorschau zeigt ihre Zeilennummer, das Aktenzeichen und das Fahrzeug sowie vier Kennzeichen und eine Fehlerliste:

Ist gültig — die Zeile hat alle Feldprüfungen bestanden.
Ist Duplikat — die Zeile stimmt mit einem bestehenden Mandat oder einer früheren Zeile überein.
Wird importiert — nur dann true, wenn die Zeile gültig und kein Duplikat ist.
Fehler — die konkreten Gründe, aus denen eine Zeile fehlgeschlagen ist, etwa „amount must be greater than zero“ oder „countryCode must be a 2-letter ISO code.“

Tipp: Zeilennummern zählen die Kopfzeile als Zeile 1, sodass Ihre erste Datenzeile Zeile 2 ist. Verwenden Sie die Zeilennummer in der Vorschau, um die genaue zu korrigierende Zeile in Ihrer Tabelle zu finden.

Empfohlener Ablauf

Führen Sie den Probelauf für Ihre CSV-Datei aus.
Korrigieren Sie jede unter Validierungsfehler aufgeführte Zeile anhand ihrer Fehlermeldungen.
Entscheiden Sie, wie Sie mit Duplikaten verfahren — sie werden übersprungen, was bei einem erneuten Upload normalerweise erwünscht ist.
Führen Sie den Probelauf erneut aus, bis die Anzahl importierbarer Zeilen Ihren Erwartungen entspricht.
Übernehmen Sie dieselbe CSV-Datei mit einem Idempotency-Key.

Hinweis: Der Probelauf benötigt einen gültigen Mandantenkontext und mindestens eine Kopfzeile plus eine Datenzeile; eine Datei nur mit Kopfzeile wird abgelehnt.