CSV-Import

Inhalt

CSV-Import für virtuelle Geräte

Bis zu 500 Virtuelle Geräte lassen sich per CSV Datei importieren. Klicke dafür auf den Massenimport-Button (). Wähle dann das Ziel-Konto sowie einen Konnektor aus. Du kannst zusätzlich festlegen, ob die importierten Geräte einem Geräte-Template zugeordnet oder als einzelne Geräte angelegt werden sollen (mit Auswahl des Konnektor-Typs).

Hier zu sind folgende Schritte durchzuführen:

  • Import Variablen definieren: Eine Übersicht der verfügbaren Variablen und deren Bedeutung findest du in der folgenden Tabelle Import Variablen. Außerdem ist es möglich, ein Template für die Import-Datei zu erstellen und herunterzuladen. 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.

  • Upload der CSV-Datei: 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.

  • Überprüfen und Bestätigen: 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. Nachdem der Import abgeschlossen ist, kann die Seite verlassen werden.

CSV-Format Hinweise:

  • Trennzeichen: In der CSV-Datei ist es sowohl möglich Kommas als Trennzeichen zu verwenden, als auch Semikolons.
  • UTF-8 Encoding: Die CSV-Datei sollte im UTF-8 Encoding gespeichert werden.

Import Variablen

Die verfügbaren Variablen hängen vom ausgewählten Konnektor-Typ/Gerätetemplate ab. Eine vollständige Übersicht der verfügbaren Variablen wird dir direkt in der Import-Maske angezeigt (Reiter “Anleitung zum Import” ausklappen).

Allgemeine Variablen

Variable Beschreibung
coordinates Standortkoordinaten im Format latitude,longitude.
custom_KEYNAME Benutzerdefinierte Eigenschaften. Im Titel wird der Key mit Präfix custom_ benötigt; als Zeilenwert wird der zugehörige Value eingetragen.
description Beschreibungstext des virtuellen Geräts in niotix.
device_id ID des zu importierenden Geräts. Bei Firefly-Geräten entspricht dies der Device EUI.
deviceType ID des niotix Gerätetyps, um die Payload zu parsen.
deviceDriver ID des Gerätetreibers. Dieses Feld kann nur verwendet werden, wenn kein Geräte-Template genutzt wird.
groups Gerätegruppen in niotix.
faIcon Icon für die Anzeige in der UI. Siehe Font Awesome V5 Icon Übersicht.
isDeviceImport Ist dieser Parameter nicht gesetzt, versucht niotix das Gerät im externen System, z. B. Firefly, anzulegen. Sind die Geräte im externen System bereits vorhanden, müssen sie nur importiert werden. Setze den Parameter dafür auf true.
location Postanschrift, an der sich das Gerät befindet. Bitte verwende das Format Adresse, Ort, Land oder mindestens Ort, Land, damit der Coordinate Lookup funktioniert. Beispiel: Bei den Mühren 70, 20457 Hamburg, Deutschland.
operationalStatus Betriebsstatus des virtuellen Geräts in niotix.
performAddressLookup Schlägt beim Import von Koordinaten automatisch die Adresse nach. Nutze dies zusammen mit coordinates.
performCoordinateLookup Schlägt beim Import einer Postanschrift automatisch die Koordinaten nach. Nutze dies zusammen mit location.
tags Tags des virtuellen Geräts in niotix.
targetReferenceId_KEYNAME Referenz-ID für das Dynamische Datenrouting. Ersetze KEYNAME durch den Referenzschlüssel des Ziel-Digitalen-Zwillings, z. B. targetReferenceId_Melo. In der CSV-Zeile steht dann der zugehörige Referenzwert, z. B. MesslokationsnummerWert.
title Anzeigename des virtuellen Geräts in niotix.

Firefly-spezifische Variablen

Variable Beschreibung
activation LoRaWAN Join-Verfahren des Geräts. Wähle OTAA für Join per Application Key oder ABP für manuell gesetzte Session Keys und Device Address. Importiere Geräte mit unterschiedlichen Join-Verfahren in getrennten Imports.
adr_limit LoRaWAN Adaptive Datenrate.
application_key LoRaWAN Application Key. Nur für OTAA relevant.
application_session_key LoRaWAN Application Session Key. Nur für ABP relevant.
class_c Legt fest, ob es sich um ein Class-C-Gerät handelt.
deduplicate Legt fest, wie doppelte Nachrichten behandelt werden.
address LoRaWAN Device Address. Nur für ABP relevant.
network_session_key LoRaWAN Network Session Key. Nur für ABP relevant.
region LoRaWAN-Regionalparameter. Standardwert: EU868.
rx2_data_rate Datenrate mit Spreizfaktor und Bandbreite.
skip_fcnt_check Legt fest, ob der LoRaWAN-Frame-Counter ignoriert werden soll.