批量操作按钮配置
批量操作按钮在用户勾选列表数据后出现,对选中的多条记录执行统一操作。
概述
批量操作按钮位于列表工具栏,仅在用户勾选了列表行数据后才显示 / 可用。在编辑器的 批量操作按钮配置 卡片中:
- 点 击 新增批量操作按钮 添加按钮,新按钮默认样式为「链接」。
- 拖动调整显示顺序,点击按钮打开属性抽屉进行配置,可删除。
配置项
| 配置项 | 说明 |
|---|---|
| 按钮名称 | 按钮显示文字,必填 |
| 业务类型 | 目前仅支持「执行事件流」 |
| 事件流 | 点击后对勾选数据执行的动作 |
| 按钮样式 | 默认 / 主题色 / 幽灵(反色)/ 虚线 / 链接 / 文本 |
| 展示为危险按钮 | 是否使用危险色呈现 |
| 按钮图标 | 按钮前的图标 |
| 是否隐藏 | 是否隐藏该按钮 |
业务类型
批量操作按钮目前只支持「执行事件流」:
| 业务类型 | 存储值 | 说明 |
|---|---|---|
| 执行事件流 | ExecuteActionPipeline | 对勾选数据执行事件流 |
按钮样式
| 样式 | 存储值 |
|---|---|
| 默认 | default |
| 主题色 | primary |
| 幽灵(反色) | ghost |
| 虚线 | dashed |
| 链接 | link |
| 文本 | text |
支持的动作类型
批量操作可配置以下动作:
| 动作类型 | 存储值 | 说明 |
|---|---|---|
| 批量编辑表单后刷新 | BatchEditFormThenRefresh | 对勾选数据打开批量编辑表单 |
| 数据导出 | DataExport | 导出勾选数据 |
| 请求接口 | RequestInterface | 调用平台接口处理勾选数据 |
| 批量审批同意 | ApprovalBatchAgree | 批量同意审批 |
| 批量审批不同意 | ApprovalBatchDisagree | 批量不同意审批 |
| 批量退回 | ApprovalBatchReturn | 批量退回审批 |
| 关闭临时页面 | CloseTemporaryPage | 关闭临时页面 |
| 刷新关联数据 | RefreshRelation | 刷新关联数据 |
| 刷新页面 | RefreshPage | 刷新当前页面 |
| 重新加载页面 | ReloadPage | 重新加载页面 |
使用注意
- 数据范围:批量操作仅作用于当前已勾选的数据。
- 确认提示:删除、作废等危险操作建议配置二次确认 。
- 反馈机制:操作完成后应有明确结果反馈。
下一步
属性明细
以下内容面向技术实现与 AI 检索,说明批量操作按钮 MetaViewBatchButtonItem 的属性。
MetaViewBatchButtonItem 属性表
批量操作按钮继承自 MetaViewButtonItem(进而继承 MetaViewButtonBase),后台未新增任何字段,用于授权中的类型判断:
| 属性名 | 类型 | 含义 | 取值/存储值 |
|---|---|---|---|
Id | string(GUID) | 按钮标识 | 仅作前端标识 |
Name | string | 按钮名称 | 显示文字,必填 |
IsHide | bool | 是否隐藏 | 默认 false |
BizType | string | 业务类型 | 目前仅 ExecuteActionPipeline |
ActionPipeline | string | 事件流 | JSON 字符串 |
MicroAppName | string | 微应用名 | 继承自基类,批量操作不使用 |
MicroAppPath | string | 微应用路由 | 继承自基类,批量操作不使用 |
Type | string | 按钮样式 | default/primary/ghost/dashed/link/text,新建默认 link |
IsDanger | bool | 危险按钮 | 默认 false |
Icon | string | 图标 | 图标标识串 |
存储示例
{
"Id": "c2d3e4f5-0002-4b3c-9d4e-444455556666",
"Name": "批量删除",
"IsHide": false,
"BizType": "ExecuteActionPipeline",
"ActionPipeline": "[{\"ActionType\":\"RequestInterface\",\"Params\":{\"metaInterfaceId\":\"...\"}}]",
"Type": "link",
"IsDanger": true,
"Icon": "DeleteOutlined"
}
相关接口
批量操作按钮随视图列表通过 POST /api/MetaView/SaveLayout 提交,存于 BatchButtonItems 字段(JSON 序列化)。