消息订阅触发类型流程搭建
入门概念
对于安捷云来说拉取数据可以分成两种类型的应用;
一种是钉钉、企微、飞书、星辰、T+等这种有消息触发的平台
一种是万里牛、旺店通、聚水潭等这种没有消息触发的平台
有消息触发的平台安捷云会对接他的消息,用户订阅消息之后有满足条件的数据就会自动触发到安捷云满足条件的流程中,无需安捷云去主动拉取。
没有消息触发的平台,安捷云可以定时启动一个任务去主动查询他的数据,调用接口拉取客户所需数据。
本章我们会讲解自定义流程如何搭建消息触发类的自定义流程如何搭建。
实战操作
我们定一个大的需求,希望自定义流程可以实现钉钉OA审批申请发起后,所有人都审核通过同步到ERP生成凭证,这个需求虽然已经做了可视化,但是本章会从流程搭建的思路和流程搭建的概念触发讲解自定义流程搭建的思路。
首先我们可以从一个应用中创建自定义流程,可以从模板创建也可以从头创建
这个是买了一个具体应用的客户创建自定义流程的入口

这个是买了定制化应用的客户创建自定义流程的入口

我们先创建一个流程

流 程创建后会自动有一个节点,这个节点不能复制不能删除,只能选择右侧的应用,这个节点通常称为“触发节点”,一个流程的触发节点只能有一个也必须有一个,不允许复制和删除。

此处操作需要四个步骤,第一步需要选择流程要使用什么触发应用,第二步需要选择做什么操作会触发这个流程,也就是常说的“动作”,一个动作就是这个应用的一个接口,第三步需要选择该应用的授权账号,这步是安捷云基于该应用调用接口所需的参数包装的授权信息,最后一步是这个接口需要传递的参数。
此处以钉钉OA审批所有人审核通过触发该流程为例,选择“当单据审批实例同意时”动作,选择授权的账号,在配置参数处选择触发这个动作的OA审批模板,以OA模板“日常报销”为例。
安捷云每一个动作的参数,如果是需要请求接口或者订阅设置传值相 关的内容,都有两种设置方式
方式1选择候选值:客户可以直接从下拉列表选择一个值。
方式2自定义:手动输入或者使用其他节点的输出值。

是否生成测试数据,如果选择否,那就得真的审核通过一个申请去触发这个节点,如果选择是生成的数据是假数据,但是节点不会报错。

配置完以上内容后点击保存并测试会生成测试数据。需要注意的是,这里生成的测试数据是没办法直接用的,但是返回了表单code,那么我们想要一个可用的数据可以调用“查询模板的一条数据”来得到一个钉钉OA的实例id。

此处我们传递上一个节点的输出数据,点击保存并测试得到实例id后添加一个节点查询审批实例详情,在这块发现很多动作版本,如果我们只是需要钉钉OA审批表单中的数据,那么我们用查询审批实例详情(凭证场景)即可,查询审批实例详情是查 询出接口原始的返回,查询审批实例详情(凭证场景)是我们基于返回数据做了处理,去掉不需要的内容做的动作迭代。

我们选择完成后,配置这个节点需要的参数

注意审批实例ID是流程实际执行的时候使用的id,预览审批实例ID是作为本节点实际查询的参数,此处的配置根据需求选择即可。
我们查询到数据后如果需要对数据做处理,那么可以用“运行代码”节点去处理数据,如果不需要,可以不选择。
下一步我们需要将查询到的数据写入到ERP中,理论上我们可以直接选择写入接口进行配置参数,但是这么操作数据会很零碎,也没办法做些映射对照操作,那么安捷云基于这种情况内置了数据转换节点供客户处理数据。
我们添加一个数据转换节点

可以看到数据转换节点有四种转换方式
- 键值查询和去空格:这两个场景用的比较少,可以对单独的一个数据做处理。
- 明细数据转换:如果对方应用有接口,且他的字段是固定给定的,安捷云对接了这个应用的接口,那么可以使用这种情况,明细数据转换可以将数据转换成目的接口所需参数结构。
- 自定义数据转换:如果想要给OA写数据,比如钉钉OA审批的流程表单写一些数据,那么可以用自定义转换将数据转换位自定义的字典结构,这种场景用于接口给定了请求写入的格式,但是用户的表单是完全自定义的。
此处我们以写入金蝶云星辰的凭证为例,这个接口他的数据字段是固定的,那么我们选择“明细数据转换”

上方的输入数据选择我们写凭证需要的返回数据作为这个节点的数据源,数据明细转换的说明由于内容太长,我们单开了一章,可以参考:https://doc.tizdata.com/af/1668
我们配置凭证需要的相关参数,完成后点击保存下一步

可以看到这块的内容已经是请求星辰接口需要的数据格式,那么下一步我们可以将数据一起给到星辰的凭证创建接口。添加一个节点,选择目的应用需要做的操作,将参数配置到目的节点中