跳到主要内容

批量操作按钮配置

批量操作按钮在用户勾选列表数据后出现,对选中的多条记录执行统一操作。

概述​

批量操作按钮位于列表工具栏,仅在用户勾选了列表行数据后才显示 / 可用。在编辑器的 批量操作按钮配置 卡片中:

  • 点击 新增批量操作按钮 添加按钮,新按钮默认样式为「链接」。
  • 拖动调整显示顺序,点击按钮打开属性抽屉进行配置,可删除。

配置项​

配置项说明
按钮名称按钮显示文字,必填
业务类型目前仅支持「执行事件流」
事件流点击后对勾选数据执行的动作
按钮样式默认 / 主题色 / 幽灵(反色)/ 虚线 / 链接 / 文本
展示为危险按钮是否使用危险色呈现
按钮图标按钮前的图标
是否隐藏是否隐藏该按钮

业务类型​

批量操作按钮目前只支持「执行事件流」:

业务类型存储值说明
执行事件流ExecuteActionPipeline对勾选数据执行事件流

按钮样式​

样式存储值
默认default
主题色primary
幽灵(反色)ghost
虚线dashed
链接link
文本text

支持的动作类型​

批量操作可配置以下动作:

动作类型存储值说明
批量编辑表单后刷新BatchEditFormThenRefresh对勾选数据打开批量编辑表单
数据导出DataExport导出勾选数据
请求接口RequestInterface调用平台接口处理勾选数据
批量审批同意ApprovalBatchAgree批量同意审批
批量审批不同意ApprovalBatchDisagree批量不同意审批
批量退回ApprovalBatchReturn批量退回审批
关闭临时页面CloseTemporaryPage关闭临时页面
刷新关联数据RefreshRelation刷新关联数据
刷新页面RefreshPage刷新当前页面
重新加载页面ReloadPage重新加载页面

使用注意​

  1. 数据范围:批量操作仅作用于当前已勾选的数据。
  2. 确认提示:删除、作废等危险操作建议配置二次确认。
  3. 反馈机制:操作完成后应有明确结果反馈。

下一步​

属性明细​

以下内容面向技术实现与 AI 检索,说明批量操作按钮 MetaViewBatchButtonItem 的属性。

MetaViewBatchButtonItem 属性表​

批量操作按钮继承自 MetaViewButtonItem(进而继承 MetaViewButtonBase),后台未新增任何字段,用于授权中的类型判断:

属性名类型含义取值/存储值
Idstring(GUID)按钮标识仅作前端标识
Namestring按钮名称显示文字,必填
IsHidebool是否隐藏默认 false
BizTypestring业务类型目前仅 ExecuteActionPipeline
ActionPipelinestring事件流JSON 字符串
MicroAppNamestring微应用名继承自基类,批量操作不使用
MicroAppPathstring微应用路由继承自基类,批量操作不使用
Typestring按钮样式default/primary/ghost/dashed/link/text,新建默认 link
IsDangerbool危险按钮默认 false
Iconstring图标图标标识串

存储示例​

{
"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 序列化)。