1、建立互联关系
进入管理页面,在 互联管理菜单下的 互联管理>互联用户 创建互联企业。如下图所示,按提示要求填写,此处特别要注意 是否开通纷享租户 字段要选择 是,后面数据同步服务需要连接租户实现数据同步。
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719540339692/image.png)
更细节的互联企业新建操作手册见:https://help.fxiaoke.com/ebc2/d910/85ed#header-1
由于建立互联关系的方法的多样性,此处还需要有多种授权方法:
- 如果直接通过上游品牌商开通的下游租户,下游默认授权可以数据同步。
- 如果下游通过邀请码和上游建立互联关系,此时还需要两步操作:a.给该下游设置拥有【数据同步】应用的互联角色。b.下游进入【数据同步】互联应用,在菜单【同步设置】下,选择【数据同步总开关】,确认开启即可。
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719545620875/image.png)
2、数据同步
创建好互联企业后,同样在互联管理菜单下,互联管理>互联应用>其他 ,进入 数据同步 应用配置:
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719545713963/image.png)
2.1同步策略
进入 数据同步 应用,首先配置同步策略,同步策略按同步方向分为采集、下发。采集即上游CRM租户通过数据同步服务采集下游CRM租户的数据,数据同步方向为下游CRM租户数据→上游CRM租户;下发即上游CRM租户通过数据同步服务将数据下发至下游CRM租户,数据同步方向为上游CRM租户→下游CRM租户。下面以上游CRM租户下发数据为例介绍数据同步配置,采集数据配置类似。
2.1.1 添加对象
进入同步策略菜单,切换 下发 页签,左侧点击 添加对象 ,在弹窗中选择需要创建下发策略的上游CRM租户的 源对象及源从对象,完成后保存。
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719546086081/image.png)
右上角点击 添加策略 来创建同步策略,按提示填写策略信息,保存。
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719546109840/image.png)
2.1.2编辑策略
在同步策略列表右侧 操作 点击 编辑 进入策略设置:
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719546282339/image.png)
此处可以设置下发字段,并且可以对下发字段和下发数据的锁定设置,采集只可对字段下发及锁定。
注意:采集(or下发)字段预设被编辑后,会联动影响同步策略的字段映射,如果您移除了原先存在的字段,特别注意该字段是否在字段映射中,如果存在,建议您移除,避免新的企业进来后(已经移除的字段没有下发),造成同步异常。
此外,下发为一次性同步,若后续有更新,需要手动触发更新。
2.1.3字段映射
在同步策略列表右侧 操作 点击 字段编辑 进入策略设置:
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719546535754/image.png)
字段映射配置分为两大块,第一块为基本信息,此处可配置数据归属相关字段,如负责人、相关团队等;
- 负责人-支持设置变量值,下发场景支持两种变量。a.负责人(目标方的主负责人):解析逻辑为获取下游企业对应互联企业的主负责人为下发的数据的负责人。b.负责人(数据源方外部负责人):解析逻辑为获取上游的数据源的外部负责人,然后转为对应下游的负责人。
- 相关团队-支持设置变量值,下发场景支持一种变量。a.相关团队(数据源方外部相关团队):解析逻辑为获取上游数据源的外部相关团队,过滤出本下游对应的互联用户,解析为下游员工,写入到相关团队。b.该变量支持两种写入模式,一种是覆盖:每次更新后,会直接以新的值写到下游相关团队,一种是增量更新,会把最新的数据更新到下游相关团队。
第二块为对象字段配置,包含对象的主、从(如果有)的字段映射关系配置。
- 多种纷享预设的字段内容都支持字段映射。字段映射也支持插入固定值或者变量值。例如以日期字段为例,标准映射时,就是日期字段同步到日期字段,如果此时设置插入固定值,支持设置一个固定时间,所以同步的数据,该字段都是一个固定时间。如果需要动态,支持可以设置为变量值,支持当前时间。该种转换的字段场景蛮多,根据需要可以自主设置。
- 除了上游的人员、部门字段不支持同步外,其他的纷享对象的预设字段类型都是支持同步映射的。如:单行文本,日期时间,布尔值,单选,多选,图片,查找关联,查找关联多选(覆盖or增量更新)、定位,省市区,数字,手机,业务类型等等
完成要同步的对象的字段映射,就完成了主要的同步规则。
2.1.4数据范围
在同步策略列表右侧 操作 点击 数据范围 进入该策略的数据范围设置,对于主从结构对象,支持分别设置数据范围条件,且各个数据范围条件之间支持与/或关系灵活设置;
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719564699199/image.png)
- 数据范围的条件支持变量范围,例如:【经销商(变量值)】包含【关联客户】。解析逻辑为识别下发的数据查找关联客户的字段等于下游企业关联的客户,实现效果就是把关联下游经销商的数据下发给该下游租户。
- 从对象数据范围支持开启配置:从对象的数据范围为空时,也正常同步主对象及其他从对象数据。原有的主从数据范围解析逻辑为取交集,此选项是取并集逻辑,为了满足部分场景下从对象不同步仅仅同步主对象的需求。
- 一般情况下,如果需要同步全部数据可以设置条件为true的条件。例如:主属性不为空
2.1.5同步规则
在同步策略列表右侧 操作 点击 同步规则 进入该策略的同步规则设置。此处设置分基本权限逻辑、基本设置、同步逻辑参数、自定义函数四大块。基本权限逻辑主要设置关联数据的同步逻辑;基本设置主要设置数据同步修改逻辑;同步逻辑参数主要设置同步触发动作,在右侧 高级设置 中,还支持对接具体字段的事件监听设置;插入自定义函数则是在同步前、中、后三个节点插入自定义逻辑;
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719573225473/image.png)
同步规则主要设置包含基本权限逻辑,基本设置,同步逻辑参数和同步过程中插入函数能力。
- 基本权限逻辑包含三项配置: a.关联对象不允许同步,该对象也不同步:一般选择该配置时,标准数据范围会选择全部,但会通过当前对象关联的对象做数据范围控制。举个例子:联系人不做范围控制,但是联系人关联的客户有精准的数据范围控制,开启此配置后,实现的效果会变成只有同步客户相关的联系人。 b.关联对象不允许同步,该对象需要同步时,也同步关联对象:改配置恰好和上一个配置相反,会强调当前对象的数据范围更重要。举个例子:联系人的数据范围设置后,识别联系人ID1001的数据需要同步,此时联系人关联的客户不在数据范围,但是这个联系人一定要同步,则开启此配置后,同步联系人自动触发客户联动同步。 c.关联对象没有同步或者部分同步,该对象也正常同步:此配置解耦了当前对象和关联对象的数据范围依赖,启用后,会忽略关联对象的范围依赖。
- 基本设置包含五项配置: a.初始化同步:同步策略启用后,会初始化的把策略对应对象的全量数据都同步一遍,一般是同步策略调试完毕后,再启用。初始化同步仅仅只能开启一次,请确认策略正确后再执行。 b.目标方重复数据写入失败则直接映射数据关系,不重复同步:如果数据写入到目标方时,识别数据是重复的,不开启此配置,目标方数据重复,会提示同步失败。如果开启了此配置,则会直接把重复数据建立映射关系,不会同步失败。 c.重新启用策略后也同步停用期间符合指标的数据:如果策略维护较多,建议开启此配置。开启后,会记录停用周期,再次启用策略时,会自动把停用周期内的数据重新同步。 d.数据同步到目标以后不会触发流程:开启配置,数据往目标方写入后,不会触发审批流和工作流。 e.目标方的数据在流程流转状态时,也强制覆盖写入数据:此配置一般用于更新场景,开启配置,数据更新触发目标方数据写入后,如果识别目标方数据正在锁定状态,也支持更新数据。
- 同步逻辑参数 a.同步事件:同步事件主要是数据源的同步事件监听,配置哪些事件会触发同步。同步事件包含新增、修改、作废和手动同步按钮,前三者都是自动同步,手动同步开启后,会在数据源新增自定义按【数据同步】,点击后可以手动触发数据同步。同步事件还支持高级设置:按字段的配置不同字段支持的事件,包含新增(默认选中,不可取消,即只要新建都会触发数据同步),修改(支持字段取消,即支持部分字段修改了不触发数据同步)。修改还支持细节设置,包含【本字段修改时,更新本字段:本字段的修改事件才能更新本字段】、【任意字段修改时,更新本字段:任意字段的修改,都会把数据源的当前字段重新同步到本字段】。 b.其他事件:打标签。该配置主要适配标签同步。 c.补充逻辑:补充逻辑包含两个配置项。一项是存在数据映射,数据范围不符合条件,也触发数据同步。该配置主要使用在修改场景,过往历史数据同步后,存在了映射关系,但后续更换了数据范围,类似数据也支持同步;另一项是更新字段不在字段映射或数据范围中则不新增。改配置启用后数据源的更新字段如果不在同步策略的字段映射,不在同步策略的数据范围,即使数据更新了也不触发同步。
- 插入自定义函数 a.支持在同步前、同步中、同步后不同节点插入函数逻辑,对数据进行处理。 b.同步成功后更新数据源方的外部负责人为目标方的主负责人:同步成功后依然回写数据到数据源方,主要为了更新源数据的外部数据权限,供对应的用户直接可用互联业务。 c.下发成功后,自动根据目标方的最新数据修改数据源方数据(一般是上游下发数据成功并自动加工后,会回到上游使用)。
2.1.6同步策略启用、停用、删除
同步策略配置完成后,支持启用停用。启用时会做策略可用性的校验,校验通过就会正式开始同步数据。停用后的策略支持删除。
2.2数据维护
完成同步策略设置后,启用策略。当有数据同步时,即可在数据维护查看同步的记录,包含中间表映射关系及数据同步的详情。进入 数据维护,分为采集和下发两个方向,此处同样以下发为例说明。
进入 数据维护 界面,在上方切换 下发 页签,选择对应的策略明细,右侧即默认展示该策略同步失败的数据。对于失败数据,可以在 操作 列点击 重试,以重新出发数据同步。若已有数据ID,也可以通过 关联 来手动关联数据映射关系。详情 则是进入数据同步详情页面,查看数据同步源与目标数据值以及同步的日志记录。删除则为删除该条数据的映射关系。勾选多条数据时,支持批量重试和删除操作。
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719653437156/image.png)
- 数据维护支持导入操作:一般上下游都有历史数据的情况下,可以直接导入数据映射关系,避免通过同步造成目标方数据冗余。
- 数据维护支持导出操作:支持导出已存在的数据映射关系,支持手动微调后再重新导入。
- 单条的数据维护支持基础操作:详情是查看每次同步的详情信息。删除是直接删除数据映射关系,删除映射关系时也支持联动删除目标方的数据。对于同步失败的数据支持重试和关联操作,重试就是手动触发重新同步,关联是手动选择本企业和相关企业同步的数据映射关系。
2.3同步设置
同步设置即数据同步异常通知设置,进入 同步设置, 开启即可按提示添加对应的通知人员。
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719654117674/image.png)
2.4历史数据同步
历史数据同步可通过右上角新建按钮,创建历史数据同步任务,创建同步任务界面如下截图:
![](https://help-cdn.fxiaoke.com/t/e77d24d5-3d21-4bbc-8ec5-886214579a51/u/7d0ff442-82b6-4ab8-b498-4d5192ec6f12/1719654134948/image.png)
同步策略支持选择当前数据同步所有策略,选择后,目标企业(策略为下发)/数据源企业(策略为采集)需要输入对应的企业ID(即企业ei),多个企业用英文逗号隔开;
任务类型支持按时间段、按源主属性字段、按对象数据范围三类,按时间段即指将选择时间段内的数据做数据同步到目标企业/上游企业;按源主属性字段即按数据ID方式将数据同步到目标企业/上游企业,每次最多不超过1000个;按对象数据范围即可以通过条件过滤设置主/从(如果有)的数据范围,将数据同步到目标企业/上游企业;