• Documentation
• Registering a Business Object Type

Registering a Business Object Type

Business object types include multiple levels, for example, site types (such as wind farm and building), device types (such as meter and energy storage system), and component types (such as battery bank and battery rack). Only by registering object types in Common Data Service can these object types be referenced to define the asset types that metrics, attributes, and measurement points belong to.

Common Data Service provides the following methods to register object types:

• You can register public or private object types by importing template files.

• You can synchronize the OU business objects in EnOS Configuration Center as private object types.

Prerequisites

• You need to be assigned the required asset permission and operation permission, and a menu group containing the Business Object Types menu. If not assigned, contact the application administrator.

• If you need to specify the object type to come from Configuration Center in the template file, or synchronize private object types from Configuration Center, Configuration Center needs to be obtained, authorized, and enabled in the current OU and the business objects to be referenced or synchronized need to prepared. For more information about business objects in Configuration Center, see Configuring OU Business Objects.

Importing an Object Type Using Template File

Follow the steps below to register a public or private object type by importing the template file.

1. Select Business Object Types from the left navigation pane.

2. Select a tab according to the effective scope of the target object type. For more information about the difference between public and private object types, see Public/Private Object Types.

   • If you need to register public object types, select Public Object Types > Import.

   • If you need to register private object types, select Private Object Types > Import > From File.

3. Click Download in the pop-up window and choose to download an Excel and a JSON template file.

4. Enter the following information in the template file. After the file is filled, click Upload in the pop-up window, select the filled file, and click OK.

Field Name	Identifier	Required/Optional	Description
Object Type Identifier	mdmType	Required	The identifier of the object type, which needs to be unique within the same (public/private) effective scope.
Object Type Chinese/English/Japanese/Spanish Name	nameZh/En/Ja/Es	English and Chinese names are required	The object type name in different languages.
Related Domain Identifier	domain	Required	The identifier of the domain that the object type belongs to. You can go to Business Object Types > Public Object Types to view all supported domains in the filter list of the Related Domain Name column and locate the identifier of the target domain in the Related Domain Identifier column. If your target domain is not listed, contact the system administrator to add the target domain.
Domain Chinese/English/Japanese/Spanish Name	domainNameZh/En/Ja/Es	English and Chinese names are required	The domain name in different languages. You can go to Business Object Types > Public Object Types to view all supported domains in the filter list of the Related Domain Name column. If your target domain is not listed, contact the system administrator to add the target domain.
IoT Model Mapping	modelId	Required	The identifier of the EnOS model mapped with the object type. Each model can be mapped to at most one object type. After you map the business object type with an EnOS model, by default all assets that are onboarded under the model and its child models will be mapped with the business object type. If a child model is mapped to another business object type, the assets onboarded under the child model will be mapped with the business object type mapped with the child model. For example, “Asset A” is mapped with “Child Model B”, but no business object type is mapped with “Child Model B”. Then “Asset A” will be mapped with “Business Object Type A” that is mapped with “Parent Model A”, the parent model of “Child Model B”. If the “Child Model C” is mapped with “Business Object Type B”, the “Asset B” under “Child Model C” will be also mapped with “Business Object Type B”.
Is Site	isSite	Required	Fill in Y if the object type is a site type and fill in N if not. One domain corresponds to at most one site type.
Is Device Group	isDeviceGroup	Required	Fill in Y if the object type is a device group type and fill in N if not.
Is Business Module	isBusinessModule	Optional	Fill in Y if the object type is a business module and fill in N if not. Only the object types belonging to the specified business domains can be Y. Business modules can define common virtual attributes, virtual measurement points, business metrics, source metrics, and dimension types based on business scenarios. When querying data, all business types can link to the data of the business module.
Source	source	Required	Fill in CDS if the object type comes from Common Data Service and fill in AMC if the object type comes from Configuration Center.
Configuration Center Type Mapping	amcType	Optional	The associated object type defined in Configuration Center.
Icon	icons	Optional	Specify the icon of the object type to be displayed in UI with this format: {“IconType”:”FilePath”}, for example, {“2d”:”/temp/temp.png”}. Use these icon types: 2d, Quasi-physical, default. You can also customize your own icon types.
Dimension Combination Attribute	dimensionPermutation	Optional	Specify an attribute identifier whose attribute content is a multi-dimensional aggregation method for the object type. For example, when registering the Solar Site object type, you can specify its Dimension Combination Attribute as the s_dimension_permutation attribute provided by EnOS Solar Monitoring & Control API. The attribute content is inverterType, inverterMfr, inverterModel|CENTRAL, Huawei, Sun2000_500KTL|STRING, Sungrow, SG2000_500KTL, which means that the above inverter type + inverter manufacturer + inverter model is an effective multidimensional aggregation method for the Solar Site object type.

Note

• The “Org ID”, “Org Name”, “Updated On”, and “Updated By” fields in the template file can be left blank and will be filled by the system after upload.

• When you register a private object type, if the identifier in the file is the same as a registered public object type identifier, the system will return the private object type when the duplicate identifier is passed in to query the object type.

Synchronizing Object Types from Configuration Center

Note

You can only synchronize private object types from Configuration Center. For public object types, register them in Common Data Service by importing template files.

Follow the steps below to synchronize private object types from Configuration Center.

1. Select Business Object Types from the left navigation pane.

2. Select the Private Object Types tab and click Import > From Configuration Center.

3. The top of the page prompts “Synchronized successfully” and all the OU business objects in Configuration Center are added to the private object type list.

Results

Once registered, the object type appears in the object type list. You can view its details and perform the following actions on it.

• Edit the object type: Click Export, modify the template file as required, and import the modified file. The object types with the same identifiers will overwrite the existing object types, and the object types with different identifiers will be added.

• Delete the object type: Click Delete of the target object type. Deleted object types cannot be restored.