xDM-F数据同步规则说明

在进行xDM-F数据同步时，遵循以下数据同步规则。

仅同步xDM-F同步任务清单中所选应用运行态及对应xDM-F租户下的数据，同步过来的模型和实例数据将被存放在LinkX-F系统中的指定租户下。可通过查看LinkX-F实体的“模型来源”，判断实体是否集成了xDM-F模型信息。关于xDM-F模型概念详细介绍，请参考数据模型概述。
xDM-F来源的实体存在以下修改限制：
- 在“基本信息”页签中，不支持对“责任人”、“关联领域”（仅数据实体）、“源系统”、“是否主数据”（仅数据实体）、“产品阶段”和“标签”外的其他字段进行修改。
- 在实体属性页签中，仅支持上移、下移、置顶自定义属性，其他操作均不支持（如新增、修改、删除、生效、失效等）。但如果该类数据实体中存在“是否入图”为是的自定义属性，则这类属性的“是否关联属性”值支持修改，此操作是为了便于后续手动创建非实体关系。

同步数据实体时，仅支持将“模型类型”为“实体模型”和“扩展模型”，“模型分类”为“业务数据模型”和“同步至LinkX-F”为“是”的xDM-F实体同步至LinkX-F，且该类实体的属性将被全部同步，LinkX-F实体属性的“是否入图”值会根据xDM-F实体属性是否“入图”自动映射写入，但对于唯一键或关联属性，其图数据库映射配置不依赖于xDM-F端实体属性的是否“入图”配置，对应LinkX-F实体发布后，系统将自动为该类属性配置图数据库映射字段，后续自动入图。

同步关系实体时，仅支持同步xDM-F中关系实体的非参考关系，同步过来后，按关系类型划分为实体关系和非实体关系。如表1所示。

表1 关系实体同步限制说明
关系类型	限制说明
实体关系	同步实体时，仅同步“模型类型”为“实体模型”和“扩展模型”，“模型分类”为“业务数据模型”和“同步至LinkX-F”为“是”的实体。同时，实体属性会被全部同步，并根据xDM-F实体属性是否“入图”自动映射写入对应LinkX-F实体属性的“是否入图”值。但如果属性是唯一键或关联属性，不论xDM-F实体属性是否“入图”，LinkX-F实体发布后都会自动为对应属性配置图数据库映射字段，后续自动入图。
非实体关系	当xDM-F数据实体存在“参考对象”类型的扩展属性或基本属性，LinkX-F系统会根据参考对象属性自动创建非实体关系，该类非实体关系以xDM-F数据实体作为源端，“参考对象”属性作为源端关联属性，参考对象作为目标端。如果xDM-F数据实体有多个“参考对象”类型属性，LinkX-F系统则会对应生成多条非实体关系，命名规则为{xDM-F数据实体名称}_ForeignKey_{xDM-F数据实体对应属性“参考对象”中实体的英文名称}_{xDM-F参考对象属性的英文名称}。

xDM-F中跨应用参考关系同步至LinkX-F后，其归属应用与源数据实体一致，同步情况可在所在应用的xDM-F同步任务质量监控页面查看。为确保跨应用参考关系同步成功，需为相关的两个应用分别创建同步任务，且目标数据实体所属租户须为唯一编码为“-1”的“basicTenant”默认租户，待源端和目标端数据实体都同步至LinkX-F后，参考关系才能创建成功。
在iDME控制台进行应用部署或在LinkX-F中手动同步任务时，xDM-F中的枚举类型，以及内置和自定义创建的单位类型将会被全量同步至LinkX-F系统，这类数据仅作为xDM-F来源模型的引用属性配置，不支持被LinkX-F自创建实体在管理属性时使用。您可通过“枚举来源”或“单位来源”识别，信息显示规则为XDM_{xDM-F应用英文名称}_{xDM-F租户编码}。
xDM-F模型同步至LinkX-F后，如果LinkX-F中存在同名实体（包括数据实体和关系实体），系统会自动在集成xDM-F信息生成的实体的“英文名称”或“中文名称”后添加数字编号后缀，并按顺序递增。命名规则为{xDM-F实体英文名称}_{按序递增数字编号}，示例“EntityName_02”。

当应用运行态中对应实体的基本信息、属性有更新时，LinkX-F中对应实体旁将出现更新标识。您可查看更新详情并进行同步确认。更新规则详见表2。

数据实体、关系实体同步变更信息的具体操作请参考同步xDM-F数据实体变更信息和同步xDM-F关系实体变更信息。

表2 xDM-F模型变更信息同步规则说明
更新类型	规则说明
基本信息	当应用运行态中对应实体的基本信息更新时，确认更新后，对应LinkX-F实体的基本信息也会随之更新。
属性	当应用运行态中对应实体的属性有变更时（如新增、修改、删除），确认更新后，对应LinkX-F实体的属性也会随之更新。当应用运行态中实体的属性被删除时，如果其对应的LinkX-F实体未发布，则同步更新时直接删除该属性，如果已发布，则同步更新时直接失效该属性。

当应用运行态中对应实体的实例数据有更新时（如新增、修改、删除），xDM-F来源模型的实例数据会随之自动更新，该方式仅能同步增量实例数据。如需同步全量或历史指定范围内的实例数据，需参考创建实例调度任务通过创建实例调度任务完成。
当xDM-F租户或应用被重置/删除，LinkX-F系统中对应租户，或对应应用关联的所有租户下的同步任务将自动终止，已同步的模型和实例数据将予以保留，但后续不再更新。

在处理数据同步异常时，请注意以下场景。

当xDM-F数据实体新增参考对象类型的扩展属性时，需先确认并更新LinkX-F中xDM-F来源的模型信息，再在xDM-F同步任务中处理参考关系的同步异常，确保参考关系同步生效。具体操作如下：
找到待操作的同步任务，单击其操作列的“模型同步”图标或进入该任务的同步质量监控页面，选择关系实体页签，找到同步异常的参考关系，单击同步异常重试图标，进行同步重试。
在LinkX-F中，同一实体的属性名称需保持唯一性；而在xDM-F应用中，同一租户下实体的扩展属性允许与普通属性同名。基于这一差异，当该类xDM-F实体同步至LinkX-F系统并生成模型时，将触发同步异常，且系统会提示属性名称重复。如需继续操作，需在xDM-F中修改该实体的重复属性名称，再重试同步。