2022-06-08 更新:集简云上线「伙伴云」完整应用(支持实时触发)

集简云已经完整接入了「伙伴云」最新的 OpenAPI ,并通过“订阅服务”实现了伙伴云表格数据变更后“即时触发”集简云的数据流程。由此可以实现不依赖伙伴云的工作流,来完成与外部SaaS服务的实时触发与写入啦!

「伙伴云」在集简云中支持的能力

  1. 触发动作

    • 定时查询 当有数据新增或更新时:可对指定表格按照设置的排序规则、筛选条件来定时查询数据,查询到新增或更新数据后触发后续执行动作
    • 实时触发 当有表单数据创建时:可订阅指定表格的数据创建事件,当创建数据后,实时触发后续动作
    • 实时触发 当有表单数据修改时:可订阅指定表格的数据修改事件,当修改数据后,实时触发后续动作
    • 实时触发 当有表单数据删除时:可订阅指定表格的数据删除事件,当删除数据后,实时触发后续动作
  2. 执行动作

    • 查询数据列表:可对指定表格按照设置的排序规则、筛选条件、每页条数、数据偏移量来查询数据列表(含详情)
    • 查询数据详情:可根据指定的数据ID(item_id)来查询数据详情
    • 新建数据:可在指定表格中创建新数据
    • 更新数据:可在指定表格中,根据指定的数据ID(item_id)来修改数据
    • 上传文件:可通过指定的文件 URL 来实现上传文件

下面以「文本翻译」为示例场景,介绍一下如何通过伙伴云触发集简云的流程,数据经集简云处理后再回写到伙伴云中

先看一下效果

 459658463604f245a7ae97194a5d0a40.gif

1、注册 集简云

注册成功后,可开始“新建流程”

db5a60aa396461efc1eead06921d4811.png

2、配置触发动作

配置通过在伙伴云的“文本翻译”表格中创建数据来自动触发集简云的流程执行,同时包含在集简云配置伙伴云的 API Key 授权账户(该账户以后可复用)。

2.1 在“触发动作”中选择“触发应用”为「伙伴云」

4abf5170d63bdf21830bcc4eb036446f.png

2.2 触发动作选择“当有表单数据创建时”,保存进入下一步

7232968b731343f8accb4f8d54bfaec6.png

2.3 选择账户中点击“添加新账户”,用来增加伙伴云的企业 API Key 授权(如何获取 API Key)作为账户,添加后选中该账户,并保存进入下一步

1edd8021ab3e90dee23402b6eb5b69b3.png

9a9b27b58484c0d0ae8877fec93dafae.png

2.4 字段设置中可以选择到 API Key 的权限范围内的工作区,以及工作区下的表格,保存进入下一步

这里我们需要先在伙伴云的工作区中创建一个“文本翻译”的表格,只需两个多行文本字段“原文”、“译文”即可,创建后再来集简云中选择

b70dc93c7916730da21f496de90fca10.png

2.5 点击“获取样本数据”按钮,然后可以去伙伴云的“文本翻译”表格中发一条数据

d83569022d46468963e98dd005b069c7.png

看到自动获取到如下“样本数据”,表示成功,可完成进入下一步

176abc3306311310180dc904fbce9e86.png

3、通过集简云完成翻译

将伙伴云创建数据的“原文”字段的值发给集简云的翻译应用完成翻译动作

3.1 添加执行动作,应用选择内置应用中的“文本翻译”

72118b8b2e25daa5d7b97da731c8e85f.png

3.2 执行动作选择“文本翻译”后,保存进入下一步

9eee6cb5a474b4f99e1e2fcf9d10f89a.png

3.3 配置如何进行翻译后,保存进入下一步

- 翻译文本:选择从触发动作中获取的样本数据中的“原文”字段

- 翻译源语言:选择“中文”

- 翻译目标语言:选择“英文”

5c162c0dbc9d97133bf577ff354ffb9e.png

3.4 “发送数据”来验证对样本数据的翻译是否成功

beb0107a71ede31a7cefdae02cf8de39.png

发送后如果正常获得“翻译文本结果”,则翻译成功,可继续添加步骤

34fea1a1c24dd8bd2ef7100b4d3309b2.png

4、将翻译结果写回伙伴云的对应数据

通过「伙伴云」应用执行更新数据的动作,将翻译的结果更新到触发数据的对应字段中

4.1 添加执行动作,应用可通过搜索选择「伙伴云」应用

90a3e73448566b59eb2477e50ed8dce9.png

4.2 执行动作选择“更新数据”后,保存进入下一步

a50d56815544b8ef9148303867455c59.png

4.3 选择使用的伙伴云账户,该账户即为在配置触发动作时添加的账户

f766de64f0337632ffd91bee0c4ac5b2.png

4.4 配置如何更新伙伴云中的数据

- 工作区ID:选择要更新数据的表格所在的工作区

- 表格ID:选择要更新的数据所在的表格

- 数据ID:因为是更新触发的数据,故直接从第1步触发数据中选择数据ID,先点击“查看更多”,再选择“1. item__item_id”

b5c9e24fe34d5ec0e41a3c0dfc8ba6d6.png

62b5d1fd0306cc13176706e196474f8a.png

- 原文:留空即可,因为不用更新它

- 译文:从第2步文本翻译中选择翻译结果,先点击“查看更多”,再选择“2. 翻译文本结果”

12cad82c2e04eadaf7c40cadcee1c759.png5c0887c4f4edcf4e90644e41bafe5c5a.png

4.5 “发送数据”来测试更新是否生效,看到“已经成功发送了一条数据”后,表示成功,可以完成并保存流程

7ca609477dc0a707b4b4b358059e20b5.png

1182c29ca89d7d749040b6912fd6d9ff.png

5、等待部署完成后,即可回到表格进行测试啦!

刚刚保存新流程后,集简云会进行部署,请等待1分钟左右的时间,看到流程状态从“创建中”变成“滑块开关”的样子,就表示部署成功了。

8d5b8643308fbeec29567d8c8be13e0f.png

此后可以回到伙伴云的“文本翻译”表格,创建一条数据,写入原文,保存,等待几秒钟,译文就自动出现啦~

459658463604f245a7ae97194a5d0a40.gif

还可以自己改动集简云的流程,变成由“修改数据”触发翻译并更新回伙伴云,快去试试吧~

2023-03-10 更新
452 次查看
0