钉钉连接平台速成手册.pdf

封面页（待分享）卷首语 钉钉连接平台利用低代码的配置，支持四大场景，能快速帮助企业迅捷实现系统集成和连接，降低集成实施的周期和成本。1.应用与应用互通 比如销帮帮的数据同步到 BOSS 管账，OA 审批的数据同步到宜搭；实现跨应用之间的数据互通，能力互通；2.企业与企业互通 比如母公司的数据和子公司的数据互通；实现跨组织的数据互通；3.设备与设备互通 比如设备联动，当温度高于 30 度时自动打开空调，应用和设备联动，比如当审批通过后，自动关灯等；实现跨设备互通以及设备和应用互通；4.云与云互通 比如专属钉场景，部分核心数据在企业的私有云上部署；实现跨云互通，公有云和私有云的数据互通，能力互通。本册速成手册旨在帮助开发者快速掌握连接平台在以上四大场景的应用，希望通过连接平台的能力，能帮助企业在业务数字化的道路上实现降本增效。目录 第一章：连接平台，快速实现企业系统互联互通.5 一、什么是连接平台？.5 二、连接平台的产品优势及价值.7 三、连接平台的适用场景及案例.10 四、连接平台的技术架构及概念阐释.15 第二章：企业自建场景下如何实现互联互通.19 一、连接流介绍.19 二、如何自建连接流.22 三、连接流扩展.39 第三章：OA 审批场景下如何实现系统互通.42 一、OA 审批使用连接平台基础入门.43 二、OA 审批使用连接平台连接自建系统.55 三、OA 审批通过连接平台连接传统知名 IT 系统.71 第四章：宜搭场景下如何使用钉钉连接器.79 一、宜搭与连接平台的关系.79 二、在宜搭中使用连接器.81 三、在宜搭中使用集成连接器.93 第五章：客户案例.101 一、钉钉连接平台助力凯盛浩丰迈进数字智慧农业.101 二、钉钉连接平台实现学校学生假勤场景数字化.102 三、钉钉连接平台助力企业效能提升.103 常见 Q&A.105 第一章：连接平台，快速实现企业系统互联互通 5 第一章：连接平台，快速实现企业系统互联互通 一、什么是连接平台？1.概述 钉钉连接平台，通过连接帮助企业降本增效。连接平台的愿景，是通过简单的低代码配置，帮助企业迅捷实现系统集成和连接，降低集成实施的周期和成本。2.连接平台的产品架构 下图是连接平台的整体产品架构：1)连接器 连接平台的底座是连接器，连接器是由外部系统的能力构成的，包括：官方连接器：钉钉的一方能力，比如通讯录、智能人事、机器人、考勤等构成了连接平台的官方连接器；第一章：连接平台，快速实现企业系统互联互通 6 二方连接器：阿里的二方能力，像阿里云的短信、邮箱、RDS、高德地理服务、菜鸟的物流服务等构成了连接平台的二方连接器；SaaS 连接器：比如钉钉 ISV 服务商开发的 SaaS 标品应用像财税类的销帮帮、金智 CRM、商旅类的携程等构成了连接平台的 SaaS 连接器；生态连接器：比如一些传统的知名厂商软件，像金蝶 K3，用友 u8/u9，鼎捷等，连接平台联合集成服务商一起构成连接器平台的生态连接器；自建连接器：企业自建连接器，企业内部系统，比如 ERP 系统，企业可以自建或者委托定制连接器。2)低代码场域 有了丰富的连接器生态后，在各个低代码场域，比如 OA 审批、宜搭、酷应用、氚云、简道云等，就可以通过连接平台，构建出满足不同业务场景的连接流，帮企业真正实现业务流程自动化。3)连接平台面向的人群 ISV 服务商，注册 SaaS 标品到连接平台；集成服务商，注册传统知名厂商能力到连接平台；企业内部技术人员，注册企业内部系统能力到连接平台；企业内部非技术人员，通过低代码配置构建业务场景；开发者，可以注册连接器，也可以基于丰富的连接器能力构建连接流模版，让企业低成本实现业务场景。4)连接平台的核心产品能力 连接市场；连接流管理；连接器管理；流引擎；安全中心；监控中心；稳定性。第一章：连接平台，快速实现企业系统互联互通 7 5)连接平台的商业化钉钉专业或者钉钉专属版，有些场景需要购买钉钉专业版或者钉钉专属版才能使用；集成类目，使用集成服务商提供的连接器和 SaaS 连接器，需要购买相关应用；连接流额度计费，这个目前还在进行中，请大家关注平台公告。6)连接平台支持的连接场景跨应用互通；跨企业互通；跨设备互通；跨云互通。二、连接平台的产品优势及价值 1.企业互通场景面临的挑战下图是一个真实的企业场景：客户使用了钉钉的 OA 审批、宜搭、智能报表，自建了库存系统，还购买了金蝶、金智 CRM、BOSS 管账等 SaaS 应用。针对这些应用，客户的互通诉求是：第一章：连接平台，快速实现企业系统互联互通 8 OA 审批表单的数据，可以同步到宜搭和金蝶云星空；OA 审批表单依赖自建库存系统，进行数据验证；金蝶云星辰和金智 CRM 数据互通；BOSS 管账和金智 CRM 的数据同步到智能报表，产生驾驶舱数据。基于以上诉求可以了解到，客户的互通场景是比较复杂的，有些场景依赖全代码开发，实现成本高，有些场景依赖 ISV 系统改造，周期不可控，同时还需要考虑系统稳定性安全性等问题。2.连接平台的产品优势 连接平台有三大核心产品能力，来助力企业降本增效：自动化流程，节省人力成本 将重复工作流程化和自动化，有效缩减人力成本，大大提升工作效能；多方应用互联，丰富连接场景 依托强大丰富的连接市场，实现不同类型应用与钉钉的深度连接和集成；低代码开发，快速实现连接 无需编写代码，通过最简便的方式实现连接和集成，有效缩短开发周期和开发成本。第一章：连接平台，快速实现企业系统互联互通 9 优势一：自动化流程，节省人力成本 传统方式的数据迁移（上图左）一般都是人工手动迁移，比如 OA 审批产生的线上单据希望同步到自建系统，需要通过 Excel 导入的方式来做，耗时费力，效率低下；通过连接平台（上图右）可以实现自动化同步，OA 审批产生的线上单据自动同步到目标系统，减少重复工作，缩减人力成本。优势二：多方应用互联，丰富连接场景 第一章：连接平台，快速实现企业系统互联互通 10 传统方式 比如有一个企业希望打通销帮帮和金蝶云星空的数据，客户无从感知这两个系统是否可以互通，如何进行互通，需要和 ISV 逐一进行确认，如果客户有互通的诉求，依赖双方 ISV 逐一进行对接；连接平台 有丰富的连接市场，包含了 120+的业务连接器，满足全方位的连接场景和需求。优势三：低代码开发，快速实现连接 传统的应用互联 依赖全代码开发，开发周期长，开发成本高；连接平台 支持拖拉拽的低代码方式进行快速连接，节省开发成本。三、连接平台的适用场景及案例 1.连接平台的适用场景 1)连接平台 vs 开放 API 连接平台和开放 API 是互补关系，二者的适用场景不同：第一章：连接平台，快速实现企业系统互联互通 11 有代码研发能力且已有开发经验的客户和服务商可选择开放 API 进行全代码的方式集成；无代码能力和开发经验的客户可选择连接平台实现零（低）代码的简单高效集成。2)连接平台核心场景 连接平台的核心场景是低代码场景，比如 OA 审批，宜搭，氚云，简道云，酷应用等。2.连接平台的连接场景 连接平台的核心连接场景可以概括为四类：1)应用与应用互通 比如销帮帮的数据同步到 BOSS 管账，OA 审批的数据同步到宜搭；核心：实现跨应用之间的数据互通，能力互通。2)企业与企业互通 比如母公司的数据和子公司的数据互通；核心：实现跨组织的数据互通。3)设备与设备互通 比如设备联动，当温度高于 30 度时自动打开空调，应用和设备联动，比如当审批通过后，自动关灯等；第一章：连接平台，快速实现企业系统互联互通 12 核心：实现跨设备互通以及设备和应用互通；4)云与云互通 比如专属钉场景，部分核心数据在企业的私有云上部署；核心：实现跨云互通，公有云和私有云的数据互通，能力互通。3.核心场景案例 【案例一】OA 审批 OA 审批是钉钉官方的高频场景之一，OA 审批打通连接平台，通过配置连接器可以实现应用互通，设备互通等场景。连接场景 1：官方和官方应用互通，具有代表性场景有：发票审批单，依赖 OCR 连接器识别发票后，自动将发票抬头，金额等信息回填审批单；审批通过后创建日程；审批通过后发送工作通知。第一章：连接平台，快速实现企业系统互联互通 13 连接场景 2：官方和三方应用互通，具有代表性的场景有：出差审批单通过后，自动同步数据到携程商旅，进行订机票，订酒店等；报销单审批通过后，自动同步数据到畅捷通，进行账目管理。连接场景 3：官方和企业自建系统互通，具有代表性的场景有：和自建系统实现数据联动 比如：一个物品领用表单，有两个单选框控件，其中一个叫“物品分类”，另一个叫“物品名称”，当用户选择其中一种物品分类后，调用自建系统连接器获取到当前分类下所有的“物品名称”填充到物品名称单选框。和企业内部库存系统的打通 比如：当用户提交一个物品领用表单时，依赖自建库存系统连接器，查询库存余额来决定是否可以提交表单成功。和企业的门禁系统打通 比如当请假申请单通过后，依赖自建系统连接器赋予门禁权限。【案例二】宜搭 宜搭是钉钉官方的高频场景之一，宜搭打通连接平台，通过配置连接器可以实现应用互通，设备互通等场景。连接场景 1：官方和官方应用互通，具有代表性的场景有：当表单审批通过后，发起待办。比如会议审批单通过后，发起参会人的待办任务；当企业通讯录信息发生变化时，生成表单数据。比如员工入职流程；当 OA 表单审批通过，自动同步数据到宜搭，可以使用宜搭的数据报表功能。第一章：连接平台，快速实现企业系统互联互通 14 连接场景 2：官方和三方应用互通，具有代表性的场景有：当表单审批通过后，自动同步数据到 BOSS 管账；当表单审批通过后，自动同步数据到金蝶云星空。连接场景 3：官方应用和设备互通，具有代表性的场景：当表单审批通过后，进行设备操作。比如大楼的安保同学提交一个关闭全部空调的表单，审批通过后，自动将整个大楼的所有空调都关闭。【案例三】连接平台 在连接平台，可以创建连接流，来实现一些复杂的业务场景。连接平台支持定时触发，节点过滤，分支条件等复杂逻辑。连接场景 1：官方和官方互通，具有代表性的场景有：预定会议室成功后，通过钉钉机器人发送消息到钉钉群；定时查询智能人事信息，满足设定条件后，发起待办任务。比如，实习期最后一周，提醒主管进行实习成果验收。连接场景 2：官方和企业自建系统互通，具有代表性的场景有：企业 SAP 数据同步到宜搭；OA 审批附件同步到自建系统；企业 ERP 系统数据同步到智能报表，生成驾驶舱数据。连接场景 3：三方和三方应用互通，具有代表性的场景有：销帮帮的产品，客户，项目信息同步到 BOSS 管账；有成 CRM 的客户，产品信息，同步到有成报销。第一章：连接平台，快速实现企业系统互联互通 15 连接场景 4：设备和设备互通，具有代表性的场景有：当温度高于 26 摄氏度时自动打开空调；当晚上 21 点，自动关闭窗帘。四、连接平台的技术架构及概念阐释 1.连接平台的技术架构 1)基于技术角度，连接平台有三个核心能力：a)简单高效的连接方案 无需改造系统，通过可视化参数映射快速注册连接器；支持丰富的接入协议和鉴权方式；支持模版变量，私有化部署。b)丰富灵活的连接场景 120+的连接器；一方产品无缝对接，支持 OA 审批，宜搭等 APaaS 场景；支持构建复杂业务流程。c)稳定安全的连接通道 高效的调度引擎；安全稳定的执行链路；可视化运维和监控。第一章：连接平台，快速实现企业系统互联互通 16 2)连接平台技术架构，包括以下几部分：连接平台技术架构图 a)连接方案（黄色块），包括连接器管理和安全模块：连接器管理模块：包含触发事件、执行动作、数据模型、模版参数、webhook、集成网关、可视化模型映射、执行动作二次封装、调试&日志记录、灰度&准入测试。安全模块：权限管理：比如，哪些用户可以配置连接器，哪些用户可以使用连接器等；鉴权机制：比如，APISecret，ak sk 等。b)连接场景（红色块），包括连接流管理和连接市场模块：连接流管理模块：包含业务流、集成流、连接流模版、函数表达式、过滤节点、分支节点、轮训节点、定时触发；连接市场：包含连接器市场和连接流市场，提供了丰富的连接器和连接流模版。第一章：连接平台，快速实现企业系统互联互通 17 c)连接通道（绿色块），包括流引擎、稳定性和监控中心模块：流引擎模块：包含参数校验、调度引擎、节点执行、规则引擎、历史回放、执行日志；稳定性模块：包含限流机制、降级策略、三方接口巡检、大客重保；监控中心：提供数据大盘、失败详情、日志记录、告警订阅、失败重试、批量重试的能力。2.连接平台的基础概念阐释 连接平台包含两个基础概念：连接器和连接流，如图：最下面是业务系统，比如 OA 审批、机器人、通讯录、智能人事、销帮帮、邮件等；以上这些能力，注册到连接平台会变成连接器；第一章：连接平台，快速实现企业系统互联互通 18 不同的连接器可以构建出满足不同业务场景的连接流，帮企业真正实现业务流程自动化。1)连接器 连接器（Connector）：触发事件和执行动作的集合；触发事件（Trigger）：外部系统以某种方式告诉连接平台发生了某个事件；支持定义事件的触发方式和数据格式，比如：通讯录新增用户的事件，销帮帮新增客户事件等；执行动作（Action）：连接平台调用外部系统 API 来实现某个操作。连接平台定义操作的协议类型和数据格式。比如：发送工作通知，生成报销凭证等。2)连接流 连接流（Flow）：通过可视化拖拽配置、一键订阅等高效简单的低代码方式连接多个应用系统，让重复工作自动进行；连接流分为业务流和集成流：业务（自动）流：有触发事件的连接流，支持自动运行；集成流：无触发事件的连接流，是多个执行动作的集合，支持被业务流引用。连接流模版：预置的业务流程自动化模版。钉钉连接平台，让企业系统互联更加简单高效，通过连接帮助企业降本增效。第二章：企业自建场景下如何实现互联互通 19 第二章：企业自建场景下如何实现互联互通 一、连接流介绍 1.连接流的作用 案例场景：通过钉钉 OA 审批申请一个报销单，然后将报销单数据推送到企业群，并同步到销帮帮和企业内部系统中，整个流程涉及钉钉官方应用、生态三方应用和企业内部应用。传统的方式：使用编码来实现，需要对每个节点的每个入参出参、每个 API 接口都十分了解，同时需要一台服务器部署这一数据流转的服务，过程非常复杂。使用连接流操作：在连接平台创建简单的连接流（见下图），只需将每个节点串连起来即可实现数据流转：无需代码开发即可完成三个系统数据的打通；能够将钉钉官方/生态三方的应用与企业内部系统进行相互打通；上述的流程支持逆向触发，比如由企业内部系统发起，然后自动创建钉钉/销帮帮报销单，再推送钉钉消息；通过连接流可以极大的减少开发成本。第二章：企业自建场景下如何实现互联互通 20 2.连接流的概念 连接平台分为连接器和连接流两部分；连接器包括触发事件和执行动作；连接流是以连接器的“触发事件”为输入，“执行动作”为输出的流程编排服务，从而实现应用间的数据互通；同时，连接流支持逻辑判断，根据上游节点的出参不同完成不同节点的业务逻辑、选择不同的执行动作等。第二章：企业自建场景下如何实现互联互通 21 3.连接流的特点 可视化拖拽完成流程编排；支持自定义动作、网络请求、逻辑分支等等；支持表达式完成一些复杂的逻辑判断/模型转换；能够打通钉钉-三方-企业内部之间数据流转。第二章：企业自建场景下如何实现互联互通 22 4.连接流使用场景 连接流是实现钉钉官方、三方生态、企业内部应用数据互连互通的核心桥梁。二、如何自建连接流 1.创建连接流 操作路径：钉钉开放平台-开放能力-连接平台-连接流-创建流 第二章：企业自建场景下如何实现互联互通 23 2.流编辑 在创建流页面点击确定后进入流编辑界面；操作路径：选择连接流-详情-连接流；流编辑是将各节点之间进行串连，第一个节点是触发事件，比如：会议室预定、宜搭表单更新，下一个节点是执行动作，比如：同步数据到群聊中等。3.典型场景 1)场景一：官方应用互通 【案例】会议室预定后发送机器人通知 这个案例中涉及的两个钉钉官方应用：智能会议室和机器人消息，通过连接流相互连接。第二章：企业自建场景下如何实现互联互通 24 操作步骤 第一步：创建会议室 a)进入 OA 审批页面找到“智能会议室”并点击进入；b)点击添加会议进入设置页面，填写名称、人数、描述等关键信息并点击保存；第二章：企业自建场景下如何实现互联互通 25 c)会议室创建完毕；第二步：添加机器人 a)进入群聊页面的群设置，点击智能群助手进入机器人管理页面，选择“添加机器人”；b)选择“自定义”，点击“添加”，填写名称、关键词等信息，点击“完成”；第二章：企业自建场景下如何实现互联互通 26 c)机器人添加完毕；第三步：创建连接流 a)进入开放平台，依次点击开放能力-连接平台，进入连接平台页面；b)点击左侧连接流，再点击“创建流”；c)填写名称、描述，选择业务流，并点击确定；第二章：企业自建场景下如何实现互联互通 27 d)设置触发事件，选择智能会议室-会议室预定事件；e)设置执行动作，在官方下选择机器人；执行动作选择“发送 markdown”消息，入参设置录入标题、正文、accessToken，其中标题要含关键词“会议室”；第二章：企业自建场景下如何实现互联互通 28 切换至群聊中的机器人管理页面获取 accessToken，选择刚创建的机器人；复制 webhook 连接并粘贴到聊天框内，复制 access_token 后面的部分；切回连接流界面，选择固定值将 token 粘贴入取值框，点击确定并保存。第二章：企业自建场景下如何实现互联互通 29 f)发布连接流，连接流创建完毕。第二章：企业自建场景下如何实现互联互通 30 第四步：效果展示 a)进入群聊，在搜索框搜索“智能会议室”；b)选择刚创建的会议室并选择时间预定；第二章：企业自建场景下如何实现互联互通 31 c)预定成功后有机器人发送消息到群聊。2)场景二：内部应用-官方应用互通 【案例】企业报警信息通过机器人发送到群 本案例是将企业订单支付超时告警通知，通过机器人发送到钉钉群聊，其中订单支付超时告警是企业内部应用，机器人是钉钉应用，通过连接流将两个应用互通。操作步骤 第一步：创建连接器 a)进入连接平台在左侧选择“连接器”，点击“创建连接器”；第二章：企业自建场景下如何实现互联互通 32 b)录入名称、连接、鉴权等必要信息，然后点击“确定”；c)选择刚创建的连接器，并选择“触发事件”，点击“创建触发事件”；d)设置触发事件：填写基本信息；第二章：企业自建场景下如何实现互联互通 33 模型配置，添加一个 message 字段。e)连接器创建完成。第二步：创建连接流 a)进入连接流页面，点击“创建流”，填写名称和描述并选择“业务流”；b)设置触发事件，选择刚创建的自建连接器“企业告警通知”的“消息告警通知”事件；第二章：企业自建场景下如何实现互联互通 34 c)设置执行动作，在官方下选择机器人；执行动作选择“发送 markdown”消息，入参设置录入标题、正文、Token 等重要信息，其中 AccessToken 复用会议室预定通知机器人。第二章：企业自建场景下如何实现互联互通 35 d)点击确定并发布连接流，连接流创建完毕。第三步：效果展示 a)在“我的连接器”中选择刚创建的连接器；b)选择触发事件，复制 Webhook 连接；第二章：企业自建场景下如何实现互联互通 36 c)通过 ApiPost 模拟企业内部应用调用，将 Webhook 粘贴到请求地址栏，录入必要的 message 字段并点击“发送”；d)切回群聊页面，看到机器人发送的告警通知；3)场景三：三方应用-内部应用互通 【案例】销帮帮新增客户同步到企业内部系统 销帮帮 CRM 有新增客户，需要同步客户数据到企业内部应用，在这个案例中，三方应用销帮帮通过连接流与企业内部应用进行互通，并完成业务逻辑处理。操作步骤 第一步：创建连接流 第二章：企业自建场景下如何实现互联互通 37 a)进入连接平台，点击“创建流”并填写相关信息；b)触发事件选择“销帮帮”-“新增客户”；c)删除默认的执行动作，添加“网络请求”，填写业务系统网络请求信息，选择需要的业务字段，保存并发布连接流；第二章：企业自建场景下如何实现互联互通 38 d)连接流创建完成。第二步：效果展示 a)进入销帮帮客户管理页面，并点击“新建”；b)填写客户信息并保存；c)切换到业务系统，等待触发断点，可以看到销帮帮的数据已经同步到业务系统中。第二章：企业自建场景下如何实现互联互通 39 三、连接流扩展 1.扩展一：集成流 1)操作路径：开放能力-连接平台-连接流-创建流-选择集成流；2)集成流 vs 业务流 集成流是被集成在业务中使用的，需要入参和出参，而无需触发事件；业务流可以在节点中通过引用子函数的方式引用集成流，这样可以将公用流的逻辑沉淀为集成流引入相关的业务流中以减少流的编排工作，同时为业务流的开发创造便利。第二章：企业自建场景下如何实现互联互通 40 2.扩展二：三方流 三方流是已经配置好的流，可以在连接平台的连接流市场上选择并安装使用。3.扩展三：表达式 1)操作路径：流编辑-选择节点-入参映射；2)在设置执行动作时，需要设置每个节点的出入参，下游节点的入参来自上游节点的出参，通常使用拖拽的方式操作；DML 连线 第二章：企业自建场景下如何实现互联互通 41 3)但当一些复杂场景无法直接连接出入参时，需要运用表达式；4)表达式是连接流中重要的数据映射服务，通过提供的多种函数，完成复杂模型间的数据转换，以实现复杂的逻辑转换和节点关联。表达式 第三章：OA 审批场景下如何实现系统互通 42 第三章：OA 审批场景下如何实现系统互通 【案例】在 OA 审批场景下，使用钉钉连接平台的效果如何？下面是上海某网络科技有限公司使用连接平台的前后对比。使用连接平台前：通过复制黏贴 EXCEL 表格的方式，走金蝶云星空供应商付款申请；由于是人工作业，步骤繁琐，当数据量较大时，容易出现重复数据、数据出错等问题；用传统的系统集成方式进行应用连接，不仅耗时长、成本高，严重影响企业的日常运营。使用连接平台后：通过连接平台集成之后，用户仅仅需要 5 分钟就能实现钉钉与云星空的异构；第三章：OA 审批场景下如何实现系统互通 43 通过钉钉后台就能轻松实现供应商（银行等）付款流程，步骤更简单、耗时短、数据实时检测，提升企业运营效率。那么在 OA 审批场景下，如何通过钉钉连接平台实现系统互通呢？一、OA 审批使用连接平台基础入门 1.OA 审批与连接平台的关系 应用层：包括钉钉官方应用、钉钉三方应用、知名厂商系统和企业自建系统；连接平台：每个应用的接口注册到连接平台，并通过参数映射方式封装成执行动作和集成流，发送到审批层；审批：在表单和流程中通过使用执行动作和集成流实现连接三方系统的效果。2.OA 审批使用连接器的基础概念 1)配置触发条件 触发条件可以理解为触发时机，表示在使用表单或流程某一个过程中去触发连接器，比如审批提交时、审批执行同意时；执行触发条件时，会把当前表单和流程的数据一起带给连接器。第三章：OA 审批场景下如何实现系统互通 44 2)选择连接器和执行动作 连接器列表为当前企业在连接平台可用的连接器，包括了三方、官方和自建；执行动作为当前连接器下的执行动作。3)配置执行动作 配置执行动作，把表单、流程的数据与执行动作参数做映射连接；执行连接器时，会根据你配置的数据映射做数据转换；比如表单提交时发送一个工作通知，配置执行动作会将表单中的人员字段连接到工作通知的人员字段，在执行连接器时会根据配置的数据映射进行数据转换和传输。3.OA 审批使用连接器基础流程 1)选择触发条件 表单中触发条件 新建表单加载时触发，主要为初始化表单初始化；控件值变化时触发，主要为回填表单数据；表单提交时触发，主要为校验表单是否提交。流程中触发条件 执行到连接器节点时触发，主要为同步表单数据；第三章：OA 审批场景下如何实现系统互通 45 审批同意触发，主要为校验审批人是否可以点击同意按钮；执行到审批节点时触发，主要为审批人从连接器中获取。2)配置连接器 选择连接器和执行动作：选择连接器，表示要连接哪个系统，如连接宜搭就选择宜搭连接器；连接器下的执行动作，表示要干什么，如新增宜搭表单。配置执行动作 填写以下控件的值获取数据：把审批数据和执行动作的入参做映射，将审批的数据按规则传给连接器；获取的数据填充到以下控件：把连接器获取的数据按规则填充到审批。3)使用 使用连接器：按照配置的规则使用连接器，如果出现小圆圈，表示已经触发连接器；错误日志查询：开发者后台-连接平台-执行记录；第三章：OA 审批场景下如何实现系统互通 46 4.最佳实践 【最佳实践 1】通过 AI 能力自动识别增值税发票 在 OA 审批中，使用连接平台中的 AI 连接器；用户在 OA 审批一键上传发票，自动识别发票金额、账户等信息回填到表单组件。通过连接平台，使发票信息填写效率提升 90%+。操作步骤 步骤一：创建 OA 审批表单 a)登录钉钉 OA 管理后台；b)依次选择工作台-应用管理，单击 OA 审批；第三章：OA 审批场景下如何实现系统互通 47 c)选择创建新表单，然后选择流程表单；d)在基础设置界面填写基本信息，包括表单名称和所在分组；e)在表单设计界面，设计并添加 OA 审批表单控件，然后选择连接器-配置连接器；第三章：OA 审批场景下如何实现系统互通 48 注意：需要在表单设计器中添加图片控件。步骤二：配置 AI 能力连接器 a)在配置连接器界面，选择触发事件为控件值发生变化时，绑定触发事件控件并保存，单击下一步；第三章：OA 审批场景下如何实现系统互通 49 说明：在填写审批表单时，因为要获取图片控件值发生变化时的事件，所以在设置触发事件时，需要绑定表单中的图片控件。b)在选择连接器界面，依次选择 AI 能力-增值税发票识别，单击下一步；说明：钉钉不仅提供增值税发票识别的能力，也提供了 AI 的其他能力，包括文本翻译、OCR 文字识别和 ASR 一句话语音识别，详情请参考 AI 概述。c)在配置执行动作界面，单击下拉框控件，在表单字段下选择表单字段；d)在配置执行动作界面，单击添加，将获取的数据填充到表单控件中，然后单击保存；第三章：OA 审批场景下如何实现系统互通 50 注意：在设置绑定表单控件值时，请根据实际需求一对一绑定对应的参数字段，否则可能会出现赋值不匹配。e)表单绑定 AI 能力连接器成功后，单击发布，完成全部配置。体验流程：a)进入钉钉工作台-OA 审批，找到步骤一配置的审批表单；b)选择需要识别的增值税发票，系统会自动识别图片中的内容并自动填充到对应的空间中；第三章：OA 审批场景下如何实现系统互通 51 c)最后单击提交，完成审批业务流程。注意：AI 在识别过程中可能会因为图片的清晰度、拍摄时的光照强度、图片拍摄角度、图片有遮挡等多种因素影响，未能识别出图片数据或识别错误。为保证图片识别的准确度，请尽量选择清晰的图片。【最佳实践 2】审批通过后发送工作通知 OA 审批使用连接平台中的工作通知连接器；在一项公司政策审批通过后，向指定人员或者部门自动发送工作通知，无需所有人或者一个个的去通知。操作步骤 步骤一：创建工作通知审批表单 a)登录钉钉 OA 管理后台；b)依次选择工作台-应用管理，单击 OA 审批；第三章：OA 审批场景下如何实现系统互通 52 c)单击创建新表单，选择流程表单；d)基础设置界面填写基本信息，包括表单名称和所在分组；第三章：OA 审批场景下如何实现系统互通 53 e)在表单设计界面添加表单控件，完成表单界面设计。步骤二：配置工作通知连接器 a)进入流程设计界面，单击审批人节点后的“+”新增一个连接器；b)在弹出的连接器选择页面选择工作通知连接器和发送工作通知文本消息执行动作，然后单击下一步；第三章：OA 审批场景下如何实现系统互通 54 c)在配置执行动作下，绑定表单控件的值用于获取数据，最后单击保存；说明：控件是根据选择的连接器生成，且无法自行修改；绑定的连接器控件值，可在连接器市场对应连接器中查看，可根据需求依次选择设置图标-自定义，自定义连接器控件值：微应用 id：选择自定义，填写获取的 H5 微应用 AgentId；接收者的部门 id 列表：选择自定义，填写实际部门 id；d)在流程设计界面，单击发布，即可完成审批单的配置。体验流程：a)进入钉钉工作台-OA 审批，找到步骤二配置的审批表单；b)填写审批表单信息，单击提交进入审批流程；第三章：OA 审批场景下如何实现系统互通 55 c)当审批流程通过后，企业内所有人员会收到一条工作通知。二、OA 审批使用连接平台连接自建系统 1.操作步骤 步骤一：连接平台创建连接器 a)创建自建连接器。入口：连接平台-连接器-创建连接器；第三章：OA 审批场景下如何实现系统互通 56 b)配置执行动作。入口：连接平台-连接器-创建连接器。步骤二：OA 审批配置连接器 a)选择触发条件：根据自身的应用场景选择触发条件；b)选择连接器：选择自建的连接器；c)配置执行动作：配置执行动作入参与出参映射。步骤三：开始使用 a)使用连接器：按照配置的规则使用连接器，如果出现小圆圈，表示已经触发连接器；第三章：OA 审批场景下如何实现系统互通 57 b)错误日志查询，入口：开发者后台-连接平台-执行记录。2.最佳实践 【最佳实践 1】表单和自建系统数据实现数据联动 OA 审批使用自建连接器实现与内部系统数据实现数据联动；用户在 OA 审批自动完成内部系统客户列表拉取，客户信息填充，无需再手动录入，提高效率、减少失误。操作步骤 步骤一：创建自定义连接器 a)登录开发者后台；b)依次选择开放能力-连接平台，然后选择连接器；第三章：OA 审批场景下如何实现系统互通 58 c)单击创建连接器，填写基本信息，单击确定。步骤二：配置连接器执行工作 a)选择连接器，然后选择已创建好的连接器；b)选择执行动作，单击创建执行动作；c)填写执行动作基础信息，单击下一步；第三章：OA 审批场景下如何实现系统互通 59 说明：接口路径填写自身系统内部的真实接口。d)在入参配置界面，根据接口的实际入参填写，然后单击下一步；e)在出参配置界面，根据接口的实际出参填写，然后单击发布；第三章：OA 审批场景下如何实现系统互通 60 f)配置根据客户 ID 获取客户详情执行动作，配置步骤请参考配置第一个执行动作步骤。步骤三：配置 OA 审批表单 a)登录钉钉 OA 管理后台；b)依次选择工作台-应用管理，然后单击 OA 审批；c)选择创建新表单，然后选择流程表单；d)在基础设置界面填写基本信息，包括表单名称和所在分组。第三章：OA 审批场景下如何实现系统互通 61 步骤四：配置自定义连接器 a)在表单设计界面，设计并添加 OA 审批表单控件后，依次选择连接器-配置连接器：第三章：OA 审批场景下如何实现系统互通 62 客户连接器：选择单选框基础控件，搜索客户、客户名称、手机号、年龄，选择单行输入框基础控件。b)在配置连接器界面设置触发条件下，绑定触发事件的控件并确定，单击下一步；c)在配置连接器界面选择连接器下，依次选择数据联动连接器-根据名字模糊搜索客户，然后单击下一步；说明：数据联动连接器为步骤一自定义的连接器，根据名字模糊搜索客户为步骤二自定义的执行动作。d)设置填写以下控件的值获取数据，将 name 绑定搜索客户；e)设置获取的数据填充到以下校验结果，将 customerId、name 分别填充到“客户列表.选项列表.ID 列表”、“客户列表.选项列表.值列表”，并单击保存；第三章：OA 审批场景下如何实现系统互通 63 f)配置第二个连接器请参考配置第一个连接器操作步骤；g)审批表单配置完成后，单击发布。步骤五：填写审批表单 a)进入钉钉工作台-OA 审批，找到步骤三配置的审批表单；b)实现表单和自建系统数据联动效果。【最佳实践 2】出库审批同意时，校验库存是否足够 第三章：OA 审批场景下如何实现系统互通 64 团队成员通过 OA 审批提交商品出库审批；在管理员点击同意时，自动校验企业内部系统数据是否足够，阻断审批同意。操作步骤 步骤一：创建连接器 a)登录开发者后台；b)依次选择开放能力-连接平台，然后选择连接器；c)单击创建连接器，填写基本信息，单击确定。步骤二：配置连接器执行动作 a)选择连接器，然后选择已创建好的连接器；b)选择执行动作，单击创建执行动作；c)填写执行动作基础信息，单击下一步；第三章：OA 审批场景下如何实现系统互通 65 说明：接口路径请填写自身系统内部的真实接口。d)在入参配置界面，根据接口的实际入参填写，然后单击下一步；e)在出参配置界面，根据接口的实际出参填写，然后单击发布；第三章：OA 审批场景下如何实现系统互通 66 f)配置获取所有商品执行动作步骤，请参考配置第一个执行工作步骤。步骤三：配置 OA 审批表单 a)登录钉钉 OA 管理后台；b)依次选择工作台-应用管理，然后单击 OA 审批；c)选择创建新表单，然后选择流程表单；d)在基础设置界面填写基本信息，包括表单名称和所在分组。第三章：OA 审批场景下如何实现系统互通 67 步骤四：配置自定义连接器 a)在表单设计界面，设计并添加 OA 审批表单控件后，依次选择连接器-配置连接器：物资：选择单行输入框基础控件；数量：选择数字输入框基础控件。b)在配置连接器界面设置触发条件下，选择新建表单加载时，单击下一步；c)在配置连接器界面选择连接器下，依次选择库存系统连接器-获取所有商品，然后单击下一步；第三章：OA 审批场景下如何实现系统互通 68 说明：库存系统连接器为步骤一自定义的连接器，获取所有商品为步骤二自定义的执行动作。d)设置获取的数据填充到以下控件下，选择添加将 goodId、goodname 分别填充到物资.选项列表.ID 列表、物资.选项列表.值列表，并单击保存。步骤五：OA 审批流程设计 a)在流程设计界面，单击审批人节点，并选择高级设置；第三章：OA 审批场景下如何实现系统互通 69 b)在连接器校验条件配置界面，依次选择库存系统连接器-校验商品库存是否足够，然后单击下一步；说明：库存系统连接器为步骤一自定义的连接器，校验商品库存是否足够为步骤二自定义的执行动作。c)在连接器校验条件界面，设置填写以下控件的值获取数据，将 number、goodId分别绑定数量、物资 ID；d)在连接器校验条件界面，设置获取的数据填充到以下校验结果，将 result、msg分别填充到校验结果、校验错误信息，并单击保存；e)审批表单配置完成后单击发布。第三章：OA 审批场景下如何实现系统互通 70 步骤六：发起 OA 审批 a)进入钉钉工作台-OA 审批，找到步骤三配置的审批表单；b)填写 OA 审批相关信息，单击提交；说明：物资申请表单中的数量填写应大于实际库存。c)当进行审批同意时，弹出库存不足提醒。第三章：OA 审批场景下如何实现系统互通 71 三、OA 审批通过连接平台连接传统知名 IT 系统 1.基础概念 服务商是钉钉连接平台的合作伙伴，以公司为单位；服务商基于连接平台开放能力，与连接平台共建，实现与传统知名的 IT 系统的集成互通。2.OA 审批流程 1)连接平台订阅对应的连接器 路径：在连接平台-连接器市场订阅对应连接器；按照连接器提示完成相应步骤。提示：如果有模版变量，请联系对应服务商。第三章：OA 审批场景下如何实现系统互通 72 2)OA 审批配置连接器 选择触发条件：根据自身应用场景选择触发条件；选择连接器：选择已订阅的连接器；配置执行动作：配置执行动作入参与出参映射。3)开始使用 使用连接器：按照配置的规则使用连接器，如果出现小圆圈，表示已经触发连接器；错误日志查询，入口：开发者后台-连接平台-执行记录。第三章：OA 审批场景下如何实现系统互通 73 3.