第三方系统组织人员中间表同步

栏目：云苍穹知识作者：金蝶来源：金蝶云社区发布：2024-09-23浏览：1

第三方系统组织人员中间表同步

1 业务场景

【背景介绍】

企业行政组织和人员变动频繁，因此需要实时同步第三方系统与星瀚之间的组织和人员信息，以确保数据一致性，减少手工录入错误，并提高操作效率。

【场景详细描述】

本案例中通过由第三方系统主动调用星瀚API，将数据同步到中间表中。然后中间表数据治理后，通过启动方案将中间表中的组织和人员数据同步到星瀚中。

2 解决方案

2.1 组织同步

步骤 1：导入相关资源

服务流程转API_预置flow_第三方组织同步中间表(对外)(KDflow_api2ierp_org_B)_8D9896.dts
服务流程_预置flow_第三方组织同步中间表(对外)(KDflow_api2ierp_org_B)_8D9899.dts
服务流程_预置flow_第三方api同步组织到中间表(主动调用)(KDflow_api2ierp_org_Z)_8D9896.dts
服务流程 预置flow 初始化中间表上级组织(KDflow initParent orgs)8D98100.dts

步骤 2：第三方系统数据变动时，调用集成API将数据写入中间表。

1 、通过集成API将数据写入中间表，API地址：

http://苍穹地址/kapi/v2/iscb/route/sf_KDflow_api2ierp_org_B

输入参数如下：

{
    data:[
        {
        "orgid":"组织ID-必填",
        "trd_parent":"上级ID-必填",
        "number":"组织编码-必填",
        "name":"组织名称-必填",
        "from":"来源系统-选填，当只有一个第三方系统来源时可以不填，多个第三方系统则必填",
        "fcomment":"描述，选填"
        }
    ]
}

注意:第三方根组织ID请写#,同步之后会将整棵树挂在苍穹的根组织下。

步骤 3：如果苍穹根组织与第三方系统根组织相同，需要执行以下操作。

（1）找到元数据【isc_api2ierp_org】中第三方的根组织id，将【苍穹id反写】字段设置为100000

（2）集成方案【KD_api2ierp_orgs】转换脚本最前面增加下面一行

if(src.ftrd_parent == '#'){tar.#_IGNORE_TAG = true;}

步骤 4：查看中间表数据

路径：【集成服务云】->【集成中间数据】->【第三方系统同步】->【行政组织同步】

步骤 5：发布并执行集成管理-服务流程-【KDflow_initParent_orgs】清洗数据，格式化组织上级关系。

步骤 6：启用并执行启动方案【KD_api2ierp_orgs】，将数据挂在根组织下

2.2 人员同步

步骤 1：导入/部署相关资源

服务流程转API_预置flow 第三方人员同步中间表(对外)(KDflow api2erp_user B) 8D9897.dts
服务流程_预置flow_第三方人员同步中间表(对外)(KDflow_api2erp_user_B)_8D9898.dts
服务流程_预置flow_第三方人员同步中间表(主动调用)(KDflow_api2ierp_user_z) _8D9897.dts
启动方案_预置_人员部门和上级(中间表-苍穹)_2(KD_api2ierp_user_depts_position)_FOBF96.dts
启动方案_预置_人员(中间表-苍穹)(KD api2ierp users) FOBF97.dts

步骤 2：第三方通过调用集成API将数据写入中间表

API地址：

http://苍穹地址/kapi/v2/iscb/route/sf_KDflow_api2erp_user_B

输入参数如下：

{
        data:[
        {
        "name":"姓名-必填",
        "number":"编码-必填",
        "phone":"手机号-必填",
        "mail":"邮箱-选填",
        "trd_user_id":"第三方人员唯一标识-必填",
        "gender ":"性别-必填，0保密，1男，2女",
        "enable ":"启用状态-必填，1启用，2禁用",
        "username":"用户名-选填",
        "dpt":"部门-选填，以英文逗号分隔，第一个是主职部门",
        "position":"职位-选填，按部门顺序以英文逗号分隔",
        "superior":"上级，选填，按部门顺序以英文逗号分隔",
        "mail":"邮箱-选填",
        "id_number":"身份证号，选填",
        "from":"来源系统-选填，当只有一个第三方系统来源时可以不填，多个第三方系统则必填"
        }
        ]
        }

步骤 3：查看中间表数据

路径：【集成服务云】->【集成中间数据】->【第三方系统同步】->【人员同步】