参数变量替换

命令中参数变量用于表示特定的上下文或元素，这些上下文或元素将在运行时使用特定于当前上下文和设置的值替换。参数变量将在运行时进行验证，因此在创建宏、接口服务和计算规则或工作表参数时允许所有变量。对于计算规则，在初始创建时或使用“刷新”选项恢复规则时，将在 Infor BI OLAP 中创建这些规则（针对循环周期）之前替换变量。
注意：
  • 变量不区分大小写
  • 在用于宏功能时，每个参数只允许一个变量
  • 用于应用程序的变量格式为 app_var_VarName
  • 应用程序变量是在系统级声明，可以在循环级别覆盖
  • 应用程序变量是运行时间变量，可以替换为当前循环的版本。

有关参数明细，请参阅“参数变量”。

在宏命令中映射时，上下文参数（%itemcontext%、%locationcontext%、%periodcontext%）具有以下属性：

  • 在工作表中执行宏时，变量将选取当前上下文值。
    注意：
    • 如果使用主工作表工具栏上的“执行宏”选项来执行宏，则将使用当前模块数据上下文。
    • 如果使用当前工作表中的“宏”选项执行宏，则将使用该维度的当前工作表数据上下文。
  • 当不是从工作表中（例如从循环周期详情或方案详情页面）执行宏时，则无法替换任何值，并且宏将失败。

在宏命令中映射时，上下文参数 (%measurecontext%) 具有以下属性：

  • 在工作表中执行宏时，变量将选取当前上下文值。
    注意：
    • 如果使用主工作表工具栏中的“执行宏”选项来执行宏，或者没有度量上下文传递到工作表，则无法替换任何值，并且宏将失败。
    • 如果使用多面板工作表的目标面板中的“宏”选项执行宏，则使用当前工作表的度量上下文。
  • 当不是从工作表中（例如从循环周期详情或方案详情页面）运行宏时，则无法替换任何值，并且宏将失败。

当上下文参数（%cyclecontext%、%cycleperiodcontext%、%scenariocontext% 和 %modelcontext%）从宏上下文中转换时：

  • CyclePeriod 宏有 cyclecontext 和 cycleperiodcontext。
  • 从工作表执行时，包含 RunScenarioMacro 命令的循环周期宏可以利用 scenariocontext。
    注意：
    • 如果使用主工作表工具栏中的“执行宏”选项来执行宏，则将使用当前/主要模块数据上下文。
    • 如果使用当前工作表中的“宏”选项执行宏，则使用当前/主要工作表的数据上下文 (%scenariocontext%)。例如，从面板链接（如果适用）或模块数据上下文传递的上下文。
  • 方案宏有 cyclecontext、cycleperiodcontext 和 scenariocontext。Scenariocontext 取决于宏启动流程：
    • 如果从循环周期详情或方案详情页面执行方案宏，则使用当前方案上下文。
    • 如果从主工作表工具栏上的“执行宏”选项执行宏，则使用当前模块数据上下文。
    • 如果从当前工作表上的“宏”选项执行的宏，则使用当前工作表的上下文 (%scenariocontext%)。
  • 从工作表执行时，包含 RunCyclePeriodMacro 命令的系统宏可以利用 cyclecontext、cycleperiodcontext。
  • 从工作表执行时，包含 RunScenarioMacro 命令的系统宏可以利用 cyclecontext、cycleperiodcontext 和 scenariocontext。
    • 如果从当前工作表上的“宏”选项执行的宏，则使用当前工作表的上下文 (%scenariocontext%)。例如，从面板链接（如果适用）或模块数据上下文传递的上下文。
  • 从 Advanced Scheduling 模型详情执行时，包含 RunASMacro 命令的系统宏可以利用 modelcontext。
  • 其他系统宏命令不包含上下文。因此，无法替换任何值，并且宏将失败。

对于 %previouscycleperiod-Startdate% 和 %previouscycleperiod-Enddate% 参数，如果之前没有循环周期，则使用 %horizon-start%（第一个可用周期）。

参数对于正在运行的函数无效，导致程序终止并显示错误消息。