> 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/plattform/platform-core/bulk-import.md).

# Importieren

Mit dem Massenimport können Sie Anlagentypen, Anlagen und Tags aus einer JSON-Datei in BuildingPro Suites importieren. Prüfen Sie die erkannten Entitäten und führen Sie einen Testimport durch, bevor Sie den Import starten.

## Vorgehensweise

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FMxEBfxNM7sfn9apSntnZ%2FDocs_Bulk_Import_1.png?alt=media&#x26;token=9ee10fd1-0b9d-4eba-8cea-d2f8492bc004" alt=""><figcaption></figcaption></figure>

1. Klicken Sie auf Engineering **\[A]**
2. Klicken Sie auf Importieren **\[B]**
3. Ziehen Sie eine .json-Datei per Drag-and-drop in **\[B1]**
4. Klicken Sie auf **\[B2]**\
   ▷ Das Fenster **\[C]** wird geöffnet
5. Prüfen Sie die eingegebene .json-Datei in **\[C1]**
6. Klicken Sie auf **\[C2]**
7. Das Fenster **\[D]** wird geöffnet
8. Wählen Sie über **\[D1]** und **\[D7]**, die zu importierenden Entitäten aus. ✙ Weitere Informationen zu diesen Optionen finden Sie unten.
9. Klicken Sie auf Testimport **\[D4]**\
   ▷ Das Fenster **\[E]** wird geöffnet. ✙ Im Fenster **\[E]**&#x77;erden alle Fehlermeldungen angezeigt.
10. Klicken Sie auf **\[E1]**\
    ▷ Das Fenster **\[E]** wird geschlossen.
11. Optional: Beheben Sie alle Fehlermeldungen in der .json-Datei.
12. Klicken Sie auf **\[D8]**\
    ▷ Der Import wird gestartet

## Importoptionen

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FqQ5afr1Jx8EGIJEjGamE%2FDocs_Bulk_Import_2.png?alt=media&#x26;token=2d1bb533-540d-4f2f-85df-b934f3216392" alt=""><figcaption></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="86.39996337890625">Element</th><th width="220">Titel</th><th>Details</th></tr></thead><tbody><tr><td><strong>[D1]</strong></td><td>Entitätstyp</td><td>Zeigt die in der .json-Datei erkannten Entitäten, nach Typ gefiltert.</td></tr><tr><td><strong>[D2]</strong></td><td>Schalter „Überschreiben“</td><td>Wenn dieser Schalter aktiviert ist, werden doppelte Einträge überschrieben.</td></tr><tr><td><strong>[D3]</strong></td><td>Schalter „Duplikate markieren“</td><td>Wenn dieser Schalter aktiviert ist, werden doppelte Einträge markiert.</td></tr><tr><td><strong>[D4]</strong></td><td>Testimport</td><td>Klicken Sie, um einen Testimport durchzuführen. Vor jedem Import muss ein Testimport durchgeführt werden.</td></tr><tr><td><strong>[D5]</strong></td><td>Anleitung</td><td>Onlinehilfe öffnen</td></tr><tr><td><strong>[D6]</strong></td><td>Erkannte Entitäten</td><td>Entitäten, die in der .json-Datei erkannt wurden.</td></tr><tr><td><strong>[D7]</strong></td><td>Entitätsauswahl</td><td>Aktivieren Sie das Kontrollkästchen, um ein Asset für den Import auszuwählen. Es werden nur ausgewählte Entitäten importiert.</td></tr><tr><td><strong>[D8]</strong></td><td>Import</td><td>Klicken Sie hier, um den Import zu starten. Diese Option ist erst verfügbar, nachdem ein Testimport durchgeführt wurde.</td></tr></tbody></table>

## Hinweise zu Funktionalität und Syntax

### Beispielsyntax

Dieses Beispiel kombiniert Asset-Typen, Assets und Tags ohne einen `projects` Wrapper. Ersetzen Sie die Beispielwerte durch Werte für Ihren Mandanten und führen Sie **Testimport** aus, bevor Sie den Import durchführen.

```json
{
    "tags": [
        {
            "resourceId": "d1f0e4b3-2a6c-4f8b-b9c3-7a2f5e8c3344",
            "tagName": "BLE",
            "colorId": 5
        }
    ],
    "types": [
        {
            "Field Test Device": {
                "custom": false,
                "payloadFunction": "Adeunis",
                "vendor": "Adeunis",
                "model": "Adeunis FTD Network Tester",
                "translation": { "en": "Adeunis FTD Network Tester" },
                "urldoc": "https://www.adeunis.com/en/produit/ftd-network-tester/",
                "allowedInactivity": "01:00:00",
                "icon": null,
                "attributes": [
                    {
                        "battery_level": {
                            "attributeType": "battery-voltage",
                            "subtype": "status",
                            "translation": { "en": "Battery Level" },
                            "isDigital": false,
                            "unit": "%",
                            "scale": null,
                            "zero": null,
                            "precision": null,
                            "map": null,
                            "pipelineMode": "avg",
                            "pipelineRaster": ["M15", "H1", "DAY"],
                            "viewer": false,
                            "ar": false,
                            "sourcePath": ["payload", "voltage"]
                        }
                    }
                ]
            }
        }
    ],
    "assets": [
        {
            "resourceId": "123e4567-e89b-12d3-a456-42665544001a",
            "globalAssetIdentifier": "GAI 4719",
            "name": "Example asset",
            "deviceIds": ["f6d488a8126a"],
            "assetType": "Field Test Device",
            "tags": ["BLE"]
        }
    ]
}
```

Die Werte des Assets `assetType` und `tags` verweisen auf den Typ und das Tag, die in derselben Datei definiert sind. Testen Sie den Import, um fehlende Verweise und andere Validierungsfehler zu erkennen, bevor Sie ihn starten.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.buildings.ability.abb/collection/german/plattform/platform-core/bulk-import.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
