# 06 同步方式-接口同步
CIP组织同步在中间表和视图的基础上，新增支持基于接口的组织同步。
接口同步需要第三方系统提供符合CIP数据规范的8个固定组织数据模型（集团、单位、部门、岗位、职务、人员基础信息、人员任职信息、人员跨部门兼职信息），要求第三方接口返回数据项与其映射绑定，实现异构兼容。
# 1、将第三方接口注册到“CIP集成平台-集成资源库-第三方应用接口库(V5接口)”中，如下图（下面以预置的OA组织模型接口举例）
# 2、同步方案设置
第三方应用选择注册了组织接口的应用
同步方式选择接口同步
点击同步接口绑定
# 3、集团接口绑定
以下所有的接口绑定，如果未设置过滤，则同步接口返回的所有数据，如果设置了过滤，则只同步满足过滤条件的数据
说明：
多集团架构：第三方提供集团读取接口并注册到"接口资源库"，返回信息与CIP集团模型绑定。详细绑定内容见下表。
单集团架构：根据企业集团基本信息，为CIP集团模型设置默认值。
单一企业架构：无需为CIP集团模型设置任何绑定信息，同步时系统直接忽略集团信息。
# 4、单位接口绑定
说明：
单位数据模型必需绑定数据。对与单一企业允许绑定固定值（默认值）。
在来源应用为集团、单位、部门提供统一接口情况下，过滤设置可通过数据值区分单位
所有必填数据项，必须绑定返回参数或默认值。未绑定返回参数或返回参数值为空时，取默认值
# 5、部门接口绑定
说明：
部门数据模型必需绑定数据。
在来源应用为集团、单位、部门提供统一接口情况下，过滤设置可通过数据值区分部门。
所有必填数据项，必须绑定返回参数或默认值。未绑定返回参数或返回参数值为空时，取默认值。
不支持多维部门结构同步，一般是行政部门结构。
# 6、岗位接口绑定
说明：
岗位模型为非必要绑定模型，即允许岗位不同步。
所有必填数据项，必须绑定返回参数或默认值。未绑定返回参数或返回参数值为空时，取默认值
支持集团基准岗、单位标准岗、部门岗三种岗位同步
# 7、职务接口绑定
说明：
职务模型为非必要绑定模型，即允许职务不同步。
所有必填数据项，必须绑定返回参数或默认值。未绑定返回参数或返回参数值为空时，取默认值
职务必须归属单位
# 8、人员基本信息接口绑定
说明：
所有必填数据项，必须绑定返回参数或默认值。未绑定返回参数或返回参数值为空时，取默认值
人员基本信息仅包含人员社会属性，不含单位属性。
人员任职信息依赖于人员基本信息。同一个人员基本信息可对应一个任职信息，多个兼职信息。
# 9、人员任职信息接口绑定
所有必填数据项，必须绑定返回参数或默认值。未绑定返回参数或返回参数值为空时，取默认值
人员任职信息指该员的主岗信息，同一个人员基本信息可对应一个任职信息。
一个人员任职信息可对应0-N个兼职信息。
当来源的人员任职岗位/职务缺失时，同步将直接赋予默认值
# 10、人员兼职信息接口绑定
说明：
所有必填数据项，必须绑定返回参数或默认值。未绑定返回参数或返回参数值为空时，取默认值
人员兼职信息指该员的副岗信息，一个人员任职信息对应0-N个兼职信息。
不允许只有兼职(副岗)，没有任职（主岗）的数据。
当来源的人员兼职岗位/职务缺失时，同步将直接赋予默认值
# 11、约束条件说明
1）考虑兼容第三方应用接口与CIP规范的差异，最少必须提供2个接口：部门接口和人员接口，此种情况下人员接口必须提供任职信息。
2）接口返回数据是结构化数据，限JSON/Xml/JCOTable的任意一种。
3）接口返回数据必须能够体现组织对象的归属关系（外键关系）。如人员接口仅返回部门编码，则部门接口必须返回部门编码。
4）部门接口返回数据必须是单维度树形结构，如行政结构，不允许同一部门存在多个上级部门。
5）主岗唯一性，接口必须能标明人员的唯一主岗部门。
6）接口返回数据支持包含时间戳，以支持增量同步。
- 最多只能设置一个同步方式为接口同步的同步方案
创建人：suyj
← 05 中间表数据规范 07 补充说明 →
