Configuring OU Business Objects¶

Business Objects contain the site types, device types, custom types, component types, and manufacturer model numbers of such devices and components that are necessary for asset onboarding and display.

Prerequisites¶

Ensure that the desired business object has been associated to a public model at the global layer and assigned to the current onboarding template. Contact the system administrator if necessary.

Associating a Model for Business Objects¶

Based on the public model associated with the business object, you can associate the public son model or private model for the business object within the OU as needed. For model definition, see Model.

Note

The Modelling Rules of the current OU determines the scope of models that can be associated with the business object. Onboarding Tool will also automatically create private models based on the modelling rules, and associate them to the business object. For more information, see Onboarding Assets Using Private Models.

Select Business Object from the left navigation pane.
Select the desired tab in the business object list.
- Site/Device/Component/Custom Type: select an model name or - - from the associate model column.
- Manufacturer: select View Details corresponding to the manufacturer to open the model No. page.
  - Global: models created at the global layer. Selecting - - from the associate model column corresponding to the desired model will associate a model for the global model in the current OU. Associate models take effect only within the current OU.
  - OU Customize: models of the current OU customization. Selecting - - from the associate model column corresponding to the desired model will associate a model for the current OU model number.
Select a public son model or private model in the popup window.
- Site Type & Custom Type: the same associate model is used when onboarding sites and custom type assets in the Onboarding Tool.The associate model will affect the Display Fields of the business object.
- Device Type & Component Type: the associate model only affects the display field group, and does not affect the model used when onboarding assets in Onboarding Tool.
- Manufacturer: models associated with the model under manufacturer will be used when onboarding the device/component of the corresponding model in Onboarding Tool. If the public model of a model equals to or is inherited from the public model of a device or component type, you can select this model and onboard assets using its associated model when connecting this type of device or component in Onboarding Tool.

All business objects created and associated with the corresponding model can be used during asset onboarding, so that assets at different levels can be connected to the application quickly and efficiently.

Configuring Private Icons¶

Application creators can customize the icons of business objects displayed in the applications of the current OU by the following steps:

Select Business Object from the left navigation pane.
In the business object list, select the Icon button of a business object.
In the Icon pop-up window, select Upload in the Private column to upload custom icons.
Select OK.

Note

Applications in your OU display the private icons of business objects by default. For the objects without private icons, applications display the public icons instead.

Configuring Display Fields¶

Configure field groups and define the scope (including attributes, measurement points, properties, KPIs, calculation points, and virtual properties), sequence, and display name of the field to meet the needs of the business object in different business scenarios.

Select Business Object from the left navigation pane.
On the tab of the required business object type, select Configure Display Field where a display field needs to be created.
Select the New Field Group button. In the popup window that appears, enter the field group name and key value, and select Save.
Select Configure corresponding to the newly-created field group to open the field group content configuration page. Select Add Field Category on the left and enter the category name and key value. Category allows classified display of fields within the same display field group based on user-defined categories.
Select the newly created category and then select the plus button on the right to add a field. The optional range of the field is determined by the associated model.
In the popup window, check the attribute, measurement point, property, and asset element to be added, and then select Save to complete the adding.

Exporting Display Fields¶

Select Business Object from the left navigation pane.
Select Export Display Field in the upper left corner, and then check the site/device/custom/component type to be exported.
After that, select OK to download the exported file.

Importing Display Fields¶

Select Business Object from the left navigation pane.
Select Import Display Field in the upper left corner, and select Download Template in the popup window.
After entering the required information in the template file, select Upload to upload the file.
Select Import.