# Importing

Using Bulk Import, you can import large quantities of assets, users, and other entities into BuildingPro Suites all at once.

## Procedure

<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. 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 **\[D5]**

   ▷ 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 **\[D7]**

    ▷ The import is started

## Import Options

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

## Notes on Functionality and Syntax

### Example Syntax

\[here goes the code]

### 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. The asset type and tags cannot be created via Bulk Import. If asset types and tags specified in the .json file do not exist, an error will occur during import. The import will be aborted.

## Find Project ID

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

1. [↗ Open a project](https://docs.buildings.ability.abb/collection/mandatory-base/platform-core/workspace-and-identity/users/assign-a-user-to-a-project)
2. In the URL bar, you will find a number at the end of the URL. This is the project ID

Example: The project URL is `https://yoursystem.eliona.io/engineering/projects/1337` The project ID is `1337`