Standorte¶
Standorte sind die über das Standortschema erstellten eigentlichen Standorte, bei denen Aufträge ausgeführt werden sollen. Auch wenn das Standortschema einen Baum oder Pfad definiert, ist jeder Knoten ein Standort, der mit seinen Eltern und Kindern verbunden ist.
Bei dem Abbildungswunsch der Struktur
- /20097/Spaldingstraße/64
das über das Standortschema mit drei Elementen erstellt wurde
- /PLZ/Straße/Hausnummer
sind 20097, Spaldingstraße und 64 jeweils ein Standort bei dem Aufträge ausgeführt werden könnten. Mit Klick auf Standorte im Reiter, werden die Standorte der oberste Ebene angezeigt.
In dieser Ansicht können bestehende Standorte bearbeitet oder gelöscht werden. Zudem ist es möglich, eine Liste als CSV zu exportieren. Mit Klick auf einen Standort kann man die Hierarchie des Standortes durchgehen.
Um neue Standorte hinzuzufügen gibt es die Möglichkeit Standorte manuell zu erstellen oder sie zu importieren.
Standort manuell anlegen (Neuer Standort)¶
Nach Wahl des Standortschemas öffnet sich das Eingabefeld für den Standort.
Da das Standortschema maßgeblich ist, ist das wählbare Lokationselement zunächst nur die oberste Ebene des Standortschemas. Neben frei wählbarem Namen und wählbarer Beschreibung bietet das Formular Felder für Metadaten, sofern sie im Standortschema angelegt wurden. Falls LoRaWAN Konfigurationsdownlinks standortabhängig sind, können sie hier hinterlegt- und im Prozess später genutzt werden.
Nach Bestätigung kann ein neuer Unterort zu dem gerade erstellten Ort erstellt werden. Die Optionen dazu sind identisch.
Standorte automatisiert anlegen (Standorte importieren)¶
Für den Massenimport von Standorten eignen sich der Import über CSV, element-iot oder API. Nach Klick auf Standorte importieren öffnet sich das entsprechende Eingabefeld.
Standorte: CSV Import¶
Die Spaltennamen der CSV-Datei müssen sich nach dem Standortschema richten. Die Reihenfolge von links nach rechts muss dem Pfad des Standortschemas entsprechen.
Bei dem Abbildungswunsch der Struktur
- /20097/Spaldingstraße/64
über das Standortschema
- /PLZ/Straße/Hausnummer
muss die CSV-Datei der folgenden Tabelle entsprechen:
| PLZ | Straße | Hausnummer |
|---|---|---|
| 20097 | Spaldingstraße | 64 |
Weitere Standorte können über weitere Zeilen definiert werden. Vor dem eigentlichen Import wird die CSV-Datei vom System validiert und zeigt mögliche Fehler farblich an.
Standorte: element iot Import¶
Falls in element iot bereits eine Ordnerstruktur besteht, die als Standortstruktur verwendet werden kann, besteht die Möglichkeit die Namen in der Ordnerstruktur zu nutzen, um damit Standorte zu erstellen.
Zunächst muss das Standortschema ausgewählt werden, das als Schablone für den Import dienen soll. Im Anschluss besteht zu jedem Element die Möglichkeit Filter zu setzen, die die zu findenden Ordner einschränken. Zur Auswahl stehen Ordner mit bestimmten Wörtern ein- bzw. auszuschließen und ein regulärer Ausdruck.
Nun kann der element iot Ordner gewählt werden, der als Basis für den Import genutzt werden soll. Zusätzlich ist auswählbar, ob der Basis Ordner als erstes Element des Standortschemas genutzt werden soll oder die Überprüfung erst unterhalb des Basis Ordners begonnen werden soll.
Die Schaltfläche Vorschau erstellen ermöglicht vor dem eigentlichen Import eine Überprüfung und zeigt an, was element go beim Importieren ausführen würde.
Sobald die Vorschau wie gewünscht - und durchgehend grün erscheint, können die Standorte durch einen Klick auf Standorte importieren importiert werden.