DingTalk「开发者说」 钉钉连接平台：打通企业数据孤岛的开发实践

钉钉连接平台简介

钉钉连接平台是什么？

简单来说，钉钉连接平台是打破企业系统数据孤岛的开发平台。钉钉连接平台通过统一的标准协议，接入各类应用和系统，并提供强安全、高可用、轻量化的连接能力，同时输出覆盖各类业务场景的应用标准数据模型，实现企业内外部系统的互通互联，满足企业轻量级、全方位和高灵活度的集成需求。

 钉钉连接平台的优势

对比市场中其它系统集成企业连接平台，钉钉连接平台的优势有以下几方面：

• 快速低成本
  10分钟完成一个场景连接
• 轻量级
  对比传统的系统与系统间的连接，钉钉连接平台可以实现系统内场景之间的互联互通，连接更轻量、成本更低
• 丰富的钉钉生态
  钉钉生态中的应用均可以进行互通互联
• 标准化接入
  全程自助形式的标准化流程，方便开发者使用
• 可视化编排
  使用简单的拖拉拽，既可实现数据映射

钉钉连接平台的核心能力  

系统架构 

在钉钉连接平台系统架构图中，自下而上分别为：  

• 各业务提供的能力，包括： 
  • 钉钉官方能力
    审批、日程、IM、钉邮、待办等
  • 标准SaaS间互联
  •  生态连接器
    一些外部连接器，如用友、金蝶、泛微、致远、微信、抖音、快手等
  • 企业自建连接器
    企业内部应用系统（EHR等）
• 钉钉连接平台
  作为系统间的Hub，实现接入各类系统的能力，为上层业务系统与下层系统能力提供互联互通  
• 前端业务系统层；

钉钉连接平台的核心能力  

• 连接器管理
  • 触发器&执行动作
    连接器中的两个基本要素，触发器将系统数据发送出去，执行动作则是从系统外部接收数据
  • 主数据模型（下图）
    在某一个业务场景下的标准模型，钉钉官方定义的主数据模型大概有40多个，不仅可以零成本实现系统大图，还可以实现自动化匹配连接（比如“新入职人员”的主数据模型包括了姓名、工号、性别、生日、籍贯等五个字段，如果两个连接器的触发器和执行动作分别映射了这个主数据模型，那么系统就可以自动匹配实现连接） 
    
     
  • 可视化模型映射
    简单的拖拉拽就可以实现映射
  • 灰度&准入测试
    支持在线灰度测试，确保配置没有问题；且连接器上架之前会进行准入测试，申请通过后即可上架连接器市场
  • 连接器市场
    生态伙伴可以在这里上架或者选择自己所需要连接的系统，拓展应用的开放能力
• 连接流管理
  • 流模型
    连接流是指具体业务场景的数据流程，每个连接流至少包含一个触发器和一个执行动作，也可以包含多个； 以出差审批业务为例，它的触发器是出差审批完成，执行动作是发送机器人消息，触发器将出差审批中的数据发送到机器人消息，由机器人消息执行发送，这就是一个连接流
  • 分支节点
  • 自建连接流
  • 通用授权
  • 连接流上架
    连接流也有连接流市场，用户只要配置一些基本信息，就可以实现连接（比如出差审批系统通过后发送机器人消息，只要配置一个机器人的webhook就可以实现连接）
• APaaS集成
  • 连接器订阅
  • 触发事件分发
  • 审批集成
  • 低代码集成
    APaaS的低代码平台场景，很适合使用钉钉连接平台，用户无需写代码，只需简单的拖拉拽就可以实现业务场景的连接。连接平台提供了能力给到APaaS平台集成，让APaaS平台能够在表单配置流程里选择连接平台上的连接器，从而实现连接。 
    下图是一个宜搭APaaS集成使用场景示例，选择了场景群连接器，执行动作是创建场景群，包括群名称、是否可管理、群成员列表和群主，这些信息可以从提交表单的字段中选择。 

    

    下图是一个OA审批场景，可以设置触发条件，在表单加载时选择连接器，实现自动连接。
    
• 引擎技术
  钉钉连接平台最重要的底层核心技术就是引擎技术，这也是一个系统集成开放平台不可或缺的能力，包括：
  • 认证鉴权
  • 执行校验
  • 流执行
  • 自动重试
  • 执行日志
  • 三方报警
  • 历史回放

主数据模型

初步方案

传统实现系统之间互联的方式是定制化点对点接口对接（下图），很难做到统一标准，它存在以下问题：

• 对接每个应用都需要重复研发，研发成本高；新的生态商的进入成本很高
• 每家厂商自行重复处理调用链路记录、失败重试、错误处理、错误消息触达等

优化方案  

基于上述问题，钉钉推出了一个优化方案（下图），在应用之间加入连接平台作为“消息转发中心”进行解耦直连，统一链路调用记录、错误日志排查、报表统计等。

然而这个优化方案仍然无法做到一对一连接，每次有新厂商接入，原有的基础系统也需要进行改造，新厂商接入和维护成本较高。 

最终方案

• 主数据模型
  主数据模型有两个主要功能： 
  • 实现一次接入持续集成 ，下左图是传统的方式需要多次对接不同系统，而右图就是主数据模型方案，由于使用同一个主数据模型，应用A与钉钉连接平台主数据模型连接一次即可，后续应用加入会自动连接主数据模型并接收应用A的数据。

    

  • 零成本获取数据大盘表
    主数据模型中的数据都是预先定义的，系统都可以辨识，从而实现零成本做数据大盘表。

钉钉连接平台可覆盖的高频场景

覆盖场景 

钉钉连接平台可覆盖的场景主要有以下五类（下图）： 

• 钉钉官方场景
  钉钉开发平台上可以看到的能力都可以连接，比如机器人、公告、考勤、消息通知，文档等，目前有25个官方业务场景连接器。
• 钉钉三方场景
  钉钉工作台上的三方应用，目前接入包括销帮帮、易快报、阿里商旅、携程商旅、BOSS管账等近20个。
• 企业自建场景
  基于企业希望将自身系统与钉钉系统互联互通的诉求而设置的企业自建系统。
• APaaS
  钉钉搭等 
• 生态连接器
  外部集成服务商连接，如支持飞书、微信、微博等。

钉钉连接市场 

下图是钉钉官方连接市场（部分截图），包括大概40个生态系统。 

基于连接生态能实现的互联互通场景

钉钉连接平台的Hub形式实现钉钉平台生态系统丰富的互通互联，同时连接流管理能力

支持相对复杂的多场景连接。 

实战演示  

演示案例：审批报销单通过后发送企业群消息

1. 进入钉钉开发者平台的开发者后台，在开放能力中选择“连接平台”。 

   

2. 在连接平台页面有连接器市场，这好比手机应用商城，其中有约40种能力供用户选择；连接流市场是业务场景市场，用户可以点击开通直接使用；我的连接中的连接器和连接流都需要用户自主创建，流模板中可以看到本地连接流情况；主数据就是主数据模型，约有40个。 

   

3. 介绍完连接平台，接下来可以观看视频实战演示，我们将使用连接器市场的“审批”中的触发事件“创建报销单”和“消息通知”中的执行事件“发送消息到企业群”。在连接器中创建连接器，在连接流中创建连接流，并进行相应的配置，配置好后进行发布，即可在钉钉企业群里收到报销审批通过的信息。整个流程操作简单用时少。（详见操作演示视频）

   

   

常见问题解答

Q：转发中心如何保证数据的安全性？

A：钉钉连接平台会有统一的鉴权方式，在创建连接器的时候也支持API鉴权。

Q：如何获取群ID？

A：在钉钉官网能力中心搜索“获取群ID”即可看到开放接口了。

Q：连接器是否可以将钉钉OA数据推送到宜搭，在宜搭中进行处理分析？

A：是可以的。同时在连接平台也会有宜搭的API，比如宜搭有创建表单的执行动作，在OA审批结束后就可以将数据作为触发器触发宜搭中创建表单的执行动作，因此将OA审批数据变成宜搭的一个表单。目前宜搭也集成了连接器的能力，通过创建宜搭表单即可生成在连接器上的场景群、日志等。

Q：企业系统通过连接器进行对接数据的安全性是否可以保证？

A：可以的。所有的接口注册到连接平台，都需要有API的鉴权，以保证对接数据安全性以及企业系统安全性。

Q：连接平台与OpenAPI的区别？

A：在钉钉开发平台上的OpenAPI未来都会变成连接器，钉钉提供工具将OpenAPI转化成连接器，OpenAPI与连接器在官方场景下是一对一的关系，将来还会接入更多生态场景，在钉钉工作台上的应用也会开发对应的连接器。

Q：连接平台Hub概念是什么？

A：连接平台Hub可以理解为系统集成中心，以Hub的形式将市面上已经对接好的系统集成到钉钉平台上。

Q：钉钉连接第三方应用的自建连接器的难度大吗？

A：难度不大。钉钉提供了非常详细的操作教程，小到每一步每一个点击的操作，即使完全不会写代码的人也可以操作。

Q：企业不同ERP系统单据如何同步对接？

A：对于连接器来说，两个系统会有发送数据方和接收数据方，在发送数据方的ERP系统创建一个触发事件，接收ERP系统单据方创建一个执行动作，在自建连接流中进行配置，通过创建触发事件连接到执行动作，即可进行同步。

Q：有没有氚云平台的对接案例？

A：目前还没有，可以关注钉钉开发者服务窗，后续会提供相应案例。

Q：钉钉官方主数据模型是否是稳定不变的，如果主数据模型变化所有连接的应用是否要同步改变？

A：主数据模型会有变化，但变化的可能性比较低。如果变化会有不同版本标识，所有模型都是基于版本连接的，可以通过更新连接流来完成更新。

Q：钉钉OA审批表单中的内容是否可以通过连接获取填充、审批通过后传到外部系统？

A：可以的。钉钉OA审批有几方面的能力：

1. 在表单加载时可以从外部系统获取数据并填充至表单中；

2. 在提交审批时可以通过外部系统进行校验；

3. 提交成功后可以将表单内容同步至外部系统。

课程回看地址：

一键回看

一键回看

一键回看