配置和维护上下游数据同步

建立租户连接，按策略同步对象数据。

[!IMPORTANT]

• 上下游都已开通纷享租户，并已建立互联关系。
• 上游管理员负责配置同步策略；通过邀请码建立关系时，下游需授权开启数据同步。
• 数据同步是独立应用；仅创建互联用户或开放应用访问，不能代替租户之间的数据同步授权。

[!NOTE]
下发策略的新建流程按当前截图说明；应用入口、跨类型映射及后续维护截图沿用原始手册。旧版界面名称与当前界面不一致时，以当前配置入口为准。

1 建立关系并授权

1. 在 管理 > 互联管理 > 互联用户 创建互联企业，将 是否开通纷享租户 设为 是；已有下游租户则使用已有的互联关系。
2. 根据建立关系的方式完成授权。

建立方式	授权要求
上游直接创建并开通下游租户	下游默认授权数据同步
下游通过邀请码建立关系	上游为下游设置包含 数据同步 应用的互联角色；下游进入应用，在 同步设置 开启 数据同步总开关

3. 上游进入 互联管理 > 互联应用 > 其他 > 数据同步，配置同步策略。

   

2 进入同步策略并选择对象

在 数据同步 > 同步策略 中，先选择 采集 / 下发 页签。本文以下发客户主数据为例：上游将经销商负责的门店下发到对应下游租户，同时锁定关键主数据值，避免下游自行修改。

数据流向	数据源	目标
采集	下游租户	上游租户
下发	上游租户	下游租户

1. 在 下发 页签的左侧对象列表中，选择 客户 等数据源对象；可通过 搜索对象 查找对象。
2. 在右侧查看当前对象的策略。列表显示策略名称、数据源企业、数据源对象、目标企业、目标对象、状态、创建人、创建时间、修改人及操作入口。可搜索目标企业，并使用列表上方的下拉筛选。

3. 如果左侧没有所需对象，在 添加对象 中选择源主对象及需要同步的从对象，保存。

4. 在右上角点击 添加策略，依次完成 基本信息 → 字段映射 → 数据范围 → 同步规则。前三步完成后点击 下一步，最后一步点击 保存。

3 填写基本信息并锁定主数据

3.1 选择目标企业和目标对象

1. 在 基本信息 中填写必填的 策略名称，核对当前 数据源企业 和 数据源对象；按需要填写备注。
2. 在 目标企业 中点击 请选择对接企业，选择接收数据的下游企业。
3. 在 目标对象 中选择接收数据的对象。例如，上游客户下发到下游客户。

选择目标企业后，页面提供 下发字段预设 和 下发数据锁定设置。字段预设用于准备下游字段结构，数据锁定用于保护已下发记录中的关键值。

3.2 预设下游同步字段

1. 在 下发字段预设 > 数据源对象字段 中点击 添加字段。
2. 在字段选择窗口中搜索并选择需要下发的字段，加入右侧已选列表后点击 确认。

下游不存在的所选字段随预设下发，包含字段名称、字段 API Name 和枚举值等。上游后续修改字段属性时，系统不自动更新下游，需要手动点击 更新下游字段属性。

[!NOTE]
字段预设的下发是一次性动作，与策略后续监听业务数据变更不同。移除预设字段后，要同时检查字段映射；如果映射仍引用该字段，新接入企业可能因缺少字段而同步异常。

3.3 设置字段定义锁定和数据锁定

配置项	控制内容	主数据场景中的用途
锁定下游对象的同步字段，不可以进行编辑和删除	下游对象的同步字段定义	保持上下游字段结构一致
锁定字段的数据下游不可编辑	所选字段的数据值	保护客户编号、客户名称等由上游维护的关键主数据值
下发的数据下游不可作废	下发的数据记录	按业务要求限制下游作废上游下发的记录

1. 按需要开启字段定义锁定。
2. 需要保护关键值时，勾选 锁定字段的数据下游不可编辑，点击 锁定字段设置。
3. 在窗口中逐项勾选需要锁定的字段，点击 确认。具体锁定哪些字段应按主数据维护职责确定，页面中的候选字段不等于全部已锁定。
4. 如需限制记录作废，勾选 下发的数据下游不可作废，然后点击 下一步。

锁定字段定义与锁定数据值需要分别配置。仅锁定字段定义，不能代替对关键数据值的锁定。

4 设置字段映射

4.1 设置数据归属

1. 在 字段映射 > 基本信息 中，核对数据源企业与目标企业。
2. 设置目标数据的 负责人 和 相关团队；按业务需要选择变量值，并设置相关团队的更新方式。

归属变量	下发时的解析方式
负责人：目标方的主负责人	取下游对应互联企业的主负责人，作为目标数据负责人
负责人：数据源方外部负责人	将源数据的外部负责人转换为对应下游负责人
相关团队：数据源方外部相关团队	从源数据的外部相关团队筛出本下游互联用户，解析为下游员工；覆盖会用新值替换，增量更新会追加最新成员

4.2 映射主对象和从对象字段

1. 在 主对象字段映射 中，为每个数据源字段选择对应的目标字段；使用 继续添加 补充映射。有从对象时，同样配置从对象映射。
2. 字段名称和 API Name 均相同的场景，可开启 同字段名称且同 Api Name 自动建立字段映射，再核对自动生成的对应关系。
3. 对业务类型、单选、多选等字段，核对选项映射。截图中业务类型使用 按选项 ID 值映射，客户类型配置“客户 → 客户”“其他 → 其他”。
4. 需要统一目标值时，在目标字段旁点击 插入固定值；支持变量的字段可按业务要求使用变量，例如日期字段使用当前时间。
5. 对查找关联字段，核对关联对象的同步关系。截图中“所属供应商”采用 依赖对象同步，需结合后续关联数据处理规则检查。
6. 核对映射后点击 下一步。

对象字段支持文本、日期时间、布尔、单选、多选、图片、查找关联、定位、省市区、数字、手机和业务类型等映射。关联字段、多选字段等支持的覆盖或增量方式，以当前字段提供的选项为准。

4.3 使用跨类型映射

• 部门 → 文本：2026 年 4 月更新支持将部门字段映射到单行或多行文本字段。

  

• 人员属性 → 文本：2026 年 5 月更新支持选择创建人、修改人、负责人等人员字段的属性，如姓名、手机号，再映射到目标文本字段。

  

• 枚举“其他”的附带文本：源和目标都启用“其他”选项，并完成“其他 → 其他”的选项映射后，可同步附带文本。

[!NOTE]
跨类型映射传递部门信息或人员属性文本，不代表把上游人员、部门身份直接复制为下游同类型身份。

5 设置数据范围，隔离各经销商的数据

在 数据范围 中，按目标企业核对允许下发的数据。字段映射决定“同步哪些字段”，数据范围决定“哪些记录可以下发”。选择目标企业后仍需要配置合适的记录范围，避免将其他经销商的门店下发给当前企业。

1. 开启 数据范围设置，添加标准字段条件或变量条件。
2. 按业务要求组合 且（AND）/ 或（OR） 条件。截图示例要求同时满足：客户类型等于客户，且 上级客户（变量值）等于关联客户。
3. 核对条件后点击 下一步。

5.1 理解“上级客户（变量值）等于关联客户”

这里比较的是上游源客户记录与当前目标下游企业在上游的客户关系：

• 上级客户（变量值）：待下发的客户记录中，“上级客户”字段的值。
• 关联客户：当前目标下游企业在上游关联的客户，例如该下游经销商对应的客户记录。
• 等于：只有源客户的上级客户与该下游企业的关联客户一致，这条记录才满足此条件。

例如，经销商 A 在上游对应客户 A，门店 A1、A2 的上级客户都是客户 A。给经销商 A 的下游租户下发客户时，这两个门店满足条件；上级客户为客户 B 的门店 B1 不满足条件，不能下发给经销商 A。

上游客户记录	该记录的上级客户	目标下游企业的关联客户	此变量条件是否满足
门店 A1	客户 A	客户 A	满足
门店 A2	客户 A	客户 A	满足
门店 B1	客户 B	客户 A	不满足

[!IMPORTANT]
上述示例还需同时满足“客户类型等于客户”等其他条件。不要将经销商隔离条件与一个宽泛条件用 OR 连接，否则可能放入其他经销商的数据。变量按当前目标下游企业的关联客户解析；核对互联企业与客户的关联关系后再启用策略。

5.2 配置主从对象范围

有主从对象时，可分别设置主对象和从对象的条件。默认主从范围按交集解析；对允许只同步主对象的业务，可开启 从对象的数据范围为空时，也正常同步主对象及其他从对象数据。

只有业务确实需要向当前目标企业下发全部数据时，才设置覆盖全部目标记录的条件，例如主属性不为空；按经销商隔离门店的场景，应保留经销商关联条件。

6 设置同步规则并保存

在新建流程的 同步规则 中，依次配置 基本权限逻辑、基本设置、同步逻辑参数、插入自定义函数。已有策略可通过列表的 更多 > 同步规则 进入。

6.1 选择关联数据处理方式

规则	效果	示例
关联对象不允许同步，该对象也不同步	用关联对象的范围约束当前对象	客户在范围内，其联系人才能同步
关联对象不允许同步，该对象需要同步时，也同步关联对象	当前对象符合条件时联动关联对象	联系人需同步时，把不在原范围的关联客户一并同步
关联对象没有同步或部分同步，当前对象也正常同步	忽略关联对象范围依赖	当前对象独立按自己的条件同步

6.2 设置初始化和写入行为

基本设置	使用时的判断
初始化同步	启用后对策略对应对象进行全量初始化；只能开启一次，在策略调试正确后执行
重复数据写入失败则直接映射数据关系	对目标已有重复数据建立映射，避免继续报重复写入失败
重新启用时同步停用期间符合条件的数据	停用维护后，需要补齐停用期间数据时开启
同步到目标后不触发流程	分别勾选需要阻止触发的审批流、工作流
目标数据在流程流转状态时强制覆盖写入	更新可能覆盖处于流程锁定状态的数据，按业务要求选择

6.3 设置触发事件和补充逻辑

1. 选择 新增、修改、作废 等同步事件；需要人工触发时开启 手动同步按钮，源数据上提供 数据同步 按钮。
2. 在 高级设置 设置字段监听。字段新增事件默认选中且不可取消；修改事件可按字段取消。
3. 对字段修改选择 本字段修改时，更新本字段 或 任意字段修改时，更新本字段。
4. 需要标签同步且当前策略允许选择时，设置 打标签 事件；截图中该项为不可选状态。
5. 按需要开启已有映射在数据范围不再匹配时仍同步，或更新字段不在映射和范围中时不新增同步的补充逻辑。

6.4 插入自定义函数

标准字段映射和条件无法完成的逻辑，可以通过函数处理。当前截图提供以下三个插入节点，每个节点旁都有添加、编辑和删除入口。

插入节点	处理阶段
同步前－数据过滤	在同步前执行自定义数据筛选逻辑
同步中－数据转换前	在数据转换前执行处理逻辑
同步中－数据转换后	在数据转换后执行处理逻辑

在所需节点点击 ＋ 配置函数，按函数的处理目的选择节点。测试时同时检查过滤结果和转换后的字段值，确保函数处理仍符合目标企业的数据隔离要求。

原文还说明同步成功后的回写能力：可将源数据的外部负责人更新为目标方主负责人，维护源数据的外部访问关系；也可在下发成功后根据目标方最新数据修改源数据。这些成功后处理与截图中的三个函数节点应区分使用，具体配置入口以当前页面提供的能力为准。

完成四部分配置后，点击右上角 保存，返回下发策略列表。

7 查看新建策略并维护配置

保存后，列表增加一条策略记录。截图中新建“客户下发”策略的状态为 停用；保存完成不等于已经开始同步，需要继续校验并启用。

操作入口	用途
编辑	维护策略基本信息、字段预设和锁定配置
更多 > 字段映射	维护数据归属、字段及选项对应关系
更多 > 数据范围	维护下发记录的筛选条件
更多 > 同步规则	维护权限逻辑、写入行为、触发事件和函数
更多 > 策略明细	查看策略明细
更多 > 维护日志	查看策略维护日志
更多 > 启用	对停用策略执行启用；启用时校验策略可用性
更多 > 复制	复制策略；使用前重新核对目标企业、映射、范围和锁定配置
更多 > 删除	删除停用的策略

8 启用并检查同步结果

1. 检查字段映射、数据范围、关键字段锁定、触发事件及函数处理，在列表的 更多 > 启用 中启用策略。
2. 系统执行策略可用性校验；通过后开始同步。
3. 进入 数据维护，切换与策略一致的 采集 / 下发 页签，选择策略明细。
4. 查看数据映射和同步详情，确认源与目标数据对应正确。

建议分别检查经销商 A 的门店 A1 和经销商 B 的门店 B1：向 A 下发时，A1 应按配置生成目标数据，B1 不应下发。以目标方账号检查关键字段不可编辑，并核对非锁定字段的业务编辑权限；如配置了不可作废，也检查记录的作废限制。

需要维护时可停用策略；只有停用后的策略支持删除。

9 创建历史数据同步任务

需要初始化或补齐历史数据时，可创建历史数据同步任务，选择已配置好的同步策略，再指定企业和历史数据范围。任务关联的是 同步策略，由该策略提供同步方向、对象和字段映射等配置。

9.1 进入任务列表并新建

1. 在 数据同步 > 历史数据同步 中，查看已有任务；可按策略、状态、任务类型筛选，或搜索同步任务名称。
2. 点击右上角 新建。

列表显示任务名称、任务类型、策略名称、状态、源数据条数、目标企业数、同步总数、待同步总数和已同步总数，便于跟踪任务进度。

9.2 选择策略、企业和任务类型

1. 在 创建同步任务 中选择 同步策略，填写 同步任务名称；名称最多 50 个字符，可按需要填写最多 100 个字符的备注。
2. 下发任务设置 目标企业：可通过 选择互联企业 选择接收企业，也可使用 批量输入企业 ID 指定一批企业。批量输入使用企业 EI，多个用英文逗号分隔；采集任务对应指定数据源企业。
3. 选择 任务类型，填写对应参数。

任务类型	参数与用途
按时间段	设置历史时间段，选择在该创建时间段内的源数据
按源主属性字段	批量指定数据源主属性字段值，选择需补同步的记录；按界面要求输入，限定数量最多 1000 条
按对象数据范围	根据关联策略的同步对象配置字段条件，筛选需要补同步的主对象、从对象数据

选择 按对象数据范围 时，还可设置 仅同步主对象、仅同步从对象、主从对象都同步，并分别配置相应对象的数据范围条件。截图示例的主对象为客户，从对象为客户地址。

[!IMPORTANT]
创建历史任务前先确认关联策略的字段映射、企业范围、数据隔离及写入规则符合预期，避免批量同步后又调整策略并重复处理。当前创建页面提示日均最高历史数据同步量为 30 万条，历史同步占用同步资源，可能影响正常同步策略的速度。

9.3 启用任务并处理异常

1. 参数核对完成后点击 确定，返回任务列表。
2. 对 未启动 的任务点击 启用，开始执行。未启动任务提供 编辑、删除 操作，执行中的任务提供 停止 操作。
3. 使用列表的刷新按钮查看状态和数量变化，等待任务执行完成。
4. 在 数据维护 中检查对应企业和对象的同步结果。失败记录按下文“处理失败数据和已有映射”的流程查看错误、修复并重试；任务列表显示 完成 后，仍需核对数据同步结果。

[!NOTE]
从对象记录数上限为 2000 条；历史任务按源主属性字段指定记录的限定数量最多 1000 条。这两项限制分别控制从对象规模与指定记录批次，不能相互替代。

10 处理失败数据和已有映射

10.1 查找联系人下发失败的记录

1. 在 数据同步 > 数据维护 中切换到 下发 页签。
2. 在左侧选择 联系人，将数据状态筛选为 同步失败；按需要继续筛选对象、目标企业、时间范围或数据 ID。
3. 核对列表中的数据源企业、数据源对象、源主属性字段、源数据 ID 和目标企业，找到要处理的记录。
4. 在记录的 操作 列点击 详情。

10.2 按同步日志定位失败环节

在 数据详情 顶部核对源记录及目标企业，在左侧 最近同步日志 中选择要检查的一次执行，再查看右侧 日志详情。

日志按 数据源读取 → 数据映射 → 目标数据写入 展示各环节结果。前两个环节成功，不代表目标方已成功接收数据；需要继续检查最后的写入结果。

截图中“联系人0729-2”的数据源读取和数据映射均成功，但 目标数据写入 失败，提示：数据[联系人0729-2]必填字段负责人未填写不可进行当前操作。

10.3 补齐负责人后重试并确认成功

1. 根据错误提示检查策略的 字段映射 > 基本信息 > 负责人，补齐或修正负责人配置，确保映射后能得到目标企业中有效的负责人。源数据存在负责人，不代表它已正确转换为下游负责人。
2. 保存配置后，返回 数据维护，在该记录的 操作 列点击 重试。
3. 再次打开 详情，选择左侧最新的同步日志，检查 目标数据写入 是否显示 同步成功。
4. 在目标企业核对联系人记录和负责人值，确认写入结果符合预期。

截图中修正负责人并重试后，最新日志显示三个环节均同步成功。此前的失败日志仍保留在左侧历史中，因此应以最新一次执行结果判断处理是否成功。

10.4 使用解决方案排查其他错误

如果仅凭提示无法判断如何处理，在失败环节的错误信息下查看 解决方案，点击与当前错误对应的链接，阅读详情并按说明处理，再重试。

截图中的方案入口包括 目标数据负责人未填写或不存在、目标数据必填字段值缺失、字段不同步问题排查。关联数据失败的情况，也可能提示先检查并修复关联数据，再重试当前记录。方案入口随错误而变化，应结合当前记录的错误原因选择。

10.5 维护已有数据映射

操作	用途
重试	修复原因后重新触发失败数据同步；支持勾选多条批量重试
关联	已有双方数据 ID 时，手动建立源与目标的映射
详情	查看源、目标字段值及每次同步日志
导入 / 导出	维护已有数据映射；双方都有历史数据时，先建立映射可减少目标重复数据
删除	删除映射关系；支持批量操作，单条删除时也支持联动删除目标数据

[!WARNING]
删除映射前核对是否同时删除目标数据。删除数据与删除映射关系的影响不同。

11 配置异常通知

完成策略和历史任务配置后，在 数据同步 > 同步设置 中配置同步通知，为同步异常指定接收人。

1. 在 同步通知 中选择 通知固定人。
2. 点击 添加，选择负责接收通知的人员。
3. 点击 确定 保存。

12 相关主题

• 管理互联企业、互联部门、互联用户与互联角色
• 互联应用初始化与配置入口
• 2026 年 4 月互联平台更新说明
• 2026 年 5 月互联平台更新说明