特殊参数

  • 特殊参数为系统强制填值的参数,分登录用户参数和数据权限参数两种
  • 设置位置:
    • 开发环境: 报表模板属性编辑 -> 模板参数需要内置参数选项
    • 生产环境: 运维管理->积木打印模版设置->内置参数

用户参数

  • 所谓用户参数,为当前登录用户的参数自动填值到报表参数里
  • 表达式举例:
    • 用户编码: $vs.user.USER_ID
    • 所属部门: $vs.user.DEPT_CODE
    • 其他可以参考谷神API文档 $vs.user.xxx
  • 用户参数在报表设计时使用方式和业务自定义参数相同

数据权限

  • 数据权限为当前用户对指定数据权限的值集合
  • 设置时,需要选择(或填写)数据权限编码和报表参数名称
  • 数据权限使用示例:
    -- authDeptCode 为部门数据权限参数名称
    -- 系统将自动把当前用户所拥有的代码列表传参过来,数据如: 0001,0002,0003
    -- 系统管理员和不控制权限的用户,数据为: *
    -- 没有任何权限的用户,数据为: 空字符串
    -- 话外:其他类型的报表,如:润乾和帆软,数据权限填值时也是这个格式
    select * from basic_dept where 1=1
    <#if isNotEmpty(authDeptCode)>
      <#if authDeptCode!='*'> -- * 表示所有权限,不用添加约束
          -- 若为数字格式,则使用:and num_field in (${authDeptCode})
          and dept_code in (${DaoFormat.in('${authDeptCode}')})
      </#if>
    <#else> -- 空表示当前用户没有任何权限
       and 1=2
    </#if>
    <#if isNotEmpty(DEPT_CODE)> -- 普通参数条件表达式
       and DEPT_CODE = '${DEPT_CODE}'
    </#if>
文档更新时间: 2026-04-29 14:42   作者:weir