Obiee使用变量

Obiee 变量

Obiee 版本 11.1.1.5

库变量

库变量在同一时刻只有单一值。可以分为静态变量和动态变量。

静态变量和动态变量的调用方式是相同的。

 

 

静态变量

定义

后台与前台字段中调用

VALUEOF(“DATE”)

前台文本中调用

选择包含 HTML 标记来转义引号类的字符

@{biServer.variables['BI_EE_HOME']}

 

 

初始化块

 

初始化块用于创建 动态库变量 和 session 变量

可选择 3 种类型的数据源 :

1.         数据库 : 为库变量 /session 变量

2.         LDAP: 仅为 session 变量

3.         定制验证程序 : 仅为 session 变量

 

 必须为以下类型初始化块创建一个 专用的连接池（数据源类型选择 Obiee 服务器例外）

1.         All authentication and login-specific initialization blocks such as language,externalized strings, and group assignments.

2.         All initialization blocks that set session variables.

3.         All initialization blocks that set repository variables. These initialization blocks should always be run using credentials with administrator privileges.

 

选择延迟执行选项（仅 session 变量可用）

 
 

 

此选项会延迟执行该初始化块直到首次访问相关联的 session 变量，以此提高性能。

若不选此项，则在用户登录时，将执行所有初始化块来初始化全部 session 变量，登录用时将变长。

但下列情况下，无法开启此选项

1.       使用了 行范围初始化

2.       使用了 验证所需 选项

3.       数据源类型非 数据库型

4.       与系统变量 USER 或 POXY 关联

5.       关联的 session 变量使用了 安全相关 选项

6.       调用了与其他不允许 延迟执行 的初始化块相关联的 session 变量

 

验证所需选项（仅 session 变量可用）

 

 

 

选择此项后， 若该初始化块执行失败，则用户被拒绝登录 Obiee ！

但不影响系统用户的登录

 

 

动态变量

定义

l  首先创建初始化块

l  指定连接池后写入相应数据库的 sql 语句

定义的变量值即为 Select 结果集，顺序与 select 语句中选择的字段顺序一致。

此时若 select 返回多行，只取第一行作为结果，其余行忽略。（只有在 session 变量中使用行范围初始化可以令变量包含整个结果集 , 详见 Example3 ）

l  点击左下测试按钮来验证表达式（联机模式下使用了 :USER/:PASSWORD 变量的表达式不能测试 , 详见 session 变量 Example1 ）

l  指定刷新频率

 

分配到一个动态变量，可以设定默认初始化数值

调用

调用方法与库静态变量相同

 

Session 变量

session 变量在用户登录时被创建；它们可以分为 系统 session 变量 和 非系统 session 变量 。

session 变量不通过调度刷新。当用户启动一个 session 时， Oracle BI Server 创建一个新的 session 变量实例并将其初始化。

用户与 Session 变量交互的实质在于初始化块的 SQL 中引用的 ’:USER’, 详见之后的 Example

系统 session 变量和非系统 session 变量的定义与调用方法相同。

选择安全相关选项可以采用数据库行级别安全限制策略（如 VPD ）

 

 

 

 

系统 session 变量

系统 session 变量的名称是预定义的关键字。

系统 session 变量列表

USER	用户名
PROXY	代理人
GROUP	权限组
WEBGROUPS	定义目录组 Presentation Services groups
USERGUID
ROLES	角色
ROLEGUIDS	角色 GUID
PERMISSIONS	权限
DISPLAYNAME	显示名
PORTALPATH	定义用户登录时所见默认 Dashboard
LOGLEVEL	0~5
REQUESTKEY
SKIN	皮肤
DESCRIPTION	说明
USERLOCALE
DISABLE_CACHE_HIT
DISABLE_CACHE_SEED
DISABLE_SUBREQUEST_CACHE
SELECT_PHYSICAL
DISABLE_PLAN_CACHE_HIT
DISABLE_PLAN_CACHE_SEED
TIMEZONE	时区

 

 

Example1- 使用 session 变量

本例通过建立系统 session 变量 USER 来使用外部权限表的用户登录 Obiee

 

l  首先创建外部权限表（ FCT_PERMISSION ）

 

l  新建初始化块，数据源选择 数据库 型

l  编写 SQL 语句：

select USER_NAME, USER_PASSWORD from FCT_PERMISSION

WHERE USER_NAME = ':USER' AND USER_PASSWORD = ':PASSWORD'

':USER' 和 ':PASSWORD' 是页面登录时键入的用户名、密码（在数据源选择 Obiee 服务器 时，无需加上引号）

若去掉该 where 子句，结果是任何用户名无需密码即可登录 Obiee ！

原因是此时系统 session 变量 USER 被成功的初始化了（即 select 结果集的第一个值），而页面键入的登录用户名只是作为了 DISPLAYNAME

l  将该初始化块分配给系统 session 变量 USER 和非系统 session 变量 PASSWORD

 

非系统 session 变量

通常使用非系统 session 变量来设定用户过滤器。

 

定义

参见前面 Example

 

后台与前台字段中调用

 

VALUEOF(NQ_SESSION.s_var)

 

前台文本中调用

@{biServer.variables['NQ_SESSION.s_var']}

 

 

Example2- 使用行范围初始化 Row-Wise Initialization

You can use the row-wise initialization option to create session variables dynamically and set their values when a session begins

本例使用数据库中的表数据来一次建立用户的 Session 变量列表，并设置其初始化值

本例中为 2 个用户定义了 1 个同名的 session 变量及各自独有的 session 变量

若令 Neednot 登录查看 Jane 独有的 session 变量 Status 将返回 Error ，故应用户屏蔽对其非法的 session 变量

 

l  数据库中建立 Session 变量对应的表 FCT_SESSION_LIST

Session_name 作为 Session 变量名， Session_value 作为变量值

l  建立初始化块 , 数据源选择 数据库型

l  编写 SQL 为

SELECT  SESSION_NAME, SESSION_VALUE FROM FCT_SESSION_LIST

WHERE USER_NAME = ':USER'

l  变量目标配置时选择行范围初始化

l  在前台中调用 VALUEOF(NQ_SESSION.Level) 查看效果

l  Neednot 登录时为 4 ， Jane 登录时为 5

 

Example3- 使 session 变量包含一个值列表

本例创建一个名为 LIST_OF_USERS 的 session 变量，包含符合特定条件的 USER 列表。

l  仍使用前例的表 FCT_SESSION_LIST

l  建立初始化块 , 数据源选择 数据库型

l  编写 SQL 为

SELECT  ‘LIST_OF_USERS’, USER_NAME FROM FCT_SESSION_LIST

WHERE SESSION_NAME = ‘Level’

l  变量目标配置时选择行范围初始化

l  将此变量用于 WHERE 字句作为过滤条件

WHERE Yourtable .USER_NAME = valueof(NQ_SESSION.LIST_OF_USERS)

等价于

WHERE Yourtable .USER_NAME IN (‘Neednot’,’Jane’)

 

表示变量

是与 仪表盘提示 绑定的变量

可以创建 列提示 或 变量提示 来绑定一个表示变量

定义

在仪表盘提示中进行定义

列提示

 

变量提示

 

公式与文本中调用

@{variables.P_var}[Format}{Default}     Format 用方括号包围

或

@{scope .variables['P_var ']}

加上单引号可使其转换为文本型

scope identifies the qualifiers for the variable. You must specify the scope when a variable is used at multiple levels (analyses, dashboard pages, and dashboards) and you want to access a specific

value. (If you do not specify the scope, then the order of precedence is analyses, dashboard pages, and dashboards.)

Example ：   @{variables.SelectDate}[MM/DD/YYYY]{'Unkown'}

 

请求变量

请求变量同样与 仪表盘提示绑定 ， 与 session 变量设置为同名用来更新 session 变量的值 。