快捷按钮执行动作-数据处理类

快捷按钮中的数据处理类执行按钮,均由系统自动执行完成数据的增删改查(创建、删除、修改、查找)。
当前主要包含以下7种类型执行操作:

1、创建新数据

该节点功能与原有触发器中的“创建新数据”一致。
可在点击快捷按钮后,依据设定好的规则在指定表格创建新数据,并且在各个字段按照规则写入值。

  • 创建数据时,将忽略字段的必填、唯一验证,以及数据验证的规则,直接写入数据。
  • 创建数据的字段值,也可以通过点选的方式,引用前序节点的输出结果。
  • 创建后,该节点将会输出“创建的数据”结果,为数据类型,以及创建出的数据的所有字段值,供后续节点使用。

以知识库内容反馈场景为例,介绍一下配置步骤:
如下图中点击按钮“有用+1”,系统自动创建一条反馈数据到反馈表,并将反馈类型、反馈人、关联物料、反馈时间等值自动写入。

该场景就是通过执行动作“创建新数据”实现的,该执行动作配置步骤如图:

如上图是“创建新数据”的配置界面,主要包含两个步骤:选择在哪个表创建新数据、设置字段默认值。

1.1 在哪个表格创建新数据

1.2 字段默认值设置

默认值的设置有三种类型备选,如图:

  • 选择选项:由于本案例中添加的是选项类型字段,这里会显示该字段本选项,若是其他类型字段则显示略有不同。(文本、数值类字段不显示该项)

  • 常用变量:可选择引用触发数据中的变量

  • 前序结果:如果改执行动作前还有其他执行动作,则可以选择前序执行的结果值写入。图中空白表示前序没有其他执行动作或结果。

2、修改已有数据

该节点功能与原有触发器中的“修改已有数据”一致。
可修改指定条件下的表格数据,也可以直接从前序节点的输出结果中选择数据来进行直接修改。

  • 修改数据的来源
    • 修改指定条件下的表格数据,可在所选表格中,根据设置的筛选条件找到数据后,进行修改。
    • 也可从触发的数据或前序结果中,选择数据类型的变量,或数据类型的数组,作为数据源,直接修改这些数据。
  • 修改数据时,将忽略字段的必填、唯一验证,以及数据验证的规则,直接写入数据。
  • 修改数据的字段值,也可以通过点选的方式,引用前序节点的输出结果。
  • 修改后,该节点将会输出“修改后的数据”结果,为数组类型,最多提供100条修改的数据,以及修改后的所有字段值,供后续节点使用。

以设计代做中的点赞场景为例,介绍一下配置步骤:
外部用户访问门户查看设计师作品时,如果觉得喜欢可以点赞,快捷按钮触发修改点赞数量。

修改已有数据-配置步骤

如上图,该功能效果就是通过“修改已有数据”实现的,该执行动作配置步骤如图:

如上图是“修改已有数据”的配置界面,主要包含4个步骤:

2.1 选择要修改哪些数据

“修改哪些数据”是用于选择目标数据来源,选框中有两种备选:

  • 触发的数据:在哪条数据点击快捷按钮,哪条数据就是触发的数据
  • 指定条件下的数据:需要进一步指定哪个工作区、哪个表格,并设置筛选条件查找目标数据(案例中是第二种情况)

2.2 选择目标数据所在工作区、表格(仅在第一步选择指定条件下的数据时,才显示)

2.3 添加筛选目标数据的条件(仅在第一步选择指定条件下的数据时,才显示)


(*本案例中其实选择触发数据即可实现,为了展示指定数据的配置流程设置了如图配置。大家可以根据自己的需求选择设置。)

2.4 添加要修改哪些字段,并设置写入值的规则

3、删除已有数据

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

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

4、获取单条数据

该节点功能与原有触发器中的“ITEM()”函数一致。
可在所选表格中,根据排序和筛选条件,获取到一条数据。

  • 该节点将会输出“获取的数据”结果,为数据类型,以及该数据的所有字段值,供后续节点使用。

该执行动作常常与后序执行动作配合使用,将获取到的数据运用到后序节点中。

5、获取多条数据

该节点功能与原有触发器中的“ITEMS()”函数一致。
可在所选表格中,根据排序和筛选条件,获取到多条数据。

  • 获取数据的数量最多 100 条。
  • 该节点将会输出“获取的数据”结果,为数组类型,最多提供 100 条获取的数据,以及每套数据的所有字段值,供后续节点使用。

如上图以订单发货场景为例,订单表中点击订单发货,明细中可发货数量大于0的产品明细,将被筛选出并写入发货单的发货明细中。

获取多条数据-配置步骤

该执行动作配置步骤与获取单条数据基本一致:

5.1 获取那个表格中的数据

5.2 设置筛选条件

5.3 获取数据数量

获取数据量默认100条,目前支持上限也是100条。

5.4 返回哪些字段

返回哪些字段有两种类型选项:

  • 数据的所有字段:即返回到所有字段的值。将会根据设置的数量获取数据后,输出为数据数组。
  • 某一个字段:仅返回选择的这个字段值。会从获取到的指定数量的数据中,将指定的字段值取出,如为多选字段会拆分多选值为数组的每一项,最后返回对应数据类型的数组。

6、执行手动触发器

该节点功能与原有触发器中的“触发手动执行触发器”一致。
可在选择表格中的“手动执行的触发器”,来进行执行。

  • 执行参数可赋予默认值。
  • 未设置默认值的执行参数将由操作人在点击按钮后在弹出的窗口中填写。
  • 执行后不输出任何结果。

7、调用服务端API

在快捷按钮的前端交互场景中,很容易联想到是否可实现点击按钮即可开具发票,或者点击按钮立即推送企微群消息等功能。

而这些都可以通过调用提供此类服务的第三方 SaaS 接口实现。

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

7.1 请求配置

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

7.2 返回值解析

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

7.3 调用示例

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

配置后,点击“获取接口返回值”,即可立即获得结果,并显示在下面的“返回值”中。

返回值也会以 JSON 代码的形式显示,支持高亮和缩进,还支持逐层折叠。

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

2024-04-22 更新
1266 次查看
0