> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/weitere-funktionen/bulk-import.md). # 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 {% 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](/collection/german-14.2-freezed/dokumentation/systeme-und-projekte/benutzer-zu-einem-projekt-hinzufugen.md) 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` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/weitere-funktionen/bulk-import.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.