Skip to content

行为动作

行为动作是事件流里「真正执行的一步」:打开模块、设值、校验、发请求、提示等。配置事件时先选时机,再按顺序添加动作;多个动作组成动作链。

本文是动作能力的完整说明;何时触发请看事件配置表单事件全局事件

行为动作

在哪里用到动作

入口说明
组件事件点击、值变化等 → 事件流里添加动作
表单事件提交、加载完成等 → 同样可挂动作
全局事件沉淀可复用的动作流,再被引用
插槽点击等部分插槽支持点击后再走事件 / 动作

动作链怎么执行

text
动作1 → 动作2 → 动作3 → …
机制含义(界面文案)
顺序执行默认按添加顺序往下走
等待完成确认框、校验、请求、打印等会等完成后再继续
执行条件条件成立才执行该动作,否则跳过
阻断条件条件成立则后面的动作不再执行
执行异常出错后是继续还是中断(「执行异常」)

条件写法见使用逻辑条件

内置动作一览

名称以界面中文为准。与事件配置中的简表对应,本文补充配置要点。

页面

动作做什么配置要点
跳转页面打开指定地址或路由链接跳转(浏览器地址)或 路由跳转(单页应用路径);可开新窗口 / 当前窗口
刷新页面刷新当前页一般无需参数

链接 vs 路由

链接跳转是传统整页跳转;路由跳转用于单页应用内切换。路由方式需环境已提供路由能力,否则请用链接跳转。

弹层 / 提示

动作做什么配置要点
打开弹窗 / 打开模块打开模块管理中的弹窗 / 抽屉选择目标模块;可带表单数据、提交回调(以界面为准)
关闭弹窗 / 关闭模块关闭当前或指定弹窗选择要关的模块
消息提醒顶部 / 角落提示类型:信息 / 成功 / 警告 / 错误;文案、时长、是否显示关闭
确认弹窗让用户确认后再继续标题 + 内容;用户取消则后续动作不继续

行为动作

表单

动作做什么配置要点
组件可见性显示或隐藏指定组件可选多个;静态或表达式 / 公式
组件可用性启用或禁用指定组件同上
重置表单恢复为初始值
清空表单清空字段值
校验表单校验整表失败时通常阻断后续(配合阻断 / 异常策略)
校验表单项只校验选中的字段多选字段
表单赋值给一个或多个字段设值静态值或表达式 / 公式
提交表单手动触发提交会走表单提交相关流程

与高级条件的分工

长期、随填写自动变化的显隐 / 禁用,优先隐藏条件 / 禁用条件。 动作里的可见性 / 可用性适合「点一下才改」或与弹窗流程绑定的临时状态。

其它

动作做什么配置要点
发送请求调用接口地址、方法、参数等;可「追加表单数据」;结果可存到变量
打印表单调起打印
导出 PDF导出当前表单为 PDF
复制内容复制到剪贴板静态文本或表达式
抛出事件通知外部业务事件名称 + 可选参数(供宿主页面监听)
自定义操作用脚本补充仅在内置动作不够时使用

发送请求配置

环境可通过扩展注册更多动作,列表以界面实际项为准。

怎么配置(分步)

  1. 在事件中进入事件流。
  2. 点击 添加动作,按分类选择。
  3. 填该动作的参数(目标字段、模块名、文案等)。
  4. 需要时设置执行条件 / 阻断条件。
  5. 调整动作顺序(先确认再校验再提交,等)。
  6. 预览:成功路径、取消确认、校验失败各走一遍。

业务示例

入门:打开须知再关闭

text
点击「查看须知」
  → 打开模块(活动须知)

须知内「我知道了」:

text
点击
  → 关闭模块

入门:提交前确认

text
点击「提交」
  → 确认弹窗(确认提交本单?)
  → 校验表单
  → 提交表单

用户点取消,确认未通过,后续不执行。

确认后提交动作链

常用:选人回填

text
主表「选择」点击 → 打开模块(选人)
弹窗「确定」点击 → 表单赋值(姓名、部门)→ 关闭模块

常用:校验联系方式再进入下一步

text
点击「下一步」
  → 校验表单项(手机号、邮箱)
  →(失败则消息提醒,并阻断后续)
  → 打开模块(步骤二)或跳转页面

常用:复制单号

text
点击「复制」
  → 复制内容(取单号字段或表达式)
  → 消息提醒(已复制)

也可把「复制」放在字段插槽后缀图标的点击上。

常用:保存草稿到接口

text
点击「存草稿」
  → 发送请求(草稿接口,追加或部分表单数据)
  → 成功则消息提醒;结果写入变量供后续使用

常用:按条件跳过打印

对「打印表单」动作设执行条件:仅当「需要纸质存档」= 是 时执行;否则跳过该动作,继续后面的关闭模块等。

常用:无权限则阻断导出

结合身份与权限:导出动作前加确认;或对「打开导出」设执行条件为权限包含导出权,否则消息提醒并阻断。

配置技巧

技巧说明
先模块后动作打开模块前,先在模块管理建好目标
字段 ID 正确赋值、显隐、校验依赖稳定的字段 ID
公式 / 表达式赋值、显隐、复制等支持表达式时,可引用字段与变量
复用多按钮相同流程 → 全局事件
少用自定义团队协作优先可视化动作,便于他人维护
与变量配合请求结果、开关位可写入变量,再给变量绑定

注意点

  • 值变化事件里避免过重请求,防止输入卡顿。
  • 抛出事件需宿主页面按约定监听,否则「点了没反应」。
  • 路由跳转依赖环境路由;不确定时用链接跳转。
  • 长期显隐不要只靠动作「点一次」,应用隐藏条件自动算。

相关阅读

相关技术文档