分享人：处轩，钉钉连接平台技术负责人
视频地址：一键回看
目录
一、OA审批使用连接平台基础入门
二、OA审批使用连接平台连接自建系统
三、OA审批通过连接平台连接传统IT系统
四、Q&A
正文
在OA审批场景下，使用钉钉连接平台的效果如何？下面是上海某网络科技有限公司使用连接平台的前后对比。
使用连接平台前
- 通过复制黏贴EXCEL表格的方式，走金蝶云星空供应商付款申请；
- 由于是人工作业，步骤繁琐，当数据量较大时，容易出现重复数据、数据出错等问题；
- 用传统的系统集成方式进行应用连接，不仅耗时长、成本高，严重影响企业的日常运营。
使用连接平台后
- 通过连接平台集成之后，用户仅仅需要5分钟就能实现钉钉与云星空的异构；
- 通过钉钉后台就能轻松实现供应商(银行等)付款流程，步骤更简单、耗时短、数据实时检测，提升企业运营效率。
那么在OA审批场景下，如何通过钉钉连接平台实现系统互通呢？
一、OA审批使用连接平台基础入门
OA审批与连接平台的关系
- 应用层
包括钉钉官方应用、钉钉三方应用、知名厂商系统和企业自建系统； - 连接平台
每个应用的接口注册到连接平台，并通过参数映射方式封装成执行动作和集成流，发送到审批层； - 审批
在表单和流程中通过使用执行动作和集成流实现连接三方系统的效果。
OA审批使用连接器的基础概念
配置触发条件
- 触发条件可以理解为触发时机，表示在使用表单或流程某一个过程中去触发连接器，比如审批提交时、审批执行同意时；
- 执行触发条件时，会把当前表单和流程的数据一起带给连接器；
选择连接器和执行动作
- 连接器列表为当前企业在连接平台可用的连接器，包括了三方、官方和自建；
- 执行动作为当前连接器下的执行动作；
配置执行动作
- 配置执行动作，把表单、流程的数据与执行动作参数做映射连接；
- 执行连接器时，会根据你配置的数据映射做数据转换；
- 比如表单提交时发送一个工作通知，配置执行动作会将表单中的人员字段连接到工作通知的人员字段，在执行连接器时会根据配置的数据映射进行数据转换和传输。
OA审批使用连接器基础流程
选择触发条件
表单中触发条件：
- 新建表单加载时触发，主要为初始化表单初始化；
- 控件值变化时触发，主要为回填表单数据；
- 表单提交时触发，主要为校验表单是否提交；
流程中触发条件：
- 执行到连接器节点时触发，主要为同步表单数据；
- 审批同意触发，主要为校验审批人是否可以点击同意按钮；
- 执行到审批节点时触发，主要为审批人从连接器中获取；
配置连接器
选择连接器和执行动作：
- 选择连接器，表示要连接哪个系统，如连接宜搭就选择宜搭连接器；
- 连接器下的执行动作，表示要干什么，如新增宜搭表单；
配置执行动作
- 填写以下控件的值获取数据：把审批数据和执行动作的入参做映射，将审批的数据按规则传给连接器；
- 获取的数据填充到以下控件：把连接器获取的数据按规则填充到审批。
使用
- 使用连接器：按照配置的规则使用连接器，如果出现小圆圈，表示已经触发连接器；
- 错误日志查询：开发者后台-连接平台-执行记录；
- 使用连接器：按照配置的规则使用连接器，如果出现小圆圈，表示已经触发连接器；
最佳实践
最佳实践一：通过AI能力自动识别增值税发票
- 在OA审批中，使用连接平台中的AI连接器；
- 用户在OA审批一键上传发票，自动识别发票金额、账户等信息回填到表单组件。通过连接平台，使发票信息填写效率提升90%+。
操作步骤
步骤一：创建OA审批表单
- 登录钉钉OA管理后台；
- 依次选择工作台-应用管理，单击OA审批；
- 选择创建新表单，然后选择流程表单；
- 在基础设置界面填写基本信息，包括表单名称和所在分组；
在表单设计界面，设计并添加OA审批表单控件，然后选择连接器-配置连接器；
注意：需要在表单设计器中添加图片控件。
步骤二：配置AI能力连接器
在配置连接器界面，选择触发事件为控件值发生变化时，绑定触发事件控件并保存，单击下一步；
说明：在填写审批表单时，因为要获取图片控件值发生变化时的事件，所以在设置触发事件时，需要绑定表单中的图片控件。
在选择连接器界面，依次选择AI能力-增值税发票识别，单击下一步；
说明：钉钉不仅提供增值税发票识别的能力，也提供了AI的其他能力，包括文本翻译、OCR文字识别和ASR一句话语音识别，详情请参考AI概述。
- 在配置执行动作界面，单击下拉框控件，在表单字段下选择表单字段；
在配置执行动作界面，单击添加，将获取的数据填充到表单控件中，然后单击保存；
注意：在设置绑定表单控件值时，请根据实际需求一对一绑定对应的参数字段，否则可能会出现赋值不匹配。
- 表单绑定AI能力连接器成功后，单击发布，完成全部配置；
体验流程
- 进入钉钉工作台-OA审批，找到步骤一配置的审批表单；
选择需要识别的增值税发票，系统会自动识别图片中的内容并自动填充到对应的空间中；
注意：AI在识别过程中可能会因为图片的清晰度、拍摄时的光照强度、图片拍摄角度、图片有遮挡等多种因素影响，未能识别出图片数据或识别错误。为保证图片识别的准确度，请尽量选择清晰的图片。
- 最后单击提交，完成审批业务流程。
最佳实践二：审批通过后发送工作通知
- OA审批使用连接平台中的工作通知连接器；
- 在一项公司政策审批通过后，向指定人员或者部门自动发送工作通知，无需@所有人或者一个个的去通知。
操作步骤
步骤一：创建工作通知审批表单
- 登录钉钉OA管理后台；
- 依次选择工作台-应用管理，单击OA审批；
- 单击创建新表单，选择流程表单；
- 基础设置界面填写基本信息，包括表单名称和所在分组；
- 在表单设计界面添加表单控件，完成表单界面设计；
步骤二：配置工作通知连接器
- 进入流程设计界面，单击审批人节点后的“+”新增一个连接器；
- 在弹出的连接器选择页面选择工作通知连接器和发送工作通知[文本消息]执行动作，然后单击下一步；
在配置执行动作下，绑定表单控件的值用于获取数据，最后单击保存；
说明：
- 控件是根据选择的连接器生成，且无法自行修改；
- 绑定的连接器控件值，可在连接器市场对应连接器中查看，可根据需求依次选择设置图标-自定义，自定义连接器控件值：
- 微应用id：选择自定义，填写获取的H5微应用AgentId；
- 接收者的部门id列表：选择自定义，填写实际部门id；
- 在流程设计界面，单击发布，即可完成审批单的配置；
体验流程
- 进入钉钉工作台-OA审批，找到步骤二配置的审批表单；
- 填写审批表单信息，单击提交进入审批流程；
- 当审批流程通过后，企业内所有人员会收到一条工作通知。
二、OA审批使用连接平台连接自建系统
操作步骤
步骤一：连接平台创建连接器
- 创建自建连接器。入口：连接平台-连接器-创建连接器。
- 配置执行动作。入口：连接平台-连接器-创建连接器。
步骤二：OA审批配置连接器
- 选择触发条件：根据自身的应用场景选择触发条件；
- 选择连接器：选择自建的连接器；
- 配置执行动作：配置执行动作入参与出参映射；
步骤三：开始使用
- 使用连接器：按照配置的规则使用连接器，如果出现小圆圈，表示已经触发连接器；
- 错误日志查询，入口：开发者后台-连接平台-执行记录。
最佳实践
最佳实践一：表单和自建系统数据实现数据联动
- OA审批使用自建连接器实现与内部系统数据实现数据联动；
- 用户在OA审批自动完成内部系统客户列表拉取，客户信息填充，无需再手动录入，提高效率、减少失误。
操作步骤
步骤一：创建自定义连接器
- 登录开发者后台；
- 依次选择开放能力-连接平台，然后选择连接器；
- 单击创建连接器，填写基本信息，单击确定；
步骤二：配置连接器执行工作
- 选择连接器，然后选择已创建好的连接器；
- 选择执行动作，单击创建执行动作；
填写执行动作基础信息，单击下一步；
说明：接口路径填写自身系统内部的真实接口。
- 在入参配置界面，根据接口的实际入参填写，然后单击下一步；
- 在出参配置界面，根据接口的实际出参填写，然后单击发布；
- 配置根据客户ID获取客户详情执行动作，配置步骤请参考配置第一个执行动作步骤；
步骤三：配置OA审批表单
- 登录钉钉OA管理后台；
- 依次选择工作台-应用管理，然后单击OA审批；
- 选择创建新表单，然后选择流程表单；
- 在基础设置界面填写基本信息，包括表单名称和所在分组；
步骤四：配置自定义连接器
在表单设计界面，设计并添加OA审批表单控件后，依次选择连接器-配置连接器：
- 客户连接器：选择单选框基础控件，搜索客户、客户名称、手机号、年龄，选择单行输入框基础控件；
- 在配置连接器界面设置触发条件下，绑定触发事件的控件并确定，单击下一步；
在配置连接器界面选择连接器下，依次选择数据联动连接器-根据名字模糊搜索客户，然后单击下一步；
说明：数据联动连接器为步骤一自定义的连接器，根据名字模糊搜索客户为步骤二自定义的执行动作。
- 设置填写以下控件的值获取数据，将name绑定搜索客户；
- 设置获取的数据填充到以下校验结果，将customerId、name分别填充到“客户列表.选项列表.ID列表”、“客户列表.选项列表.值列表”，并单击保存；
- 配置第二个连接器请参考配置第一个连接器操作步骤；
- 审批表单配置完成后，单击发布；
步骤五：填写审批表单
- 进入钉钉工作台-OA审批，找到步骤三配置的审批表单；
- 实现表单和自建系统数据联动效果。
最佳实践二：出库审批同意时，校验库存是否足够
- 团队成员通过OA审批提交商品出库审批；
- 在管理员点击同意时，自动校验企业内部系统数据是否足够，阻断审批同意。
操作步骤
步骤一：创建连接器
- 登录开发者后台；
- 依次选择开放能力-连接平台，然后选择连接器；
- 单击创建连接器，填写基本信息，单击确定；
步骤二：配置连接器执行动作
- 选择连接器，然后选择已创建好的连接器；
- 选择执行动作，单击创建执行动作；
填写执行动作基础信息，单击下一步；
说明：接口路径请填写自身系统内部的真实接口。
- 在入参配置界面，根据接口的实际入参填写，然后单击下一步；
- 在出参配置界面，根据接口的实际出参填写，然后单击发布；
- 配置获取所有商品执行动作步骤，请参考配置第一个执行工作步骤；
步骤三：配置OA审批表单
- 登录钉钉OA管理后台；
- 依次选择工作台-应用管理，然后单击OA审批；
- 选择创建新表单，然后选择流程表单；
- 在基础设置界面填写基本信息，包括表单名称和所在分组；
步骤四：配置自定义连接器
在表单设计界面，设计并添加OA审批表单控件后，依次选择连接器-配置连接器：
- 物资：选择单行输入框基础控件；
- 数量：选择数字输入框基础控件；
- 在配置连接器界面设置触发条件下，选择新建表单加载时，单击下一步；
在配置连接器界面选择连接器下，依次选择库存系统连接器-获取所有商品，然后单击下一步；
说明：库存系统连接器为步骤一自定义的连接器，获取所有商品为步骤二自定义的执行动作。
- 设置获取的数据填充到以下控件下，选择添加将goodId、goodname分别填充到物资.选项列表.ID列表、物资.选项列表.值列表，并单击保存；
步骤五：OA审批流程设计
- 在流程设计界面，单击审批人节点，并选择高级设置；
在连接器校验条件配置界面，依次选择库存系统连接器-校验商品库存是否足够，然后单击下一步；
说明：库存系统连接器为步骤一自定义的连接器，校验商品库存是否足够为步骤二自定义的执行动作。
- 在连接器校验条件界面，设置填写以下控件的值获取数据，将number、goodId分别绑定数量、物资.物资ID；
- 在连接器校验条件界面，设置获取的数据填充到以下校验结果，将result、msg分别填充到校验结果、校验错误信息，并单击保存；
- 审批表单配置完成后单击发布；
步骤六：发起OA审批
- 进入钉钉工作台-OA审批，找到步骤三配置的审批表单；
填写OA审批相关信息，单击提交；
说明：物资申请表单中的数量填写应大于实际库存。
- 当进行审批同意时，弹出库存不足提醒。
三、OA审批通过连接平台连接传统知名IT系统
基础概念
- 服务商是钉钉连接平台的合作伙伴，以公司为单位；
- 服务商基于连接平台开放能力，与连接平台共建，实现与传统知名的IT系统的集成互通。
OA审批流程
连接平台订阅对应的连接器
- 路径：在连接平台-连接器市场订阅对应连接器；
- 按照连接器提示完成相应步骤；
提示：如果有模版变量，请联系对应服务商。
OA审批配置连接器
- 选择触发条件：根据自身应用场景选择触发条件；
- 选择连接器：选择已订阅的连接器；
- 配置执行动作：配置执行动作入参与出参映射；
开始使用
- 使用连接器：按照配置的规则使用连接器，如果出现小圆圈，表示已经触发连接器；
- 错误日志查询，入口：开发者后台-连接平台-执行记录。
- 使用连接器：按照配置的规则使用连接器，如果出现小圆圈，表示已经触发连接器；
最佳实践
最佳实践一：审批费用单自动同步至畅捷通
财务单据同步的痛点
伴随公司发展和数字化水平提高，大量的财务单据需要手动审核和录入，其企业原有财务单据同步上报过程如下:
- 首先员工需要分别录入信息提交OA审批；
- 审批通过后，通过企业支付，公司财务人员确定支付；
- 出纳会将支付内容汇总提交给运营进行手动录入到T+Cloud中；
- T+Cloud生成财务单据，财务人员再进行财务汇总；
- 这些重复机械的操作占据大量人力，同时极容易出现数据出错或丢失等情况，严重影响着企业经营效率；
集简云&钉钉融合解决方案
使用集简云提供服务的钉钉连接器，完成财务单据同步，业务流程简单且灵活，大大降低了相同流程的时间和精力，大幅减少了人工采集环节，财务管理系统内财务单据同步生成，为畅捷通T+Cloud企业的发展和成长升级赋能。
操作步骤
步骤一：安装并购买集简云应用
在钉钉应用中心搜索集简云，点击安装并购买；
步骤二：授权应用账户
在集简云完成账户授权获取AccountKey。
- 进入集简云界面，绑定用户手机号；
授权畅捷通T+Cloud；
- 在集简云界面-应用管理，搜索畅捷通T+Cloud；
- 进入畅捷通T+Cloud界面，选择产品，单击去开通；
- 返回集简云应用列表界面，找到畅捷通T+Cloud，点击下图红框中的按钮获取AccountKey，将AccountKey复制备用；
步骤三：订阅畅捷通T+Cloud连接器
- 进入钉钉连接器平台-连接器市场，找到畅捷通T+Cloud集简云连接器，点击订阅；
- 订阅后畅捷通T+Cloud连接器就会出现在OA审批连接器列表中；
步骤四：创建钉钉审批
在钉钉OA审批后台配置审批表单、审批字段，填写集简云AccountKey。
- 进入钉钉OA审批界面，单击创建新表单；
- 在基础设置界面填写基本信息；
进入表单设计界面，设计并添加OA审批表单控件；
建议：将费用类型、票据类型这些固定字段选项设置成下拉选项，并标注畅捷通编码；
进入流程设计界面，单击“+”添加步骤-连接器，选择刚刚订阅的畅捷通T+Cloud集简云连接器；
创建费用单，配置执行动作，将畅捷通创建费用单所需字段和创建表单字段进行一一对应；
注意：key字段需要改为自定义，然后将获取到的AccountKey复制填充到key对应字段；
- 配置完成后，保存并发布；
步骤五：提交审批单
提交OA审批审批单及时同步到畅捷通T+Cloud；
- 进入钉钉OA审批界面，找到步骤四创建的审批单，填写并提交审批单；
- 提交成功后，对审批单进行审批确认操作；
- 审批完成后进入畅捷通后台，可以看到刚确认的审批单对应的销售费用单据。
四、Q&A
Q：关于连接器实操部分的教程可以在哪里找到？
A：在钉钉开放平台的文档中，有关于连接器详细的实操教程，路径：钉钉开放平台-开发文档-连接平台。
Q：连接器的原理主要是钉钉从第三方的接口来获取数据吗？
A：企业或第三方将接口提供给钉钉连接平台，就可以通过连接平台实现数据互通。
Q：非钉钉专业版是否可以使用OA审批连接器？
A：目前只有钉钉专业版可以在OA审批场景中使用连接器。
Q：钉钉官方应用管理参数在哪里查看？
A：在钉钉连接市场中有很多官方连接器，进入连接器选择所需触发事件或执行动作，点击进入可以查看到对应的参数。
Q：连接平台可以连接哪些平台？
A：只要平台可以提供对外接口，都可以连接到钉钉连接平台。
Q：如果对方业务系统没有接口，连接平台是否可以连接到对方数据库？
A：目前连接平台不支持连接到数据库。
Q：在Postman配置成功后可以直接在连接平台配置吗？
A：可以。
Q：第三方接口要注册到连接器才能实现数据的互联互通？
A：是的。连接平台提供官方接口，仅限于官方能力和AI能力，如果需要连接企业自建或三方，可以将能力注册到连接平台即可使用。
Q：Postman中有很多json文件，要如何对应配置？
A：连接平台支持将出参的json文件直接导入到参数配置中。
