分享人:东怀,钉钉连接平台技术负责人
视频地址:一键回看
目录
一、宜搭与连接平台的关系
二、在宜搭中使用连接器
三、在宜搭中使用集成连接器
四、Q&A
一、宜搭与连接平台的关系
宜搭与连接平台互通的价值
宜搭是企业低代码应用平台,可以通过低代码的方式,帮助企业完成专有应用的开发,低成本帮助企业解决业务数据化问题。宜搭的使用场景一般是信息管理,比如:项目管理、出差管理、客户管理、订单管理等。
宜搭与连接平台互通以前:
- 客户需求:在宜搭填写表单后,能够直接连接钉钉发布代办任务;
- 遇到的问题:宜搭与钉钉平台相对独立,数据互通难;需要代码开发打通宜搭和钉钉;
宜搭与连接平台互通以后:
- 通过低代码配置,既可在宜搭中使用钉钉连接器,也可在连接器中配置连接流操作宜搭API。
宜搭与连接平台之间,是相互集成、互相开放的典型例子。如下图所示,宜搭的表单数据源场景和流程编排场景,集成连接平台的连接器的各种能力,实现数据互通。
- 通过低代码配置,既可在宜搭中使用钉钉连接器,也可在连接器中配置连接流操作宜搭API。
宜搭集成连接平台
- 连接流:在连接平台中,实现数据转换同步的流程被定义为连接流,可以通过低代码的形式制作,也可以像宜搭一样以系统集成的方式生成。
- 在宜搭使用连接平台连接器的过程中,每一个调用关系的背后都是一个连接流。宜搭在使用钉钉能力时,会通过连接流与钉钉交换数据,由此来完成自己的业务。
连接平台中的宜搭连接器
- 连接器:连接器是触发事件和执行动作的集合,借助连接器市场丰富的连接器,可以实现企业内异构系统之间的互联互通。
- 宜搭将自身开发能力注册成为连接器,使用连接平台连接流,通过低代码的方式,结合其它连接器,可以实现与宜搭的连通。
二、在宜搭中使用连接器
宜搭:集成&自动化
操作路径:宜搭 - 集成&自动化 - 新建集成&自动化
触发类型选择:
- 表单事件触发:指定的表单或流程事件触发;
- 定时触发:按照设定时间周期循环触发流程;
- 应用事件触发:由连接平台连接器提供的一方、三方应用事件作为流程执行的触发条件。
典型场景一:在宜搭中使用连接平台中的待办连接器
用户通过宜搭內的表单填写,实现自动在钉钉内为指定成员创建钉钉待办消息、且执行人点击待办查看表单详情。发起强有力的消息提醒,做到件件有着落,事事有回音。
操作步骤
- 创建应用
- 新建表单
进行表单设计: 新建集成&自动化
- 选择触发类型为:表单事件触发;
流程设计:
- 创建表单事件触发;
- 添加连接器并配置动作;
- 保存并发布集成&自动化;
- 选择触发类型为:表单事件触发;
- 发布表单到公共平台,并查看表单效果
- 在宜搭创建一个待办表单,填好后单击提交
- 在钉钉客户端收到待办信息
至此,完成宜搭表单到钉钉待办的互通。
典型场景二:在宜搭中使用连接平台中的消息通知连接器
当用户在宜搭上完成某项任务,或通过数据分析后发现达到某项指标,需要发送群消息通知群成员时,可以通过宜搭连接器实现向钉钉群内发送消息。
操作步骤
- 创建应用:群聊
- 新建表单
进行表单设计: 创建集成&自动化,将刚创建的表单作为触发条件
流程设计:
- 创建表单事件触发;
- 添加连接器并配置动作;
- 添加新增数据并配置新增数据;
- 配置完成后,保存并发布集成&自动化;
- 填写表单,查看效果
创建群聊表单“创建群聊并发送群消息”并提交,在钉钉客户端看到新创建的群聊,创建成功。 - 创建表单,用于向新创建的群聊中发送消息
创建集成&自动化,将刚创建的表单作为触发条件
流程设计:
- 创建表单事件触发,添加连接器,选择连接器动作,配置动作;
- 保存并发布集成&自动化。
- 创建表单事件触发,添加连接器,选择连接器动作,配置动作;
- 填写表单并提交,在钉钉客户端消息群“创建群聊并发送群消息”收到宜搭表单中的消息,消息发送成功。
典型场景三:在宜搭中使用连接平台中的通讯录连接器触发执行宜搭集成流
当企业员工发生变化时,触发执行宜搭的业务流程,完成入职或离职等自动化操作。
操作步骤
- 使用一个已搭建的出差表
创建集成&自动化,选择应用事件触发
流程设计:
- 应用事件触发配置:触发应用:选择通讯录;触发动作:企业内部用户变更;
- 删除连接器,添加新增数据;
- 配置完成后保存并发布。
- 应用事件触发配置:触发应用:选择通讯录;触发动作:企业内部用户变更;
- 查看结果
在钉钉通讯录中更改一个员工的信息,在宜搭出差数据表单中的数据管理页面就会收到一条变更的信息。
三、在宜搭中使用集成连接器
基础概念
集成连接器
集成连接器是带有集成网关、集成执行动作或触发器的一类连接器,通过集成网关与外部系统连接,执行动作与触发器可与外部系统进行联动。
集成网关
集成网关是连接平台提供的与外部数据平台以特定数据格式进行交换的网关,它可以要求外部平台将复杂的数据格式进行转换,以连接平台特有的格式注册连接器,以简化连接器的出入参。
在宜搭尊享版中使用集成连接器
- 选择集成连接器
执行动作与审批表单联动
配置说明
- 第一步,选择连接器动作:可通过输入名称搜索或点击选择找到所需的连接器执行动作;
- 第二步,选择流程表单:首先需要选择钉钉内审批应用,(如上图中的OA审批),此应用需用户自行在钉钉中创建;然后需要进行宜搭内表单选择(如上图中的加班审批测试);
- 第三步,配置动作:即通过点选将宜搭表单与钉钉应用进行绑定。
典型场景:宜搭中使用OA审批连接器高级功能
- 传统的连接器是固定出入参的,然而像OA审批这类平台,表单由用户搭建,表单的操作也会根据搭建的内容有所不同。
- 宜搭开通高级功能后,将支持与OA审批连接器的高级功能进行连接。
- 在宜搭中将可以选择OA审批这类平台下搭建的某个表单进行连接。
场景一:OA审批表单数据同步到宜搭
操作步骤
- 在钉钉OA审批中选择一个表单-物品领用
- 根据钉钉表单内容,在宜搭尊享版中创建一个对应的表单
创建集成&自动化
流程设计
应用事件触发:
- 连接器:审批;
- 触发动作:实例通过(高阶版);
- 应用名:OA审批;
- 流程表单:物品领用;
- 删除连接器,添加新增数据;
- 配置完成后,保存并发布。
- 查看结果
在钉钉OA审批中提交一个物品领用表单,在宜搭的物品领用记录表中的数据管理页面会收到一条新信息,内容就是在钉钉提交的物品领用表单。
场景二:宜搭表单数据同步到钉钉OA审批
操作步骤
- 在宜搭中创建表单
- 创建集成&自动化并配置连接流,完成后保存并发布
- 查看结果:在宜搭填写表单并提交后,在钉钉OA审批数据中会新增一条宜搭表单信息。
四、Q&A
Q:我们使用连接器是否一定要使用钉钉专业版呢?
A:首先是这个没有要求的,因为连接器本身是在连接平台上是开放给大家的。但是大家使用连接器的可能会在各种的各样的产品里面,比如说像审批、像宜达这种场景。那审批里面就需要开通专业版,因为审批里面它集成连接器的这个功能是要专业版开通以后才可以使用。那宜达中也是一样的,不过宜达的话他有个数限制。然后宜搭增强版它还会有更高就是更高程度的一些集成连接器可以使用。
Q:宜搭获取连接器数据后能否更新到本表单?
A:是可以更新到本表单的,但是这个操作可能要比如说要关联一下表单的数据;如果连接器有返回的话,可以利用这个数据去更新对应的表单。
Q:通过调用OA的审批接口发起的一个审批流程要怎么去集成连接器
A:可能是就跟大家想的不一样了,因为在审批里面使用连接器的话,大部分是在表单新建的时候或者是在流程中的时候。如果是通过接口发起的话那估计就是只能在流程中了。
Q:如果我是专业版用户会有什么连接器的优惠吗
A:那个专业版用户的话是在首先是审批里面他就打通了我们连接平台的连接器就是可以在审批里面使用连接平台的连接器了。也可以自己在连接平台里面定义新的连接器,然后在审批里面去使用。很多客户在新建表单的时候去获取自己系统的数据或者获取三方系统的数据都可以通过连接器来获取。
Q:请问钉钉的OA怎么样去获取宜达的一个数据
A:表单的一个数据目前来说宜搭提供的那个连接器功能还相对来说比较简单。它返回的那个数据格式也没有明确的解析。可能目前来说还是有些困难的。我们也在推进这个事情。如果后续我们有了一个相关的进展的话我们也会去通过钉钉的服务窗或者是开放平台的官网、连接器的官网来把一些更新的一些消息来推送给大家。
Q:在连接平台上去开发上架的一些连接器呢我可不可以去在宜搭中去使用呢
A:因为宜搭本身他是一个独立性的产品,我们连接平台也是一个独立性的产品,两个产品之间是有合作的。然后一搭为了他自己的产品体它筛选了一些我们连接平台提供的一些连接器
如果比如说有一些那个服务商或者一些开发者他开发的连接器上架了,可能上架以后呢,我们可以跟那个宜达那边去沟通一下,看一下这个连接器是否能提供给宜搭使用,宜搭那边就会把这个连接器可以放开的。
Q:现在是否在宜搭中可以通过连接去实现把钉钉智能会议室里面的预定的一些数据来跟宜达去打通
A:首先官方连接线丰厚度非常多而且很多是由我们已经开放的接口转换过来的。所以就是具体的功能可能就是由对应的连接器的那个业务方案来提供出来的。如果是有智能会议室这样的
可以获取这样预定数据的一个接口的话那是可以的。但是比如说你获取那个智能会议室的预定数据需要一些接口入参,这个的话可能是要自己去搭建表单配合连接去使用。
Q:目前钉钉无法获取宜达的一个数据吗
A:是可以的。但是只能由宜达来发起。就是在宜达集成自动化里头可以就是可以调用一些我们官方的一些执行动作就是连接器来把他的数据来传过来。但是目前来说宜达本身提供的那个连接器还是相对来说功能比较简单不能完整的去解析他的数据结构。所以我们比如说在审批里面想获取一些宜达表达的数据目前来说还是做不到的。所以我们也在推荐这个事情不断完善连接器的丰富度。
Q:宜搭的数据可以放到钉钉OA审批中吗
A:这个好像还不行,因为两个本身是独立性的产品,没有办法把宜搭的表单放过去。但是刚才视频里面有演示,可以把宜搭的一个表单转换成审批流程,这个是可以的。其实它底层的一个数据是可以去打通但是入口目前是没有办法。尊享版深度融合以后审批和宜搭的开放了一些数据格式。宜搭,在他的流程中可以比如说这样发起审批就可以完成这样一个功能。就像实现了简单的这种宜搭的和审批的活动。当然宜搭本身也可以收到那个审批单完成的事件,
把这个数据落下来也是可以的。
Q:可不可以把宜搭的一个数据应用做成连接器然后来给钉钉去一个进行一个调用
A:可以的这个是完全可以的。这个我们目前本身官方也在推荐这些能力,就是我们自己来做。
如果有开发者小伙伴们可以自己来实现这个功能的话,也可以上架成连接器,上架上来也是可以的。
Q:我们在宜搭中去集成了一个连接平台的连接器,那我们能不能就是去给其他的一些三方的一些系统去使用
A:宜搭跟连接平台是合作的关系,宜搭是集成了我们连接平台下的连接器并且进行了筛选。那这样的一个模式我们后续也计划把我们平台下面的连接器上开放给三方。还有比如说企业自己本身来进行集成。那这样的话企业或者三方就可以调用我们那个连接平台提供的连接器。
Q:已经发起的一个审批的流程还可不可以去对接连接器
A:已经在流程中的是肯定不行了。因为我们当时做的那个审批单版本它的流程是固定的。就是已经是当时提保存的那个。但是比如说你后续的话如果要添加连接器的话新发起的流程呢就可以走连接器了。
Q:宜搭做了一张板凳上面有身份证图片如何更新到本张单子的身份证信息(9分17秒)
A:有个客户有个场景就是说他表单里面有身份证图片,比如说他做了身份识别以后能不能毁掉回来。毁掉回来更新那个连接是这样的, 你们调用那个接口识别,识别完身份证也是识别完身份证信息,他如果是同步返回的话那当下表单本身就可以更新那个表单里面的身份信息的,这个是没有问题的。还有一种比如审批中,审批中的话可以就是有些审批流程可以去添加这个我们那个身份证识别的一些接口型交互。如果有返回的话,也可以更新当前这个流程的表单。可能比如说你这个如果是xx的话,比如说我去识别身份证,然后过了一会以后那个接口发生发毁掉,说是这个身份证识别出来了再更新这个可能就要自己自行开发了。因为这个过程中实际上是不是同步获取数据的话是没办法更新表单。
Q:我们可不可以去绑定一个基础表单的删除的权限
A:这个其实也是可以的,但是这个要具体比如说我删除哪一条数据可能要提供数据的ID过来,那连接器本身是不会记数据的,可能要自己的行动来进行试配。
Q:钉钉OA审批中可不可以通过把宜搭应用做成连接器供钉钉OA审批来调用?
A:这个是可以的,要结合首先宜搭开放的一些接口,然后你如果做成连接器的注册到钉钉上的话你本身也要提供一个公网的htv地址。相关的那个连接器的开发,开发平台上本身就有文档的大家可以去看一下。把那个宜达作为一个把它的API,做过一些简单的数据转换,然后转换成连接平台的格式。然后登记在连接平台上就可以做成连接器了。原理是比较简单的。
Q:空键失去焦点时出发连接器
A:这个其实我们也在跟审批那边进行那个沟通.我们也在想增加一些连接器的一些连接点.在一些事件里面去进行触发的。这个大家不用着急哈。我们都是有安排进行迭代优化的。这些我们都会有一些迭代和一些优化。如果后续我们进行了一个相关的一个更新的话,那么也会通过开发者的一个服务窗,然后看看还有后台啊来通知给大家。也会到时候举办一些新的一些训练营和直播活动等再为大家进行一些讲解哈。
Q:怎么把宜搭做成连接器
A:就接口域名的话,因为你要提供给连接器的接口的话是要自己进行开发的。
这个宜搭是不会提供的,这个是要你把宜搭的接口包装出来。
更多钉钉开发者说视频内容请访问:https://open.dingtalk.com/developer/topic