🚢Bulk Import

Via Bulk Import, you can import large quantities of assets, users, and other entities into Eliona in one go.

Procedure

1. Click on Engineering [A]

2. Click on Importing [B]

3. Drag a .json file into [B1]

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

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

6. Click on [C2]

7. The window [D] opens

8. Select via [D1] and [D7] the entities you want to import. ✙ Details about these options can be found below.

9. Click on Test Import [D5] ▷ The window [E] opens. ✙ In the 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 [D7] ▷ The import starts

Import options

Element	Title	Details
[D1]	Entity type	Shows the entities recognized in the .json file filtered by type.
[D2]	Toggle "Overwrite"	If this toggle is enabled, duplicate entries are overwritten
[D3]	Toggle "Mark duplicate assets"	If this toggle is enabled, duplicate entries are marked
[D4]	Test import	Click to perform a test import. A test import must be performed before each test import.
[D5]	Guide	Open online help
[D6]	Recognized entities	Entities that were recognized in the .json file.
[D7]	Entity selection	Check to enable 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 how it works and syntax

Example syntax

{
  "roles": [],
  "types": [],
  // Adds a project. Several assets are added within this project
  "projects": [
    {  /*Start of the project details. 
      If there is NOT YET a project with this information, it will be created. 
      If a project with this data already exists, the import options can be used to determine whether the project should be overwritten. */
      
      "projectId": "1234567",
      "displayName": "An example project",
      "location": "Zurich,CH",
      "email": "[email protected]",
        /* End of the project details  */
      
      /* Several assets follow, which are added to the project specified above.  */
      "assets": [
        /* An asset.  */
        {  
          "resourceId": "123e4567-e89b-12d3-a456-42665544001a",
          "globalAssetIdentifier": "GAI 4719",
          "name": "Test Asset 1",
          "deviceIds": [
            "f6d488a8126a"
          ],
          /* The asset type must already exist in the project, otherwise the import will fail.  */
          "assetType": "VIRTUAL Light",
          /* All specified tags must already exist in the project, otherwise the import will fail.  */
          "tags": [
            "BLE",
            "LoRa"
          ]
        },
        
        { /* An asset.  */
          "resourceId": "03525950-38a5-4900-b4ef-cec2736cc831",
          "globalAssetIdentifier": "GAI 4725",
          "name": "Test Asset 2",
          "deviceIds": [
            "1a3231234e32"
          ],
          "assetType": "VIRTUAL Dali",
          "tags": [
            "BLE",
            "LoRa"
          ]
        },

        /* An 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 type and tags

In the .json file, you have the option to specify an asset type and tags for each asset to be added.

The asset type and tags must already be created in the project. Asset types and tags cannot be created via Bulk Import. If the asset types and tags specified in the .json file do not exist, an error will occur during import. The import will be aborted.

Find out project ID

You must specify the project ID in the .json file. Proceed as follows to find out the project ID.

1. ↗ Open a project

2. At the end of the URL, you will find a number in the URL bar. This is the project ID

Example: The URL of the project is https://ihrsystem.eliona.io/engineering/projects/1337 The project ID is 1337