Configure OpenBOS

Use this procedure to configure the connection between a Building Edge site and BuildingPro Suites. First retrieve the Edge Identification Number from ABB Ability BuildingPro, then configure the Edge connection and the tree structure in the openBOS app.

Get the Edge Identification Number

Retrieve the Edge Identification Number from the BuildingPro site before configuring the site in the openBOS app.

1. Select the portfolio that contains the required Building Edge under [A].

2. Open Building Pro Vision [B].

3. Click on the required Building Edge or site under [C].

4. Copy the Edge Identification Number [D]. ◈ You need this number in the Edge Configuration section of the openBOS site configuration.

Configure the Edge connection

Open the site configuration as described in Open openBOS config. Then configure the Edge connection and select the data that should be synchronized.

[1]	Edit Edge Configuration	Enables editing of the Edge Configuration section.
[2]	Edge Identification Number	Enter the Edge Identification Number copied from BuildingPro.
[3]	Save	Saves the Edge Identification Number.
[4]	BuildingPro Edge trees	Shows the trees and data available from the Building Edge.
[5]	Refresh	Refreshes the tree from the Building Edge.
[6]	Search	Searches the Building Edge tree. Only the part of the tree that matches the search is displayed.
[7]	Replicate filtered tree	Copies the filtered tree from the Building Edge to the BuildingPro Suites tree.
[8]	Use all data points	Mirrors the complete Building Edge tree in the BuildingPro Suites tree.
[9]	Drag and drop	Moves individual assets from the Building Edge tree to the BuildingPro Suites tree. Drag and drop can also be used in the BuildingPro Suites tree to change its structure.
[10]	BuildingPro Suites trees	Shows the trees configured for BuildingPro Suites.
[11]	Expand and collapse	Expands or collapses the tree on either side.
[12]	Delete	Removes an individual asset from the BuildingPro Suites tree.
[13]	Discard	Discards the current tree configuration and removes unsaved changes.
[14]	Save	Saves the tree configuration.

1. Click [1] to edit the Edge Configuration. ▷ The Edge Identification Number field becomes editable.

2. Enter the copied Edge Identification Number under [2].

3. Click [3] to save the Edge Identification Number.

4. Review the tree available from the Edge under [4].

5. Click [5] to refresh the tree from the Building Edge. ▷ The current tree structure from the Building Edge is loaded.

6. Enter a search term under [6] to search the Edge tree. ▷ Only the part of the tree that matches the search is displayed.

7. Click [7] to replicate the filtered tree. ▷ The filtered tree is copied to the BuildingPro Suites tree.

8. Activate [8] to use all data points. ▷ The complete Edge tree is mirrored in the BuildingPro Suites tree.

9. Drag individual assets from the Edge tree to the BuildingPro Suites tree under [9]. ◈ You can also use drag and drop in the BuildingPro Suites tree to change the structure of the tree.

10. Review the configured BuildingPro Suites trees under [10].

11. Use [11] to expand or collapse the tree on either side.

12. Click the delete control at [12] to remove an individual asset from the BuildingPro Suites tree.

13. Click [13] to discard the current tree configuration. ▷ Unsaved changes to the tree configuration are removed.

14. Click [14] to save the tree configuration. ▷ The configured tree is saved.

After the tree configuration is saved, the openBOS app creates the required asset types and assets in BuildingPro Suites according to the mirrored tree. The assets receive the data sent by the Building Edge.

Reload the page to display the newly created asset types and assets in BuildingPro Suites.

For the complete OpenBOS reference, including Edge preparation, API Subscriptions, gateway configuration, and Continuous Asset Creation, see OpenBOS.