Massenimport per Tabelle

Die Funktion Aus Tabelle importieren ermöglicht das Onboarding von Objekten in Unternehmensgröße durch dateibasierte Stapelverarbeitung. Anstatt Hunderte von Objekten einzeln manuell hinzuzufügen, laden Sie eine vorbereitete Tabelle hoch, und die Plattform verarbeitet alle Einträge in einem einzigen Vorgang. Behandelt werden: Was der Massenimport per Tabelle leistet, Wann er einzusetzen ist, Der Import-Arbeitsbereich.

Was der Massenimport per Tabelle leistet

Greifen Sie über die linke Seitenleiste darauf zu: Klicken Sie auf Konfiguration und wählen Sie anschließend die Registerkarte IMPORT STATUS.

Der Ablauf erfolgt in drei Schritten: Hochladen — wählen Sie Ihre Datei mit der Schaltfläche Upload site sheet aus (oder ziehen Sie eine Datei direkt in den Ablagebereich); Vorschau — die hochgeladenen Zeilen erscheinen in einer Tabelle Imported Sites (gekennzeichnet mit “Previewing locally. Continue to upload to the server.”) mit einer Anzahl-Plakette (zum Beispiel 15 sites) und den Spalten Site name, Site Contact, Camera brand, Connection, Status und Camera name; jede Zeile trägt einen Status Preview (local), sodass Sie sie vor dem Übernehmen prüfen können; Auf den Server hochladen — klicken Sie auf Upload To Server, um zu übernehmen. Die Plattform verarbeitet die Datei serverseitig und zeigt einen Verarbeitungsstatus an, bevor die endgültigen Ergebnisse erscheinen und der Import-Tracker mit den endgültigen Zahlen aktualisiert wird.

Schritt 1 — Leerer Hochlade-Arbeitsbereich. Die Registerkarte Spreadsheet Import, bevor eine Datei ausgewählt wurde. Der Ablagebereich und die Schaltfläche Upload site sheet sind bereit. Verwenden Sie Download Current As Template, um vor dem Ausfüllen Ihrer Datei das korrekte Spaltenlayout zu erhalten.

Schritt 2 — Datei bereit zum Hochladen. Eine Datei wurde in den Ablagebereich gezogen. Der Dateiname erscheint und die Schaltfläche Upload and continue wird aktiv.

Schritt 3 — Lokale Vorschau. Die hochgeladenen Zeilen erscheinen in der Tabelle Imported Sites und zeigen jeweils einen Status Preview (local). Prüfen Sie hier die Zeilenanzahl und die Spaltenwerte, bevor Sie übernehmen — es wurde noch nichts an den Server gesendet.

Schritt 4 — Serververarbeitung. Nach dem Klick auf Upload and continue validiert die Plattform jede Zeile und erstellt die Objekt- und Kameradatensätze. Während der Vorgang läuft, wird die Verarbeitungsanzeige angezeigt.

Schritt 5 — Import abgeschlossen. Das Bestätigungsbanner und der Fortschrittsbalken Overall onboarding progress zeigen die endgültigen Ergebnisse. Alle Zeilen, die die Validierung nicht bestanden haben, erscheinen auf der Registerkarte Failed. Unterhalb des Fortschrittsbalkens erscheint außerdem ein Link Bulk device configuration — klicken Sie darauf, um SMTP- und Bewegungs-E-Mail-Einstellungen für alle privaten Geräte im Importstapel zu übertragen, ohne jede Kamera einzeln einzugeben. Um eine einzelne fehlgeschlagene Kamera erneut zu versuchen, öffnen Sie die Registerkarte Failed, suchen Sie die Kamera und klicken Sie auf Retry — dadurch wird die Verbindung für diese Kamera erneut versucht, ohne dass ein vollständiger erneuter Upload erforderlich ist. Nachdem Sie die Kameraprobleme behoben haben, verwenden Sie Send Site Key Via WhatsApp/Email im rechten Bereich, um den Objektschlüssel an den Kontakt vor Ort zu übermitteln. Die animierte Schritt-für-Schritt-Anleitung unten spielt den gesamten Ablauf von Anfang bis Ende erneut ab.

Wann er einzusetzen ist

Der Massenimport ist der richtige Weg, wenn der Rollout objektlastig ist, wenn Geräte in Stapeln übergeben werden oder wenn Sie einen einzigen Validierungs-Arbeitsbereich für die gesamte Bereitstellung wünschen statt einer Abfolge von Einzelobjekt-Formularen.

Der Import-Arbeitsbereich

Nachdem Sie eine Datei hochgeladen haben, zeigt die Registerkarte Spreadsheet Import die Ergebnisse des Imports an. Wenn die Verarbeitung abgeschlossen ist, erscheint ein Bestätigungsbanner (“Import completed. Confirm your devices in the list below.”) und ein Fortschrittsbalken Overall onboarding progress zeigt den Prozentsatz der erfolgreich eingebundenen Kameras an (zum Beispiel 100 % — 1/1 Kameras).

Unterhalb des Fortschrittsbalkens gliedern vier Gruppen von Übersichtskarten den Import auf. Jede Karte kann zwischen einer Anzahl- und einer Prozentansicht umgeschaltet werden:

• TOTAL — Gesamtanzahl der übermittelten Zeilen nach Ergebnis: Valid, Invalid, Failed und Created.
• Deployment — wie die erstellten Objekte verbunden sind: Public, Private und Edge.
• Cameras — Kamerakonnektivität: Online, Offline und Alarm.
• Progress — Onboarding-Status: Done, Left, Online und Active.

Status-Tags

Sobald der Import abgeschlossen ist, zeigt jede Zeile in der Tabelle Imported Sites zwei Status-Tags an: den Erstellungsstatus und den Verbindungspfad.

• Created — der Objekt- und Kameradatensatz wurde erfolgreich erstellt und wartet auf die Aktivierung.
• Public IP — die Kamera verwendet den Verbindungspfad Public IP (Cloud-direkt).
• GDA — die Kamera verwendet den Pfad Private/VPN und erfordert das GDA vor Ort.
• GC Edge — die Kamera verwendet den Pfad Edge Deployment.
• Alarm Ready — die Kamera ist vollständig verbunden und sendet aktiv Alarme an die Plattform.

Falls Zeilen korrigiert werden müssen, verwenden Sie den Link Download spreadsheet to fix and re-upload unterhalb der Karten, um eine vorgefilterte Datei zu exportieren, die zur Korrektur und zum erneuten Hochladen bereit ist — Sie müssen die fehlgeschlagenen Zeilen nicht manuell aus der Originaldatei herauslösen.

Der untere Teil der Ansicht listet die importierten Sites auf (mit den Spalten Site, Site Contact, Type, Connected und Status), ergänzt um eine Suche nach Objektnamen und einen Typfilter. Durch Auswählen eines Objekts wird rechts dessen Kamerabereich geöffnet, der zwei Registerkarten enthält — All Cameras und Failed — sowie ein Kamerasuchfeld und eine Aktion Send Site Key. Öffnen Sie die Registerkarte Failed, um jede fehlgeschlagene Kamera und das jeweilige Validierungsproblem zu sehen, das vor dem erneuten Hochladen behoben werden muss.

Bekanntes Problem: Der Statusfilter auf der Registerkarte Failed zeigt möglicherweise eine falsche Anzahl an, bis die Seite aktualisiert wird. Wenn die Registerkarte Failed leer erscheint, die Zähler jedoch weiterhin eine Failed-Anzahl ungleich null anzeigen, aktualisieren Sie die Seite, bevor Sie den Import als fehlerfrei einstufen.

Massenkonfiguration von Geräten

Nach Abschluss des Imports erscheint der Bereich Bulk device configuration unterhalb des Fortschrittsbalkens. Er überträgt Port-, SMTP- und Bewegungs-E-Mail-Einstellungen an alle Kameras im privaten Netzwerk im Importstapel — sodass Sie nicht jede Kamera einzeln konfigurieren müssen.

Klicken Sie auf Configure Devices, um zu beginnen. Der Bereich prüft, ob das GDA läuft und im selben lokalen Netzwerk wie die importierten Kameras erreichbar ist.

Lokaler Agent nicht verbunden

Wenn das GDA nicht läuft oder nicht erreichbar ist, zeigt der Bereich eine Warnung Local Agent Not Connected an. So beheben Sie das Problem:

1. Laden Sie den Local Agent herunter — klicken Sie auf Windows Installer oder MacOS Installer, um den Agenten für den PC vor Ort herunterzuladen.
2. Installieren und starten Sie den Agenten auf einem Gerät, das mit demselben lokalen Netzwerk wie die Kameras verbunden ist.
3. Sobald der Agent läuft, klicken Sie auf Retry Connection. Die Massenkonfiguration startet automatisch, sobald der Agent erreichbar ist.

Die Massenkonfiguration von Geräten gilt nur für Kameras im privaten Netzwerk im aktuellen Import. Kameras mit Public IP und GC Edge erfordern diesen Schritt nicht.

Die Vorlage

Verwenden Sie stets die offizielle NXGEN-Tabellenvorlage. Laden Sie sie direkt von der Plattform über die Schaltfläche Download Current As Template im Bereich Add multiple new sites and cameras herunter — verwenden Sie kein benutzerdefiniertes Format und keine Datei aus einem früheren Import.

Jede Zeile steht für eine Kamera. Dies sind die Spalten der Vorlage in der richtigen Reihenfolge — richten Sie sich exakt nach der heruntergeladenen Vorlage und benennen oder ordnen Sie sie nicht um:

• siteName — der Objektname.
• cameraName — Kameraname oder -bezeichnung.
• ipAddress — IP-Adresse der Kamera.
• port — Kameraport.
• userName — Benutzername der Kamera.
• password — Passwort der Kamera.
• cameraBrand — Kameramarke (zum Beispiel Hikvision, Axis oder Dahua).
• siteOwnerEmail — die E-Mail-Adresse des Kontakts vor Ort, der den Objektschlüssel erhält und das GDA für die Feldaktivierung ausführt. Erforderlich für Private/VPN-Objekte; optional für Public IP.
• contactPhone — Telefonnummer des Kontakts vor Ort, einschließlich Ländervorwahl (zum Beispiel +15550101).
• contactName — Name des Kontakts vor Ort.
• protocol — Verbindungsprotokoll, http oder https.

Regeln für saubere Spalten:

• Eine Kamera pro Zeile.
• Nur Klartextwerte — keine Excel-Formeln oder Sonderformatierungen.
• Verschieben Sie die Spalten nicht aus der offiziellen Reihenfolge.
• Lassen Sie Pflichtfelder nicht leer.
• Speichern Sie die Datei als .xlsx oder .xls (nicht .csv).

Vor dem Hochladen

Die häufigste Ursache für fehlgeschlagene Massenimporte sind Datenqualitätsprobleme in der Quelldatei. Validieren Sie vor dem Hochladen:

• Alle erforderlichen Spalten sind vorhanden und in der richtigen Reihenfolge.
• Jede Zeile enthält Werte in den für ihren Verbindungstyp erforderlichen Feldern. Erforderlich für alle Objekte: Objektname, Kamera-IP, Port, Kameramarke, Protokoll, Benutzername und Passwort. Nur für Private/VPN- und Edge-Objekte erforderlich: Kontaktname, Kontakttelefon (siteOwnerEmail ist außerdem für die Zustellung des Objektschlüssels erforderlich). Für Public-IP-Objekte sind die Kontaktfelder optional.
• Die Objektnamen sind innerhalb der Datei eindeutig und stehen nicht in Konflikt mit bestehenden Objekten auf der Plattform.
• Die Kontakttelefonnummern enthalten Ländervorwahlen — zum Beispiel +962797XXXXXX, nicht 0797XXXXXX.
• Keine Zeile enthält Daten in der falschen Spalte.

Importvorgang

Phase 1 – Validierungsstapel

1. Wählen Sie 5 bis 10 repräsentative Zeilen aus Ihrem vollständigen Datensatz aus.
2. Laden Sie diesen Teststapel zuerst hoch.
3. Stellen Sie sicher, dass alle Zeilen ohne Fehler auf der Registerkarte All Cameras erscheinen.
4. Falls Fehler auftreten, ermitteln Sie das Muster, korrigieren Sie die Quelldaten und testen Sie erneut, bevor Sie mit der vollständigen Datei fortfahren.

Phase 2 – Vollständiger Import

1. Laden Sie die vollständige Datei hoch. Unter Send options steht ein Schalter Auto-send site key to owners after import zur Verfügung — aktivieren Sie ihn, damit die Plattform den Aktivierungsschlüssel jedes Objekts automatisch an den zugewiesenen Kontakt sendet. Wenn diese Option aktiviert ist, wählen Sie einen Zustellkanal — WhatsApp oder Email. Wenn Sie die Schlüssel lieber manuell verteilen möchten, lassen Sie dies deaktiviert und verwenden Sie nach dem Import den Objektschlüssel-Bereich in der Konfiguration. Aktivieren Sie den automatischen Versand nur dann, wenn jede Zeile bereits einen korrekten, verifizierten Kontakt enthält; lassen Sie ihn deaktiviert, wenn Sie Objekte im Voraus bereitstellen, wenn Kontakte nicht verifiziert sind oder wenn Sie den Import auf Fehler prüfen möchten, bevor Schlüssel versendet werden.
2. Notieren Sie nach Abschluss der Verarbeitung die Gesamtanzahl auf der Registerkarte All Cameras.
3. Vergleichen Sie sie mit Ihrer erwarteten Gesamtzahl — jede Abweichung erfordert eine Untersuchung, bevor Sie fortfahren.
4. Wechseln Sie zur Registerkarte Failed.

Phase 3 – Triage fehlgeschlagener Zeilen

1. Lesen Sie den Fehlergrund für jede fehlgeschlagene Zeile.
2. Suchen Sie die entsprechende Zeile in Ihrer Quelldatei und beheben Sie das konkrete Problem.
3. Fügen Sie die korrigierte Zeile einer separaten Wiederholungsdatei hinzu — laden Sie keine Zeilen erneut hoch, die bereits erfolgreich importiert wurden.

Phase 4 – Korrigierte Zeilen erneut importieren

1. Laden Sie die Wiederholungsdatei hoch, die nur die korrigierten Zeilen enthält.
2. Stellen Sie sicher, dass die korrigierten Zeilen ohne Fehler auf der Registerkarte All Cameras erscheinen.
3. Wiederholen Sie dies, bis die Registerkarte Failed leer ist.

Häufige Fehlergründe

• Doppelter Objektname — Der Objektname existiert bereits auf der Plattform oder in derselben Datei. Benennen Sie das Objekt in der Quelldatei um.
• Fehlendes Pflichtfeld — Eine erforderliche Spalte ist in dieser Zeile leer. Tragen Sie den fehlenden Wert ein.
• Ungültiges Telefonformat — Der Telefonnummer fehlt die Ländervorwahl oder sie enthält nicht-numerische Zeichen. Formatieren Sie sie neu als +[Ländervorwahl][Nummer].
• Objekt nicht gefunden — Die Kamerazeile verweist auf ein Objekt, das nicht existiert. Erstellen Sie zuerst das Objekt und importieren Sie dann die Kamera erneut.
• Falsche Spaltenreihenfolge — Die Daten befinden sich in den falschen Spalten. Richten Sie sich exakt nach der Spaltenreihenfolge der NXGEN-Vorlage.
• Nicht unterstützte Marke — Die Markenangabe wird für die automatische Konfiguration nicht erkannt. Verwenden Sie eine unterstützte Marke für die automatische Konfiguration, exakt wie in der Vorlage geschrieben (zum Beispiel Hikvision, Axis, Dahua).
• Fehlerhafte IP-Adresse — Der Wert ist keine gültige IPv4-, IPv6- oder DNS-Hostadresse (und darf keinen abschließenden Schrägstrich enthalten).
• Port außerhalb des Bereichs — Der Port muss zwischen 1 und 65535 liegen.

Nach dem Import: Abschließende Validierung

Nachdem Sie alle Importphasen ohne Fehler abgeschlossen haben:

1. Öffnen Sie Konfiguration und überprüfen Sie, ob die Gesamtanzahl der Objekte mit Ihrer erwarteten Liste übereinstimmt.
2. Navigieren Sie zum Home Dashboard und bestätigen Sie, dass die neu importierten Objekte im Bereich der Objektkarten erscheinen.
3. Überprüfen Sie in der Video Search den Ereignisfluss für jedes neu erstellte Objekt. Warten Sie nach der Aktivierung einige Minuten, bis die ersten Ereignisse eintreffen.
4. Prüfen Sie die Analysen für die neuen Objekte — sie sollten beginnen, Alarmvolumendaten zu sammeln, sobald die Kameras aktiviert sind.