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 Server 、应用程序或数据库级别创建或设置替代变量。

要确保新的替代变量值在公式、分区定义和安全筛选器中可用,请停止并重新启动应用程序。替代变量的所有其他用途将在使用时动态解析。

添加或更新替代变量时,这些变量将发送到应用程序并动态解析。

要使用 Essbase Web 界面设置替代变量,请参阅使用替代变量。您还可以使用应用程序工作簿在应用程序级别设置变量,或使用以下 MaxL 语句:

删除替代变量

您可能需要删除不再需要的 Essbase 替代变量。

要删除替代变量,您可以将其从应用程序工作簿中删除并构建多维数据集,使用 Essbase Web 界面将其删除,或者使用以下 MaxL 语句:

更新替代变量

由于替代变量是用于更改信息的占位符,因此您可能需要频繁更新其值。您可以使用 MaxLEssbase Web 界面修改现有的替代变量。

要更新替代变量,可以使用以下 MaxL 语句之一(要使用的语句取决于变量的上下文):

如果您希望使用 Essbase Web 界面更新变量,请参阅使用替代变量以获取说明。