*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

Для пояснения DESTINATION_APP с SKIP_DIM, ADD_DIM, и RENAME_DIM, создается другая модель DETAIL_PLAN путем копирования модели PLANNING из поставляемого образца среды EnvironmentShell. Это необходимо, чтобы:

• создать новые измерения PRODUCT и MARKET и добавить их в модель DETAIL_PLAN

• заменить P_ACCT на P_ACCTDETAIL

• удалить измерение P_ACTIVITY из инфо-провайдера DETAIL_PLAN

               *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 является целевой моделью, в которой имеются все измерения PLANNING, кроме P_ACCT. Это измерение заменено на P_ACCTDETAIL. Кроме того, DETAIL_PLAN имеет два дополнительных измерения: PRODUCT и MARKET.

Вышеупомянутая логика скрипта перемещает данные в DETAIL_PLAN с:

• пустыми данными в измерениях PRODUCT и MARKET

• P_DATASRC, определенным ключевым словом INPUT

• соответствующими значениями P_ACCT, скопированными в P_ACCTDETAIL