Geräte in großen Mengen importieren

Wenn Sie zehn oder Hunderte Geräte haben, fügen Sie sie per CSV-Datei hinzu, statt sie einzeln anzulegen. Jeder Import wird zuerst geprüft („Jeder Import wird zuerst als Testlauf ausgeführt: Es wird nichts geschrieben, bis jemand prüft, was passieren würde.“), dann angewendet, und er kann rückgängig gemacht werden. Neue Geräte erhalten sofort ihre Zugangsdaten, die in einer Datei bereitgestellt werden, die Sie nur einmal herunterladen können.

Importe werden auf der Seite Importe vorgenommen (Adresse /admin/settings/imports, im Bereich Organisation des Menüs). Die Seite ist vorhanden, wenn das Importmodul in Ihrer Organisation aktiviert ist. Sie benötigen die Berechtigung, Geräte anzulegen.

Datei vorbereiten

Die Datei ist eine CSV-Datei, als UTF-8 gespeichert, durch Kommas, Semikola oder Tabulatoren getrennt, mit den Spaltennamen in der ersten Zeile. Bis zu 1.000 Zeilen pro Datei. Wählen Sie im Import-Assistenten Vorlage herunterladen, um eine Datei mit allen Spalten und einer Beispielzeile zu erhalten.

Spalte	Bedeutung	Regeln
name	Gerätename (eindeutig in diesem Konto)	Pflichtfeld.
label	Bezeichnung	Optionaler Freitext.
type	Gerätetyp	Optional, zum Beispiel pump-controller.
profile	Name des Geräteprofils (leer = Standardprofil)	Das Profil muss vorhanden sein.
serial	Seriennummer	Optional, bis zu 32 Zeichen aus A–Z a–z 0–9 . _ : -. Auf der Plattform eindeutig.
mac	MAC-Adresse	Optional. Wird in den Zusatzinformationen des Geräts gespeichert.
credentialType	Zugangstyp (leer = ACCESS_TOKEN)	ACCESS_TOKEN oder MQTT_BASIC. X.509 wird nie importiert.
mqttUsername	MQTT-Benutzername (MQTT_BASIC; leer = wird erzeugt)	Auf der Plattform eindeutig.
mqttClientId	MQTT-Client-ID (MQTT_BASIC, optional)	1 bis 64 Zeichen aus A–Z a–z 0–9 . _ : -.
attr:<key>	Ein Server-Attribut	Bis zu 50 Attributspalten, Werte bis zu 4.096 Zeichen.
shared:<key>	Ein gemeinsames Attribut	Wie oben.

Beispiel:

name,label,profile,serial,credentialType,attr:maxTemp,shared:cfg.report_interval_s
pump-house-01,Pump house north,Water pumps,SN-000123,ACCESS_TOKEN,80,300
pump-house-02,Pump house south,Water pumps,SN-000124,MQTT_BASIC,75,300

Import

1. Öffnen Sie Importe und wählen Sie Neuer Import.
2. Datei: Wählen Sie unter Was importiert werden soll die Option IoT-Geräte, wählen Sie die CSV-Datei und lassen Sie Die erste Zeile enthält die Spaltennamen aktiviert. Der Assistent zeigt an, wie viele Zeilen er gefunden hat.
3. Spalten: Prüfen Sie, dass jedes Feld die richtige Spalte Ihrer Datei hat („Spalten mit passenden Namen sind bereits ausgefüllt.“). Spalten, die mit attr: oder shared: beginnen, werden unverändert übernommen. Wählen Sie Wenn ein Datensatz bereits existiert:

Strategie	Wirkung
Nur neue Datensätze hinzufügen; vorhandene melden	Ein bereits vorhandener Name ist ein Fehler.
Nur vorhandene Datensätze aktualisieren	Nur vorhandene Namen werden geändert; die übrigen werden übersprungen.
Neue Datensätze hinzufügen und vorhandene aktualisieren	Beides.
Neue Datensätze hinzufügen und vorhandene überspringen	Vorhandene Namen werden übersprungen.

1. Wählen Sie Datei prüfen. Jede Zeile wird geprüft; noch wird nichts geschrieben. Der Schritt Prüfung zeigt Zeilen in der Datei, Bereit zum Import, Wird übersprungen und Hat ein Problem, mit Zeilen mit Problem (Zeile, Feld, Problem).
2. Korrigieren Sie die Datei und wählen Sie Andere Datei auswählen, oder wählen Sie Import n Zeilen und bestätigen Sie. Zeilen mit Problem werden ausgelassen.

Was die Prüfung ablehnt

Problem	Bedeutung
Der Name kommt in dieser Datei mehr als einmal vor.	Jeder Name nur einmal pro Datei. Seriennummern und MQTT-Benutzernamen ebenso.
Kein Geräteprofil heißt „…“.	Legen Sie zuerst das Profil an oder lassen Sie die Spalte leer für das Standardprofil.
Ein Gerät namens „…“ existiert bereits.	Wählen Sie „Duplikate überspringen“, um nur neue Zeilen zu importieren, oder „aktualisieren“, um vorhandene Geräte zu ändern.
Ein Import ändert nicht die Seriennummer eines vorhandenen Geräts.	Seriennummern sind fest.
Das Profil „…“ erlaubt nicht …	Das Profil erlaubt den Zugangstyp nicht. Wählen Sie ein anderes Profil oder einen anderen Zugangstyp.
Ein Gerät mit dieser Seriennummer ist bereits registriert.	Ein lizenziertes Gerät wird durch Beanspruchen hinzugefügt, nicht durch Import.
Dieser MQTT-Benutzername ist bereits in Verwendung.	Benutzernamen sind auf der Plattform eindeutig.

Das Gerätelimit Ihres Tarifs wird für die gesamte Datei geprüft, bevor etwas geschrieben wird: Eine Datei, die nicht passt, wird insgesamt abgelehnt, mit den Zahlen.

Was eine Aktualisierung ändert

Eine Aktualisierung ändert Bezeichnung, Typ, Profil, MAC-Adresse und die Attribute und merkt sich die alten Werte für das Rückgängigmachen. Sie ändert nie eine Seriennummer oder einen Zugang („Die Zugangsdaten eines vorhandenen Geräts werden durch einen Import nicht geändert; erneuern Sie sie über die Geräteseite.“). Dieselbe Datei erneut hochzuladen ist unbedenklich: Nichts wird doppelt angelegt und keine Zugangsdaten werden erneut erzeugt; der Assistent warnt, dass genau diese Datei bereits importiert wurde.

Zugangsdaten herunterladen

Nach einem Import, der Geräte hinzugefügt hat, bietet der Schritt Ergebnis Ein weiterer Schritt: Zugangsdaten der neuen Geräte herunterladen. „Die Zugriffstoken und MQTT-Passwörter der Geräte, die dieser Import hinzugefügt hat, in einer Datei, die Sie nur einmal innerhalb von 15 Minuten nach dem Import herunterladen können. Bewahren Sie sie sicher auf: Sie wird nicht erneut angezeigt.“

• Nur die Person, die den Import ausgeführt hat, kann die Datei herunterladen.
• Nach dem Download oder nach 15 Minuten ist sie weg („Fertig. Dies kann nicht wiederholt werden.“).
• Ein Gerät, dessen Datei verloren ging, erhält neue Zugangsdaten auf seiner eigenen Seite über Geheimnis rotieren.

Rückgängig

Der Schritt Ergebnis und die Importliste bieten Diesen Import rückgängig machen: „Hinzugefügte Datensätze werden entfernt und geänderte Datensätze wieder in ihren früheren Zustand versetzt.“ Für Geräte gilt:

• ein angelegtes Gerät wird nur entfernt, solange es sich nie verbunden hat,
• ein aktualisiertes Gerät wird auf die Werte zurückgesetzt, die es vor dem Import hatte.

Zeilen, die nicht zurückgesetzt werden können, werden gezählt („n Zeilen konnten nicht zurückgesetzt werden.“).

Siehe auch

• Hinzufügen und Beanspruchen von Geräten
• Gerätezugangsdaten