*DESTINATION_APP

Syntax

*DESTINATION_APP = {app name}

Häufig hat das Zielmodell nur einige Dimensionen mit dem Ausgangsmodell gemeinsam. In diesem Fall kann man die fehlenden Dimensionen aus den ursprünglichen Sätzen mit folgender Anweisung wegfallen lassen:

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

Wenn das Ausgangsmodell Dimensionen besitzt, die im Zielmodell nicht vorhanden sind, ist das Schlüsselwort SKIP_DIM obligatorisch. Eine Validierung kann ohne das Schlüsselwort SKIP_DIM nicht stattfinden.

Der Anweisung können mehrere Dimensionsnamen hinzugefügt werden, entweder durch Kommas getrennt oder durch mehrere SKIP_DIM-Anweisungen in einzelnen Zeilen.

Wenn das Zielmodell Dimensionen aufweist, die im Ausgangsmodell nicht vorhanden sind, können diese den übermittelten Sätzen mit folgender Anweisung hinzugefügt werden:

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

Der Anweisung können mehrere Dimensionsnamen und -werte hinzugefügt werden, entweder durch Kommas getrennt oder durch mehrere ADD_DIM-Anweisungen in einzelnen Zeilen. Dimensionseigenschaften (Dimension aus dem Quellmodell) werden ebenfalls unterstützt

Beispiel:

Mit dem Schlüsselwort RENAME_DIM können Sie den Namen einer oder mehrerer Dimensionen ändern. Syntax:

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

Diese Anweisung kann verwendet werden, wenn Daten an ein Modell übermittelt werden, in dem eine Dimension eine andere ID trägt.

Der Anweisung können mehrere Dimensionsnamen und -werte hinzugefügt werden, entweder durch Kommas getrennt oder durch mehrere RENAME_DIM-Anweisungen in einzelnen Zeilen.

Alle Kombinationen der drei oben genannten Schlüsselwörter werden unterstützt.

Beispiele

Beispiel 1

Environment: EnvironmentShell_V

Modell: PLANNING

In diesem Beispiel ist EnvironmentShell_V eine Kopie von EnvironmentShell, und COPY_PLANNING ist eine Kopie des PLANNING-Modells. Sie können das Skript aus diesem Beispiel in einem PLANNING-Modell ausführen, um die ACTUAL-Daten in das COPY_PLAN-Modell zu übernehmen.

Wenn der Befehl *DESTINATION_APP ein Mal mitten im Skript erscheint, werden alle noch zu schreibenden Daten der Skriptlogikdatei in das referenzierte Zielmodell geschrieben. Vor dem Auftreten von *DESTINATION_APP werden alle Daten in das Modell geschrieben, in dem das Skript aktuell ausgeführt wird.

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

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

Beispiel 2

Um DESTINATION_APP mit SKIP_DIM, ADD_DIM, und RENAME_DIM zu erklären, ließe sich als Beispiel nennen, dass ein anderes Modell, DETAIL_PLAN, durch Kopieren des Modells PLANNING aus der mitgelieferten EnvironmentShell erstellt wird. Sie müssen:

• die neuen Dimensionen PRODUCT und MARKET erstellen und zum Modell DETAIL_PLAN hinzufügen

• P_ACCT durch P_ACCTDETAIL ersetzen

• die Dimension P_ACTIVITY aus dem InfoProvider DETAIL_PLAN entfernen

               *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
            

Erklärung

DETAIL_PLAN ist das Zielmodell, das alle Dimensionen von PLANNING außer P_ACCT besitzt. Diese Dimension wird durch P_ACCTDETAIL ersetzt. Außerdem besitzt DETAIL_PLAN zwei zusätzliche Dimensionen, nämlich PRODUCT und MARKET.

Die oben beschriebene Skriptlogik verschiebt die Daten nach DETAIL_PLAN mit

• leeren Daten in den Dimensionen PRODUCT und MARKET

• P_DATASRC, definiert durch das Schlüsselwort INPUT

• entsprechenden Werten aus P_ACCT, übernommen nach P_ACCTDETAIL