🚢Importing

Using Bulk Import, you can import asset types, assets, and tags into BuildingPro Suites from a JSON file. Check the recognized entities and run a test import before starting the import.

Procedure

1. Click on Engineering [A]

2. Click on Importing [B]

3. Drag and drop a .json file into [B1]

4. Click on [B2] ▷ The window [C] opens

5. Check the entered .json file in [C1]

6. Click on [C2]

7. The window [D] opens

8. Via [D1] and [D7], select the entities you want to import. ✙ Details on these options can be found below.

9. Click on Test Import [D4] ▷ The window [E] opens. ✙ In window [E], you will see any error messages.

10. Click on [E1] ▷ The window [E] closes.

11. Optional: Fix any error messages in the .json file.

12. Click on [D8] ▷ The import is started

Import Options

Element	Title	Details
[D1]	Entity type	Shows the entities recognized in the .json file, filtered by type.
[D2]	"Overwrite" switch	When this switch is activated, duplicate entries are overwritten
[D3]	"Mark duplicates" switch	When this switch is activated, duplicate entries are marked
[D4]	Test Import	Click to perform a test import. A test import must be performed before every import.
[D5]	Guide	Open online help
[D6]	Recognized entities	Entities that were recognized in the .json file.
[D7]	Entity selection	Check to activate an asset for import. Only checked entities are imported.
[D8]	Import	Click to start the import. This option is only available after a test import has been performed.

Notes on Functionality and Syntax

Example Syntax

This example combines asset types, assets, and tags without a projects wrapper. Replace the example values with values for your tenant and run Test Import before importing.

{
    "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"]
        }
    ]
}

The asset's assetType and tags values refer to the type and tag defined in the same file. Test the import to catch missing references and other validation errors before you start it.