全局变量

1 概述

1.1 版本

1.2 功能简介

系统中可能会存在很多表单都使用了某些参数，希望能够通过全局更改对应参数值，所有引用了对应参数的表单将自动按照全局设置的参数值进行查询，可减少用户重复操作，提升用户体验。
通过全局变量变更可以批量改变表单中参数默认值进行数据查询。

2 功能说明

2.1 变量配置

以“系统管理员”身份登录系统，进入“系统维护–》资源–》用户变量”界面，如下图：

配置需要使用的全局变量，具体参考“用户变量”章节说明。

2.2 变量使用

1、选择应用中需要显示的变量
登录设计器，切换到需要显示变量的应用，进入工具栏“应用》高级配置”配置界面，切换到“门户”Tab，选择需要显示的变量即可，如下图：

• 全局变量：选择该应用中需要使用的全局变量，下拉可选的变量就是系统管理员配置的有控件的“用户变量”；
• 常用变量个数：按照全局变量列表显示顺序结合配置的常用变量个数（最多可配置5个），计算出哪些作为常用变量显示，常用变量可直接在页面顶部操作，无需进入专门的面板。

2、表单参数默认值引用用户变量
需要将通过门户全局设置的变量值传递给表单参数，才能做到批量更改表单查询条件进行数据查询。
下面以报表为例，报表中需要存在用来接收全局变量值的参数，默认值勾选“默认值脚本解析”，通过表达式引用系统用户变量中系统管理员定义的全局变量即可。如下图：

用于接收变量值的参数一般不需要显示，参数不勾选“报表查看时，在参数区域显示”即可。

2.3 门户操作

2.3.1 全局变量显示和交互

普通用户登录门户，访问某应用时，若该应用的高级配置中添加了全局变量，则顶部栏右上角的位置上将显示添加的所有变量以及对应的默认值，其具体样式由应用设计者的配置决定，主要分为以下两种显示方式：
方式一：常用变量直接显示（当设计者设置了“常用变量个数”大于0时）
在顶部栏直接显示一个或多个可编辑的控件（目前仅支持下拉框），每个控件对应一个变量。

直接在这些控件中修改变量值，修改立即生效。应用中所有用到此变量的地方都会同步更新。

如果应用的全部变量数量多于直接显示的数量，将会显示 “更多”按钮，点击它，会展开一个面板，里面列出了所有未在顶部直接显示的变量，您可以在此进行编辑，编辑同样实时生效。

方式二：显示全局变量按钮（当设计者设置“常用变量个数”为0时）
顶部栏将显示一个 “全局变量” 按钮，全部变量统一由该按钮管理，如下图：

点击“全局变量”按钮，会弹出完整的全局变量设置面板。您可以在面板中修改所有变量的值，修改立即生效。

2.3.2 变量值记忆规则

您可能会发现，有时重新登录应用，之前修改的变量值还在；有时又变回了初始值。这是因为“记忆功能”由系统管理员统一控制：

• 开启记忆：如果管理员在后台开启了“记住用户修改的全局变量值”功能，系统会保存您最后一次设置的变量值。您之后在任何地方登录，都会看到自己保存的值。
• 关闭记忆：如果管理员关闭了此功能，系统将不会保存您修改的值。您每次登录看到的都是该变量的“默认值”。
  具体配置参考“首选项”章节说明。

注意：此功能对所有变量统一生效，您个人无法单独设置某个变量是否记忆。