# 组织同步

# 说明

V8主动调用V5接口拉取组织信息，仅需配置V8系统

# 操作步骤

# 1、创建应用

使用租户账号在后台管理中进入三方应用集成（也可能叫连接器），点击新建

录入基础信息，请求地址需根据实际情况录入

# 2、配置接口

新增一个分类用于存放组织同步所需接口，创建1个认证接口以及分别获取单位、部门、人员接口

（注：认证接口必须存在，由于获取token方式存在多种，如无特殊需求建议使用文档配置方式即可。文档中获取单位、部门、人员接口使用V5平台已提供的对外接口，内容比较全，相对的也比较多，可以根据实际情况考虑V5侧定制开发获取三类数据的接口。字段之间的映射也可根据实际情况调整，需与同步配置中各接口的配置匹配）

# 2.1、配置认证接口

# 2.2、配置获取单位信息接口

要求结构必须一致，配置方式见配置技巧 (opens new window)

# 2.3、配置获取部门信息接口

要求结构必须一致，配置方式见配置技巧 (opens new window)

# 2.4、配置获取人员信息接口

要求结构必须一致，配置方式见配置技巧 (opens new window)

# 3、配置安全认证

使用V5平台创建的rest用户名与密码，创建文档链接 (opens new window)

Token名称必须设置为"token"
Token值选择认证接口返回参数中的id字段
V5平台token有效时长大概23分钟，此处设置为20分钟

# 4、同步配置

# 4.1、同步参数配置

# 4.2、同步内容配置

内部根节点根据项目实际情况选择，一般情况下应该是最顶层机构

示例场景使用V5集团版，外部根节点为集团ID默认值"-1730833917365171641"，如V5是企业版使用"670869647114347"
岗位和职级提前建好，使用默认值

排除外部根节点配置的ID

# 4.2.1、机构

组织id对应组织code，副组织id对应父组织code，由于使用的接口未提供这样的结构，仅提供当前单位id与上级单位id，因此将其作为组织code同步至V8，（可考虑自行开发接口）
组织类型使用默认值"INSTITUTION"

status设置内容如图

# 4.2.2、部门

请求参数映射页签中录入单位ID，由于此接口是根据单位ID获取部门，存在多个单位的情况下需要多次修改并同步数据。（可考虑自行开发接口）
组织类型使用默认值"DEPARTMENT"

status设置内容如图

# 4.2.3、人员

请求参数映射页签中录入单位ID，由于此接口是根据单位ID获取人员，存在多个单位的情况下需要多次修改并同步数据。（可考虑自行开发接口）
人员类型使用默认值"MEMBER"

人员编号默认值配置，配置名称与文档中完全一致的情况下可直接粘贴以下内容，否则根据图中含义自行配置

{
    "type": "__EXPRESS_TOKENS",
    "data": [
        {
            "controlData": null,
            "desc": "条件返回",
            "subOps": [
                [
                    {
                        "uid": "0269cdf3-83ff-42f5-8b49-4e4854c160fb",
                        "type": "FUNCTION",
                        "value": "isNotNull",
                        "desc": "不为空",
                        "subOps": [
                            [
                                {
                                    "uid": "68b5a046-a743-4a01-bb51-f68623df4984",
                                    "type": "VARIABLE",
                                    "value": "code",
                                    "desc": "参数变量.人员编号"
                                }
                            ]
                        ]
                    }
                ],
                [
                    {
                        "uid": "6f1e18e9-a07b-482c-8441-741e21832bfc",
                        "type": "VARIABLE",
                        "value": "code",
                        "desc": "参数变量.人员编号"
                    }
                ],
                [
                    {
                        "uid": "b5553077-7fc8-4cfb-8e41-32194b424659",
                        "type": "VARIABLE",
                        "value": "loginName",
                        "desc": "参数变量.登录名"
                    }
                ]
            ],
            "type": "FUNCTION",
            "uid": "de1ec0c5-aacb-45de-8464-b329954c3bc1",
            "value": "ifs",
            "g_l_index": "1"
        }
    ]
}