自定义动作介绍

---

概述

自定义动作用于为工作表添加业务按钮，用户点击按钮后，可以填写指定字段、更新数据或触发工作流，实现业务流程的快速处理。

如下图，在员工档案表中配置了【转正】和【离职】两个按钮：

• 点击【转正】时，弹出窗口填写转正相关信息并保存；
• 点击【离职】时，直接执行工作流，更新离职状态和离职日期。

除了添加业务按钮外，还可以设置用户点击记录行（记录卡片）后的动作效果，例如打开记录详情、打开指定链接，或点击后不执行任何操作。

根据记录数据源不同，点击按钮时也可以执行不同的效果：

• 单条数据源：

  在一条记录中点击按钮时，可以弹窗让操作人填写指定的字段，或点击按钮后执行工作流。

• 多条记录数据源：

  在表格视图下勾选多条记录，点击按钮后，获取勾选的多条数据并执行一次工作流。参考示例3。

点击记录的动作

除了自定义动作外，还可以设置用户点击记录行（记录卡片）后的动作效果。

操作路径：通过【配置视图】> 【记录操作】，选择点击记录时的动作。

支持以下方式：

• 打开记录详情：默认行为，进入记录详情页。
• 打开链接：读取指定文本字段中的链接地址，并直接打开该链接。
• 无：点击记录后不执行任何操作。

添加自定义动作入口

自定义动作可以在工作表或视图中创建。

工作表中添加

操作路径：【编辑表单】>【更多设置】> 【自定义动作】 > 【添加按钮】。

视图中添加

操作路径：【配置视图】 > 【记录操作】， 添加【动作】,选择【创建新动作】。

在视图下创建的按钮，会自动同步到工作表的管理页面，在工作表的按钮管理页面中，可以指定按钮在哪些视图下可用。

基础配置示例

示例1 ：点击按钮后填写指定字段

当表单字段较多时，通过按钮填写字段内容，可以让用户聚焦于当前业务场景所需填写的信息，减少无关字段干扰。

例如，在试用视图下添加转正按钮，点击后仅填写转正日期和状态。

按钮界面

1. 名称、图标和说明

• 名称支持自定义。
• 图标和颜色支持自定义。
• 按钮说明用于描述按钮用途，用户将鼠标悬停在按钮上时可查看说明。

2. 动作

点击按钮后支持两种动作：执行工作流、填写表单字段

实际还支持“填写字段后继续执行工作流”。

本示例选择填写表单字段，点击按钮后填写转正日期和状态。

3. 填写字段配置

首先选择填写对象：

• 当前记录
• 当前记录关联的记录（仅支持单条关联字段）

然后选择填写内容：

• 填写记录字段
• 新增关联记录

可以实现4个效果

• 为当前记录填写指定字段
• 为当前记录新增关联记录
• 编辑关联记录字段
• 为关联记录新增下级关联记录

4. 字段显示与默认值

窗口中的字段可设置为：编辑、只读和必填，并支持设置：固定默认值、动态默认值和清空字段。

如果填写的是关联记录字段，还可以引用当前记录中的字段值作为默认值。

5. 二次验证和备注

支持在执行按钮前进行二次确认，并填写备注信息。

• 二次验证：启用后，用户需确认操作后才能继续执行。
• 备注信息：支持预设常用意见模板，帮助用户快速填写。

验证和备注效果:

工作流获取备注内容:

用户填写的备注信息可在工作流中获取和使用。

6. 启用安全验证

开启后，用户需完成身份验证才能提交。

开启安全验证后，组织超级管理员还可开启“1 小时内免密验证”。详情请参考：/org/security#passwordless

7. 提交后继续执行工作流

字段填写完成并提交后，可自动执行按钮工作流。

支持以下设置：

• 流程执行完成后提示：流程执行完毕后，向操作人显示提示信息，例如“操作完成”“成功入库”等。

  注意： 流程执行完成不等于业务处理成功。例如，工作流根据分支条件进入了“失败”分支，只要流程正常执行结束，也会被视为流程执行完成。因此，如需根据业务结果提示成功或失败，建议通过工作流中的界面推送节点发送提示。

• 执行完成后继续填写：流程执行完成后，再次打开填写窗口，适用于连续扫码录入、批量登记等场景。

8. 启用按钮

可设置按钮可点击的条件，或一直可点击使用。

• 一直：按钮始终可以被点击。

• 满足筛选条件：设置一个或多个字段的筛选条件，只有当前记录满足了条件，按钮才可以点击，否则“灰色不可点击”。

例如，仅当员工状态为“正式”时，允许点击【离职】按钮。

9. 隐藏按钮

当按钮不可用时，可直接隐藏按钮，而不是显示为灰色不可点击状态。

此设置仅对当前视图下按钮生效。

进阶示例

示例2：点击按钮后执行工作流

示例：在视图下，添加转正按钮，点击按钮后触发工作流，自动将员工状态改为"正式",转正日期改为当天。

配置要点：

1. 动作

   选择执行工作流。

2. 流程执行完成后提示

   开启后，工作流执行完成时向操作者显示提示信息。

   如果工作流内部还存在业务校验逻辑，建议关闭此选项，通过工作流通知节点向用户反馈结果。

3. 点击保存按钮配置工作流

   点击保存按钮后自动打开工作流配置页面，通过更新记录节点，修改状态和转正日期字段。

   

4. 发布流程

5. 测试效果

   打开一个试用期的员工记录，点击按钮后，会自动修改字段内容。

   

示例3：勾选多条记录执行一次工作流

适用于批量处理场景，如下几个场景：

• 场景1：员工日常每次完成出差登记下消费明细，在某个时间，勾选多条待报销的明细数据，自动生成一个报销单。

• 场景2：在 ERP 中，勾选多条订单合并生成一个出货单

• 场景3：在生产制造中，勾选多条订单合并生成一个生产计划单

我们以多条报销明细生成一个报销单为例进行介绍。

配置步骤：

1、添加批量操作的按钮

此场景是针对多条数据统一处理的，因此需要在批量操作的表(报销明细)中添加按钮。

操作路径:【记录操作】 > 【批量操作】， 点击【动作】，

2、数据源选择多条记录

动作选择执行工作流，数据源选择多条记录

当按钮的数据源设置为多条记录时：

• 用户勾选多条记录后点击按钮；
• 工作流仅执行一次；
• 触发节点代表当前勾选的全部记录。

3、配置工作流

• 1）获取上次提交的报销单

  获取最近一次提交的报销单，可以复用银行卡、部门等内容

  

• 2）获取勾选的任意1条明细记录

  获取任意一个明细记录，以使用其关联的项目信息。由于是多条记录触发，"触发节点"就代表了多条触发的数据，因此通过获取单条数据 节点的 从多条数据中获取的方式任意获取一条，不用加筛选条件。

  

• 3）新增报销单

  报销单的报销明细，直接选择触发节点即可

  

• 4）弹出新增的记录进行完善

  如果还需要人工完善其他信息，可以使用界面推送节点自动打开刚才自动创建的报销单。

  

效果：

如何获取按钮流程的触发者

在系统类别下，获取点击批量按钮的触发者信息

记录详情动作和批量操作的动作

按钮可分别控制在记录详情页和批量操作时是否可用。

记录详情页中添加的按钮

• 打开记录详情时可见。
• 在列表中勾选单条记录时可见。

批量操作中添加的按钮

• 在表格视图中勾选多条记录时可见。
• 可根据业务需要关闭批量操作入口。

如下图配置：转正按钮在详情页和批量操作时都可用，离职按钮只能在详情页使用

快捷操作-让按钮显示在记录行和卡片中

支持将按钮添加到表格最右侧的操作列中，方便对记录快速操作。

支持添加的按钮包括：自定义动作、系统操作、配置好的打印模版。

支持的视图包括表格、看板、画廊、层级等视图。

如果按钮在当前视图中不可用时再操作列中也会隐藏，如果记录的数据不满足按钮条件，按钮为灰色不可点击的状态。

表格操作列效果：

卡片中的效果：

添加按钮

在视图的【配置视图】 > 【记录操作 > 【行内操作】（非表格视图时为“卡片操作”） ，添加需要的按钮。

按钮样式

按钮由名称、图标和颜色组成，在操作列表中，按钮的显示方式有三种：

• 标准样式： 显示名称、图标和颜色，可取消显示图标。

• 文字样式： 显示文字、图标，不显示颜色，可取消显示图标。

• 仅图标： ：不显示名称和颜色，仅显示图标。

显示按钮数量和首要按钮数量

• 设置操作列单元格中显示的按钮数量，最多显示3个， 超过设置数量，需点击更多按钮操作。

• 首要按钮将显示为实心按钮，其他按钮则显示为空心线框。 最多支持3个首要按钮。