3.6 系统变量

数据接口:系统变量

1.简介

系统变量是一种特殊的数据接口。它就是一组含由平台提供的系统的数据,主要由当前的日期信息和当前的用户信息组成:
比如,设计请假单时,可以通过填写规范直接调用系统变量,填写表单的当前的登录用户的员工工号、员工姓名、部门信息和当前的时间、日期等等,对填写进行了规范化,也大大提高了填写效率。

2.系统变量属性

系统变量默认是全局的,在数据接口中选择“全局”后右侧才会出现“系统变量”的选项卡
名称用途
当前日期获取当前系统的日期,数据类型为日期类型
当前时间获取当前系统的时间,数据类型为时间型数据
当前日期时间获取当前系统的日期时间,数据类型为日期时间型数据  
当前用户部门编号获取当前登录用户的部门编号,数据类型为文本型数据  
当前用户部门全称获取当前登录用户的部门全称,数据类型为文本型数据
当前用户登录账号获取当前登录用户的登录账号,数据类型为文本型数据
当前用户所在部门获取当前登录用户所在部门,数据类型为文本型数据
当前用户所在机构获取当前登录用户所在机构,数据类型为文本型数据
当前用户所在机构全称获取当前登录用户所在机构全称,数据类型为文本型数据  
当前用户姓名获取当前登录用户姓名,数据类型为文本型数据
当前用户所有角色获取当前登录用户所有角色,数据类型为文本型数据
当前用户编号获取当前登录用户的编号,数据类型为文本型数据
当前用户所有岗位获取当前登录用户所有岗位,数据类型为文本型数据
当前用户部门ID获取当前登录用户部门ID,数据类型为文本型数据  
当前用户主岗位获取当前登录用户主岗位,数据类型为文本型数据
UUID通用唯一识别码,由英文数字随机组成,数据类型为文本型数据
当前用户登录第三方APPID需要特殊授权,且仅限云表平台内部使用
当前用户第三方登录类型需要特殊授权,且仅限云表平台内部使用

3.系统变量用法

使用位置说明
数据接口①自动编号数据接口的组成类别中可调用系统变量;②列表选择数据接可在过滤条件中调用系统变量进行筛选,在数据列中调用系统变量作为数据列,当有多数据源时还可在关联条件中调用系统变量;③下拉列表数据接口可在过滤条件中调用系统变量进行筛选;④树形列表数据接口可在过滤条件中调用系统变量进行筛选;
填写规范在数据表管理的填写规范上直接调用系统变量;
填表公式在填表公式事件下的公式中使用,比如赋值公式
业务公式在业务公式事件下的公式中使用;

4.案例应用

4.1在数据接口中的使用

查询当日的销售订单,过滤条件为“销售单.销售日期=系统变量.当前日期”。
在过滤条件上单击【编辑】,打开“过滤设置”对话框,该对话框的“分类”栏中显示“系统变量”,单击系统变量,“选项”栏中显示该分类下详细的选项,双击添加。

4.2在填写规范中的使用

比如,新建销售订单时自动填写销售日期。
进入《销售订单》模板的“数据定义管理”,在“销售日期”的填写规范上,单击【...】,弹出“选择数据接口”对话框,选择【全局】,打开“系统变量”选项卡,选择系统变量下的“当前日期”。

4.3在填表公式中的使用

比如,工作日报必须在第二天的8点前提交,如果通过填表公式提示用户时,需要在填表公式的“保存表单前”事件下添加“提示框”操作。
什么时候弹出提示框呢?执行条件为 :填报日期与表单的汇报日期相差1天,并且 填报日期的时间在8点后,即 日期间隔( "dd" , 本表单.汇报日期 , 系统变量.当前日期 ) >= 1 并且 HourOfTheDay( 系统变量.当前日期 ) >= 8  时,弹出提示框提示用户。

4.4在业务公式中的使用

比如《采购入库单》的审核人与反审人必须为同一人,则当反审人与表单的审核人不一致时,系统弹出提示框提醒。
“采购入库单”审核时,将“系统变量.当前用户姓名”赋值给“本表单.审核人”,添加情况“反审_校验审核人”,反审时,执行条件为“本表单.审核=常量.否”,设置满足满足条件,“本表单.审核人<> 系统变量.当前用户姓名”时,弹出提示框“该单据的审核人与反审人不一致,不允许反审!”
2022-06-30
41 41