*DESTINATION_APP

Syntaxe

*DESTINATION_APP = {app name}

Il est fréquent que le modèle de destination partage seulement une partie des dimensions du modèle d’origine. Dans ce cas, les dimensions manquantes peuvent être ignorées dans les enregistrements d'origine avec l’instruction suivante :

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

Si le modèle d'origine a des dimensions introuvables dans le modèle de destination, le mot-clé SKIP_DIM est obligatoire. La validation ne peut pas être transférée sans le mot-clé SKIP_DIM.

Les noms de dimensions multiples peuvent être fournis à l’instruction séparés par des virgules ou par des instructions SKIP_DIM multiples entrées sur des lignes séparées.

Si le modèle de destination contient des dimensions qui n’existent pas dans le modèle d’origine, celles-ci peuvent être ajoutées aux enregistrements transférés à l’aide de l’instruction :

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

Les noms et valeurs de dimensions multiples peuvent être fournis à l’instruction séparés par des virgules ou par des instructions ADD_DIM multiples entrées sur des lignes séparées. Les propriétés de dimensions (dimension d'un modèle source) sont également prises en charge.

Exemple :

Le mot-clé RENAME_DIM peut être utilisé pour modifier le nom d'une ou plusieurs dimensions. La syntaxe est la suivante :

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

Cette instruction peut être utilisée lorsque des données doivent être écrites dans un modèle comportant une dimension qui porte un ID différent.

Les noms et valeurs de dimensions multiples peuvent être fournis à l’instruction séparés par des virgules ou par des instructions RENAME_DIM multiples entrées sur des lignes séparées.

Le système supporte toutes les combinaisons des trois mots-clés ci-dessus.

Exemples

Exemple 1

Environment : EnvironmentShell_V

Modèle : PLANNING

Dans cet exemple, EnvironmentShell_V est une copie de EnvironmentShell et COPY_PLANNING une copie du modèle PLANNING. Vous pouvez exécuter le script affiché dans cet exemple dans un modèle PLANNING pour copier les données ACTUAL dans le modèle COPY_PLAN.

Si la commande *DESTINATION_APP apparaît une fois au milieu du script, toutes les données restantes écrivant le fichier de script de calcul se trouvent dans le modèle de destination de référence. Toutes les écritures de données avant *DESTINATION_APP sont écrites dans le modèle où le script est actuellement en cours d'exécution.

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

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

Exemple 2

Pour expliquer DESTINATION_APP avec SKIP_DIM, ADD_DIM, et RENAME_DIM, un autre modèle, DETAIL_PLAN, est créé en copiant le modèle PLANNING à partir de l'EnvironmentShell fourni. Il est nécessaire de :

• Créer des dimensions, PRODUCT et MARKET et de les ajouter au modèle DETAIL_PLAN.

• Remplacer P_ACCT par P_ACCTDETAIL

• Supprimer la dimension P_ACTIVITY de l'InfoProvider 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
            

Explication

DETAIL_PLAN représente le modèle cible, qui a toutes les dimensions de PLANNING sauf pour P_ACCT. Cette dimension est remplacée par P_ACCTDETAIL. Aussi, DETAIL_PLAN a deux dimensions supplémentaires, à savoir PRODUCT et MARKET.

Le script de calcul ci-dessus déplace les données vers DETAIL_PLAN avec :

• Les données vierges dans les dimensions PRODUCT et MARKET.

• P_DATASRC défini par le mot-clé INPUT

• Les valeurs correspondantes de P_ACCT copiées dans P_ACCTDETAIL