2024-03-28 快捷按钮新增循环、调用API等10个节点

本次快捷按钮升级,重点提升了「循环」和「调用 API」的能力,更大范围的拓宽自动化的应用场景。

1. 节点个数提升至 30 个

新版自动化的配置方式相较之前更加易学、易懂,但是会使得配置的步骤变多,相对的节点使用量也会逐步增加。

之前快捷按钮除触发节点、结束节点之外,可以添加 20 个中间执行节点,本次将该数量升级到 30 个,可以配置出更复杂的处理流程。

2. 删除已有数据

在表格数据回收站的支持下,删除数据的风险已经大大降低,也应很多用户的需求,在新版自动化中,支持了删除数据的节点。

  • 支持传入数据类型、关联类型、数据 ID 类型的变量,来删除指定的数据。
  • 也可以删除指定表格中满足筛选条件的数据。

3. 打开数据查看页

现在通过“打开数据创建页”节点创建数据后,只会往后传递创建数据的结果。但是有些场景下,只是需要打开创建数据,创建后更希望查看这条数据。

也有一些场景,就是希望点击按钮后,直接查看与当前数据有关的其他数据,也需要直接打开数据查看页面。

因此,我们提供了“打开数据查看页”这样一个交互节点。

3.1 打开数据的默认查看页

  • 支持传入数据类型、关联类型、数据 ID 类型的变量,来查看指定的数据。
  • 也可以查看指定表格中满足筛选条件排序后的第一条数据。
  • 查看数据时,还可以选择打开表格的默认数据详情页,还是指定的标准表单,或者自定义详情页。
  • 这种查看方式,与用户主动打开表格的数据查看页是一样的。

3.2 仅查看数据的指定字段

  • 可通过小弹窗的方式,选择只查看表格的指定字段。
  • 可用于过滤无用信息,精准呈现最符合场景需要的数据内容。

3.3 支持多种查看权限

  • 可以选择使用操作人的权限来查看数据,这样可以保持数据不越权,同时对数据可进行权限内的所有操作。
  • 而在一些特定场景下,则可以使用管理员权限来实现“仅查看”数据,满足临时的“赋权”需要。
  • 当以管理员权限查看时,则可以被“赋予”特殊权限来查看数据的详细信息、动态、评论、流程信息,以及所有标签页中的所有数据,如子表、关联数据标签页、流程执行记录,但是不支持查看仪表盘。

3.4 同时还扩展性的支持了“继续执行按钮”

  • 如开启了继续执行按钮,则可以实现类似“审批”的场景。
  • 点击配置的按钮,按钮名称可作为节点的执行结果,供后续节点调用。

4. 调用服务端 API

在快捷按钮的前端交互场景中,很容易联想到是否可实现点击按钮即可开具发票,或者点击按钮立即推送企微群消息等功能。而这些都可以通过调用提供此类服务的第三方 SaaS 接口实现。

在快捷按钮中新增的此节点,一方面覆盖了伙伴云原先触发器中的“调用外部接口”的能力,同时提供了对于接口返回值的接收与处理,输出的结果可以供后续节点调用,实现数据的选择与写入。

4.1 请求配置

  • 可以设置调用接口的方式、地址、参数,其中地址和参数都支持使用变量拼接。
  • 可以设置接口的请求头信息,可用于传递接口授权。
  • 可以设置请求体的类型,支持 JSON 和文本,特别优化了 JSON 请求体的录入体验,支持“所见即所得”的代码结构高亮与缩进,同时还支持插入变量。

4.2 返回值解析

  • 可以设置是否解析返回值,如果不解析将不会接收返回值,如果解析目前支持按照 JSON 或文本格式进行解析。
  • 对于特定的语言编码,也可以指定,避免返回值乱码。
  • 返回的 JSON 结构会解析为自动化支持的对象结构,或数组结构,供后续节点调用。
  • 如果返回值不稳定,还可以设置“预期返回值”来替代接口的真实返回,更便于对返回结构进行预定义。

4.3 调用示例

以伙伴云的 OpenAPI 为例,可以“获取工作区成员列表”,按照接口逐项配置。

配置后,点击“获取接口返回值”,即可立即获得结果,并显示在下面的“返回值”中。
返回值也会以 JSON 代码的形式显示,支持高亮和缩进,还支持逐层折叠。

输出的结果,在不同节点中,会根据数据类型的需要,可被调用选择。

5. 打开数据选择页(单选/多选)

在之前的数据选择页中,只支持以表格形式选择表格的数据。现在支持了“调用服务端API”后,是不是也可以选择接口返回的数据,然后再录入到系统中。可能再扩展一点,是否可以选择任意类型的数据。由此也对这两个已上线的节点,进行了能力升级。

5.1 数据选择形式升级

  • 对于通过接口返回的“对象”类型的数据,也可以像表格数据一样,支持通过“表格”形式进行选择。
  • 而且还支持将数据显示为图标、日期、或数值,选择时也支持筛选、排序、搜索。

对于所有类型的数据,还支持“列表”形式的选择,可以指定列表的图标、标题,以及多行的描述。标题、描述行都支持变量拼接,十分灵活。

5.2 支持选择的数据类型升级

  • 除支持选择表格的数据外,配合“调用服务端API”,支持了可选“对象”类型的数据,可将接口的返回值可视化的呈现出来,并参与到后续交互的设计中。
  • 还支持文本、数值、真假、用户、选项、数据、关联、日期等多种类型的变量选择,可以更好的将系统的现有数据变成支持选择的内容,让系统设计更加贴近业务场景。
  • 选择的所有结果,都可以被后续节点调用。

6. 数组循环

循环能力也是伙伴云的用户在触发器中需求量非常高的能力。配合“调用服务端API”、“打开数据选择页”的多选能力等,就可以循环的创建、更新输入的数组数据。

通过上面的例子,我们可以通过“调用服务端API”获取到工作区的成员列表,然后通过“打开数据选择页”节点选择多个用户,这个节点输出的“选择的数据”变量就是一个包含了多个数据的“数组”。在循环节点中我们就可以循环这个数组,为每个用户创建对应的数据。

  • 在“数组循环”节点中只可以选择数组类型的变量,数组变量会在变量列表中增加“[]”这样的标记。
  • 在循环体中,可以使用“当前循环次数”来获得当前是第几次循环,还可以使用“循环内容”来获得数组中每一项的具体内容。
  • 循环结束后,会输出“实际循环”次数。

使用循环有一些需要注意的地方

  • 循环体中不可以添加循环节点,暂时避免循环嵌套导致的大量运算。
  • 在循环体中添加数据处理节点,会因为循环而多次执行数据查询或写入动作,可能大幅增加自动化的执行时间。

7. 条件循环

条件循环相对于数组循环,只是不再依赖数组循环,而是以设定的固定循环次数进行循环。

每次进入循环前都会重新验证一下是否满足循环条件。

当前因为还未支持“自定义”变量,所以该节点目前还无法发挥出全部的作用,但仍可作为批量循环创建出指定条数的数据使用。

  • 在循环体中,可以使用“当前循环次数”来获得当前是第几次循环。
  • 循环结束后,会输出“实际循环”次数。

8. 跳过循环(仅循环体内支持)

为了控制循环的执行,可以在循环体中增加“条件分支”来判断进入循环后是否需要执行对应的节点,如果无需执行,则可通过“跳过循环”节点来直接进入下一次循环。

9. 结束循环(仅循环体内支持)

为了控制循环的执行,可以在循环体中增加“条件分支”来判断进入是否已经不再需要继续执行后续的循环,如果无需执行,则可通过“结束循环”节点来直接进入循环节点的后续节点进行执行。

10. 终止执行

该节点的作用与整个自动化的最后的“结束”节点一致,用来在自动化的中间过程中来终止整个自动化的执行。

该节点也可以设置结束时的提示方式与提示内容。

11. 快捷按钮未触发时即可获的“触发人”数据

快捷按钮的显示条件可用于判断何时才可以显示或使用该快捷按钮,例如项目的“负责人”才可以点击按钮完成对项目的操作,就会涉及到显示条件的设置。

上述场景,之前会碰到在设置显示条件时,设置的“负责人 = 触发人”无效,是因为自动化还未被执行,导致“触发人”未被赋值,所以判断失效。

本次优化也特别兼容了此类情况,更好的满足业务的应用场景。

总结

本次涉及的“调用服务端API”、“循环”、“选择数据”节点的优化,配合到一起可以实现出很多贴合具体业务的场景,还期待大家进行深入的体验和探索。

2024-04-01 更新
78 次查看