Implement Variables for Changing Information
您可以使用 Essbase 替代变量作为定期更改信息的占位符。由于对变量值的更改会反映在使用该变量的任何位置,因此将手动更新需求降至最低。
例如,许多报告取决于报告期间;如果根据本月生成报告,则必须每月手动更新报告脚本。有了替代变量(例如,在 Essbase Server 上设置的 CurMnth),您就可以将每个月的分配值更改为相应的期间。在报表脚本中使用变量名称时,将在运行最终报表时动态更新信息。
可以在以下区域将替代变量与聚合存储 (ASO) 和块存储 (BSO) 应用程序一起使用(除非另有说明):
-
汇总存储大纲公式
-
块存储大括号公式
-
计算脚本(仅限块存储数据库)
计算脚本支持替代变量和运行时替代变量。
-
数据加载规则文件标题定义和字段定义。您可以为维和成员名称输入变量名称。
-
SQL 数据源的规则文件中的数据源名称 (Data Source Name,DSN) 规范
-
SQL 数据源的规则文件中的 SELECT、FROM 或 WHERE 子句
-
安全性筛选器
-
MDX 查询
-
Smart View
-
报告脚本
可以在以下级别设置替代变量:
-
全局:提供对 Essbase Server 上所有应用程序和数据库的变量的访问权限。
-
应用程序:提供对应用程序内所有数据库的变量的访问。
-
数据库:提供对指定数据库内变量的访问。
允许的替代变量名和值
在 Essbase 中使用替代变量时,请遵循与可用于替代变量名称和值的字符和数据类型相关的准则。
以下限制适用于替代变量名称和值:
变量名称中允许的字符
允许使用字母数字字符和下划线,但不允许使用特殊字符或空格。字符限制:请参见 Limits 。
变量值中允许的字符
除前导和符号 (&) 之外,允许使用任何字符。字符限制:请参见 Limits 。
用作变量值的 Essbase 成员名称
对于块存储数据库,将以数字开头或包含任何特殊字符的成员名称括起来 (" ");对于聚合存储数据库,将成员名称括起来 ([ ])。有关更多详细信息,请参阅计算脚本、报表脚本、公式、筛选器以及替代和环境变量值中的命名惯例。
要将替代变量值设置为重复的成员名称,请使用括在双引号中的限定成员名称;例如,&Period 的值可以是 "[2022].[Qtr1]"。
请勿将替代变量名称用作限定成员名称的一部分。例如,指定 "[2022].[&CurrentQtr]" 无效。
用作变量值的数字
对于块存储 (BSO) 数据库,将数字值括在引号 (" ") 中;对于聚合存储 (ASO) 数据库,将数字值括在括号 ([ ]) 中。
例如,如果变量 name 为 Month,而其值为 01,则对于块存储,将值设置为 "01"。对于聚合存储,请将该值设置为 [01]。
具有相同名称的多个变量
变量可以具有相同的名称,只要它们是在不同的作用域中定义的。变量解析优先级的工作方式如下:数据库变量在应用程序变量之前解析。应用程序变量在全局变量之前解析。
创建或设置替代变量
设置替代变量之前,请参阅允许的替代变量名称和值。
要确保新的替代变量值在公式、分区定义和安全筛选器中可用,请停止并重新启动应用程序。替代变量的所有其他用途将在使用时动态解析。
添加或更新替代变量时,这些变量将发送到应用程序并动态解析。
要使用 Essbase Web 界面设置替代变量,请参阅使用替代变量。您还可以使用应用程序工作簿在应用程序级别设置变量,或使用以下 MaxL 语句: