xDM-F数据同步规则说明

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

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

同步数据实体时，只同步“模型类型”为“实体模型”和“扩展模型”，“模型分类”为“业务数据模型”和“同步至LinkX-F”为“是”的实体。同时，实体属性会被全部同步，并根据xDM-F实体属性是否“入图”自动映射写入对应LinkX-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实体属性更新同步时也会被删除，已发布的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中修改该实体的属性名称，然后再进行同步重试。