MySQL和钉钉单据接口对接

MySQL和钉钉单据接口对接

数据源系统:钉钉

钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。

写入目标:MySQL

MySQL是一个关系型数据库管理系统，由瑞典MySQLAB公司开发，属于Oracle旗下产品。MySQL是最流行的关系型数据库管理系统之一，在WEB应用方面，MySQL是最好的RDBMS(RelationalDatabaseManagementSystem，关系数据库管理系统)应用软件之一。

系统对接接口配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：钉钉，并且选择对应的连接器（关于钉钉的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的获取流程实例（宜搭）接口作为数据对接来源。然后再通过写入目标平台配置目标系统为MySQL，并且选择对应连接器。选择对应的执行操作-v1接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
 

钉钉接口明细

• 接口：v1.0/yida/processes/instances
• 接口名称：获取流程实例（宜搭）
• 接口方法：POST

请求参数

字段	名称	类型	描述
pageNumber	分页页码	string	分页页码
pageSize	分页大小	string	分页大小
appType	应用ID	string	应用ID
systemToken	应用秘钥	string	应用秘钥
userId	用户的userid	string	用户的userid
language	语言	string	语言，取值：zh_CN：中文（默认值）en_US：英文
formUuid	表单ID	string	表单ID
searchFieldJson	条件	object
searchFieldJson.textField_kspgl3w6	流水号	string
searchFieldJson.originatorId	根据流程发起人工号查询	string	根据流程发起人工号查询
searchFieldJson.createFromTimeGMT	创建时间起始值	string	创建时间起始值
searchFieldJson.createToTimeGMT	创建时间终止值	string	创建时间终止值
searchFieldJson.modifiedFromTimeGMT	修改时间起始值	string	修改时间起始值
searchFieldJson.modifiedToTimeGMT	修改时间终止值	string	修改时间终止值
searchFieldJson.taskId	任务ID	string	任务ID
searchFieldJson.instanceStatus	实例状态	string	实例状态
searchFieldJson.approvedResult	流程审批结果	string	流程审批结果

响应参数

字段	名称	类型	描述
gmtCreate	创建时间	string
gmtModified	最近修改时间	string
originatorUserId	创建人ID	string
originator	创建人	string
attachmentField_knh4jlom	附件	string
textField_krri0c3m	月周	string
dateField_kzdsg96q	（出纳）实际支付时间	string
dateField_kmo8rpow	支付日期	string
textField_kqkdqdss	编码	string
selectField_kqhc3rpp	名称	string
selectField_kqhc3rpo	收付款类型	string
textField_kr4skn4t	银行编码	string
selectField_kq97ayh5	支付账号	string
selectField_kq97ayh4	银行名称	string
selectField_kq8ryql2	支付账户	string
selectField_ksu1wqm5	使用组织	string
textField_kqvm6slb	银行账号（支付宝账号）	string
textField_kqupzsd4	开户行信息（平台）	string
textField_kqupzsdb	账户名（姓名）	string
textField_kqupzsd9	姓名（或公司名称）	string
selectField_kquro2hj	银行账号（支付宝账号）	string
selectField_kquro2hi	开户行信息（平台）	string
selectField_kquro2hh	账户名（姓名）	string
textField_kquro2hk	姓名（或公司名称）	string
textField_krve7dxt	领取人ID	string
selectField_krve7dxs	现金领取人	string
textField_ksgri8vy	支付方式编码	string
selectField_kquro2h6	是否使用已有银行卡（账号）	string
selectField_kmo8rpov	支付方式	string
textareaField_kmo8rpox	支付备注	string
textField_kr0dr2qg	大写金额	string
numberField_kmo8rpou	金额	string
textField_kymebdj1	同类型超额	string
selectField_l094uooz	是否培训费	string
textField_krvpf8fl	费用付款组织编码	string
selectField_krvpf8fk	费用付款组织	string
textField_l094uop0	OA培训费申请审批单号	string
textField_kxpgmv0d	当前月份	string
selectField_kzfb3nrj	预算部门	string
selectField_kmo8rpot	费用类型	string
numberField_kniuzfrc	总借支金额	string
numberField_kniuzfra	其他专项费用已借支金额	string
numberField_kniuzfr8	运营费用已借支金额	string
numberField_kniuzfr6	管理费用已借支金额	string
textField_krfouieg	会计ID	string
textField_krk92v7t	部门中的子部门ID（报表使用）	string
textField_krx3me1l	财务BP ID	string
textField_krfouiei	事业群负责人ID	string
textField_kzjhkyl7	C级负责人	string
textField_krfouieh	项目决策层ID	string
textField_kzij3gkp	会计主管ID	string
textField_ksgri8vw	部门ID	string
textField_krvpf8fh	申请组织编码	string
textField_krvpf8fg	费用申请组织	string
textField_krjz186m	员工ID	string
textField_kqgnbecs	人员层级	string
selectField_kowwh082	预算类型	string
textField_kspgl3w6	流水号	string
selectField_kmvroghv	借支人部门	string
textField_kmvroghw	借支人	string
textField_kmspnafz	申请人	string
text_klkn4yn7		string
tableField_ks8a1ak1	费用明细	array
tableField_ks8a1ak1.textField_kr37axo2	费用明细-费用承担组织编码	string
tableField_ks8a1ak1.textField_kwjz1agw	费用明细-费用承担部门编码	string
tableField_ks8a1ak1.textField_ks8a1ak6	费用明细-费用项目金蝶编码	string
tableField_ks8a1ak1.textField_kxpgmv0e	费用明细-预算科目编码	string
tableField_ks8a1ak1.radioField_ks9ozzfv	费用明细-是否充值到补单平台	string
tableField_ks8a1ak1.numberField_kxpgmv0f	费用明细-可用余额	string
tableField_ks8a1ak1.numberField_ks8a1ak5	费用明细-金额	string
tableField_ks8a1ak1.selectField_kwjz1agv	费用明细-费用承担部门	string
tableField_ks8a1ak1.selectField_kniam5ik	费用明细-费用承担组织	string
tableField_ks8a1ak1.textField_kveukayu	费用明细-费用项目说明	string
tableField_ks8a1ak1.selectField_ks8a1ak4	费用明细-费用项目	string
tableField_ks8a1ak1.selectField_ks8a1ak3	费用明细-费用类别	string

MySQL接口明细

• API：execute
• NAME：执行操作-v1
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
main_params	主参数
main_params.serial_number	流水号	{{textField_kspgl3w6}}
main_params.applicant	申请人	{{textField_kmspnafz}}
main_params.applicant_dept	申请部门	{{textField_ksgri8vw}}
main_params.budget_dept	预算部门	{{selectField_kzfb3nrj}}
main_params.budget_month	预算月份	{{textField_kxpgmv0d}}
main_params.receive_name	收款人或公司名称	function case '{{textField_kquro2hk}}' when '' then '{{textField_kqupzsd9}}' else '{{textField_kquro2hk}}' end
main_params.receive_account	收款账户	_function case '{{selectField_kquro2hh}}' when '' then '{{textField_kqupzsdb}}' else '{{selectField_kquro2hh}}' end
main_params.receive_account_number	收款账号	function case '{{selectField_kquro2hj}}' when '' then '{{textField_kqvm6slb}}' else '{{selectField_kquro2hj}}' end
main_params.receive_account_bank	开户银行	_function case '{{selectField_kquro2hi}}' when '' then '{{textField_kqupzsd4}}' else '{{selectField_kquro2hi}}' end
main_params.extend_params_1	1:1扩展参数	tableField_ks8a1ak1
main_params.extend_params_1.lastInsertId	借款单ID	:lastInsertId
main_params.extend_params_1.cost_type	费用类型
main_params.extend_params_1.cost_class	费用类别	{{tableField_ks8a1ak1.selectField_ks8a1ak3}}
main_params.extend_params_1.cost_item_id	费用项目	111
main_params.extend_params_1.cost_undertake_org	费用承担组织	{{tableField_ks8a1ak1.textField_kr37axo2}}
main_params.extend_params_1.cost_undertake_dept	费用承担部门	{{tableField_ks8a1ak1.textField_kwjz1agw}}
main_params.extend_params_1.amount	金额	{{tableField_ks8a1ak1.numberField_ks8a1ak5}}
main_params.extend_params_1.replenishment_platform	是否充值到补单平台
main_params.extend_params_1.extend_params_2	1:N扩展参数
main_params.extend_params_1.extend_params_2.lastInsertId	借款单ID	:lastInsertId
main_params.extend_params_1.extend_params_2.pay_org	费用支出组织	{{textField_krvpf8fl}}
main_params.extend_params_1.extend_params_2.pay_account	支付账户	{{selectField_kq8ryql2}}
main_params.extend_params_1.extend_params_2.pay_account_bank	银行名称	{{selectField_kq97ayh4}}
main_params.extend_params_1.extend_params_2.pay_time	支付日期	{{dateField_kmo8rpow}}
main_params.extend_params_1.extend_params_2.real_pay_time	实际支付日期	{{dateField_kzdsg96q}}
main_params.extend_params_1.extend_params_2.pay_acconunt_number	银行编码	11
main_params.extend_params_1.extend_params_2.main_sql	主语句	INSERT INTO cc_bill_ioan ( serial_number, applicant, applicant_dept, budget_dept, budget_month, receive_name, receive_account, receive_account_number, receive_account_bank) VALUES ( <{serial_number: }>, <{applicant: }>, <{applicant_dept: }>, <{budget_dept: }>, <{budget_month: }>, <{receive_name: }>, <{receive_account: }>, <{receive_account_number: }>, <{receive_account_bank: }>);
main_params.extend_params_1.extend_params_2.extend_sql_1	1:1扩展语句	INSERT INTO cc_bill_ioan_cost_detail (ioan_id, cost_type, cost_class, cost_item_id, cost_undertake_org, cost_undertake_dept, amount, replenishment_platform) VALUES (<{lastInsertId: }>, <{cost_type: }>, <{cost_class: }>, <{cost_item_id: }>, <{cost_undertake_org: }>, <{cost_undertake_dept: }>, <{amount: }>, <{replenishment_platform: }>);
main_params.extend_params_1.extend_params_2.extend_sql_2	1:N扩展语句	INSERT INTO cc_bill_ioan_payment_detail (ioan_id, pay_org, pay_account, pay_account_bank, pay_acconunt_number, pay_time, real_pay_time) VALUES (<{lastInsertId: }>, <{pay_org: }>, <{pay_account: }>, <{pay_account_bank: }>, <{pay_acconunt_number: }>, <{pay_time: CURRENT_TIMESTAMP}>, <{real_pay_time: }>);

系统集成总览

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。