*DESTINATION_APP

语法

*DESTINATION_APP = {app name}

通常，目标模型仅共享原始模型的某些维。在此情况下，可以使用下列指令从原始记录拖出缺失的维：

*SKIP_DIM= {dimension name}[,{dimension name},…]

当原始模型包含在目标模型中找不到的维时，SKIP_DIM 关键字为必需项。如果缺少 SKIP_DIM 关键字，则无法通过验证。

可以向指令提供由逗号分隔的多个维名称，或通过在单独的行中输入多个 SKIP_DIM 指令来提供多个维名称。

如果目标模型中包含原始模型中不存在的维，则可以使用下列指令将这些维添加到传递的记录：

*ADD_DIM {dimension name}={value}[,{dimension name}={value} [, {dimension name} = {dimension name(source): Property name}, #]

可以向指令提供由逗号分隔的多个维名称和值，或通过单独的行中输入多个 ADD_DIM 指令来提供多个维名称和值。此外，也支持维属性（源模型中的维）。

示例：

可以使用关键字 RENAME_DIM 更改一个或多个维的名称。语法是：

*RENAME_DIM {dimension name}={value}[,{dimension name}={value},…]

将数据写入其维具有不同名称标识的模型中时，可以使用此指令。

可以向指令提供由逗号分隔的多个维名称和值，或通过单独的行中输入多个 RENAME_DIM 指令来提供多个维名称和值。

支持以上三个关键字的任意组合。

示例

示例 1

Environment：EnvironmentShell_V

模型：PLANNING

在此示例中，EnvironmentShell_V 是 EnvironmentShell 的副本，COPY_PLANNING 是 PLANNING 模型的副本。可以在 PLANNING 模型中执行此示例中显示的脚本，从而将 ACTUAL 数据复制到 COPY_PLAN 模型。

当 *DESTINATION_APP 命令仅在脚本中出现过一次，则参考目标模型中将出现脚本逻辑文件的所有剩余数据写入。所有数据均在 *DESTINATION_APP 写入当前脚本运行的模型中之前写入。

               *XDIM_MEMBERSET TIME = 2006.AUG
               *XDIM_MEMBERSET CATEGORY=ACTUAL
               

               *DESTINATION_APP=COPY_PLANNING
               *WHEN CATEGORY
               *IS "ACTUAL"
               *REC(EXPRESSION=%VALUE%)
               *ENDWHEN
            

示例 2

要说明带有 SKIP_DIM、ADD_DIM, 和 RENAME_DIM 的 DESTINATION_APP，需通过从交付的 EnvironmentShell 中复制 PLANNING 模型来创建另一模型 DETAIL_PLAN。需要执行下列操作：

• 新建维 PRODUCT 和 MARKET，并将其添加到 DETAIL_PLAN 模型

• 用 P_ACCTDETAIL 替换 P_ACCT

• 从 DETAIL_PLAN InfoProvider 中移除 P_ACTIVITY 维

               *XDIM_MEMBERSET TIME = 2006.AUG
                *XDIM_MEMBERSET CATEGORY=ACTUAL
               

               *DESTINATION_APP=DETAIL_PLAN
               *SKIP_DIM = P_ACTIVITY
               *ADD_DIM P_DATASRC=INPUT, PRODUCT = NO_PRODUCT, MARKET = NO_MARKET
               *RENAME_DIM P_ACCT=P_ACCTDETAIL
               

               *WHEN CATEGORY
                       *IS "ACTUAL"
                       *REC(EXPRESSION=%VALUE%)
               *ENDWHEN
            

解释

DETAIL_PLAN 是目标模型，它包含除 P_ACCT 之外的 PLANNING 的所有维。用 P_ACCTDETAIL 替代该维。另外，DETAIL_PLAN 有两个附加维，名称分别为 PRODUCT 和 MARKET。

上述脚本逻辑将数据移动到包含下列数据的 DETAIL_PLAN 中：

• PRODUCT 和 MARKET 维中的空白数据

• P_DATASRC，由关键字 INPUT 定义

• 复制到 P_ACCTDETAIL 的 P_ACCT 的相应值