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参考对象属性的英文名称}。

• 在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模型生成的LinkX-F实体的实例数据会随之自动更新，此种方式只能同步增量的实例数据。如果想同步全量或历史指定范围内的实例数据，则需通过创建实例调度任务来实现，相关操作可参考创建实例调度任务。
• 如果xDM-F租户或应用被重置/删除，LinkX-F系统中对应租户或对应应用下的所有租户的同步任务将自动中断，已同步过来的模型和实例数据会被保留，但后续不再进行更新。

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

• 如果您为xDM-F数据实体新增了参考对象类型的扩展属性，在LinkX-F中，在确认并更新模型信息后，还需在xDM-F同步任务中对参考关系进行同步异常处理。找到待操作的同步任务，单击其操作列的“模型同步”图标或进入该任务的同步质量监控页面，选择关系实体页签，找到同步异常的参考关系，单击同步异常重试图标，进行同步重试。
• 在LinkX-F系统中，同一实体属性的名称必须是唯一的。然而，在xDM-F应用中，同一租户中实体的扩展属性可以与普通属性同名。因此，当将此类xDM-F实体同步LinkX-F系统生成模型时，会出现同步异常，并提示属性名称重复。如果您想继续操作，可以在xDM-F中修改该实体的属性名称，然后再进行同步重试。