IoT-Geraeteimport

Beim Hinzufuegen mehrerer IoT-Geraete zu Ihrer Flotte spart die CSV-Importfunktion erheblich Zeit im Vergleich zum einzelnen Hinzufuegen von Geraeten. Diese Anleitung erklaert, wie Sie Ihre CSV-Datei vorbereiten und Geraete erfolgreich massenimportieren.

Importprozess-Ueberblick

Der IoT-Geraeteimportprozess folgt diesen Schritten:

1. CSV-Datei vorbereiten mit Geraetedaten
2. Datei hochladen ueber die IoT-Geraeteseite
3. System validiert die Daten und zeigt eventuelle Fehler an
4. Daten werden bereitgestellt in einer temporaeren Importtabelle
5. Importfunktion wird ausgefuehrt um Geraetedatensaetze zu erstellen/aktualisieren
6. Fahrzeugidentitaets-Cache wird geleert um korrekte Verknuepfung sicherzustellen

CSV-Dateianforderungen

Dateiformat

• Format: CSV (Comma-Separated Values)
• Trennzeichen: Semikolon (;) - NICHT Komma
• Kodierung: UTF-8 empfohlen
• Header: Erste Zeile muss Spaltenheader enthalten
• Anfuehrungszeichen: Verwenden Sie doppelte Anfuehrungszeichen (") fuer Textfelder mit Sonderzeichen

Erforderliche Spalten

Optionale Spalten

Gueltige IoT-Typen

Das Feld iot_type muss einer dieser Werte sein:

CSV-Datei vorbereiten

Mit Microsoft Excel

1. Oeffnen Sie eine neue Excel-Arbeitsmappe
2. Geben Sie Spaltenheader in Zeile 1 ein
3. Fuegen Sie Ihre Geraetedaten ab Zeile 2 hinzu
4. Speichern unter und waehlen Sie "CSV (Trennzeichen-getrennt)"
5. Oeffnen Sie die gespeicherte CSV-Datei in einem Texteditor
6. Suchen und Ersetzen Sie alle Kommas (,) durch Semikolons (;)
7. Speichern Sie die Datei

Mit Google Sheets

1. Erstellen Sie eine neue Tabelle
2. Geben Sie Spaltenheader in Zeile 1 ein
3. Fuegen Sie Ihre Geraetedaten ab Zeile 2 hinzu
4. Gehen Sie zu Datei > Herunterladen > Kommagetrennte Werte (.csv)
5. Oeffnen Sie die heruntergeladene Datei in einem Texteditor
6. Suchen und Ersetzen Sie alle Kommas (,) durch Semikolons (;)
7. Speichern Sie die Datei

CSV-Vorlage herunterladen

Anstatt eine Datei von Grund auf zu erstellen, koennen Sie eine vorformatierte Vorlage herunterladen:

1. Gehen Sie zu IoT-Geraete in der Seitenleiste
2. Klicken Sie auf Importieren, um den Import-Dialog zu oeffnen
3. Klicken Sie auf Vorlage herunterladen
4. Die Vorlagen-CSV enthaelt alle Spaltenheader und Beispieldaten
5. Ersetzen Sie die Beispieldaten durch Ihre tatsaechlichen Geraeteinformationen
6. Speichern und laden Sie die geaenderte Datei hoch

Beispiel-CSV-Inhalt

imei;iccid;iot_type;iot_model;owner_name;notes
867648045123456;8901260123456789012;queclink;GL530M;Betriebsteam;Flotte A
867648045123457;8901260123456789013;queclink;GL530M;Betriebsteam;Flotte A
867648045123458;8901260123456789014;segway;;Betriebsteam;Flotte B
867648045123459;8901260123456789015;okai;ZK200;;Neue Lieferung

CSV-Datei hochladen

Schritt-fuer-Schritt-Upload

Was waehrend des Imports passiert

Bereitstellungsprozess

1. Das System leert die Bereitstellungstabelle (iot_devices_import)
2. Ihre CSV-Daten werden in die Bereitstellungstabelle eingefuegt
3. Grundlegende Validierung wird fuer erforderliche Felder durchgefuehrt

Importfunktion

Die Datenbankfunktion import_iot_devices():

1. Validiert jede Zeile in der Bereitstellungstabelle
2. Erstellt neue Geraetedatensaetze fuer neue IMEIs
3. Aktualisiert bestehende Datensaetze, wenn IMEI bereits existiert
4. Setzt Standardwerte fuer fehlende Felder:
   • online_status: false
   • activation_status: pending
   • total_rides: 0
   • trips_current_month: 0
   • current_month_revenue: 0
   • previous_month_revenue: 0
   • iot_added_on: aktueller Zeitstempel

Cache-Loeschung

Nach einem erfolgreichen Import wird der Fahrzeugidentitaets-Cache automatisch geleert. Dies stellt sicher:

• Neue IMEI-zu-Fahrzeug-Zuordnungen werden erkannt
• Aktualisierte Geraeteinformationen werden sofort wirksam
• Keine veralteten Daten beeinflussen die Telemetrieverarbeitung

Umgang mit Importfehlern

Haeufige Validierungsfehler

Dateiformatfehler

Fehler beheben

1. Laden Sie den Fehlerbericht herunter, falls verfuegbar
2. Beheben Sie Probleme in Ihrer urspruenglichen Tabelle
3. Exportieren Sie erneut mit korrektem Format
4. Laden Sie die korrigierte Datei hoch

Bestehende Geraete aktualisieren

Wenn Sie eine CSV mit IMEIs importieren, die bereits im System existieren:

• Bestehende Geraete werden aktualisiert mit neuen Werten aus der CSV
• Leere Zellen ueberschreiben nicht bestehende Daten
• Das Datum iot_added_on bleibt erhalten fuer bestehende Geraete

Dies ermoeglicht Ihnen, CSV-Import sowohl fuer die Ersteinrichtung als auch fuer Massenaktualisierungen zu verwenden.

Geraete nach dem Import mit Fahrzeugen verknuepfen

Nach dem Import von IoT-Geraeten moechten Sie diese typischerweise mit Fahrzeugen verknuepfen. Es gibt mehrere Ansaetze:

Option 1: Fahrzeuge mit IMEIs importieren

Beim Importieren von Fahrzeugen per CSV fuegen Sie die Spalte iot_imei ein. Das System verknuepft automatisch Geraete mit Fahrzeugen basierend auf uebereinstimmenden IMEI-Werten.

Option 2: Manuelle Verknuepfung

1. Gehen Sie zu Fahrzeuge
2. Klicken Sie auf ein Fahrzeug
3. Bearbeiten und fuegen Sie die IMEI im Feld IoT-IMEI hinzu
4. Speichern Sie das Fahrzeug

Option 3: Von der IoT-Geraeteseite verknuepfen

1. Gehen Sie zu IoT-Geraete
2. Klicken Sie auf ein nicht verknuepftes Geraet
3. Klicken Sie auf Mit Fahrzeug verknuepfen
4. Waehlen Sie das Zielfahrzeug
5. Bestaetigen Sie die Verknuepfung

Best Practices

Vor dem Import

• IMEIs validieren - Stellen Sie sicher, dass alle 15-stelligen IMEIs korrekt sind
• Auf Duplikate pruefen - Entfernen Sie alle doppelten IMEI-Zeilen
• Unterkonten verifizieren - Bestaetigen Sie, dass Unterkonto-UUIDs existieren
• Mit kleinem Batch testen - Versuchen Sie zuerst, 5-10 Geraete zu importieren

Dateivorbereitung

• Konsistente Formatierung verwenden - Gleiches Datumsformat, Gross-/Kleinschreibung, usw.
• Leere Zeilen entfernen - Loeschen Sie alle leeren Zeilen am Ende
• Backup speichern - Behalten Sie Ihre urspruengliche Tabelle
• Zuordnungen dokumentieren - Notieren Sie, welche Spalten Sie verwendet haben

Nach dem Import

• Anzahl verifizieren - Pruefen Sie, ob Gesamtgeraete der Erwartung entspricht
• Stichproben pruefen - Oeffnen Sie einige Geraete zur Datenverifizierung
• Konnektivitaet testen - Bestaetigen Sie, dass Geraete kommunizieren koennen
• Mit Fahrzeugen verknuepfen - Ordnen Sie Geraete Flottenfahrzeugen zu

Programmatischer Import

Fuer fortgeschrittene Benutzer koennen IoT-Geraete auch ueber die API importiert werden:

API-Endpunkt

POST /api/iot-devices/import

Anfrageformat

{
  "csv_data": [
    {
      "imei": "867648045123456",
      "iccid": "8901260123456789012",
      "iot_type": "queclink",
      "iot_model": "GL530M",
      "notes": "Flotte A"
    },
    {
      "imei": "867648045123457",
      "iccid": "8901260123456789013",
      "iot_type": "queclink"
    }
  ]
}

Antwort

{
  "success": true,
  "message": "Successfully imported IoT devices",
  "total_count": 150
}

Geraet mit Fahrzeug per API verknuepfen

Sie koennen ein IoT-Geraet auch programmatisch mit einem Fahrzeug verknuepfen:

PUT /api/iot-devices/import

Anfragebody

{
  "imei": "867648045123456",
  "vehicle_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Antwort

{
  "success": true,
  "message": "IoT device linked to vehicle successfully",
  "vehicle_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "imei": "867648045123456"
}

Dieser Endpunkt:

1. Aktualisiert das Feld iot_imei des Fahrzeugs mit der angegebenen IMEI
2. Leert den Fahrzeugidentitaets-Cache fuer sofortige Erkennung
3. Gibt Bestaetigung der Verknuepfung zurueck

Fehlerbehebung

Import erfolgreich, aber Geraete erscheinen nicht

1. Pruefen Sie den Unterkontofilter - Sie sehen moeglicherweise ein anderes Unterkonto
2. Aktualisieren Sie die Seite, um sicherzustellen, dass die neuesten Daten geladen sind
3. Suchen Sie nach IMEI, um spezifische Geraete zu finden

Geraete importiert, aber nicht mit Fahrzeugen verknuepft

1. Ueberpruefen Sie, ob die IMEI exakt uebereinstimmt (keine Leerzeichen oder Bindestriche)
2. Pruefen Sie, ob Fahrzeuge mit uebereinstimmenden iot_imei-Werten existieren
3. Versuchen Sie, manuell zu trennen und erneut zu verknuepfen

Telemetrie kommt nach Import nicht an

1. Bestaetigen Sie, dass das Geraet eingeschaltet ist und Konnektivitaet hat
2. Ueberpruefen Sie, ob Servereinstellungen auf dem Geraet mit Ihrem Endpunkt uebereinstimmen
3. Pruefen Sie die Liste "Nicht zugeordnete Geraete" auf eventuelle Probleme
4. Warten Sie 5-10 Minuten auf den ersten Heartbeat

---