# 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

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/xQTHlm9SzcYqLR0ZQQpB/Docs_Bulk_Import_1.png" alt=""><figcaption></figcaption></figure>

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

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/mYxoRt40h2G3Jn0tZYXT/Docs_Bulk_Import_2.png" alt=""><figcaption></figcaption></figure></div>

| 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

{% code overflow="wrap" fullWidth="true" %}

```json
{
  "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": "admin@eliona.io",
        /* 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": []
    }
  ]
}

```

{% endcode %}

### 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](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/systeme-und-projekte/benutzer-zu-einem-projekt-hinzufugen)
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`