Datenimport-Tools

Die Datenimport-Tools ermöglichen den Massenimport von Kunden-, Fahrten- und Fahrzeugdaten aus CSV-Dateien. Diese Anleitung behandelt alle Importfunktionen, Dateiformatanforderungen und bewährte Praktiken für eine erfolgreiche Datenmigration.

Zugriff auf Datenimport-Tools

Navigieren Sie zu Admin > Datenbank-Tools, um auf die Import-Oberfläche zuzugreifen.

Voraussetzungen:

• Admin-Zugriff auf das System
• Korrekt formatierte CSV-Dateien
• Daten, die dem erwarteten Schema entsprechen

Übersicht

Verfügbare Importtypen

Import-Workflow

---

Kundenimport

Zugriff auf Kundenimport

Suchen Sie in den Datenbank-Tools die Karte "Kundenimport" und klicken Sie darauf.

CSV-Formatanforderungen

Trennzeichen: Semikolon (;)

Erforderliche Spalten:

• ID - Eindeutige Kennung (wird zu original_id)

Unterstützte Spalten:

Importprozess

Kleine Dateien (< 4 MB):

1. Klicken Sie auf "Datei auswählen" oder per Drag-and-Drop
2. Klicken Sie auf "Importieren"
3. Verarbeitung erfolgt synchron
4. Ergebnisse werden sofort angezeigt

Große Dateien (4+ MB):

1. Upload startet Stapelverarbeitung
2. Datei wird in 500-Zeilen-Stapel aufgeteilt
3. Fortschritt über Import-Jobs verfolgt
4. Benachrichtigung bei Abschluss

Importergebnisse

Nach Abschluss des Imports sehen Sie:

• Verarbeitet: Gesamtanzahl der gelesenen Zeilen
• Importiert: Neue erstellte Datensätze
• Aktualisiert: Aktualisierte bestehende Datensätze
• Fehler: Zeilen, die nicht importiert werden konnten

Fehlerdetails: Erste 10 Fehler werden angezeigt mit:

• Zeilennummer
• Kunden-ID (falls verfügbar)
• Fehlermeldung

---

Fahrtenimport

Zugriff auf Fahrtenimport

Suchen Sie in den Datenbank-Tools die Karte "Fahrtenimport" und klicken Sie darauf.

CSV-Formatanforderungen

Trennzeichen: Semikolon (;)

Wichtige Spalten:

Zusätzliche Spalten (50+ insgesamt):

• Zonen-IDs (Parken, kostenpflichtig, Parkverbot, Bonus, Geschwindigkeitsbegrenzung, Sperrzone)
• Standortkoordinaten (Start-/Endpositionen)
• Abonnementdetails
• Preispaket-Informationen
• Dynamische Preisdaten

Importverhalten

Der Fahrtenimport führt automatisch Folgendes aus:

1. Erstellt fehlende Kunden (wenn Benutzer-ID vorhanden)
2. Erstellt fehlende Fahrzeuge (wenn Fahrzeug-ID vorhanden)
3. Verknüpft Fahrten mit bestehenden Kunden und Fahrzeugen
4. Behandelt doppelte Fahrten via Upsert auf Fahrten-ID

Importergebnisse

Nach dem Import:

• Gesamtanzahlen in den Datenbank-Statistiken prüfen
• Erstellung von Kunden und Fahrzeugen überprüfen
• Eventuelle Fehlermeldungen überprüfen

---

Fahrzeugimport

Format

Der Fahrzeugimport verwendet das JSON-Format (nicht CSV):

[
  {
    "vehicle_number": "VH-001",
    "iot_imei": "123456789012345",
    "vin": "1HGBH41JXMN109186",
    "vehicle_model": "Scooter Pro"
  },
  {
    "vehicle_number": "VH-002",
    "iot_imei": "123456789012346"
  }
]

Erforderliche Felder

• vehicle_number - Erforderlich - Eindeutige Kennung für das Fahrzeug

Optionale Felder

• iot_imei - IoT-Geräte-IMEI-Nummer
• vin - Fahrzeug-Identifikationsnummer
• vehicle_model - Modellname oder ID
• Zusätzliche Felder nach Bedarf

Importergebnis

Gibt pro Fahrzeug Ergebnisse zurück:

• Erfolgs- oder Fehlerstatus
• Fehlermeldung für fehlgeschlagene Zeilen
• Automatische Verknüpfung mit IoT-Geräten über IMEI

---

IoT-Geräteimport

Format

Der IoT-Geräteimport verwendet das JSON-Format:

[
  {
    "imei": "123456789012345",
    "device_type": "Tracker",
    "firmware_version": "2.1.0"
  }
]

Erforderliche Felder

• imei - Erforderlich - Geräte-IMEI-Nummer

Verknüpfung mit Fahrzeugen

Nach dem Import können Geräte mit Fahrzeugen verknüpft werden:

• Manuell über Fahrzeugbearbeitung
• Automatisch, wenn Fahrzeug übereinstimmende IMEI hat
• Über PUT-Anfrage an die API

---

Import-Job-Verfolgung

Wie Jobs funktionieren

Für große Dateien und Hintergrundimporte:

1. Job erstellt: System erstellt einen import_jobs-Datensatz
2. Status: Verarbeitung: Datei wird geparst und importiert
3. Fortschrittsaktualisierungen: Anzahl verarbeiteter Zeilen erhöht sich
4. Abschluss: Status wechselt zu completed oder completed_with_errors

Job-Status

Aktive Jobs anzeigen

Auf der Stripe-Import-Seite werden aktive Jobs angezeigt mit:

• Fortschrittsbalken (verarbeitet/Gesamtzeilen)
• Statusanzeige
• Importiert/Aktualisiert/Übersprungen/Fehler-Anzahlen
• Startzeit und Dateiname

Job-Polling

Das System fragt alle 2 Sekunden Job-Updates ab, während Sie sich auf der Import-Seite befinden.

---

Fehlerbehandlung

Häufige Fehler

Fehlergrenzen

• Verarbeitung stoppt nach 100 aufeinanderfolgenden Fehlern
• Erste 10 Fehlerdetails werden in der Oberfläche angezeigt
• Vollständiges Fehlerprotokoll im Import-Job-Datensatz verfügbar

Umgang mit teilweisen Importen

Wenn der Import mittendrin stoppt:

1. Letzte erfolgreiche Zeile notieren
2. Fehler in verbleibenden Zeilen beheben
3. Nur verbleibende Daten erneut importieren
4. Oder alles löschen und komplett neu importieren

---

Dateigrößenrichtlinien

Tipps für große Dateien

1. Sehr große Dateien aufteilen: In Blöcke von 50.000 Zeilen unterteilen
2. Zuerst testen: Kleine Stichprobe vor vollständigem Import importieren
3. Außerhalb der Spitzenzeiten: Große Imports in verkehrsarmen Zeiten durchführen
4. Fortschritt überwachen: Job-Status auf Probleme beobachten

---

Staging-Tabellen

Wie Staging funktioniert

1. CSV-Daten werden in eine Staging-Tabelle geladen (z.B. users_import)
2. RPC-Funktion transformiert und validiert Daten
3. Gültige Datensätze werden in die Haupttabelle eingefügt (Upsert)
4. Staging-Tabelle wird geleert (oder zur Prüfung aufbewahrt)

Staging-Tabellen

---

Bewährte Praktiken

Vor dem Import

1. Vorhandene Daten sichern: Aktuelle Daten zuerst exportieren
2. CSV-Format validieren: Trennzeichen, Kodierung, Header prüfen
3. Mit Stichprobe testen: Zuerst 10-20 Zeilen importieren
4. Aktuelle Anzahlen notieren: Statistiken zum Vergleich aufzeichnen

Während des Imports

1. Nicht wegnavigieren: Bei synchronen Imports auf der Seite bleiben
2. Fortschritt überwachen: Job-Status bei großen Imports beobachten
3. Fehler notieren: Fehlermeldungen dokumentieren oder Screenshots erstellen

Nach dem Import

1. Anzahlen überprüfen: Datenbank-Statistiken prüfen
2. Datensätze stichprobenartig prüfen: Einige importierte Datensätze überprüfen
3. Funktionalität testen: Sicherstellen, dass importierte Daten korrekt funktionieren
4. Import dokumentieren: Aufzeichnen, was wann importiert wurde

---

Datentransformation

Automatische Transformationen

Während des Imports werden Daten automatisch:

• Von Leerzeichen befreit
• Leere Zeichenketten in NULL konvertiert
• Daten in Zeitstempel geparst
• Zahlen aus Zeichenketten geparst
• Boolesche Zeichenketten (TRUE/FALSE/Yes/No) konvertiert

Manuelle Vorbereitung

Vor dem Import sicherstellen:

• Keine zusätzlichen Header-Zeilen
• Konsistente Datumsformate
• Gültige E-Mail-Formate
• Einheitlich formatierte Telefonnummern
• Keine Sonderzeichen in IDs

---

Fehlerbehebung

Datei-Upload schlägt fehl

Mögliche Ursachen:

• Datei zu groß
• Falscher Dateityp
• Netzwerk-Timeout

Lösungen:

• Dateigröße reduzieren
• .csv-Erweiterung sicherstellen
• Netzwerkverbindung prüfen

Import abgeschlossen, aber keine neuen Datensätze

Mögliche Ursachen:

• Alle Datensätze existieren bereits
• ID-Spalte verweist auf bestehende Datensätze
• Upsert hat aktualisiert statt eingefügt

Lösungen:

• Auf Aktualisierungen prüfen (nicht nur Einfügungen)
• ID-Spaltenwerte überprüfen
• Import-Statistiken sorgfältig prüfen

Viele Datensätze schlagen fehl

Mögliche Ursachen:

• Falsches Trennzeichen (Komma statt Semikolon)
• Spaltennamen stimmen nicht überein
• Datenformatprobleme

Lösungen:

• Semikolon als Trennzeichen überprüfen
• Spaltenüberschriften exakt prüfen
• Datenformate validieren

---

Nächste Schritte

• Super-Admin-Funktionen - Erfahren Sie mehr über Plattformadministration
• Stripe-Datensynchronisation - Zahlungsdaten von Stripe importieren
• Schnellstart-Anleitung - Erste Schritte mit der Flottenverwaltung