🚢Bulk Import

Über den Bulk Import können Sie grosse Mengen von Assets, Benutzern und anderen Entitäten auf einen Schlag in Eliona importieren.

Vorgehen

1. Klicken Sie auf Engineering [A]

2. Klicken Sie auf Importing [B]

3. Zeichen Sie eine .json-Datei in [B1]

4. Klicken Sie auf [B2] ▷ Das Fenster [C] öffnet sich

5. Überprüfen Sie in [C1] die eingegebene .json-Datei

6. Klicken Sie auf [C2]

7. Das Fenster [D] öffnet sich

8. Wählen Sie über [D1] und [D7] die Entitäten aus, die Sie importieren möchten. ✙ Details zu diesen Optionen finden Sie weiter unten.

9. Klicken Sie auf Test Import [D5] ▷ Das Fenster [E] öffnet sich. ✙ Im Fenster [E] sehen Sie eventuelle Fehlermeldungen.

10. Klicken Sie auf [E1] ▷ Das Fenster [E] schliesst sich.

11. Optional: Beheben Sie eventuelle Fehlermeldungen in der .json-Datei.

12. Klicken Sie auf [D7] ▷ Der Import wird gestartet

Import-Optionen

Element	Titel	Details
[D1]	Entitäten-Typ	Zeigt die in der .json-Datei erkannten Entitäten nach Typ gefiltert an.
[D2]	Schalter «Überschreiben»	Wenn dieser Schalter aktiviert ist, werden doppelt vorhandene Einträge überschrieben
[D3]	Schalter «Doppelte Assets markieren»	Wenn dieser Schalter aktiviert ist, werden doppelt vorhandene Einträge markiert
[D4]	Test-Import	Klicken, um einen Test-Import durchzuführen. Ein Test-Import muss vor jedem Test-Import durchgeführt werden.
[D5]	Guide	Online-Hilfe aufrufen
[D6]	Erkannte Entitäten	Entitäten, die in der .json-Datei erkannt wurden.
[D7]	Entitäten-Auswahl	Markieren, um ein Asset für den Import zu aktivieren. Nur markierte Entitäten werden importiert.
[D8]	Importieren	Klicken, um den Import zu starten. Diese Option ist erst verfügbar, nachdem ein Test-Import durchgeführt wurde.

Anmerkungen zu Funktionsweise und Syntax

Beispiel Syntax

{
  "roles": [],
  "types": [],
  // Fügt ein Projekt hinzu. Innerhalb dieses Projekts werden mehrere Assets hinzugefügt
  "projects": [
    {  /*Anfang der Angaben zum Projekt. 
      Wenn noch KEIN Projekt mit diesen Angaben vorhanden ist, wird dieses erstellt. 
      Wenn bereits ein Projekt mit diesen Daten vorhanden ist, kann in den Import-Optionen bestimmt werden, ob das Projekt überschrieben werden soll. */
      
      "projectId": "1234567",
      "displayName": "Ein Beispiel Projekt",
      "location": "Zürich,CH",
      "email": "[e-mail]",
        /* Ende der Angaben zum Projekt  */
      
      /* Es folgen mehrere Assets die dem oben angegebene Projekt hinzugefügt werden.  */
      "assets": [
        /* Ein Asset.  */
        {  
          "resourceId": "123e4567-e89b-12d3-a456-42665544001a",
          "globalAssetIdentifier": "GAI 4719",
          "name": "Test Asset 1",
          "deviceIds": [
            "f6d488a8126a"
          ],
          /* Der Asset-Typ muss im Projekt bereits existieren, ansonsten schlägt der Import fehl.  */
          "assetType": "VIRTUAL Light",
          /* Alle angegebenen Tags müssen im Projekt bereits existieren, ansonsten schlägt der Import fehl.  */
          "tags": [
            "BLE",
            "LoRa"
          ]
        },
        
        { /* Ein Asset.  */
          "resourceId": "03525950-38a5-4900-b4ef-cec2736cc831",
          "globalAssetIdentifier": "GAI 4725",
          "name": "Test Asset 2",
          "deviceIds": [
            "1a3231234e32"
          ],
          "assetType": "VIRTUAL Dali",
          "tags": [
            "BLE",
            "LoRa"
          ]
        },

        /* Ein Asset.  */
        {
          "resourceId": "c56c2402-c54d-44de-ae9b-e91be3b4bd31",
          "globalAssetIdentifier": "GAI 3510",
          "name": "Test Asset 3",
          "deviceIds": [
            "f6d488a81266"
          ],
          "assetType": "VIRTUAL SmartMeter",
          "tags": [
            "BLE"
          ]
        },
        {
          "resourceId": "03525950-38a5-4900-b4ef-cec2736cc831",
          "globalAssetIdentifier": "GAI 1234",
          "name": "Test Asset 2",
          "deviceIds": [
            "1a3231234e32"
          ],
          "assetType": "VIRTUAL Light",
          "tags": [
            "BLE",
            "LoRa"
          ]
        },
        {
          "resourceId": "03525950-38a5-4900-b4ef-cec2736cc831",
          "globalAssetIdentifier": "GAI 3458",
          "name": "Test Asset 2",
          "deviceIds": [
            "1a3231234e32"
          ],
          "assetType": "VIRTUAL Light",
          "tags": [
            "BLE",
            "LoRa"
          ]
        },
        {
          "resourceId": "03525950-38a5-4900-b4ef-cec2736cc831",
          "globalAssetIdentifier": "GAI 39847",
          "name": "Test Asset 2",
          "deviceIds": [
            "1a3231234e32"
          ],
          "assetType": "VIRTUAL Light",
          "tags": [
            "BLE",
            "LoRa"
          ]
        },
        {
          "resourceId": "03525950-38a5-4900-b4ef-cec2736cc831",
          "globalAssetIdentifier": "GAI 9871",
          "name": "Test Asset 2",
          "deviceIds": [
            "1a3231234e32"
          ],
          "assetType": "VIRTUAL Light",
          "tags": [
            "BLE",
            "LoRa"
          ]
        }
      ],
      "users": [],
      "alarms": []
    }
  ]
}

Asset-Typ und Tags

In der .json-Datei haben Sie die Möglichkeit, für jedes hinzuzufügende Asset einen Asset-Typ und Tags anzugeben.

Der Asset-Typ und die Tags müssen bereits im Projekt angelegt sein. Asset-Typ und Tags können nicht per Bulk-Import erstellt werden. Wenn in der .json-Datei spezifizierte Asset-Typen und Tags nicht vorhanden sind, kommt es beim Import zu einem Fehler. Der Import wird abgebrochen.

Projekt-ID herausfinden

Sie müssen in der .json-Datei die Projekt-ID spezifizieren. Gehen Sie folgendermassen vor, um die Projekt-ID herauszufinden.

1. ↗ Öffnen Sie ein Projekt

2. In der URL-Leiste finden Sie am Ende der URL eine Ziffer. Dies ist die Projekt-ID

Beispiel: Die Url des Projekts lautet https://ihrsystem.eliona.io/engineering/projects/1337 Die Projekt-ID ist 1337