CSV-Import für virtuelle Geräte
Bis zu 500 Virtuelle Geräte lassen sich per CSV Datei importieren. Klicke hierfür auf den Massenimport-Button () und wähle das Konto aus, in den die Geräte importiert werden sollen, sowie der Konnektor, über den die anzulegenden Geräte Daten empfangen sollen. Der Import erfolgt nun in drei Schritten:
-
Definieren In diesem Schritt ist es möglich, ein Template für die Import-Datei zu erstellen. Wähle über das Dropdown die optionalen Spalten aus, die in der Datei vorhanden sein sollen. Die für den ausgewählten Konnektor definieren Pflichtfelder sind bereits vorausgewählt.
Trennzeichen: In der CSV-Datei ist es sowohl möglich Kommas als Trennzeichen zu verwenden, als auch Semikolons.
Variablen
| Anzeigename | Variable | Bezieht sich auf Variable | Konnektor | Beschreibung |
|---|---|---|---|---|
| Activation | activation |
Firefly | LoRaWAN Join-Verfahren (ABP/OTAA). Import von Geräten mit unterschiedlichen Join-Verfahren bitte in getrennten Imports durchführen. | |
| ADR Limit | adr_limit |
Firefly | LoRaWAN Adaptive Datenrate | |
| Application Key | application_key |
activation |
Firefly | LoRaWAN Application Key |
| Application Session Key | application_session_key |
activation |
Firefly | LoRaWAN Application Session Key |
| Class C | class_c |
Firefly | Handelt es sich um ein Class C Gerät? | |
| Coordinates | coordinates |
Alle Konnektoren | Dieses Feld benötigt die Standortkoordinaten im Format “latitude,longitude” | |
| Custom properties | custom_KEYNAME |
Alle Konnektoren | Benutzerdefinierte Eigenschaften. Im Titel wird der Key mit Präfix “custom_” benötigt. Als Zeilen-Wert dann der Value. | |
| Deduplicate packets | deduplicate |
Firefly | Wie sollen doppelte Nachrichten behandelt werden? | |
| Description | description |
Alle Konnektoren | niotix Beschreibungstext des Virtuellen Geräts | |
| Device Address | address |
activation |
Firefly | Relevant für Aktivierung von ABP Geräte. Nicht Relevant, wenn Aktivierung OTAA. Die LoRaWAN Geräteadresse (Hexadezimal-Kodiert) |
| Device EUI | device_id |
Firefly | ID des zu importierenden Geräts | |
| Device ID | device_id |
Alle Konnektoren außer Firefly | ID des zu importierenden Geräts | |
| Device Type | deviceType |
Alle Konnektoren | ID des niotix Gerätetyps um die Payload zu parsen | |
| Groups | groups |
Alle Konnektoren | niotix Gerätegruppen | |
| Icon | faIcon |
Alle Konnektoren | Das Icon für die Anzeige in der UI Font Awesome V5 Icon Übersicht | |
| Location | location |
Alle Konnektoren | Die Adresse (Postanschrift) an der sich das Gerät befindet | |
| Network Session Key | network_session_key |
activation |
Firefly | LoRaWAN Network Session Key |
| Operational Status | operationalStatus |
Alle Konnektoren | niotix Betriebsstatus | |
| Perform Address Lookup | performAddressLookup |
coordinates |
Alle Konnektoren | Soll beim Import von Koordinaten automatisch die Adresse nachgeschlagen werden? |
| Perform Coordinate Lookup | performCoordinateLookup |
location |
Alle Konnektoren | Sollen beim Import einer Postanschrift automatisch die Koordinaten nachgeschlagen werden? |
| Region | region |
Firefly | LoRaWAN Regionalparameter; Default: EU868 | |
| RX2 Data Rate | rx2_data_rate |
Firefly | Datenrate (Streufaktor und Bandbreite) | |
| Skip frame counter increment check | skip_fcnt_check |
Firefly | Soll der LoRaWAN Frame Counter ignoriert werden? | |
| Tags | tags |
Alle Konnektoren | niotix Tags | |
| Title | title |
Alle Konnektoren | niotix Anzeigename |
-
Upload Lade nun die fertig vorbereitete Datei hoch. Sollte die CSV Datei Fehlerhaft sein, werden hier die Fehlermeldungen inklusive der zugehörigen Zeile in der Datei angezeigt. Somit kann der Fehler schnell identifiziert werden.
-
Bestätigen Im dritten Schritt werden die Geräte noch einmal aufgelistet. Hier ist es möglich, die zu importierenden Geräte noch einmal anzusehen. Nachdem ein Titel eingegeben wurde, kann mit Klick auf den “Erstellen”-Button ein Hintergrundjob angelegt werden. Im Anschluss wird automatisch ein Gerät pro Sekunde angelegt. Dabei werden die einzelnen Jobs systemweit nacheinander ausgeführt. Der Job startet, sobald die vorherigen Jobs abgeschlossen sind. Der Status des Imports kann in den Hintergrundjobs eingesehen werden. Hier werden auch Fehler aufgelistet, sollten Geräten nicht importiert werden können.