开发者学堂课程【低代码认证-第二章:连接器相关课程:2.1连接器功能介绍】学习笔记,与课程紧密联系,让用户快速学习知识。
课程地址:https://developer.aliyun.com/learning/course/1008/detail/15058
2.1连接器功能介绍
内容介绍:
一、课程背景与课程目标
二、连接器功能介绍
一、课程背景与课程目标
三、首先看一下本章的课程背景。钉钉宜搭强大的集成能力。也能够打破钉钉宜搭与企业自由的系统数据壁垒,实现跨应用间的数据互通。本章课程在资产管理的场景下,通过钉钉宜搭自定义连接器。打造智能资产管理应用,能够有效的提升资产管理效率。通过资产管理的实践,才可以掌握自定义连接器的使用。了解了课程的大概情况后,看一下本章的学习目标。本章的学习目标有,了解连接三方资产管理系统的背景诉求。掌握连接器基础功能,掌握连接器工厂的开发管理。可以独立钉钉宜搭建连接第三方系统应用。
二、连接器功能介绍
接下来学习连接器功能介绍。这里的连接器功能分别是用来集成第一方和第三方系统的,本章主要学习集成第三方系统,先来看一下集成第三方系统的背景诉求与优势。
(1)集成第三方系统的背景诉求与优势
(2)背景诉求是,目前有很多企业有较多的数据沉淀在钉钉宜搭以外的其它业务系统当中,如传统的ERP、CRM、HRM 系统等。使用钉钉宜搭搭建系统后,如何将系统之间的数据打通成为了企业关注的问题。使用钉钉宜搭搭建的优势是钉钉宜搭有强大的集成能力。不仅能为企业量身定制更为贴合业务的系统,还能打破钉钉宜搭和现有系统的数据壁垒,大幅度的提升效率,节约成本。那么使用钉钉一搭总共有哪几种方式可以去集成三方系统呢?
(3)连接三方数据传输的方式
第一种 OpenAPI 是对外提供业务开放的接口,通过服务回调和 OpenAPI 的结合使用,可以满足大部分钉钉宜搭与三方系统业务集成的需求。第二个是自定义连接器。通过集成自动化当中的自定义连接器。当然这里包括 HTTP 连接器和 Faas 连接器能够完成在钉钉宜搭页面当中调用外部数据源接口的功能。第三个是服务回调,服务回调是后端发起的 HTTP 请求,主要功能为数据同步,数据校验和动态获取审批人。那么首先来看一下 open API 的调用说明。在钉钉的开放平台上,提供了钉钉宜搭的 open API,以及如何去调用钉钉宜搭接口的文档。钉钉开放平台的直达链接在这里
在使用手册当中也可以去找到的直达链接,然后去看这些调动的说明。OpenAPI 总共它的一个调用的方式如下四个步骤,首先会创建一个应用,这里创建一个钉钉应用。支持创建企业内部应用和第三方企业应用。然后第二步去添加接口调用权限,因为在应用创建后,会默认只开放登陆和消息通知的接口和调用权限,如果想要去调用其它的接口,那么就需要根据自己的需求去添加对应的接口权限,当然这里的添加接口权限也是在的直达地址里面可以去找到,然后去进行申请。第三步是获取应用的 access token,这里的 access token 相当于是身份凭证。
在调用接口时,可以通过它来去鉴权调用者的身份。然后第四个步骤是调用服务端的接口。这里的服务端接口需要使用的上一步骤的 access token,然后去调用钉钉宜搭的接口。在开放平台当中,提供了 Java 、PHP、Python、 NET 、SDK 供开发者使用。再来简单了解一下自定义连接器的调用说明。首先是创建一个自定义连接器,这里会来到连接器工厂当中去选择 HTTP 的自定义连接器。创建完成之后,在这边去集成自动化,也就是应用的集成自动化当中去选择出发方式。如图片所示
选择表单出发,然后这里可以去选择对应的表单。选择完成表单后,点击确定。进入到的页面里面,先去配置它的一个触发方式,之后去选择自定义连接器。是它的一个简单的一个调用的步骤,详细的步骤会在下面进行一个讲解。最后来看一下服务回调的调用方式。服务回调首先要先在宜搭平台当中去进行服务注册,但是点击新增服务。然后去选择调用的接口,还有接口所需要的参数,在服务注册当中,也就是对的接口做了一个预设,比如说它要传什么样的一个参数。它的接口,类型是什么样的,做一个预设,然后回到的表单页面当中。在这里会有一个服务执行。去点击它,在这里就可以去配置服务回调。比如说刚才是配置了数据同步,然后在这里第三方服务当中,就可以去找到数据同步的这一个服务注册,然后下方的参数一参数二,就是刚才去配置的这样的一个参数。
(4)服务回调通常是用作数据同步数据。数据校验和动态获取审批人。了解了三种调用方式后,来看一下它们之间的差异化。
(5)连接三方数据传输的差异化
(6)这里 open API 和自定义联系器服务回调的不同是,open API 是外部去调用钉钉宜搭的数据,而自定义联系和服务回调,它们都是宜搭侧去调用第三方系统的接口。那么使用外部去调用宜搭的数据就适用于第三方系统未开放的这样的一个接口。并且使用 open API 可以去读取和传递第三方的数据,那么自定义连接器和服务回调,它们都是从钉钉宜搭侧去调用三方系统的这样的一个接口。所以它适用于第三方系统开放接口,这样才可以在钉钉宜搭侧去进行调用,当然自定义连接器可以读取和传递第三方数据。服务回调只是可以传递不可以去进行读取。自定义连接器还有一个优点,就是它可以实时地进行数据同步,服务回调就会有一定的延时性,所以它有延时数据同步的这样的一个差异化。那么本章课程主要学习的是连接器的调用,所以首先来了解一下连接器。
(7)连接器介绍
(8)连接器能够轻松的实现的钉钉宜搭与三方系统之间的数据互联互通,通过数据操作的节点的配置和编排,业务人员不需要编写高级函数和代码。钉钉宜搭是提供了几种连接器的,这里主要来说一下一方连接器和自定义连接器。一方连接器是钉钉宜搭接入钉钉一方连接器。包括工作通知、群通知、待办任务等等,在集成自动化当中选择连接器。钉钉宜搭官方应用就是一方连接器。可以直接去进行一个集成,不需要再去连接器工厂当中再创建一个自己封装好的一个连接器。它可以直接去进行使用而自定义连接器是支持企业开发的一个自定义连接器。包括 HTTP 连接器和 Faas 连接器。这里主要讲解的是 HTTP 连接器,它可以实现钉钉宜搭与其它三方应用的资源整合能力和业务衔接。
(9)自定义连接器介绍
自定义连接器它的主要功能是需要打通企业存量的系统,也就是说企业内部正在使用的系统,那么就可以通过钉钉宜搭连接器工厂去创建连接器,去连接用户自定义接口,当然接口需要是对外开放的。下图就是的一个连接器工厂。
在这里面已经创建了一个应用当中会使用到的连接资产管理系统的这样的一个自定义连接器。下面来对自定义连接器整体的配置步骤进行一个讲解。
首先第一步要进入到连接器的一个创建入口,也就是连接器工厂,这里要进入到钉钉宜搭的工作台,然后在这里,也就是设置里面去进入到当前页面,然后选择到连接器工厂,这里面是只有管理员才有这样的一个权限,如果没有连接器工厂,说明还不是管理员。进入到页面之后,可以去进行自定义连接器的创建,选择创建连接器,在右侧弹窗当中选择 HTTP 的自定义连接器。输入连接器的一个名称,然后点击下方的一个确定。
当然这里面的一个详细的连接器工厂的配置,会在第二小节讲解到,下一个步骤是在集成自动化当中去选择连接器进行配置。选择表单事件出发。
然后去新建一个连接器节点,在这里面去选择宜搭自定义的一个连接器。也就是刚才配置好的连接资产管理系统的一个自定义连接器。配置完成之后,下一个步骤是选择执行动作,去选择鉴权模板。当然,如果这里没有去配置鉴权模板,也可以去点击。然后下面会告知没有鉴权模板,会直接新建一个鉴权模板,跳到鉴权当中进行配置。配置完成之后去选择的执行动作。
最后是参数的一个配置。这里的参数可以看到上面一个节点是 groovy。因为自定义连接器,它的参数是一个复杂的一个参数格式,所以在上方通过 groovy 去进行配制,返回正常也就是当前接口所需要的一个数据格式之后,在配置执行动作当中,也就是在参数里面去选择到 groovy 返回的数据。在字段当中选择连接器groovy 返回的这样的一个字段去进行配置,这是参数配置。本小节介绍了连接器的功能和它大致的一个配置方法。