Zu Content springen
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

Wie funktioniert der CSV-Import für Fahrzeuge (inkl. Duplikate & Fehlerfälle)?

Mit dem CSV-Import für Fahrzeuge kannst du deinen Fuhrpark gesammelt in die Craftboxx übernehmen. Dieser Artikel erklärt dir, wie jede Zeile verarbeitet wird, wie Duplikate erkannt werden und was bei Fehlern passiert.

 

🤖 Kurze Zusammenfassung für den Chatbot:

  • Jede CSV-Zeile wird einzeln verarbeitet: Entweder wird ein neues Fahrzeug angelegt, als Duplikat übersprungen oder als Fehler abgewiesen.
  • Duplikate werden ausschließlich über das Kennzeichen (license plate) innerhalb derselben Firma erkannt; es gibt keine Updates bestehender Fahrzeuge.
  • Pro Zeile gilt „Alles-oder-nichts“: Schlägt etwas fehl (z. B. falsches Datumsformat, ungültiger Zustand), wird nichts aus dieser Zeile gespeichert.

Grundprinzip: Jede CSV-Zeile wird einzeln behandelt

Beim Fahrzeug-Import arbeitet Craftboxx Zeile für Zeile aus deiner CSV-Datei ab. Für jede Zeile wird unabhängig entschieden, ob ein neues Fahrzeug angelegt, die Zeile als Duplikat übersprungen oder als Fehler gezählt wird.

Wichtig:

  • Jede Zeile ist eine eigene „Transaktion“.
  • Wenn in einer Zeile irgendetwas schiefgeht, wird nichts aus genau dieser Zeile gespeichert (Alles-oder-nichts).

Mögliche Ergebnisse pro Zeile:

  • Erfolg: Neues Fahrzeug wird angelegt.
  • Duplikat: Zeile wird erkannt, aber übersprungen (kein Fehler).
  • Fehler: Zeile verstößt gegen Regeln oder hat andere Probleme – sie wird nicht importiert.

Datenmodell: Was ist ein Fahrzeug in Craftboxx?

Ein Fahrzeug repräsentiert ein Fahrzeug deines Fuhrparks mit z. B. folgenden Informationen:

  • Hersteller
  • Modell
  • Zulassungsnummer / Kennzeichen (license plate)
  • Kaufdatum
  • Termine für Wartung / nächste Inspektion
  • Ablaufdaten von Prüfungen
  • Zustand (Condition)
  • Notizen

Beziehungen:

  • Jedes Fahrzeug gehört immer genau zu einer Firma (deinem Craftboxx-Account).
  • Fahrzeuge werden beim Import automatisch deiner Firma zugeordnet, von der aus du den Import ausführst.
  • Gruppen oder Kategorien (wie sie manche anderen Importe nutzen) werden von diesem Fahrzeug-Import nicht verwendet.

Logik: „Anlegen“ vs. „Überspringen“ (Duplikat)

Die zentrale Frage beim Import ist: Wird ein neues Fahrzeug angelegt oder die Zeile als Duplikat übersprungen?

Duplikatprüfung über Kennzeichen (license plate):

  • Wenn in der Zeile ein Wert für vehicle-license_plate enthalten ist, prüft Craftboxx:
    • Existiert in derselben Firma bereits ein Fahrzeug mit genau diesem Kennzeichen?
  • Wenn ja:
    • Die Zeile gilt als Duplikat.
    • Es wird nichts geändert – das bestehende Fahrzeug bleibt unverändert.
    • Die Zeile wird übersprungen, aber nicht als Fehler gezählt.
  • Wenn nein (Kennzeichen ist eindeutig oder fehlt):
    • Es wird ein neues Fahrzeug angelegt.

Wichtig:

  • Es gibt keine Update-Logik in diesem Import.
  • Ein bestehendes Fahrzeug wird nicht über eine CSV-Zeile mit identischem Kennzeichen aktualisiert.

Ergebnis-Zählung: Erfolg, Duplikat, Fehler

Für jede Zeile wird im Import-Ergebnis genau ein Status gezählt:

  1. Erfolg (neu angelegt):

    • Die Zeile ist valide.
    • Es wurde kein Duplikat über das Kennzeichen gefunden (oder das Kennzeichen fehlt).
    • Ein neues Fahrzeug wird unter deiner Firma angelegt.

  2. Duplikat (übersprungen):

    • In vehicle-license_plate steht ein Kennzeichen.
    • Es existiert bereits ein Fahrzeug mit demselben Kennzeichen in derselben Firma.
    • Die Zeile wird übersprungen, es werden keine Änderungen an bestehenden Fahrzeugen vorgenommen.

  3. Fehler (abgewiesen):

    • Die Zeile verletzt eine Validierungsregel (z. B. falsches Datumsformat, ungültiger Zustandswert).
    • Oder es tritt ein anderer Fehler beim Speichern auf.
    • Die Zeile wird nicht importiert, und aus dieser Zeile wird gar nichts gespeichert.

Edge Cases & häufige Fragen (FAQ)

Was passiert, wenn zwei Zeilen im selben CSV dieselbe Kennzeichen-Nummer haben?

  • Die erste gültige Zeile mit diesem Kennzeichen, die verarbeitet wird, legt das Fahrzeug erfolgreich an.
  • Alle weitere Zeilen mit demselben Kennzeichen werden als Duplikate erkannt und übersprungen.
  • An dem bereits angelegten Fahrzeug wird nichts geändert.

Kann ich den Zustand oder Termine eines Fahrzeugs per CSV-Import aktualisieren?

  • Nein.
  • Wenn für vehicle-license_plate ein Kennzeichen angegeben wird, das bereits existiert, wird die Zeile als Duplikat behandelt und übersprungen.
  • Dieser Import ist nur zum Anlegen neuer Fahrzeuge gedacht, nicht zum Aktualisieren vorhandener.

Was passiert, wenn das Kennzeichen (vehicle-license_plate) fehlt?

  • Ohne Kennzeichen kann Craftboxx keine Duplikate über das Kennzeichen erkennen.
  • Ist die Zeile sonst gültig, wird ein neues Fahrzeug angelegt, obwohl eventuell schon ein sehr ähnliches Fahrzeug existiert.
  • Prüfe bei Imports ohne Kennzeichen besonders sorgfältig, ob doppelte Fahrzeuge entstehen können.

Was passiert bei falschen Datumsformaten (z. B. nicht dd.mm.yyyy)?

  • Datumsfelder müssen im Format dd.mm.yyyy vorliegen (z. B. 31.12.2025).
  • Wenn ein Datum in der Zeile nicht im erwarteten Format ist, schlägt die Validierung fehl.
  • Die gesamte Zeile wird als Fehler behandelt, und es wird nichts gespeichert.

Welche Werte sind für den Fahrzeugzustand (Condition) erlaubt?

  • Für das Feld „Zustand“ werden nur vordefinierte Zustandswerte akzeptiert (z. B. je nach Systemkonfiguration: „Neu“, „Gebraucht“, „Defekt“ – bitte die konkrete Liste in deiner Oberfläche beachten).
  • Wenn ein Wert verwendet wird, der nicht zu den erlaubten Zuständen gehört, wird die Zeile als Fehler gewertet.
  • Es wird kein Fahrzeug angelegt.

Was passiert, wenn ich dieselbe Datei mehrfach importiere?

  • Zeilen mit Kennzeichen, zu denen bereits ein Fahrzeug in deiner Firma existiert, werden als Duplikate erkannt und übersprungen.
  • Nur Zeilen mit neuen Kennzeichen (oder ohne Kennzeichen) können noch neue Fahrzeuge anlegen – vorausgesetzt, sie sind ansonsten valide.
  • Es werden keine vorhandenen Fahrzeuge aktualisiert oder überschrieben.

Wird eine Zeile jemals nur teilweise gespeichert?

  • Nein. Der Import arbeitet streng nach dem Prinzip Alles-oder-nichts pro Zeile.
  • Wenn eine Zeile an einer Stelle scheitert (z. B. ungültiges Datum, ungültiger Zustandswert), wird nichts aus dieser Zeile übernommen.

Muss ich vor dem Import Gruppen oder Kategorien für Fahrzeuge anlegen?

  • Nein.
  • Der Fahrzeug-Import nutzt keine Gruppen oder Kategorien.
  • Fahrzeuge werden direkt deiner Firma zugeordnet, ohne zusätzliche Gruppierung.

Schritt-für-Schritt: Import-Datei vorbereiten & Verhalten verstehen

  1. CSV vorbereiten:
    Stelle sicher, dass deine Datei alle benötigten Spalten enthält (z. B. Hersteller, Modell, vehicle-license_plate, Datumsfelder, Zustand, Notizen). Achte speziell auf das Format der Datumsangaben (dd.mm.yyyy) und auf gültige Zustandswerte.

  2. Kennzeichen-Strategie festlegen:
    Überlege, ob du den Duplikat-Schutz über das Kennzeichen nutzen möchtest. Wenn ja, trage in jeder Zeile ein eindeutiges vehicle-license_plate ein. Wenn nein, bedenke, dass ansonsten Duplikate entstehen können, da keine Prüfung auf vorhandene Fahrzeuge stattfindet.

  3. Import starten & Ergebnis prüfen:
    Starte den Import wie gewohnt im Bereich Stammdaten > Fahrzeuge (oder entsprechend deinem Menü). Nach Abschluss des Imports siehst du, wie viele Zeilen erfolgreich, als Duplikat oder als Fehler verarbeitet wurden. Prüfe im Fehlerprotokoll, welche Zeilen du ggf. korrigieren und erneut importieren musst.

💡 HINWEIS:
Wenn du versehentlich viele Fahrzeuge doppelt angelegt hast (z. B. weil du ohne Kennzeichen importiert hast), kannst du diese nicht per Sammel-CSV wieder „zusammenführen“ oder automatisch korrigieren. In diesem Fall müssen Duplikate manuell aufgeräumt oder über einen separaten Prozess bereinigt werden. Achte daher vor dem Import unbedingt auf saubere Kennzeichen und korrekte Formate.