钉钉和金蝶云星空接口打通对接实战

数据源平台:钉钉
钉钉(DingTalk)是阿里巴巴集团打造的企业级智能移动办公平台,是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合,打造简单、高效、安全、智能的数字化未来工作方式,助力企业的组织数字化和业务数字化,实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。
集成系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接口方案配置
数据集成平台对应的配置钉钉与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据钉钉的接口参数要求记录在轻易云集成平台。第二步配置钉钉与金蝶云星空之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。

钉钉接口明细
- 调用接口:topapi/v2/user/get
- 接口名称:获取通讯录
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
userid | 用户的userid | string | |
language | 通讯录语言 | string | zh_CN |
dep_strategy | 部门集成策略ID | string | 193da10a-c901-3466-b5b6-b741021e04ce |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
userid | 员工的userid | string | |
unionid | 唯一标识 | string | |
name | 员工名称 | string | |
avatar | 头像 | string | |
state_code | 国际电话区号 | string | |
manager_userid | 员工的直属主管 | string | |
mobile | 手机号码 | string | |
hide_mobile | 是否号码隐藏 | string | |
telephone | 分机号 | string | |
job_number | 员工工号 | string | |
title | 职位 | string | |
email | 员工邮箱 | string | |
work_place | 办公地点 | string | |
remark | 备注 | string | |
login_id | 专属帐号登录名 | string | |
exclusive_account_type | 专属帐号类型 | string | |
dept_id_list | 所属部门ID列表 | array | |
dept_id | 部门ID | string | |
order | 员工在部门中的排序 | string | |
extension | 扩展属性 | string | |
hired_date | 入职时间 | string | |
active | 是否激活了钉钉 | string | |
real_authed | 是否完成了实名认证 | string | |
senior | 是否为企业的高管 | string | |
admin | 是否为企业的管理员 | string | |
boss | 是否为企业的老板 | string | |
leader_in_dept | 员工在对应的部门中是否领导 | array | |
leader_in_dept.dept_id | 部门 | string | |
leader_in_dept.leader | 是否是领导 | string | |
leader_in_dept.role_list | 角色列表 | array | |
leader_in_dept.role_list.id | 角色ID | string | |
leader_in_dept.role_list.name | 角色名称 | string | |
leader_in_dept.role_list.group_name | 角色组名称 | string | |
金蝶云星空接口明细
- 调用接口:batchSave
- 接口名称:员工新增
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FName | 名称 | string | {{name}} |
FNumber | 编码 | string | {{unionid}} |
FUseOrgId | 使用组织 | string | 2.01 |
FCreateOrgId | 创建组织 | string | 2.01 |
FStaffNumber | 员工编号 | string | {{userid}} |
FormId | 业务对象表单Id | string | BD_Empinfo |
Operation | 执行的操作 | string | BatchSave |
IsAutoSubmitAndAudit | 提交并审核 | bool | true |
IsVerifyBaseDataField | 验证基础资料 | bool | false |
数据对接效果
全新的API数据集成模式,赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式,基于全新API战略中台的API新型集成方式通过解耦系统资源,降低系统间对接难度,实现快速业务需求响应,提升对接效率,助力企业满足快速业务交付需求,实现业务创新。通过构建API生态,助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产,可实现内部资源共享,满足内部开发人员资源使用需求,例如:金蝶云星空与钉钉之间数据集成;并将API资源对外可控开放,打造面向开发者的生态服务,为您打通自身和上下游合作伙伴,创造共赢价值链。开展API战略中台,重塑IT 帮助您基于内部资源构建不同业务能力中心,打造企业统一API战略中台,赋能企业发展,实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时,无需从“零”组建各业务模块,提升开发效率,重塑IT组织及交付能力。
