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
2323
Baidu
map