注意事项 集成xDM-F模型生成的LinkX-F关系实体，仅支持上移、下移、置顶对应的自定义属性，其他操作均不支持（如新增、修改、删除、生效、失效等）。集成方xDM-F模型的属性与LinkX-F属性自动匹配规则如下： 如果xDM-F模型属性的英文名称与LinkX-F“系统基本属性”相同（不区分大小写），则与系统基本属性匹配。其中实体属性“类型”保持LinkX-F系统固有不变，“系统基本属性”的“是否入图”值显示规则与LinkX-F自创建实体相同，实体发布后均更新为是。 如果其他属性（如扩展属性）同步过来后会自动匹配为自定义属性。如果属性是唯一键或关联属性，不论xDM-F实体属性是否“入图”，LinkX-F实体发布后都会自动为对应属性配置图数据库映射字段，后续自动入图。

相关操作 实体未发布前，您可进入实体编辑状态，在实体属性页签对实体的属性进行一些相关操作，具体如下。 表2 实体属性相关操作 操作 说明 修改实体属性 单击属性的“英文名称”链接，在弹窗中修改属性后保存。 说明： 并非所有字段都支持修改，请以实际情况为准。 删除实体属性 勾选一条或多条自定义属性，单击列表上方的“删除”。可能出现以下情况： 勾选本次新添加的属性，成功删除。 勾选本次修订前已发布的属性，按钮置灰，不可操作。 失效实体属性 勾选一条或多条自定义属性，单击“失效”。 说明： 仅历史版本生效的属性支持失效。失效成功后，属性英文名称旁回显失效标识，并显示EOS日期，系统当前缺省将EOS时间定为60个自然日。已失效的属性字段在 数据实例 列表中不再展示。 实体最新版本新增的属性不支持失效，“失效”按钮置灰且不可操作。 生效实体属性 勾选处于“失效”状态的自定义属性，单击“生效”。 上移/下移实体属性 勾选实体的自定义属性，单击“上移”或“下移”，或直接单击实体属性“操作”列处的置顶。

注意事项 导入文件只支持Excel类型文件，结尾处需标注#EOF。 单次批量导入的关系实体数量不能超过500个。 导入的关系实体或属性若已存在则进行更新或修订，若不存在则进行创建。 导入的关系实体如存在参考对象，导入时支持自动解耦。 导入关系实体时，系统会对如下相关数据进行修正。 如果导入的关系实体属性类型为“文件”类型，会将“值可变”修正为“是”。 如果导入的关系实体属性类型不是“文本”类型，会将“值存储方式”置空。 如果导入的关系实体属性已被发布，则该属性的“入库”参数不会进行更新。此外， 如果该属性类型为“参考对象”类型，则该属性的参考对象信息（参考对象的英文名称、ID和类型）和“组合关系”参数也不会进行更新。 如果该属性类型为“浮点型（自定义精度）”类型，则该属性的“单位类型”参数的英文名称也不会进行更新。 如果该属性类型为“文件”类型，则该属性的“存储方式”和“必填”参数也不会进行更新。 如果该属性类型为“枚举”类型，则该属性的“枚举类型ID”参数也不会进行更新。

步骤3：功能配置（可选） 完成基本信息的填写后，您可根据实际业务场景，在“功能配置”中设置基础功能或可选功能相对应的功能规则。如果系统提供的默认功能配置已满足您实际的业务需求，可跳过此步骤。 选择“功能配置”页签，进入功能配置页面。 图4 功能配置 根据实际需求，设置如下信息。 表3 功能配置-参数说明 类型 参数 参数说明 设置规则 扩展属性 如果在填写基本信息时，“功能列表”添加了“扩展属性”，可在“功能配置”中设置“扩展属性”的规则，用于约束应用运行态下该实体可添加的扩展属性类型数量、文本长度等配置。 单击“新增”，参考如下说明进行设置。 属性类型：用于约束应用运行态下该实体可添加的扩展属性类型。当前支持选择文本、长文本、整型、长整型、浮点型、浮点型（自定义精度）、布尔值、日期、枚举、分类、URL和文件类型。 数量：用于约束应用运行态下该实体可添加对应扩展属性类型的数量。 如果应用的数据库类型为mysql，文本、长文本、布尔、日期、分类类型的属性数量不可超过200个，整型、长整型、浮点型、浮点型（自定义精度）类型的属性数量不可超过100个，枚举类型的属性数量不可超过55个，URL类型的属性数量不可超过4个，文件类型的属性数量不可超过183个。 如果应用的数据库类型为postgresql，每种类型的属性数量不可超过200个。 文本长度：表示存储至数据库的文本总长度。如果应用的数据库类型为mysql，其文本总长度不可超过14234字节（Byte）。 是否索引：选择为“是”，系统会在对应实体扩展表中创建普通索引，后续您在应用运行态为该实体添加“索引”为“是”的扩展属性时，将自动匹配至有索引的列。同时存在如下约束： 长文本、文件、布尔值、URL不支持选择“索引”为“是”。 文本、日期和分类类型的属性数量不可超过60个，整型、长整型、浮点型和浮点型（自定义精度）类型的总属性数量不可超过60个。 如果应用的数据库类型为postgresql，枚举类型的属性数量不可超过60个。 如果应用的数据库类型为mysql，且“文本长度”的设置大于768个字符，则该配置无效，无需配置。 扩展表名称：默认为“应用英文名称_关系实体英文名称_REL+属性类型+EXAValue”，可自定义。 例如应用名为DMEApp，数据实体为Parts，属性类型为整型，扩展表名称默认为“DMEApp_Parts_RELNumberEXAValue”。 联合索引管理 关系实体的默认功能，如果您需要对该实体进行多属性查询时，可在“功能配置”中定义联合索引，提高查询效率。更多关于联合索引的介绍请参见联合索引管理。 API列表 - 应用发布后，API列表中的API会注册到APIG，提供调用。 单击“保存”。

请求示例 POST https://dme.cn-north-4.huaweicloud.com/rdm_b3f9b7523a6141f4b2d76b92d6595281_app/publicservices/api/RelationModel/queryRelationship/10/1 { "params" : { "role" : "Target", "objectId" : "614786496192323584", "isNeedTotal" : true, "latestOnly" : false } }

响应示例 状态码： 200 OK { "result" : "SUC CES S", "data" : [ { "id" : "614786585191260160", "creator" : "xdmAdmin", "modifier" : "xdmAdmin", "createTime" : "2024-03-28T03:42:24.092+0000", "lastUpdateTime" : "2024-03-28T03:42:24.092+0000", "rdmVersion" : 1, "rdmDeleteFlag" : 0, "rdmExtensionType" : "RelationModel", "tenant" : { "id" : "-1", "creator" : "xdmAdmin", "modifier" : "xdmAdmin", "createTime" : "2024-03-28T03:28:34.795+0000", "lastUpdateTime" : "2024-03-28T03:28:34.795+0000", "rdmVersion" : 1, "rdmDeleteFlag" : 0, "rdmExtensionType" : "Tenant", "tenant" : null, "className" : "Tenant", "name" : "basicTenant", "description" : "默认租户", "kiaguid" : null, "securityLevel" : "internal", "nameEn" : null, "code" : "basicTenant", "disableFlag" : false, "dataSource" : "DefaultDataSource" }, "className" : "RelationModel", "source" : { "id" : "614786412419489792", "creator" : "xdmAdmin", "modifier" : "xdmAdmin", "createTime" : "2024-03-28T03:41:42.900+0000", "lastUpdateTime" : "2024-03-28T03:41:42.900+0000", "rdmVersion" : 1, "rdmDeleteFlag" : 0, "rdmExtensionType" : "Classes", "tenant" : { "id" : "-1", "creator" : "xdmAdmin", "modifier" : "xdmAdmin", "createTime" : "2024-03-28T03:28:34.795+0000", "lastUpdateTime" : "2024-03-28T03:28:34.795+0000", "rdmVersion" : 1, "rdmDeleteFlag" : 0, "rdmExtensionType" : "Tenant", "tenant" : null, "className" : "Tenant", "name" : "basicTenant", "description" : "默认租户", "kiaguid" : null, "securityLevel" : "internal", "nameEn" : null, "code" : "basicTenant", "disableFlag" : false, "dataSource" : "DefaultDataSource" }, "className" : "Classes", "name" : "初二四班", "description" : "初中二年级四班", "kiaguid" : null, "securityLevel" : "internal" }, "target" : { "id" : "614786496192323584", "creator" : "xdmAdmin", "modifier" : "xdmAdmin", "createTime" : "2024-03-28T03:42:02.873+0000", "lastUpdateTime" : "2024-03-28T03:42:02.873+0000", "rdmVersion" : 1, "rdmDeleteFlag" : 0, "rdmExtensionType" : "Student", "tenant" : { "id" : "-1", "creator" : "xdmAdmin", "modifier" : "xdmAdmin", "createTime" : "2024-03-28T03:28:34.795+0000", "lastUpdateTime" : "2024-03-28T03:28:34.795+0000", "rdmVersion" : 1, "rdmDeleteFlag" : 0, "rdmExtensionType" : "Tenant", "tenant" : null, "className" : "Tenant", "name" : "basicTenant", "description" : "默认租户", "kiaguid" : null, "securityLevel" : "internal", "nameEn" : null, "code" : "basicTenant", "disableFlag" : false, "dataSource" : "DefaultDataSource" }, "className" : "Student", "name" : "张三", "description" : null, "kiaguid" : null, "securityLevel" : "internal", "grade" : "98.99" }, "name" : null, "description" : null } ], "errors" : [ ], "pageInfo" : { "curPage" : 1, "pageSize" : 1000, "totalRows" : 1, "totalPages" : 1 } }

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 result String 参数解释： 请求结果。 取值范围： SUCCESS：请求成功。 FAIL：请求失败。 默认取值： 不涉及。 data Array of RelationModelViewDTO objects 参数解释： 请求数据。 取值范围： 不涉及。 默认取值： 不涉及。 errors Array of strings 参数解释： 异常信息。 取值范围： 不涉及。 默认取值： 不涉及。 pageInfo PageInfoViewDTO object 参数解释： 分页信息。 取值范围： 不涉及。 默认取值： 不涉及。 表7 RelationModelViewDTO 参数 参数类型 描述 className String 参数解释： 类名。 取值范围： 不涉及。 默认取值： 不涉及。 createTime String 参数解释： 创建时间。 取值范围： 不涉及。 默认取值： 不涉及。 creator String 参数解释： 创建者。 取值范围： 不涉及。 默认取值： 不涉及。 description String 参数解释： 实体描述。 取值范围： 不涉及。 默认取值： 不涉及。 id String 参数解释： 唯一标识。 取值范围： -9223372036854775808到9223372036854775807的整数。 默认取值： 不涉及。 lastUpdateTime String 参数解释： 最后更新时间。 取值范围： 不涉及。 默认取值： 不涉及。 modifier String 参数解释： 修改人。 取值范围： 不涉及。 默认取值： 不涉及。 name String 参数解释： 名称。 取值范围： 不涉及。 默认取值： 不涉及。 rdmDeleteFlag Integer 参数解释： 软删除标识，参数值为0或1。 取值范围： 0：表示未删除。 1：表示已删除。 默认取值： 不涉及。 rdmExtensionType String 参数解释： 扩展类型。 取值范围： 不涉及。 默认取值： 不涉及。 rdmVersion Integer 参数解释： 系统版本。 取值范围： 不涉及。 默认取值： 不涉及。 source ClassesViewDTO object 参数解释： 源实体。 取值范围： 不涉及。 默认取值： 不涉及。 target StudentViewDTO object 参数解释： 目标实体。 取值范围： 不涉及。 默认取值： 不涉及。 tenant TenantViewDTO object 参数解释： 租户信息。 取值范围： 不涉及。 默认取值： 不涉及。 表8 ClassesViewDTO 参数 参数类型 描述 className String 参数解释： 类名。 取值范围： 不涉及。 默认取值： 不涉及。 createTime String 参数解释： 创建时间。 取值范围： 不涉及。 默认取值： 不涉及。 creator String 参数解释： 创建者。 取值范围： 不涉及。 默认取值： 不涉及。 description String 参数解释： 描述。 取值范围： 不涉及。 默认取值： 不涉及。 id String 参数解释： 唯一标识。 约束限制： 不涉及。 取值范围： -9223372036854775808到9223372036854775807的整数。 默认取值： 不涉及。 kiaguid String 参数解释： 关键信息资产ID。 取值范围： 不涉及。 默认取值： 不涉及。 lastUpdateTime String 参数解释： 最新更新时间。 取值范围： 不涉及。 默认取值： 不涉及。 modifier String 参数解释： 修改人。 取值范围： 不涉及。 默认取值： 不涉及。 name String 参数解释： 名称。 取值范围： 不涉及。 默认取值： 不涉及。 rdmDeleteFlag Integer 参数解释： 软删除标识，参数值为0或1。 取值范围： 0：表示未删除。 1：表示已删除。 默认取值： 不涉及。 rdmExtensionType String 参数解释： 扩展类型。 取值范围： 不涉及。 默认取值： 不涉及。 rdmVersion Integer 参数解释： 系统版本。 取值范围： 不涉及。 默认取值： 不涉及。 securityLevel String 参数解释： 安全密级。 取值范围： INTERNAL：内部公开。 SECRET：秘密。 CONFIDENTIAL：机密。 TOP_SECRET：绝密。 默认取值： 不涉及。 tenant TenantViewDTO object 参数解释： 租户信息。 取值范围： 不涉及。 默认取值： 不涉及。 表9 StudentViewDTO 参数 参数类型 描述 className String 参数解释： 类名。 取值范围： 不涉及。 默认取值： 不涉及。 createTime String 参数解释： 创建时间。 取值范围： 不涉及。 默认取值： 不涉及。 creator String 参数解释： 创建者。 取值范围： 不涉及。 默认取值： 不涉及。 description String 参数解释： 描述。 取值范围： 不涉及。 默认取值： 不涉及。 grade Number 参数解释： 成绩。 取值范围： 不涉及。 默认取值： 不涉及。 id String 参数解释： 唯一标识。 取值范围： -9223372036854775808到9223372036854775807的整数。 默认取值： 不涉及。 kiaguid String 参数解释： 关键信息资产ID。 取值范围： 不涉及。 默认取值： 不涉及。 lastUpdateTime String 参数解释： 最新更新时间。 取值范围： 不涉及。 默认取值： 不涉及。 modifier String 参数解释： 修改人。 取值范围： 不涉及。 默认取值： 不涉及。 name String 参数解释： 名称。 取值范围： 不涉及。 默认取值： 不涉及。 rdmDeleteFlag Integer 参数解释： 软删除标识，参数值为0或1。 取值范围： 0：表示未删除。 1：表示已删除。 默认取值： 不涉及。 rdmExtensionType String 参数解释： 扩展类型。 取值范围： 不涉及。 默认取值： 不涉及。 rdmVersion Integer 参数解释： 系统版本。 取值范围： 不涉及。 默认取值： 不涉及。 securityLevel String 参数解释： 安全密级。 取值范围： INTERNAL：内部公开。 SECRET：秘密。 CONFIDENTIAL：机密。 TOP_SECRET：绝密。 默认取值： 不涉及。 tenant TenantViewDTO object 参数解释： 租户信息。 取值范围： 不涉及。 默认取值： 不涉及。 表10 TenantViewDTO 参数 参数类型 描述 className String 参数解释： 类名。 取值范围： 不涉及。 默认取值： 不涉及。 code String 参数解释： 租户编码。 取值范围： 不涉及。 默认取值： 不涉及。 createTime String 参数解释： 创建时间。 取值范围： 不涉及。 默认取值： 不涉及。 creator String 参数解释： 创建者。 取值范围： 不涉及。 默认取值： 不涉及。 dataSource String 参数解释： 租户使用的数据源名称。 取值范围： 不涉及。 默认取值： 不涉及。 description String 参数解释： 描述信息。 取值范围： 不涉及。 默认取值： 不涉及。 disableFlag Boolean 参数解释： 失效标识。 取值范围： true：失效。 false：未失效。 默认取值： false。 id String 参数解释： 唯一标识。 取值范围： -9223372036854775808到9223372036854775807的整数。 默认取值： 不涉及。 kiaguid String 参数解释： KIA密级。 取值范围： 不涉及。 默认取值： 不涉及。 lastUpdateTime String 参数解释： 最后更新时间。 取值范围： 不涉及。 默认取值： 不涉及。 modifier String 参数解释： 修改人。 取值范围： 不涉及。 默认取值： 不涉及。 name String 参数解释： 中文名称。 取值范围： 不涉及。 默认取值： 不涉及。 rdmDeleteFlag Integer 参数解释： 软删除标识。 取值范围： 0：表示未删除。 1：表示已删除。 默认取值： 0。 rdmExtensionType String 参数解释： 扩展类型。 取值范围： 不涉及。 默认取值： 不涉及。 rdmVersion Integer 参数解释： 系统版本。 取值范围： 不涉及。 默认取值： 不涉及。 securityLevel String 参数解释： 安全密级。 取值范围： INTERNAL：内部公开。 SECRET：秘密。 CONFIDENTIAL：机密。 TOP_SECRET：绝密。 默认取值： 不涉及。 tenant TenantViewDTO object 参数解释： 租户信息。 取值范围： 不涉及。 默认取值： 不涉及。 表11 PageInfoViewDTO 参数 参数类型 描述 curPage Integer 参数解释： 当前页。 取值范围： 不涉及。 默认取值： 不涉及。 pageSize Integer 参数解释： 每页大小。 取值范围： 不涉及。 默认取值： 不涉及。 totalRows Integer 参数解释： 总行数。 取值范围： 不涉及。 默认取值： 不涉及。 totalPages Integer 参数解释： 总页数。 取值范围： 不涉及。 默认取值： 不涉及。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： IAM 用户的token。 获取方法请参见获取IAM用户Token。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 表4 请求Body参数 参数 是否必选 参数类型 描述 applicationId 否 String 参数解释： 应用ID。 约束限制： 不涉及。 取值范围： 由英文字母和数字组成，且长度为32个字符。 默认取值： 不涉及。 params 否 GenericLinkQueryDTO object 参数解释： 请求参数对象。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 表5 GenericLinkQueryDTO 参数 是否必选 参数类型 描述 isNeedTotal 否 Boolean 参数解释： 是否需要查询总记录数。 约束限制： 不涉及。 取值范围： true：需要。 false：不需要。 默认取值： false。 latestOnly 否 Boolean 参数解释： 是否返回源模型数据实例关联的最新版本目标模型数据实例。此参数仅对源/目标模型为M-V模型实体有效。 约束限制： 不涉及。 取值范围： true：返回源模型数据实例关联的最新版本的目标模型数据实例。 false：返回源模型数据实例关联的所有版本的目标模型数据实例。默认为false。 默认取值： false。 objectId 否 String 参数解释： 角色对应数据实例ID。 约束限制： 不涉及。 取值范围： -9223372036854775808到9223372036854775807的整数。 默认取值： 不涉及。 role 否 String 参数解释： 角色。 约束限制： 不涉及。 取值范围： TARGET：目标模型。 SOURCE：源模型。 默认取值： 不涉及。

URI POST /rdm_{identifier}_app/publicservices/api/{modelName}/queryRelationship/{pageSizePath}/{curPagePath} 表1 路径参数 参数 是否必选 参数类型 描述 pageSizePath 是 Integer 参数解释： 分页大小（路径参数）。 约束限制： 不涉及。 取值范围： 1-1000。 默认取值： 不涉及。 curPagePath 是 Integer 参数解释： 当前页数（路径参数）。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 1。 identifier 是 String 参数解释： 应用唯一标识。 约束限制： 不涉及。 取值范围： 由英文字母和数字组成，且长度为32个字符。 默认取值： 不涉及。 modelName 是 String 参数解释： 数据模型的英文名称。 约束限制： 不涉及。 取值范围： 大写字母开头，只能包含字母、数字、"_"，且长度为[1-60]个字符。 默认取值： 不涉及。 表2 Query参数 参数 是否必选 参数类型 描述 curPage 否 Integer 参数解释： 当前页。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 1。 endIndex 否 Integer 参数解释： 结束索引。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 0。 maxPageSize 否 Integer 参数解释： 最大分页数。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 1000。 pageSize 否 Integer 参数解释： 每页大小。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 1000。 startIndex 否 Integer 参数解释： 起始索引。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 0。 totalPages 否 Integer 参数解释： 总页数。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 0。 totalRows 否 Integer 参数解释： 总行数。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 0。