注册业务对象类型¶
业务对象类型包含场站类型（如风场、楼宇等）、设备类型（如电量表、储能系统等）、部件类型（如电池组、电池簇等）等多种层级。只有在通用数据服务上注册过的对象类型，才能在注册指标、属性、测点时被使用，定义数据所属的资产类型。
通用数据服务为应用构建者提供以下方式注册业务对象类型：
前提条件¶
开始之前，确保以下事项：
当前帐号已被分配所需的资产权限、操作权限点和包含 业务对象类型 在内的菜单组。如未分配，联系应用管理员。
若需在模板文件中指定对象类型来源是配置中心，或从配置中心同步私有对象类型，当前 OU 需已获取、授权和启用配置中心，且已在配置中心内准备好业务对象数据。有关配置中心业务对象的更多信息，参见 配置 OU 业务对象。
通过模板导入对象类型
按照以下步骤通过导入模板文件，注册公有或私有对象类型。
在左侧导航栏中选择 业务对象类型。
根据目标对象类型的生效范围选择对应标签页。有关公有/私有对象类型的区别，参见 公有/私有对象类型。
如需通过模板导入公有对象类型，选择 公有对象类型 > 导入。
如需通过模板导入私有对象类型，选择 私有对象类型 > 导入 > 文件导入。
在弹窗中点击 下载模板，选择下载 Excel 或 JSON 模板文件。
参考以下信息填写模板文件。填写完成后，在弹窗中点击 上传，选择填写后的模板文件并点击 确定。
字段名称 |
标识符 |
必填/选填 |
描述 |
|---|---|---|---|
对象类型标识符 |
mdmType |
必填 |
对象类型的标识符，需保证在同一作用域（公有/私有）内的唯一性。 |
对象类型中文/英文/日语/西班牙语名称 |
nameZh/En/Ja/Es |
中文和英文为必填 |
不同语言的对象类型名称。 |
所属领域标识符 |
domain |
必填 |
资产所属领域的标识符。前往 业务对象类型 > 公有对象类型，可在表头 所属领域名称 列中筛选出目前支持的领域名称并查看其对应标识符。若无任何筛选项，联系系统管理员添加。 |
所属领域中文/英文/日语/西班牙语名称 |
domainNameZh/En/Ja/Es |
中文和英文为必填 |
不同语言的资产所属领域的名称。前往 业务对象类型 > 公有对象类型，可在表头 所属领域名称 列的筛选项中查看目前支持的领域名称。若无任何筛选项，联系系统管理员添加。 |
IoT 模型映射 |
modelId |
必填 |
|
是否场站类型 |
isSite |
必填 |
若为场站类型，填写 Y，否则填 N。 |
是否设备组类型 |
isDeviceGroup |
必填 |
若为设备组类型，填写 Y，否则填 N。 |
来源 |
source |
必填 |
若对象类型来源于通用数据服务，填写 CDS；若对象类型来源于配置中心，填写 AMC。 |
配置中心资产类型映射 |
amcType |
选填 |
配置中心里定义的关联资产类型。 |
图标 |
icons |
选填 |
指定对象类型展示在界面上的图标，格式为：{“图标类型”:”路径”}，例如：{“2d”:”/temp/temp.png”}。目前支持的图标类型：2d、Quasi-physical（仿真）、default（默认）。支持自定义图标类型。 |
有效维度组合属性 |
dimensionPermutation |
选填 |
指定一个属性标识符，其属性内容为对当前对象类型来说有效可查的多维度聚合方式。例如：在注册 光伏场站 对象类型时，可指定其有效维度组合属性为 EnOS 光伏集控 API 提供的 s_dimension_permutation 属性。该属性内容为 inverterType,inverterMfr,inverterModel|CENTRAL,Huawei,Sun2000_500KTL|STRING,Sungrow,SG2000_500KTL，表示以上逆变器类型+逆变器厂家+逆变器型号对光伏场站来说是一种有效的多维聚合方式。 |
备注
导入模板中的“所属组织标识符”、“所属组织名称”、“更新时间”、“操作人”和“是否与公有标识符重复”字段无需填写，将在上传后由系统自动填充。
注册私有对象类型时，若文件中的对象类型标识符与已注册的公有对象类型标识符重复，传入重复的标识符查询对象类型数据时，系统将返回私有对象类型的数据。
从配置中心同步对象类型
备注
通用数据服务支持从配置中心同步私有对象类型。如需注册公有对象类型，通过 导入模板文件 完成注册。
按照以下步骤从 配置中心 同步私有对象类型。
在左侧导航栏中选择 业务对象类型。
选择 私有对象类型 标签页，点击 导入 > 配置中心同步。
页面顶部提示“同步成功”，配置中心内所有 OU 业务对象自动添加到私有对象类型列表中。
结果¶
注册成功后，对象类型出现在对象类型列表中。应用构建者可以查看对象类型详情，并进行以下操作：
修改对象类型：点击 导出，按需修改下载的文件后再导入新文件。标识符相同的对象类型会覆盖原有对象类型，不同则新增对象类型。
删除对象类型：点击对应对象类型行的 删除
。对象类型删除后不可恢复。