#变量

#介绍

变量是一组标记，用来标识当前上下文中的某个值，可以在配置区块数据范围、字段默认值、联动规则、工作流等场景下使用。

#现在已经支持的变量

#当前用户

表示当前登录用户的数据。

#当前角色

表示当前登录用户的角色标识（role name）。

#当前表单

当前表单的值，仅用于表单区块。使用场景有：

• 当前表单的联动规则
• 表单字段默认值（仅新增数据时有效）
• 关系字段的数据范围设置
• 提交操作的字段赋值配置

#当前表单的联动规则

#表单字段默认值（仅新增表单）

#关系字段的数据范围设置

用于根据上游字段动态筛选下游字段的可选项，确保数据录入准确。

示例：

1. 用户选择 Owner 字段的值。
2. 系统根据所选 Owner 的 userName 自动筛选 Account 字段的选项。

#当前记录

记录是指数据表中的行，每一行代表着一条记录。在展示类的区块的行操作的联动规则里都有「当前记录」变量。

示例：「已付款」的单据禁用删除按钮。

#当前弹窗记录

弹窗操作在 NocoBase 界面配置中扮演着非常重要的角色。

• 行操作的弹窗：每个弹窗都会有个「当前弹窗记录」变量，表示当前行记录。
• 关系字段的弹窗：每个弹窗都会有个「当前弹窗记录」变量，表示当前点击的关系记录。

弹窗里的区块都可以使用「当前弹窗记录」这个变量，相关使用场景有：

• 配置区块的数据范围
• 配置关系字段的数据范围
• 配置字段的默认值（新增数据的表单）
• 配置操作的联动规则

#URL 查询参数

该变量表示的是当前页面 URL 中的查询参数，只有当页面 URL 中存在查询字符串时该变量才是可用状态。配合链接操作一起使用会更方便。

#API token

该变量的值是一个字符串，是用于访问 NocoBase API 的凭证。可以用于验证用户的身份。

#当前设备类型

示例：非电脑端设备不显示「模板打印」操作。