Sei sulla pagina 1di 232

HYPERION FINANCIAL DATA QUALITY

MANAGEMENT
VERSION 9.3.1

ADMINISTRATOR'S GUIDE
FDM Administrator's Guide, 9.3.1
Copyright 1989, 2007, Oracle and/or its affiliates. All rights reserved.
Authors: John Billinger
The Programs (which include both the software and documentation) contain proprietary information; they are provided
under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and
other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except
to the extent required to obtain interoperability with other independently created software or as specified by law, is
prohibited.
The information contained in this document is subject to change without notice. If you find any problems in the
documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be
expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or
transmitted in any form or by any means, electronic or mechanical, for any purpose.
If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the
United States Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to
U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the
applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication,
disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject
to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional
rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle USA, Inc., 500
Oracle Parkway, Redwood City, CA 94065.
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous
applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures
to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any
damages caused by such use of the Programs.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their
respective owners.
The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is
not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with
the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly
between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b)
fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty
obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you
may incur from dealing with any third party.
Sommaire

Chapitre 1. Principes fondamentaux de FDM ........................................................................................................... 13


Prsentation de FDM .................................................................................................................. 13
Fonctions et avantages principaux ....................................................................................... 14
Produits ................................................................................................................................. 15
Dfinition d'une application FDM ............................................................................................. 16
Architecture d'application FDM ................................................................................................. 16
Data ....................................................................................................................................... 17
Inbox ...................................................................................................................................... 17
Outbox ................................................................................................................................... 18
Reports .................................................................................................................................. 19
Configuration du groupe de serveurs d'quilibrage de charge ................................................. 19
Adaptateurs .................................................................................................................................. 20
Fichier adaptateur DLL/EXE ................................................................................................ 20
Fichier adaptateur XML ....................................................................................................... 20

Chapitre 2. Gestion des applications ....................................................................................................................... 23


Utilisation de l'cran d'application ............................................................................................. 23
Premire connexion une application ....................................................................................... 27

Chapitre 3. Navigation dans FDM ............................................................................................................................. 29


Fonctions de Workbench ............................................................................................................ 29
Touches de commande ......................................................................................................... 30
Fonctions du client Web ............................................................................................................. 30
Bureau ................................................................................................................................... 30
Menu Workflow .................................................................................................................... 31
Utilisation des donnes de grille .......................................................................................... 32
Tri des colonnes .................................................................................................................... 32
Recherche dans les arborescences ........................................................................................ 33
Personnalisation de l'interface ............................................................................................. 34
Verrouillage et dverrouillage du PDV ................................................................................ 37
Verrouillage et dverrouillage du mode PDV ..................................................................... 38
Fonctions communes au client Web et Workbench ............................................................... 38

Sommaire iii
Bascule du mode PDV .......................................................................................................... 38
Configuration d'un PDV d'emplacement ........................................................................... 38
Configuration d'un PDV de catgorie ................................................................................. 39
Configuration d'un PDV de priode ................................................................................... 39
Recherche dans le PDV ......................................................................................................... 40
Verrouillage et dverrouillage du systme ........................................................................... 40
Procdure de dtermination des points de vue utilisateur par dfaut ...................................... 41

Chapitre 4. Configuration des paramtres systme ................................................................................................. 43


Options systme ........................................................................................................................... 43
Configuration des paramtres de l'application .......................................................................... 43
Options de paramtre d'application .................................................................................... 44
Configuration des paramtres d'intgration ....................................................................... 45
Paramtrage des options de configuration .......................................................................... 48

Chapitre 5. Affectation de la scurit FDM et gestion des utilisateurs .................................................................. 53


Scurit ......................................................................................................................................... 53
Affectation de la scurit aux objets d'application .............................................................. 53
Scurit d'emplacement ........................................................................................................ 54
Gestion des utilisateurs ............................................................................................................... 54
Ajout d'utilisateurs ................................................................................................................ 55
Configuration des droits d'application ................................................................................ 55
Configuration des droits d'emplacement ............................................................................ 56
Suppression d'utilisateurs ..................................................................................................... 57
Changement des mots de passe du systme cible ................................................................ 57

Chapitre 6. Dimensions ............................................................................................................................................ 59


Activation des dimensions mappables ....................................................................................... 59
Dimension ............................................................................................................................. 59
Alias ....................................................................................................................................... 59
Squence de calcul ................................................................................................................ 60
Active ................................................................................................................................... 60
Utiliser pour la recherche ..................................................................................................... 60
Libells de dimension .................................................................................................................. 60

Chapitre 7. Manipulation des tables de contrle ..................................................................................................... 61


A propos des tables de contrle .................................................................................................. 61
Configuration des priodes ......................................................................................................... 61
Configuration des tables de contrle de priode pour les adaptateurs de
suppression ............................................................................................................................ 63
Remarques sur la maintenance des donnes ....................................................................... 64

iv Sommaire
Configuration des catgories ....................................................................................................... 64
Configuration des tables de contrle de catgorie pour les adaptateurs de
suppression ............................................................................................................................ 65
Remarques sur la maintenance des donnes ....................................................................... 66
Configuration des codes de devise .............................................................................................. 66

Chapitre 8. Utilisation des emplacements de chargement des donnes ................................................................. 67


A propos des emplacements de chargement des donnes ......................................................... 67
Types d'emplacements FDM ....................................................................................................... 67
Cration d'emplacements FDM .................................................................................................. 68
Cration de rpertoires d'emplacements ............................................................................. 68
Attributs d'emplacement ...................................................................................................... 69
Changements organisationnels ................................................................................................... 71

Chapitre 9. Comptes logiques .................................................................................................................................. 73


Comptes logiques ........................................................................................................................ 73
Cration de groupes logiques ...................................................................................................... 73
Type de logique ..................................................................................................................... 73
Comptes logiques simples .................................................................................................... 74
Cration de comptes logiques complexes ............................................................................ 79

Chapitre 10. Formats d'importation ......................................................................................................................... 85


Prsentation ................................................................................................................................. 85
Cration de groupes d'importation ............................................................................................ 85
Dfinition des champs pour les groupes d'importation ............................................................ 86
Dfinition des champs pour les groupes d'importation fixes ............................................. 86
Dfinition des champs pour un groupe d'importation dlimit ........................................ 86
Dfinition du champ Glisser-dposer .................................................................................. 86
Affectation de formats d'importation ......................................................................................... 87
Fonctions d'importation avances .............................................................................................. 88
Ajout d'expressions et de scripts d'importation .................................................................. 88
Cration de scripts d'importation ............................................................................................... 94
Cration de scripts d'intgration ................................................................................................ 94
Utilisation de groupes d'importation d'adaptateur ............................................................ 96
Empilement d'expressions et ordre de traitement .............................................................. 96

Chapitre 11. Tables de mappage ............................................................................................................................. 99


Prsentation ................................................................................................................................. 99
Types de mappage ....................................................................................................................... 99
Mappage explicite (un un) .............................................................................................. 100
Mappage avec caractre gnrique ..................................................................................... 101

Sommaire v
Mappage conditionnel ........................................................................................................ 104
Ordre de traitement des mappages ........................................................................................... 108
Ordre de traitement en prsence de plusieurs types de mappage .................................... 108
Ordre de traitement dans un mme type de mappage ..................................................... 108
Copie de tables de mappage ...................................................................................................... 109
Restauration de mappages ........................................................................................................ 109
Recalcul des mappages et des comptes logiques ...................................................................... 110
Importation de tables de mappage ........................................................................................... 110
Tables de conversion LedgerLink ....................................................................................... 110
Tables de conversion Hyperion Enterprise ....................................................................... 111
Format de table de conversion de compte / Equivalent FDM .......................................... 111
LedgerLink TRA / Equivalent FDM ................................................................................... 111
LedgerLink TRN / Equivalent FDM .................................................................................. 112
Importation de descriptions au format LedgerLink ......................................................... 112
Tables de conversion Hyperion Enterprise ....................................................................... 112
Format de table de conversion de compte / Equivalent FDM .......................................... 112
Importation de mappages Excel ......................................................................................... 113

Chapitre 12. Contrles financiers .......................................................................................................................... 115


Cration de groupes de contrles ............................................................................................. 115
Sections ................................................................................................................................ 116
Questions ............................................................................................................................. 117
Corbeille .............................................................................................................................. 120
Profils de questions ............................................................................................................. 121
Explorateur de processus ........................................................................................................... 123
Ajout de mmos et de documentation .............................................................................. 124
Processus de certification ................................................................................................... 125

Chapitre 13. Rgles et entits de validation .......................................................................................................... 127


Cration d'un groupe de rgles de validation .......................................................................... 128
Cration d'une rgle de validation ............................................................................................ 128
Valeur affiche .................................................................................................................... 130
Description .......................................................................................................................... 131
Nom de la rgle ................................................................................................................... 131
Texte de la rgle ................................................................................................................... 131
Type ..................................................................................................................................... 131
Catgorie ............................................................................................................................. 132
Squence .............................................................................................................................. 132
Logique de la rgle .............................................................................................................. 132
Editeur de validation .......................................................................................................... 136

vi Sommaire
Groupes d'entits de validation ................................................................................................ 140
Dfinition des entits de validation ................................................................................... 140

Chapitre 14. Flux de processus .............................................................................................................................. 143


Importation de donnes source ................................................................................................ 143
Mthode de chargement (Type d'importation) ................................................................ 143
Flux du processus d'importation ....................................................................................... 143
Affichage des rgles de conversion (Explorer le niveau suprieur) .................................. 144
Archivage des donnes ........................................................................................................ 144
Ajout de mmos sur les lignes de dtail ............................................................................. 145
Drill up des attributs ........................................................................................................... 146
Validation des donnes source .................................................................................................. 146
Formulaire de validation : absence d'erreurs de mappage ............................................... 147
Formulaire de validation : prsence d'erreurs de mappage .............................................. 147
Exportation dans le systme cible ............................................................................................. 148
Analyse drill down .............................................................................................................. 148
Ajout de mmos et extraction des donnes source ........................................................... 148
Drill back partir de Financial Management .................................................................... 149
Consolidation du systme cible ................................................................................................ 150
Paramtres de consolidation .............................................................................................. 150
Erreurs de consolidation .................................................................................................... 151
Validation des donnes du systme cible (Vrifier) ................................................................. 151

Chapitre 15. Importation d'autres fichiers de donnes ......................................................................................... 153


Journaux ..................................................................................................................................... 153
Dfinition d'un modle de journal .................................................................................... 153
Validation des donnes du journal .................................................................................... 157
Traitement d'un modle de journal ................................................................................... 157
Scurit du journal .............................................................................................................. 158
Fichiers de balance comptable Excel ........................................................................................ 158
Prsentation ........................................................................................................................ 158
Chargement d'un fichier texte de balance comptable par opposition au chargement d'un
fichier Excel de balance comptable .................................................................................... 158
Dfinition d'un modle de balance comptable Excel ........................................................ 159
Fichiers de chargement multiple ............................................................................................... 159
Chargement multiple de fichiers texte par opposition au chargement multiple de fichiers
Excel ..................................................................................................................................... 160
Dfinition des modles de chargement multiple .............................................................. 160
Validation des donnes du modle Excel de chargement multiple .................................. 167
Evnements de chargement multiple ................................................................................. 168

Sommaire vii
Contrle d'un fichier de chargement multiple .................................................................. 168
Importation d'un fichier de chargement multiple ............................................................ 168
Validation d'un fichier de chargement multiple ............................................................... 169
Chargement d'un fichier de chargement multiple ............................................................ 169
Consolidation d'un fichier de chargement multiple ......................................................... 169
Excution de rapports de validation pour un fichier de chargement multiple ............... 169
Scurit du chargement multiple ....................................................................................... 170
Champs de donnes de chargement multiple ................................................................... 170

Chapitre 16. Rapports ........................................................................................................................................... 171


Excution de rapports ............................................................................................................... 171
Afficheur de rapports .......................................................................................................... 171
Gestion des rapports .................................................................................................................. 172
Modification des descriptions ............................................................................................ 172
Rapports du moniteur de processus .................................................................................. 172
Conception de rapports ...................................................................................................... 172
Configuration de la scurit des groupes de rapports ...................................................... 172

Chapitre 17. Chargeur de lots ................................................................................................................................ 175


Prsentation ............................................................................................................................... 175
Prparation des fichiers du chargeur de lots ............................................................................ 175
Format des noms de fichiers .............................................................................................. 175
Emplacement des fichiers de lot ......................................................................................... 176
Format des noms de fichiers chargement multiple ........................................................ 176
Rpertoire de lots de fichiers chargement multiple ....................................................... 176
Utilisation du chargeur de lots .................................................................................................. 176
Commandes applicables aux lots ....................................................................................... 177
Rsultats de l'cran Traitement par lots ............................................................................ 178
Scripts du chargeur de lots ........................................................................................................ 178
Script de chargement de lots standard ............................................................................... 179
Script de chargement de lots en parallle .......................................................................... 179

Chapitre 18. Autres outils ...................................................................................................................................... 181


Exportation au format XML ..................................................................................................... 181
Journal systme .......................................................................................................................... 182
Importation de donnes depuis Microsoft Excel ..................................................................... 182
Remplacement de donnes ................................................................................................. 183
Convertisseur de mappage ........................................................................................................ 183
Editeur de tables ........................................................................................................................ 184
Segments de donnes ................................................................................................................. 184

viii Sommaire
Cration de segments .......................................................................................................... 184
Suppression, recration et raffectation de segments de donnes ................................... 185
Editeur de texte .......................................................................................................................... 185
Fonction Sauvegarder les fichiers d'application ....................................................................... 185

Chapitre 19. Script ................................................................................................................................................. 187


A propos du script ..................................................................................................................... 187
Editeur de script ......................................................................................................................... 187
Client Web .......................................................................................................................... 188
Workbench .......................................................................................................................... 188
Scripts d'importation ................................................................................................................. 189
Cration d'un script d'importation .................................................................................... 189
Paramtres de script d'importation ................................................................................... 190
Valeur de retour de la fonction de script d'importation .................................................. 191
Affectation d'un script d'importation un format d'importation ................................... 191
Fonctions de script d'importation ..................................................................................... 192
Variables temporaires ................................................................................................................ 198
Stockage des variables temporaires .................................................................................... 198
Rcupration des variables temporaires ............................................................................ 200
Scripts d'importation pour intgration .................................................................................... 201
Cration d'un script d'importation pour intgration ....................................................... 202
Paramtres de script d'importation pour intgration ....................................................... 202
Affectation d'un script d'importation pour intgration des formats
d'importation ...................................................................................................................... 204
Exemple de script d'importation pour intgration ........................................................... 205
Scripts personnaliss .................................................................................................................. 206
Cration d'un script personnalis ...................................................................................... 206
Scripts d'vnement ................................................................................................................... 206
Cration d'un script d'vnement ...................................................................................... 207
Paramtres de script d'vnement ..................................................................................... 207
Modification dynamique des formats d'importation ....................................................... 208
Modification dynamique d'autres attributs d'emplacements ........................................... 208
Utilisation de l'objet File System Object dans un script d'vnement ............................. 209
Concepteur de menu ................................................................................................................. 210
Excution de scripts asynchrones ............................................................................................. 211

Annexe A. Expressions de script Visual Basic les plus courantes .......................................................................... 213
Prsentation ............................................................................................................................... 213
InStr ............................................................................................................................................ 213
Arguments ........................................................................................................................... 214

Sommaire ix
Paramtres ........................................................................................................................... 214
Valeurs retournes .............................................................................................................. 214
Remarques ........................................................................................................................... 215
InStrRev ...................................................................................................................................... 215
Arguments ........................................................................................................................... 215
Paramtres ........................................................................................................................... 216
Valeurs retournes .............................................................................................................. 216
Remarques ........................................................................................................................... 216
IsNumeric .................................................................................................................................. 217
Remarques ........................................................................................................................... 217
Len .............................................................................................................................................. 217
Arguments ........................................................................................................................... 218
Remarques ........................................................................................................................... 218
Left .............................................................................................................................................. 218
Arguments ........................................................................................................................... 218
Remarques ........................................................................................................................... 219
LCase .......................................................................................................................................... 219
Remarques ........................................................................................................................... 219
LTrim et RTrim ......................................................................................................................... 219
Remarques ........................................................................................................................... 220
Mid ............................................................................................................................................. 220
Arguments ........................................................................................................................... 220
Remarques ........................................................................................................................... 220
MsgBox .......................................................................................................................................221
Arguments ........................................................................................................................... 221
Now ............................................................................................................................................ 222
Remarques ........................................................................................................................... 222
Replace ....................................................................................................................................... 222
Arguments ........................................................................................................................... 223
Paramtres ........................................................................................................................... 223
Valeurs retournes .............................................................................................................. 224
Remarques ........................................................................................................................... 224
Right ........................................................................................................................................... 224
Arguments ........................................................................................................................... 224
Remarques ........................................................................................................................... 225
UCase ......................................................................................................................................... 225
Remarques ........................................................................................................................... 225
DoLoop .................................................................................................................................. 225
Arguments ........................................................................................................................... 226

x Sommaire
Remarques ........................................................................................................................... 226
If...Then...Else ............................................................................................................................ 227
Arguments ........................................................................................................................... 227
Remarques ........................................................................................................................... 228
File System Object ..................................................................................................................... 228
Cration des fichiers ........................................................................................................... 229
Ajout de donnes dans un fichier ...................................................................................... 229
Lecture de fichiers ...................................................................................................................... 230
Dplacement, copie et suppression de fichiers ........................................................................ 231

Sommaire xi
xii Sommaire
Principes fondamentaux de FDM
1
Dans ce chapitre
Prsentation de FDM..................................................................................................................................................13
Dfinition d'une application FDM...............................................................................................................................16
Architecture d'application FDM...................................................................................................................................16
Configuration du groupe de serveurs d'quilibrage de charge.....................................................................................19
Adaptateurs...............................................................................................................................................................20

Prsentation de FDM

Oracle's Hyperion Financial Data Quality Management (FDM) est un outil de transformation
de donnes prt l'emploi qui fournit des donnes financires source aux applications de
consolidation, de reporting, de planification et d'analyse. Plus qu'un simple outil de conversion
de donnes, FDM fournit une analyse rtrospective des donnes financires source. FDM
garantit ainsi l'intgrit des donnes et assure une cohrence, qui permet le rapprochement ais
des donnes financires. L'analyse rtrospective des donnes financires source permet aux
utilisateurs, administrateurs et vrificateurs de gagner du temps sur la recherche, l'identification
et la correction d'erreurs de donnes.
FDM propose un processus de collecte de donnes unique pour toutes les units de reporting
de l'organisation. FDM comporte galement une fonctionnalit de contrle financier qui
participe la gestion des processus de contrle financier internes. En outre, FDM comprend des
adaptateurs permettant d'intgrer facilement l'outil Oracle's Hyperion Enterprise, Oracle's
Hyperion Financial Management System 9 (Financial Management), Oracle's Hyperion
Essbase System 9 (Essbase) et Oracle's Hyperion Planning System 9 (Planning), et peut
tre utilis pour charger des donnes dans d'autres applications de consolidation et d'analyse
financire.
Le processus FDM de base est compos de six tapes :
1. Importation des donnes source
2. Validation des donnes source par rapport des tables de mappage
3. Exportation des donnes source dans le systme cible
4. Consolidation des donnes du systme cible
5. Validation des donnes du systme cible

Prsentation de FDM 13
6. Examen et validation du contrle financier interne

Fonctions et avantages principaux


FDM offre un processus unique et systmatique destin au chargement de donnes source
partir de divers systmes dans des applications d'analyse cible. Le processus assure la visibilit,
l'intgrit et la vrification des donnes.
Les fonctions et avantages de FDM sont les suivants :
Mise en place d'un rfrentiel central de l'ensemble des donnes financires source
Analyse rtrospective drill down
Possibilit d'archiver les fichiers source, les historiques des erreurs et les fichiers de
chargement
La fonction d'valuation et de certification des contrles internes contribue la conformit
aux sections 302 et 404 de la Loi Sarbanes-Oxley
Contrle des processus l'chelle de l'entreprise
Possibilit d'importer des donnes source depuis un fichier texte format ou une source de
donnes quelconque
Capacits de mappage et de validation multidimensionnelles
Validation et assurance qualit des donnes
Identification et notification des erreurs
Consolidation des donnes des systmes cible
Validation et reporting des donnes des systmes cible
Capacit d'quilibrage des charges par l'intermdiaire de journaux Excel
Chargement de donnes de budget pour plusieurs priodes
Fonctions avances de reporting et d'audit
Chargement par lots en service rduit

14 Principes fondamentaux de FDM


Prise en charge d'un nombre illimit d'utilisateurs simultans
Dploiement Web lger
Compatibilit avec les bases de donnes SQL et Oracle

Produits
FDM comprend deux produits principaux : un client Windows (Workbench) et un client Web.

Workbench
FDM Workbench est un client Windows pouvant tre install sur un PC ou un terminal serveur.
Workbench permet d'utiliser les fonctions de configuration, d'intgration et de dveloppement
d'applications de FDM et s'adresse uniquement aux administrateurs. Les fonctionnalits
essentielles de FDM Workbench sont les suivantes :
Intgration de systmes
Cration et maintenance de scripts
Cration et maintenance de rapports
Importation et exportation d'applications
Configuration et contrle du processeur par lots

Client Web
Le client Web FDM comporte quatre composants :
Serveur Web
Serveur d'application
Gestionnaire d'quilibrage de la charge
Gestionnaire de tches

Serveur Web
Les composants du serveur Web FDM peuvent tre installs sur un serveur Web excutant IIS 6.0
(ou suprieur). Ces composants permettent aux utilisateurs d'accder aux applications FDM
partir d'Internet ou de l'intranet de l'entreprise. L'interface base sur le Web permet d'utiliser
toutes les fonctions d'utilisateur final et la plupart des fonctions d'administrateur de FDM.

Serveur d'application
Le serveur d'application FDM permet FDM d'excuter des tches sollicitant des ressources
importantes sur un ou plusieurs serveurs d'application, au lieu de les excuter sur le serveur
Web. Pour rduire le volume du trafic rseau et acclrer le transfert des donnes, il est
recommand d'installer le composant de serveur d'application sur un serveur distinct des
serveurs Web et de donnes (SQL ou Oracle).

Prsentation de FDM 15
Gestionnaire d'quilibrage de la charge
Le Gestionnaire d'quilibrage de la charge FDM permet FDM de grer les serveurs d'application
qui excutent des tches sollicitant des ressources importantes. Il est recommand d'installer le
Gestionnaire d'quilibrage de la charge sur le premier serveur d'application.

Gestionnaire de tches
Le Gestionnaire de tches FDM excute des tches planifies (scripts FDM) intervalles dfinis.
Le Gestionnaire de tches permet galement d'ajouter, de modifier et de supprimer des tches.
Il peut tre install sur un serveur quelconque ayant accs l'application FDM. Vous pouvez
planifier des tches rptitives, quotidiennes, hebdomadaires ou mensuelles.

Dfinition d'une application FDM


Une application FDM comprend une base de donnes SGBDR (systme de gestion de base de
donnes relationnelle) et des rpertoires qui contiennent l'ensemble des donnes
transactionnelles, mtadonnes, rapports et autres fichiers utiliss pour intgrer FDM des
applications cible.
Une application FDM peut se charger dans plusieurs applications cible de diffrents systmes.
Par exemple, une application FDM peut se charger dans deux applications Hyperion Enterprise
diffrentes, dans une application Financial Management et dans trois applications Oracle's
Hyperion Planning System 9 distinctes.

Architecture d'application FDM


La figure ci-aprs prsente les rpertoires crs lors de la cration d'une application FDM. Dans
cet exemple, le rpertoire WLDATA est cr par l'utilisateur pour stocker l'ensemble des
applications FDM. Lors de la cration de l'application ABC Corp , le rpertoire ABCCorp et
ses sous-rpertoires ont t crs automatiquement par FDM. Chaque application contient
quatre rpertoires principaux : Data, Inbox, Outbox et Reports.

16 Principes fondamentaux de FDM


Data
Data est le rpertoire dans lequel FDM archive les fichiers de donnes imports dans et exports
depuis FDM : fichiers source imports, journaux d'importation, entres de journaux, fichiers
chargement multiple, fichiers de chargement de systme cible et documents de mmos associs.
Chaque fichier du rpertoire Data porte un nom unique, peut tre extrait partir des crans
Importer et Exporter et fournit une analyse rtrospective complte. Pour plus d'informations,
reportez-vous la section Archivage des donnes la page 144.

Scripts
Le rpertoire Data contient un sous-rpertoire Scripts dans lequel sont stocks les scripts
FDM. Ce rpertoire contient galement les fichiers source, les journaux, les fichiers chargement
multiple, les fichiers de donnes de sortie et les pices jointes. Le rpertoire Scripts contient
un sous-rpertoire pour chaque type de script.
Custom : Contient des scripts excutables partir d'un menu personnalis cr dans l'cran
Concepteur de menu.
Event : Contient des scripts excuts lorsqu'un vnement spcifique se produit. Tous les scripts
de ce rpertoire sont nomms par rapport l'vnement auquel ils correspondent.
Import : Contient les scripts d'importation crs lors de la dfinition des formats d'importation.
Les scripts d'importation sont excuts au cours du processus d'importation de fichiers source.

Inbox
Il s'agit du rpertoire par dfaut partir duquel les fichiers source sont imports. Ce rpertoire
peut servir de rfrentiel central pour tous les fichiers d'extraction de grand livre. Les fichiers

Architecture d'application FDM 17


source peuvent tre extraits partir de tout rpertoire accessible. Par consquent, il n'est pas
ncessaire de placer les fichiers d'importation dans ce rpertoire. Le rpertoire Inbox contient
deux sous-rpertoires : Archive Restore et Batches.

Archive Restore
Ce rpertoire stocke les fichiers d'importation source et les journaux archivs puis restaurs.
FDM place les fichiers source et les journaux d'origine archivs dans le rpertoire Data
\Archive. Pour plus d'informations, reportez-vous la section Groupes d'entits de
validation la page 140 et Archivage des donnes la page 144.

Batches
Les fichiers utiliss pour le chargement par lots sont stocks dans le rpertoire Batches. Les
fichiers de lot standard chargs l'aide du chargeur de lots doivent tre placs dans le rpertoire
OpenBatch. Les fichiers de lot chargement multiple chargs l'aide du chargeur de lots doivent
tre placs dans le rpertoire OpenBatchML.

Outbox
Ce rpertoire constitue un emplacement centralis pour tous les fichiers d'exportation FDM qui
seront chargs dans les systmes cible. Le rpertoire Outbox contient quatre sous-rpertoires :
Excel Files, Logs, Templates et ArchiveRestore.

Excel Files
Lorsque FDM exporte le contenu d'une grille, les fichiers Excel qui en rsultent sont stocks dans
ce rpertoire.

Logs
Le rpertoire Logs contient les fichiers journaux crs lors de l'importation de fichiers source.
Ces journaux contiennent les lignes de donnes que FDM n'a pas pu importer, ainsi que le motif
de l'chec de l'importation. Le rpertoire Logs contient galement des historiques des erreurs
nomms selon la convention <username>.err, o <username> correspond au nom de
l'utilisateur connect FDM et o .err correspond l'extension commune utilise par FDM
pour identifier les historiques des erreurs. Ce rpertoire peut tre vid pour rcuprer de l'espace
disque.

Templates
Le rpertoire Templates est utilis par les emplacements de reporting pour grer et distribuer
des modles personnaliss de chargement multiple ou de journaux. Le contenu de ce rpertoire
est affich sous forme de liens dans le client Web FDM. Vous pouvez publier un modle en le
plaant dans ce rpertoire.

18 Principes fondamentaux de FDM


Archive Restore
Ce rpertoire contient les fichiers de chargement de donnes archivs puis restaurs. FDM place
les fichiers de chargement de donnes d'origine archivs dans le rpertoire Data. Pour plus
d'informations, reportez-vous la section Archivage des donnes la page 144. Le contenu
de ce rpertoire est supprim lorsqu'un compactage est ralis.

Reports
Le rpertoire Reports contient les fichiers de rapport actifs. Les fichiers de rapport actifs portent
l'extension *.rpx.

Configuration du groupe de serveurs d'quilibrage de charge


Avant d'accder Workbench, vous devez dfinir un groupe de serveurs d'quilibrage de charge.
Le groupe de serveurs dfinit les serveurs d'quilibrage de charge utiliss par FDM. L'cran
d'installation du groupe de serveurs d'quilibrage de charge s'affiche automatiquement au
premier dmarrage de Workbench.

Pour configurer des groupes de serveurs d'quilibrage de charge, procdez comme suit :
1 Accdez l'cran de connexion de Workbench en slectionnant Dmarrer > Programmes > Hyperion >
Financial Data Quality Management > Workbench > Client Workbench.
La bote de dialogue Groupe de serveurs d'quilibrage de charge s'affiche (lors du premier
dmarrage de Workbench).
2 Cliquez sur Ajouter.
Le formulaire Groupe de serveurs d'quilibrage de charge s'affiche.
3 Entrez un nom et une description de groupe de serveurs.
4 Entrez le nom du serveur d'quilibrage principal et du serveur d'quilibrage de sauvegarde (facultatif).
Recherchez les serveurs disponibles en cliquant sur .
5 Cliquez sur Connexion.
Vous pouvez dfinir plusieurs groupes de serveurs d'quilibrage de charge l'aide du formulaire
Groupe de serveurs d'quilibrage de charge. Cela permet Workbench de s'associer plusieurs
applications FDM sur diffrents serveurs.

Remarque :
Si un groupe de serveurs d'quilibrage de charge a dj t dfini, et si vous souhaitez ajouter ou
modifier un groupe de serveurs, accdez au formulaire Groupe de serveurs d'quilibrage de
charge. Pour cela, connectez-vous Workbench et slectionnez Fichiers > Groupe de serveurs
d'quilibrage de charge.

Configuration du groupe de serveurs d'quilibrage de charge 19


Adaptateurs
Les adaptateurs sont des codes logiciels qui communiquent avec diverses applications source et
cible. Chaque adaptateur est conu pour s'intgrer un systme cible (par exemple Oracle's
Hyperion Essbase System 9 ou Financial Management) ou un systme source (SAP, SQL,
etc.) spcifique. Workbench permet d'importer et de grer les adaptateurs utiliss par
l'application FDM.
Les adaptateurs comprennent un composant de mtadonnes XML et un fichier DLL/EXE
(adaptateurs cible uniquement). Le fichier DLL/EXE contient les instructions permettant
d'interagir avec le systme cible. Le fichier XML contient l'ensemble des donnes associes
l'application FDM.

Fichier adaptateur DLL/EXE


Le fichier adaptateur de systme cible DLL ou EXE joue le rle de tampon entre FDM et
l'application cible. Le fichier DLL contient l'ensemble des instructions permettant FDM de
communiquer avec l'application cible (connexion la base de donnes, chargement des donnes,
extraction des donnes, etc.). Chaque fichier adaptateur DLL de systme cible contient les appels
d'interface de l'application cible concerne. Par consquent, FDM peut s'intgrer de nombreux
systmes cible sans avoir grer de grandes quantits d'appels spcifiques l'application dans
le programme.

Fichier adaptateur XML


Le fichier adaptateur XML joue le rle de couche secondaire entre FDM et l'application cible. Le
fichier adaptateur XML stocke les paramtres et options de configuration de l'application, ainsi
que les scripts d'appel des fonctions d'interface, et renvoie les rsultats partir de l'application
cible. Le fichier XML peut galement contenir les informations permettant de configurer une
application FDM (emplacements, scurit, formats d'importation, rapports, etc.).
Vous pouvez accder au menu Adaptateurs partir du bureau de Workbench en cliquant sur
l'onglet Adaptateurs dans la partie infrieure du volet de gauche.

20 Principes fondamentaux de FDM


Chaque adaptateur rpertori dans l'cran Adaptateurs contient les sections suivantes :
Dimensions
Libells de dimension
Dimensions d'attribut
Actions
Profils d'ordinateur
Options

Dimensions
La section Dimensions rpertorie les listes de dimensions disponibles pour l'application cible.
Chaque lment de la section Dimension principale reprsente une dimension disponible et
contient un script qui extrait une liste des membres de la dimension slectionne partir de
l'application cible. Seuls les adaptateurs cible utilisent la section Dimensions. Les adaptateurs de
systmes source ne prsentent pas de section Dimension.

Adaptateurs 21
Actions
Il s'agit de scripts qui interagissent avec l'application cible et qui utilisent les appels d'interface
d'adaptateur DLL pour excuter des fonctions, notamment Connect, Load, ValueGet,
Export, Drill Down, etc.

Profils d'ordinateur
Cette section contient des informations qui permettent FDM de dterminer sur quels
ordinateurs ou serveurs se trouvent les bases de donnes source et cible. Le profil d'ordinateur
contient galement des informations de connexion gnrales aux applications cible. Lorsque
l'option de connexion globale est slectionne, FDM utilise toujours le nom d'utilisateur et le
mot de passe indiqus pour se connecter FDM et l'application cible. Le compte utilisateur
doit donc avoir accs au serveur sur lequel se trouve l'application cible.
Pour que FDM extraie et charge des valeurs de et vers l'application cible, le compte utilisateur
doit bnficier des droits de scurit appropris dans l'application cible, quel que soit l'utilisateur
connect FDM. Vous devez configurer un profil d'ordinateur pour chaque ordinateur sur
lequel le composant Serveur d'application ou Gestionnaire de tches de FDM est install.

Options
Cette section du fichier XML contient les valeurs par dfaut des paramtres d'intgration et les
paramtres de l'application cible laquelle FDM s'intgre.

22 Principes fondamentaux de FDM


Gestion des applications
2
Dans ce chapitre
Utilisation de l'cran d'application.............................................................................................................................23
Premire connexion une application........................................................................................................................27

Utilisation de l'cran d'application


Les applications sont gres partir de l'cran Nouvelle application et Ouvrir l'application. Ces
crans permettent d'ajouter, de modifier et de supprimer des applications.

Pour crer des applications FDM, procdez comme suit :


1 Accdez la page Connexion de FDM en dmarrant le client Web ou Workbench :
Client Web : Slectionnez Dmarrer > Hyperion > Financial Data Quality Management >
Web Server Components > Web Logon.
Workbench : Slectionnez Dmarrer > Hyperion > Financial Data Quality Management
> Workbench > Client Workbench.
2 Dans Applications, slectionnez <Nouvelle application>.
3 Entrez le nom d'utilisateur et le mot de passe de l'administrateur de la nouvelle application.
4 Cliquez sur Connexion (client Web) ou sur OK (Workbench).
La bote de dialogue Nouvelle application s'affiche, avec les onglets Gnral et Base de donnes.
5 Entrez les informations ncessaires dans l'onglet Gnral.
L'onglet Gnral permet d'entrer le nom et la description de l'application, et indique
l'emplacement de l'architecture d'application.
Nom : Nom de l'application (20 caractres alphanumriques maximum). Le nom ne doit
pas contenir d'espace. Le trait de soulignement (_) est autoris.
Description : Entrez la description de l'application.
Chemin : Indiquez le chemin d'accs de l'emplacement de cration de la nouvelle
application. L'application correspond au rpertoire qui contient les sous-rpertoires
Inbox, Outbox, Data et Reports. Si les utilisateurs accdent l'application depuis plusieurs
serveurs Web et d'application, il est recommand d'utiliser la convention UNC afin d'viter
les problmes d'incohrence de mappage de lettre de lecteur.

Utilisation de l'cran d'application 23


Lorsqu'une application est cre, un nouveau rpertoire portant le mme nom est galement
cr. Le nom de l'application est ajout au fichier HyperionFDMApplications.xml stock
dans le rpertoire d'installation de FDM.
6 Slectionnez l'onglet Base de donnes et entrez les informations ncessaires.
L'onglet Base de donnes permet de dfinir les proprits de la base de donnes SGBDR qui
contient les donnes de transaction de FDM.
Fournisseur de base de donnes OLE : Indiquez la base de donnes utilise par l'application.
La base de donnes par dfaut est SQLOLEDB. Oracle est galement pris en charge.
Serveur de base de donnes : Emplacement de la base de donnes utilise par l'application
FDM. Cette option apparat uniquement lorsque le Fournisseur de base de donnes OLE
est SQLOLEDB.
Nom de la base de donnes : Nom de la base de donnes (gnralement le nom de
l'application). Cette option apparat uniquement lorsque le Fournisseur de base de donnes
OLE est SQLOLEDB.
Service : Entrez le service Oracle utilis pour la connexion la base de donnes Oracle. Cette
option apparat uniquement lorsque le Fournisseur de base de donnes OLE est
ORAOLEBD.
Nom d'utilisateur : Entrez l'ID de l'administrateur de base de donnes (par exemple, l'ID
d'administrateur SQLOLEDB).
Mot de passe : Entrez le mot de passe administrateur de la base de donnes.
Options : Permet de supprimer le tablespace par dfaut l'emplacement de cration de
l'application. Cette option apparat lorsque le Fournisseur de base de donnes OLE est
ORAOLEB.
7 Cliquez sur OK.

Remarque :
Si des tablespaces de suppression ne sont pas dfinis, tous les tablespaces prennent la valeur par
dfaut Utilisateurs . Cet tat peut nuire gravement aux performances. Reportez-vous au
manuel DBA Guide (disponible en anglais uniquement) pour des instructions d'ajustement
dtailles avant la cration de l'application FDM.

Pour supprimer des applications, procdez comme suit :


1 Accdez la page Connexion de FDM en dmarrant le client Web ou Workbench :
Client Web : Slectionnez Dmarrer > Hyperion > Financial Data Quality Management >
Web Server Components > Web Logon.
Workbench : Slectionnez Dmarrer > Hyperion > Financial Data Quality Management
> Workbench > Client Workbench.
2 Dans Applications, slectionnez <Ajouter une application>.
3 Entrez le nom d'utilisateur et le mot de passe de l'application.
4 Cliquez sur Connexion (client Web) ou sur OK (Workbench).

24 Gestion des applications


L'cran Ajouter une application s'affiche.
5 Slectionnez une application.
6 Cliquez sur Supprimer.
7 Cliquez sur OK.

Remarque :
La suppression d'une application n'entrane pas la suppression ou n'affecte pas les donnes de
l'application. Cette tche supprime seulement le pointeur de l'utilisateur vers l'application dans
le fichier XML de celle-ci. Le rpertoire qui contient l'ensemble des informations reste intact.

Pour modifier des applications, procdez comme suit :


1 Accdez la page Connexion de FDM en dmarrant le client Web ou Workbench :
Client Web : Slectionnez Dmarrer > Hyperion > Financial Data Quality Management >
Web Server Components > Web Logon.
Workbench : Slectionnez Dmarrer > Hyperion > Financial Data Quality Management
> Workbench > Client Workbench.
2 Dans Applications, slectionnez <Ajouter une application>.
3 Entrez le nom d'utilisateur et le mot de passe de l'administrateur.
4 Cliquez sur OK.
La bote de dialogue Ouvrir l'application s'affiche.
5 Slectionnez une application.
6 Cliquez sur Modifier.
La bote de dialogue Modifier l'application s'affiche.
7 Dans Modifier l'application, modifiez les paramtres ncessaires.
La bote de dialogue affiche les paramtres de l'application slectionne et permet de les modifier.
Vous pouvez modifier chaque attribut de l'application, sauf son nom. Pour changer le nom de
l'application, vous devez supprimer cette dernire, puis l'ajouter nouveau sous un nouveau
nom l'aide de la commande Ajouter une application.
8 Cliquez sur OK.

Remarque :
La procdure de cration d'une application est utilise lorsque l'application n'existe pas. La
procdure d'ajout d'une application est utilise lorsque l'application existe, mais qu'aucun
pointeur vers l'application ne figure dans le fichier XML de l'application.

Pour ajouter des applications FDM, procdez comme suit :


1 Accdez la page Connexion de FDM en dmarrant le client Web ou Workbench :

Utilisation de l'cran d'application 25


Client Web : Slectionnez Dmarrer > Hyperion > Financial Data Quality Management >
Web Server Components > Web Logon.
Workbench : Slectionnez Dmarrer > Hyperion > Financial Data Quality Management
> Workbench > Client Workbench.
2 Dans Applications, slectionnez <Ajouter une application>.
3 Entrez le nom d'utilisateur et le mot de passe de l'application.

Remarque :
Le nom de domaine peut tre ncessaire pour certaines configurations.
4 Cliquez sur Connexion.
L'cran Applications s'affiche avec la liste des applications dfinies sur l'ordinateur.
5 Cliquez sur Ajouter.
L'cran Ajouter une application s'affiche. Cet cran comporte deux onglets (Gnral et Base de
donnes) qui contiennent des informations sur le nom et l'emplacement de l'application.
6 Entrez les informations ncessaires dans l'onglet Gnral.
Nom : Nom de l'application. Le nom ne doit pas contenir d'espace. Le trait de
soulignement (_) est autoris.
Description : Entrez la description de l'application.
Chemin : Indiquez le chemin d'accs l'emplacement de l'application.
7 Slectionnez l'onglet Base de donnes et entrez les informations ncessaires.
L'onglet Base de donnes permet de nommer la base de donnes SGBDR qui contient l'ensemble
des donnes de transaction de FDM.
Fournisseur de base de donnes OLE : Indique la base de donnes utilise par l'application.
La base de donnes par dfaut est SQLOLEDB (SQL). Oracle est galement pris en charge.
Serveur de base de donnes : Emplacement de la base de donnes utilise par l'application
(disponible uniquement lorsque le Fournisseur de base de donnes OLE est SQLOLEDB).
Nom de la base de donnes : Gnralement le nom de l'application. Le nom de base de
donnes dfini sera le nom de la base de donnes SGBDR (disponible uniquement lorsque
le Fournisseur de base de donnes OLE est SQLOLEDB).
Service : Service utilis pour la connexion la base de donnes Oracle. Disponible
uniquement lorsque le Fournisseur de base de donnes OLE est ORAOLEDB (Oracle).
Nom d'utilisateur : ID de l'administrateur de base de donnes (par exemple, l'ID
d'administrateur SQLOLEDB).
Mot de passe : Mot de passe de l'administrateur de base de donnes.
Options : Supprime le tablespace par dfaut l'emplacement de cration de l'application
(disponible uniquement lorsque le Fournisseur de base de donnes OLE est ORAOLEDB).
8 Cliquez sur OK.
Le fichier .ini et les paramtres de registre de l'application rfrence sont crs.

26 Gestion des applications


Premire connexion une application
L'cran de connexion de FDM permet aux utilisateurs de se connecter aux applications, de crer
des applications ou d'ajouter des applications existantes. Le nom d'utilisateur utilis pour crer
l'application est le seul nom d'utilisateur (ID utilisateur) valide jusqu' la configuration de
l'application pour accepter d'autres utilisateurs.
Lors de la premire connexion une nouvelle application, vous tes invit configurer une
nouvelle intgration FDM. Reportez-vous au manuel FDM Installation Guide (disponible en
anglais uniquement) pour plus d'informations sur la configuration de l'adaptateur d'intgration,
et au Chapitre 4, Configuration des paramtres systme pour des informations concernant
les paramtres de configuration.

Premire connexion une application 27


28 Gestion des applications
Navigation dans FDM
3
Dans ce chapitre
Fonctions de Workbench............................................................................................................................................29
Fonctions du client Web.............................................................................................................................................30
Fonctions communes au client Web et Workbench..................................................................................................38
Procdure de dtermination des points de vue utilisateur par dfaut..........................................................................41

Fonctions de Workbench
La image ci-dessous reprsente le bureau de Workbench.

1. Barre Point de vue (PDV) : Utilisez cette barre pour slectionner l'emplacement FDM, la
priode FDM, la catgorie FDM, la catgorie de systme cible, le mode global ou local et le
verrouillage systme.
2. Onglets de slection d'cran : Slectionnez l'cran Adaptateurs, Scripts ou Rapports.

Fonctions de Workbench 29
Touches de commande
Le tableau ci-dessous rpertorie les raccourcis clavier permettant d'accder divers composants
de l'interface FDM.

Fonction Combinaison de touches Action

Ouvrir des formulaires/botes de dialogue Alt + F4 Fermer le programme

Ctrl + O Ouvrir le formulaire de connexion une


application

Ctrl + N Ouvrir un nouveau script

Aide F1 Aide sur FDM

Fonctions du client Web

Bureau
Le bureau FDM constitue le point de commande central pour la cration et l'administration des
applications. Le bureau s'affiche aprs la connexion une application. Le bureau comporte trois
zones principales : l'indicateur d'cran, les menus FDM et la barre PDV.

1. Indicateur d'cran : Affiche l'cran FDM en cours.

30 Navigation dans FDM


2. Dveloppeur de menus FDM : Contient six onglets. Slectionnez un onglet pour afficher le
menu sous-jacent. Toutes les fonctions FDM disponibles dans le client Web sont accessibles
partir de ces menus. Dans l'exemple, l'onglet Workflow est slectionn et le menu
Workflow est affich. Vous pouvez galement accder toutes les fonctions dans la barre
de menus situe dans la partie suprieure du bureau FDM.
3. Barre PDV (Point de vue) : Affiche l'utilisateur, l'application FDM, l'emplacement FDM, la
priode FDM, la catgorie FDM, la catgorie de systme cible, le mode (global ou local),
l'tat du verrouillage systme et l'adaptateur utiliss dans l'emplacement en cours.

Menu Workflow
Le menu Workflow permet d'ouvrir rapidement une tche sans excuter nouveau toutes les
tapes du processus de workflow. L'utilisateur peut ouvrir une tape du processus, et revalider
ou exporter. Le processus de workflow comporte cinq tapes.

Dernire tape : Ouvre le dernier cran du processus de workflow excut pour le PDV en
cours (russi ou non). Lorsqu'un utilisateur a chou lors d'une tentative de validation des
donnes, le fait de cliquer sur Dernire tape affiche l'cran Valider.
Importer : Affiche l'cran Importer.
Valider : Affiche l'cran Valider (mme si le processus d'importation n'a pas t excut
pour le PDV en cours) sans valider les donnes.
Exporter : Affiche l'cran Exporter (mme si le PDV en cours n'a pas valid les donnes)
sans lancer le processus d'exportation.
Vrifier : Affiche le rapport de vrification pour le PDV en cours. En l'absence de donnes
de rapport de vrification pour le PDV en cours, une page vide s'affiche.

Fonctions du client Web 31


Utilisation des donnes de grille
La plupart des formulaires (crans) de FDM affiche des donnes dans une ou plusieurs grilles.
Les oprations de grille de base de manipulation des donnes sont les suivantes :
Ajouter un enregistrement : Pour ajouter un enregistrement, cliquez sur Ajouter.
Supprimer : Pour supprimer un enregistrement slectionn, cliquez sur Supprimer.
Supprimer tout : Pour supprimer tous les enregistrements d'une grille, cliquez sur
Supprimer tout.

Remarque :
Si le formulaire contient plusieurs grilles, vous ne pouvez pas supprimer le contenu d'une grille.

Modifier un enregistrement : Pour modifier un enregistrement, cliquez dans la cellule


correspondante et saisissez les nouvelles donnes.
Annuler les modifications : Pour annuler les modifications apportes une ligne, cliquez
gauche de la cellule et slectionnez Annuler les modifications de ligne dans le menu
contextuel.
Sauvegarder un enregistrement : Pour sauvegarder un enregistrement, cliquez sur Mettre
jour la grille. Cette opration rpercute les modifications de la grille actuelle dans la base
de donnes.
Mettre jour la grille : Cliquez sur Mettre jour la grille pour rpercuter dans la base de
donnes les lignes mises jour (ajoutes, supprimes et modifies).
Excel : Cliquez sur Excel pour sortir le contenu d'une grille dans une feuille de calcul Excel.
La feuille de calcul Excel est enregistre dans le sous-rpertoire Excel du rpertoire
Outbox dfini dans le formulaire Connections.

Remarque :
Les crans exports dans Excel sont configurs pour une rimportation (le cas chant) dans
FDM. La plage nomme est configure automatiquement, et les noms de la table d'importation
et des colonnes sont dfinis.

Tri des colonnes


Pour trier une colonne de la grille, cliquez sur l'en-tte de la colonne pour activer cette dernire,
puis cliquez sur la flche bidirectionnelle gauche de la description de la colonne. Cliquez
nouveau sur la flche bidirectionnelle pour trier la colonne dans le sens inverse.

Remarque :
Lorsqu'un formulaire contient plusieurs grilles, vous ne pouvez pas trier une colonne dans une
grille.

32 Navigation dans FDM


Recherche

Pour rechercher un enregistrement, procdez comme suit :


1 Cliquez sur l'en-tte d'une colonne de la grille.
2 Cliquez sur le bouton Rechercher ( ).
3 Entrez les critres de recherche dans la zone de texte Rechercher.
4 Cliquez sur le bouton Rechercher suivant ( ) pour parcourir les enregistrements qui correspondent aux
critres.

Filtrage

Pour filtrer les enregistrements d'une grille, procdez comme suit :


1 Cliquez sur l'en-tte d'une colonne de la grille.
2 Cliquez sur le bouton Filtrer ( ).
La bote de dialogue Filtre s'affiche.
3 Slectionnez un oprateur dans Mthode de filtrage.
4 Entrez une valeur de filtrage dans Valeur du filtre.
Pour supprimer le filtrage de la grille, slectionnez Tous.

Remarque :
Si le formulaire contient plusieurs grilles, vous ne pouvez pas utiliser la fonction de filtrage.

Recherche dans les arborescences


Les crans qui contiennent des arborescences (par exemple l'cran Emplacements) comportent
une fonction de recherche.

Pour rechercher dans une arborescence, procdez comme suit :


1 Cliquez avec le bouton droit sur un nud et slectionnez Rechercher.
La bote de dialogue Rechercher s'affiche.
2 Entrez les critres de recherche dans la bote de dialogue Rechercher.
Les critres de recherche peuvent tre une expression exacte ou le fragment d'un nom
d'emplacement. Les critres ne sont pas sensibles la casse.
3 Cliquez sur OK.

Fonctions du client Web 33


Personnalisation de l'interface
Vous pouvez personnaliser l'interface Web au niveau global de l'application ou au niveau
individuel de l'utilisateur.

Paramtres Web
L'cran Paramtres Web permet de contrler les icnes de barre d'tat, les thmes, le nombre
de lignes de grille par page et le fonctionnement de la barre d'informations. Pour accder aux
paramtres Web, slectionnez le menu Administration > Paramtres Web. L'cran Paramtres
Web contient cinq onglets :
Gnral
Grille
Thme
Barre d'informations
Cache

Onglet Gnral
Autoriser la suppression des icnes de barre d'tat : Permet de supprimer les icnes par dfaut
de la barre d'tat. Les icnes de la barre d'tat correspondent aux icnes de russite/d'chec
affiches dans la zone de workflow sous Importer, Valider, Exporter et Vrifier. Lorsque cette
option est active, l'utilisateur peut dfinir des icnes individuelles par dfaut.
Icnes de barre d'tat par dfaut : Icnes de barre d'tat affiches sous les processus de workflow
(Importer > Vrifier). Le groupe d'icnes slectionn est utilis, sauf si l'utilisateur a choisi un
groupe de remplacement. Les groupes disponibles sont stocks sur le serveur Web sous
\Hyperion\ FDM\ WebServerComponent\ WebSite\ StatusBarIcons.

Pour crer des groupes d'icnes de barre d'tat supplmentaires, crez un dossier sous le
rpertoire StatusBarIcons et placez-y les icnes supplmentaires.

Remarque :
Les icnes doivent avoir le mme nom que les icnes des rpertoires existants.

Autoriser la suppression des types de publication de rapports par dfaut : Permet de supprimer
le type de publication de rapports par dfaut. Le type de publication de rapports par dfaut
correspond au format utilis pour les rapports affichs sans que l'utilisateur puisse slectionner
l'option Type (rapports de vrification et d'Explorateur de processus). Lorsque cette option est
active, l'utilisateur peut dfinir un type de publication de rapports par dfaut individuel.
Type de publication de rapport par dfaut : Type de rapport utilis lorsque les rapports de
vrification et d'Explorateur de processus sont excuts. Cette valeur est dfinie par dfaut dans
la liste des types de publication de la page Rapports. Les choix de la liste sont : PDF, Excel, Word,
RTF et HTML.

34 Navigation dans FDM


Gnrer des informations de dbogage : Activez la barre d'informations pour afficher les
informations de trace en cas d'erreur. Les informations de trace sont utiles lorsque vous contactez
le support technique Hyperion en cas de problme.

Remarque :
Cette option doit tre utilise uniquement si une erreur se produit et si le support technique
Hyperion a besoin d'informations complmentaires.

Onglet Grille
Autoriser la suppression des grilles : Permet de supprimer le nombre par dfaut de lignes de
grille par page. La valeur par dfaut est 100. Lorsque cette option est active, l'utilisateur peut
dfinir le nombre de lignes par page (toute valeur infrieure ou gale la taille maximale de la
page grille dfinie par l'administrateur).
Taille de la page grille par dfaut : Nombre de lignes de grille par page (si l'utilisateur n'a pas
dfini de valeur de remplacement).
Taille maximale de la page grille : Nombre maximum de lignes de grille que l'utilisateur peut
dfinir pour remplacer le nombre par dfaut de lignes de grille par page. Pour ne pas nuire aux
performances, la valeur maximale autorise est 500.

Onglet Thme
Autoriser la suppression des thmes : Permet de supprimer le modle de couleur par dfaut de
FDM. Le thme par dfaut contient les couleurs, styles et icnes gnrales affichs sur l'interface
Web. Lorsque cette option est active, l'utilisateur peut slectionner un thme dans la liste Thme
par dfaut de la page Paramtres utilisateur.
Thme par dfaut : Modle de couleur par dfaut utilis dans l'interface de FDM pour
l'application. Le thme slectionn est utilis, sauf si l'utilisateur a choisi un groupe de
remplacement. Les groupes disponibles sont stocks sur le serveur Web sous \\Hyperion\
FDM\ WebServerComponent\ WebSite\ Themes.
Vous pouvez crer des thmes supplmentaires en ajoutant un dossier dans le rpertoire
Themes, et en y plaant les icnes et fichiers de style supplmentaires.

Remarque :
Les icnes doivent avoir le mme nom que les icnes du rpertoire existant.

Onglet Barre d'informations


Afficher uniquement les erreurs et les messages de script dans la barre d'informations :
Dsactive les messages de confirmation affichs dans la barre d'informations de FDM (utilisation
du bouton Mettre jour la grille, mise jour des enregistrements, suppression de lignes, etc.).
Lorsque cette option est active, FDM affiche uniquement les messages gnrs par script dans
la barre d'informations.

Fonctions du client Web 35


Minuteur de la barre d'informations : Dfinit la dure d'affichage de la barre d'informations
(avant masquage). Une fois masque, la barre d'informations est accessible en cliquant sur l'icne
Information ( ).

Onglet Cache
Effacer le cache Web : Supprime l'ensemble des valeurs XML de la mmoire du serveur Web
relatives l'diteur de tables. Cette opration n'efface aucun fichier sur le serveur Web et
supprime uniquement leur apparition dans la mmoire cache.

Remarque :
La session FDM doit tre redmarre pour appliquer les modifications de l'interface. Cette
procdure s'applique toutes les sessions Web.

Paramtres utilisateur
Pour accder aux paramtres utilisateur, slectionnez Outils > Paramtres utilisateur. Ces
paramtres permettent chaque utilisateur de contrler les thmes, les icnes de barre d'tat, le
nombre de lignes de grille par page et le type de publication de rapports par dfaut. Quatre
options sont disponibles :
Thmes
Barre d'tat
Taille de la page grille
Type de publication de rapport par dfaut
Thmes : Permet l'utilisateur de choisir un thme par dfaut. Le thme par dfaut contient les
couleurs, styles et icnes gnrales affichs sur l'interface Web. L'utilisateur slectionne un thme
dans la liste Thmes.
Icnes de la barre d'tat : Permet l'utilisateur de choisir des icnes de barre d'tat par dfaut.
Les icnes de la barre d'tat correspondent aux icnes de russite/d'chec affiches dans la zone
de workflow sous Importer, Valider, Exporter et Vrifier. L'utilisateur peut slectionner un
groupe de barre d'tat dans la liste Status Bar Groups.
Taille de la page grille : Permet l'utilisateur de dfinir le nombre par dfaut de lignes de grille
par page. Le nombre de lignes maximum correspond la taille maximale de la page grille dfinie
sur la page Paramtres Web de l'administrateur.
Type de publication de rapport par dfaut : Permet l'utilisateur de choisir un type de rapport
par dfaut utilis lorsque les rapports de vrification et d'Explorateur de processus sont excuts.
Cette valeur est dfinie par dfaut dans la liste des types de publication de la page Rapports. Les
choix de la liste sont : PDF, Excel, Word, RTF et HTML.

36 Navigation dans FDM


Remarque :
La session FDM doit tre redmarre pour appliquer les modifications. Ces options peuvent tre
dfinies uniquement si l'administrateur a autoris les remplacements pour l'option slectionne.

Verrouillage et dverrouillage du PDV


Les paramtres de verrouillage de point de vue comportent les options suivantes :
Verrouiller le point de vue en cours
Dverrouiller le point de vue en cours
Verrouiller tous les emplacements (Catgorie/Priode en cours)
Dverrouiller tous les emplacements (Catgorie/Priode en cours)
Le verrouillage du PDV empche les emplacements de modifier leurs donnes FDM. Lorsqu'un
emplacement est verrouill pour une priode ou une catgorie spcifique, l'utilisateur ne peut
pas importer, valider, exporter ou rexcuter le rapport de validation. Excutez le rapport de
moniteur de processus pour voir l'tat de verrouillage de l'ensemble des emplacements.

Lorsqu'un emplacement est verrouill, un cadenas ( ) apparat dans la barre du PDV.


Le PDV peut tre verrouill/dverrouill par les utilisateurs ou les administrateurs pour chaque
emplacement. Une option rserve aux administrateurs permet galement de verrouiller/
dverrouiller tous les emplacements simultanment.

Pour verrouiller/dverrouiller les emplacements individuellement (tous les utilisateurs),


procdez comme suit :
1 Dans le client Web, dfinissez la catgorie et l'emplacement de PDV verrouiller/dverrouiller.
2 Slectionnez l'option de menu approprie :
Pour verrouiller : slectionnez Outils > Verrouiller le point de vue en cours.
Pour dverrouiller : slectionnez Outils > Dverrouiller le point de vue en cours.

Pour verrouiller/dverrouiller tous les emplacements pour la catgorie et la priode en cours


(administrateurs uniquement), procdez comme suit :
1 Dans le client Web, dfinissez la catgorie et la priode de PDV verrouiller/dverrouiller.
2 Slectionnez l'option de menu approprie :
Pour verrouiller tous les emplacements : slectionnez Administration > Verrouiller tous les
emplacements (Catgorie/Priode en cours).
Pour dverrouiller tous les emplacements : slectionnez Administration > Dverrouiller
tous les emplacements (Catgorie/Priode en cours).

Fonctions du client Web 37


Verrouillage et dverrouillage du mode PDV
Utilisez cette option pour contrler l'accs au mode PDV local. Lorsque cette option est active,
l'utilisateur final ne peut pas basculer en mode PDV local. Lorsque l'option est dsactive, le
mode PDV local est accessible par tous les utilisateurs du systme. Pour plus d'informations sur
le mode PDV, reportez-vous la section Bascule du mode PDV la page 38.

Pour changer le verrouillage du mode PDV, procdez comme suit :


1 Dans le client Web, slectionnez Administration > Verrouillage du mode Point de vue.
2 Slectionnez/dslectionnez Actif/Inactif.
3 Cliquez sur OK.

Fonctions communes au client Web et Workbench


Utilisez le PDV pour dfinir le ciblage de donnes de FDM. Lorsque le verrouillage de PDV est
activ, les valeurs de catgorie et de priode sont contrles sur l'ensemble du systme, et seul
l'administrateur systme est autoris les modifier. Cette procdure permet de s'assurer que
l'utilisateur final pourra seulement charger des donnes dans la priode et la catgorie
appropries.
Pour plus de flexibilit au niveau de l'utilisateur final, vous pouvez dsactiver le verrouillage de
PDV. Cela permet l'utilisateur final de basculer en mode PDV local afin de traiter des donnes
pour n'importe quelle catgorie ou priode.

Bascule du mode PDV


L'indicateur de mode de la barre du PDV indique le mode de PDV en cours : Global ou Local.
Lorsque le systme est en mode local, cliquez deux fois sur Local dans la barre du PDV pour
basculer en mode global. Lorsque le systme est en mode Global, cliquez deux fois sur Global
pour basculer en mode local.
Mode PDV local : Permet de slectionner n'importe quelle catgorie ou priode traiter.
Mode PDV global : Restreint le traitement de catgories/priodes une valeur globale valable
pour l'ensemble des utilisateurs du systme.

Remarque :
L'administrateur systme peut basculer en mode PDV local, tandis que l'utilisateur final peut
simplement accder cette option lorsque le verrouillage de PDV est dsactiv.

Configuration d'un PDV d'emplacement


L'utilisateur peut seulement voir les emplacements auxquels il est autoris accder. Les
autorisations sont dtermines et accordes par les administrateurs systme. Un emplacement

38 Navigation dans FDM


par dfaut doit tre affect chaque utilisateur. Lorsqu'un utilisateur se connecte, le PDV est
celui de son emplacement par dfaut.

Pour dfinir un PDV d'emplacement, procdez comme suit :


1 Dans la barre du PDV, cliquez deux fois sur l'emplacement en cours.
La bote de dialogue PDV (onglet Emplacement) s'affiche.
2 Slectionnez un emplacement.
3 Cliquez sur OK.

Configuration d'un PDV de catgorie


L'administrateur FDM contrle la catgorie de donnes active pour l'ensemble des utilisateurs.
Cette procdure empche les utilisateurs de charger par inadvertance des donnes dans la
mauvaise catgorie.

Pour dfinir un PDV de catgorie, procdez comme suit :


1 Dans la barre du PDV, cliquez deux fois sur la catgorie en cours.
La bote de dialogue PDV (onglet Catgorie) s'affiche.
2 Slectionnez une catgorie.
3 Cliquez sur OK.
Le fait de changer la catgorie FDM change galement la catgorie du systme cible. Lorsqu'une
catgorie FDM est dfinie dans le formulaire Tables de contrle, celle-ci est associe une
catgorie de systme cible.

Configuration d'un PDV de priode


L'administrateur FDM contrle la priode comptable active pour l'ensemble des utilisateurs.
Cette fonction empche les utilisateurs de charger par inadvertance des donnes dans la mauvaise
priode.
Lorsqu'un utilisateur se connecte FDM, l'application vrifie la valeur de priode globale et
dfinit automatiquement le PDV sur la valeur en cours.

Pour dfinir un PDV de priode, procdez comme suit :


1 Dans la barre du PDV, cliquez deux fois sur la priode en cours.
L'onglet Priode de la bote de dialogue PDV s'affiche.
2 Mettez une priode en surbrillance.
3 Cliquez sur OK.
Le fait de changer la priode FDM change galement la priode du systme cible.

Fonctions communes au client Web et Workbench 39


Recherche dans le PDV
Pour rechercher dans le PDV du client Web, procdez comme suit :
1 Ouvrez la bote de dialogue PDV en cliquant deux fois sur l'emplacement, la priode ou la catgorie en cours
dans la barre du PDV.
2 Cliquez sur Rechercher.
3 Entrez une chane ou un fragment de chane rechercher.
4 Cliquez sur OK.

Pour rechercher dans le PDV de Workbench, procdez comme suit :


1 Ouvrez la bote de dialogue PDV en slectionnant l'emplacement, la priode ou la catgorie en cours dans
la barre du PDV.
2 Dans Slectionner un emplacement, entrez une chane ou un fragment de chane rechercher.
3 Cliquez sur >.

Verrouillage et dverrouillage du systme


Utilisez cette option pour fermer les sessions utilisateur et pour empcher de nouveaux
utilisateurs de se connecter. Vous pouvez galement entrer un message qui s'affiche lorsque les
utilisateurs sont dconnects. Vous devez fermer les sessions utilisateur avant de procder aux
tches de maintenance de la base de donnes.
Lorsque le systme est verrouill, les utilisateurs ne peuvent pas se connecter. Les sessions
utilisateur qui crivent des enregistrements dans la base de donnes ne sont pas fermes.

Pour verrouiller et dverrouiller le systme, procdez comme suit :


1 Dans la barre du PDV (client Web ou Workbench), cliquez deux fois sur la catgorie Verrouillage du systme.
La catgorie Verrouillage du systme se trouve totalement droite de la barre du PDV et porte
l'tiquette Verrouill ou Ouvert .
La bote de dialogue Verrouillage du systme s'affiche.
2 Basculez l'option Actif/Inactif pour changer l'tat de verrouillage du systme.
3 (Facultatif) Dans Message de verrouillage du systme, entrez le message qui s'affiche lorsque les
utilisateurs sont dconnects.
4 Cliquez sur OK.
Le nouvel tat de verrouillage du systme s'affiche dans le PDV (Verrouill ou Ouvert).

Remarque :
Les droits de verrouillage et de dverrouillage du systme sont rservs aux administrateurs.

40 Navigation dans FDM


Procdure de dtermination des points de vue utilisateur par
dfaut
Lorsqu'un utilisateur se connecte FDM, la squence d'vnements suivante s'excute pour
dterminer le PDV :
1. Le PDV d'emplacement est dfini en extrayant le profil de scurit de l'utilisateur.
2. Le mode PDV est dfini sur Global.
3. Le PDV de catgorie est dfini en extrayant la catgorie globale du systme (dfinie par
l'administrateur).
4. Le PDV de priode est dfini en extrayant la priode globale du systme (dfinie par
l'administrateur).

Procdure de dtermination des points de vue utilisateur par dfaut 41


42 Navigation dans FDM
Configuration des paramtres
4 systme

Dans ce chapitre
Options systme........................................................................................................................................................43
Configuration des paramtres de l'application............................................................................................................43

Options systme
Les options systme sont des valeurs gnrales qui permettent de grer le comportement d'une
application FDM. Les options systme permettent de contrler les mcanismes et les mcanismes
de rglage des performances. Il existe trois types d'options systme :
Paramtres de l'application
Paramtres d'intgration
Options de configuration
Vous pouvez configurer les options systme de Workbench et du client Web.

Configuration des paramtres de l'application


Pour accder aux paramtres de l'application, procdez comme suit :
1 Ouvrez la bote de dialogue Paramtres de l'application :
Dans Workbench : slectionnez Outils > Paramtres de l'application.
Dans le client Web : slectionnez Administration > Paramtres de l'application.
2 Dans Options, slectionnez un paramtre d'application.
Il existe quinze options de paramtre d'application. Pour plus d'informations sur chacune de
ces options, reportez-vous la section Options de paramtre d'application la page 44.
3 Slectionnez les paramtres d'option.
Les paramtres d'option sont situs dans la moiti infrieure de la bote de dialogue Paramtres
de l'application. Les options affiches dpendent du paramtre d'application slectionn dans
la partie Options.

Options systme 43
Options de paramtre d'application

Code systme
Indique le systme cible que vous intgrez FDM. Un code systme cible doit tre associ
chaque adaptateur d'intgration de systme cible utilis. Une application FDM peut tre associe
un nombre illimit d'applications cible.

Ignorer l'lment de mappage


Cette option permet de stocker un membre d'une dimension cible identifi comme la valeur
supprimer ou ignorer . Toute dimension source mappe cette valeur n'est pas charge
dans le systme cible. Les dimensions source mappes cette valeur sont affiches dans l'cran
Exporter. Cependant, elles ne figurent pas dans le fichier de donnes d'exportation. La valeur
par dfaut est la valeur ignorer .

Consigner les modifications de mappage


Lorsque cette option est active, toutes les modifications apportes la table de mappage, quel
que soit l'emplacement, sont consignes dans un journal systme. Ceci vous permet de conserver
une analyse rtrospective de ces modifications de mappage. La valeur par dfaut est Actif.

Chargeur de lots
Utilisez cette option pour activer le chargeur de lots.

ID de rapport de validation
Utilisez cette option pour dfinir l'ID du rapport de validation.

Mthode d'archivage
Cette option permet de spcifier si les fichiers archivs sont copis dans l'emplacement
d'archivage ou s'ils sont dplacs vers l'emplacement d'archivage.

Verrouillage des contrles


Cette option est utilise en association avec la fonctionnalit Contrles financiers de FDM. Pour
plus d'informations, reportez-vous au Chapitre 12, Contrles financiers .

Contrles sans donnes


Cette option est utilise en association avec la fonctionnalit Contrles financiers de FDM. Pour
plus d'informations, reportez-vous au Chapitre 12, Contrles financiers .

44 Configuration des paramtres systme


Annulation de l'envoi des contrles
Cette option est utilise en association avec la fonctionnalit Contrles financiers de FDM. Pour
plus d'informations, reportez-vous au Chapitre 12, Contrles financiers .

Dbut de la priode fiscale


Cette option est utilise en association avec la fonctionnalit Contrles financiers de FDM. Pour
plus d'informations, reportez-vous au Chapitre 12, Contrles financiers .

Date Format Mask


Option permettant de dfinir le format de date du champ de description Priodes de FDM.
Toutes les priodes FDM cres aprs la dfinition de cette option sont conformes au format
spcifi. Le format par dfaut est MMM-AAAA.

Crer un dossier d'emplacement


Ce paramtre dtermine si FDM cre un dossier d'emplacement dans la bote de rception
lorsque les emplacements FDM sont crs. Les options possibles sont les suivantes : Emplacement
de chargement des donnes uniquement, Tous les emplacements ou Aucun.

Supprimer le dossier d'emplacement


Ce paramtre permet d'indiquer si, lorsque des emplacements FDM sont supprims, FDM doit
supprimer les dossiers d'emplacement de la Inbox.

Configuration des paramtres d'intgration


Un paramtre d'intgration dtermine les niveaux d'intgration entre FDM et le systme cible
et contrle quels points sont actifs, le type de processus d'intgration excuter et les valeurs
par dfaut lies aux intgrations.

Pour accder aux paramtres d'intgration, procdez comme suit :


1 Ouvrez la bote de dialogue Paramtres d'intgration :
Dans Workbench, slectionnez Outils > Paramtres d'intgration.
Dans le client Web, slectionnez Administration > Paramtres d'intgration.
2 Dans Options, slectionnez un paramtre d'intgration.
3 Slectionnez les paramtres d'option.
Les paramtres d'option sont situs dans la moiti infrieure de la bote de dialogue Paramtres
d'intgration. Les options affiches dpendent du paramtre d'intgration slectionn dans la
partie Options.
Il existe trois catgories d'options d'intgration :

Configuration des paramtres de l'application 45


Connexion
Point d'intgration
Chargement par dfaut

Options de type connexion


Nom de l'application : Spcifie le nom de l'application cible intgrer FDM.
Mthode de connexion : Contrle la mthode que FDM utilise pour se connecter au systme
cible lorsque FDM tablit une connexion. Il existe deux mthodes de connexion : unifie et
globale.
Unifie : Le nom d'utilisateur et le mot de passe FDM sont utiliss pour se connecter au
systme cible.
Globale : Le nom d'utilisateur et le mot de passe spcifis dans l'option Infos sur la
connexion globale est transmise au systme cible. Cette option permet tous les
utilisateurs de se connecter au systme cible en utilisant les mmes nom d'utilisateur et
mot de passe.

Remarque :
Dans Workbench, un nom d'utilisateur et un mot de passe spcifiques un ordinateur
remplacent la mthode de connexion spcifie pour cet ordinateur en particulier.
Infos sur la connexion globale : Associe l'option Mthode de connexion. Lorsque la
mthode de connexion est dfinie sur Globale , le nom d'utilisateur et le mot de passe
spcifis sont utiliss pour se connecter au systme cible. Sparez le nom d'utilisateur et le
mot de passe par un point-virgule (NomUtilisateur;Motdepasse).
Utiliser SSO : Option permettant d'activer la connexion unique Hyperion lorsqu'un jeton
est transmis FDM.
Utiliser le serveur fixe : Option permettant de forcer l'utilisation d'un serveur pour le
chargement, la consolidation et le contrle (obligatoire pour le temps de rponse du cache
du serveur d'application Financial Management).

Options de type Point d'intgration


Activer le chargement : Force FDM charger automatiquement le fichier d'exportation
(fichier *.dat) dans le systme cible aprs l'exportation. Si cette option n'est pas active,
FDM cre le fichier d'exportation. Cependant, il ne le charge pas automatiquement.
Activer la consolidation : Excute une consolidation dans le systme cible aprs un
chargement de donnes.
Activer le rapport de validation : Contrle les priodes affiches lors de l'intgration dans
le systme cible. Slectionnez cette option pour afficher toutes les priodes. Dsactivez cette
option pour afficher les priodes de base uniquement.

46 Configuration des paramtres systme


Toutes les priodes : Activez cette option pour forcer FDM excuter un rapport de
validation (s'il en existe un affect l'emplacement) aprs le chargement des donnes et le
processus de consolidation.

Options de type chargement par dfaut


Type de consolidation : paramtre par dfaut pour l'option Type de consolidation de la
bote de dialogue de chargement du systme cible
Mthode de chargement : paramtre par dfaut pour l'option Mthode de chargement de
la bote de dialogue de chargement du systme cible
Opration de chargement : paramtre par dfaut pour l'option Load Process Type de la bote
de dialogue de chargement du systme cible
Liste2 : non utilise
Liste3 : non utilise
Calc : paramtre par dfaut pour l'option Calculer de la bote de dialogue de chargement
du systme cible
Cumuler dans le fichier : paramtre par dfaut pour l'option Cumuler dans le fichier de la
bote de dialogue de chargement du systme cible
Le fichier contient des donnes relatives aux titres : paramtre par dfaut pour l'option Le
fichier contient des donnes relatives aux titres de la bote de dialogue de chargement du
systme cible
Etat3 : non utilise
Protection des donnes : Activez cette option pour permettre FDM d'empcher les donnes
du systme cible d'tre crases pendant les importations de donnes, en fonction d'une
valeur de protection spcifie. Utilisez cette option lorsque les donnes sont entres dans le
systme cible au moyen d'une mthode diffrente de la mthode FDM.
Valeur de protection 1 : Stocke la valeur utilise pour l'option Protection des donnes. Il
s'agit de la valeur ne pas craser.
Oprateur de protection : Stocke un oprateur (= ou <>) afin de dterminer si les lments
gaux la Valeur de protection 1 doivent tre protgs ou si les lments diffrents de la
Valeur de protection 1 doivent tre protgs.
Line Item Detail Loading Switch : Activez cette option pour permettre de charger les dtails
d'lments de ligne dans Financial Management.
Type de chargement des dtails d'lments de ligne : Dfinit le type de chargement des
dtails d'lments de ligne (Chargement rsum ou dtaill).
Force Calculate before Consolidation : Activez cette option pour excuter le calcul par dfaut
avant une consolidation.

Configuration des paramtres de l'application 47


Paramtrage des options de configuration
Les options de configuration permettent de dfinir les paramtres de rglage et de performance
de la base de donnes. Ces options de rglage de la base de donnes doivent tre utilises lorsque
l'infrastructure rseau requiert la configuration du moteur de base de donnes (activit d'E/S,
notamment).

Pour accder aux options de configuration, procdez comme suit :


1 Ouvrez la bote de dialogue Configuration Options du client Web FDM ou Workbench.
Dans Workbench : slectionnez Outils > Configuration Options.
Dans le client Web : slectionnez Administration > Configuration Options.
2 Dans Options, slectionnez une option de configuration.
Il existe 31 options de configuration. Chacune de ces options est dtaille dans les sections ci-
dessous.
3 Slectionnez les paramtres d'option.
Les paramtres d'option sont situs dans la moiti infrieure de la bote de dialogue
Configuration Options. Les options affiches dpendent de l'option de configuration
slectionne dans la partie Options.

Elments d'option de configuration

Options gnrales
Version de la base de donnes : Activez cette option pour afficher le numro de version du
logiciel FDM install.
Masque de format de date de requte SQL : Activez cette option pour slectionner le format
standard utilis dans les instructions SQL de requte de dates.
Remplacement de la dcimale : Activez cette option pour permettre FDM de spcifier le
sparateur utilis lors du chargement de fichiers BCP sur le serveur SGBDR. Modifiez cette
option uniquement lorsque vous utilisez un systme ayant t configur selon des
paramtres rgionaux multiples (serveur SGBDR install sur un systme d'exploitation US-
EN et un serveur d'application ou un ordinateur client quip d'un systme d'exploitation
configur selon les paramtres rgionaux franais).
Insrer une taille de lot : Cette option permet FDM de spcifier le nombre de lignes
insrer dans la base de donnes FDM au cours de l'importation de fichiers. N'utilisez cette
option que pour les emplacements FDM utilisant un type de chargement Insertion SQL.
Nombre total de segments de donnes : Utilisez cette option pour dfinir le nombre de
segments par dfaut crs dans la base de donnes SGBDR.

48 Configuration des paramtres systme


Options de configuration SQL
Groupe de fichiers de la table de segments de donnes : Cette option permet FDM de
spcifier que le serveur SGBDR utilise un groupe de fichiers de la table de segments de
donnes diffrent de celui du groupe principal SGBDR (bases de donnes du serveur SQL
uniquement).
Groupe de fichiers de la table de segments de mappage de donnes : Cette option permet
FDM de spcifier que le serveur SGBDR utilise un groupe de fichiers de la table de segments
de mappage de donnes diffrent de celui du groupe principal SGBDR (bases de donnes
du serveur SQL uniquement).
Groupe de fichiers de tables de travail : Cette option permet FDM de spcifier que le
serveur SGBDR utilise un Groupe de fichiers de tables de travail de celui du groupe principal
SGBDR (bases de donnes du serveur SQL uniquement).
Groupe de fichiers de tables de travail : Cette option permet FDM de spcifier que le
serveur SGBDR utilise un groupe de fichiers de tables de travail diffrent de celui du groupe
principal SGBDR (bases de donnes du serveur SQL uniquement).

Options de configuration Oracle


Conseil d'insertion de segment Oracle : Cette option dfinit comment le chargeur SQL
charge des donnes dans les tables tDataSeg. L'option de chargement par dfaut est Ajouter,
ce qui permet FDM d'ajouter rapidement des donnes aux tables de segments sans devoir
trouver de l'espace libre dans la table comme le requiert le paramtre d'insertion.
Nom de TableSpace de travail Oracle : nom de tablespace pour les tables de travail FDM.
La valeur par dfaut est Utilisateurs .
Clause de stockage de travail Oracle : Cette option permet de spcifier les valeurs par dfaut
du tablespace de travail. Ces valeurs crasent les valeurs par dfaut du systme et deviennent
les valeurs par dfaut pour les objets crs dans le tablespace spcifi.
Pourcentage libre de travail Oracle : Cette option permet de spcifier la portion du bloc de
donnes n'tant pas remplie par des lignes insres dans le tablespace de travail, mais
rserves pour une mise jour ultrieure des lignes de ce bloc. La valeur de pourcentage
libre par dfaut est 10 %. Vous pouvez utiliser des valeurs comprises entre 0 et 99 inclus,
tant que la somme du pourcentage libre et du pourcentage utilis ne dpasse pas 100.
Nb initial de transactions de travail Oracle : Cette option permet de spcifier le nombre
initial d'entres de transaction affect chaque bloc de donnes affect la table. La valeur
de cette option peut tre comprise entre 1 et 255. Chaque transaction mettant jour un bloc
requiert une entre de transaction. La taille d'une entre de transaction dpend de votre
systme d'exploitation. Ce paramtre garantit qu'un nombre minimum de transactions
simultanes peut mettre jour le bloc et permet aussi d'viter le temps inactif engendr par
l'affectation dynamique d'une entre de transaction.
Nb max. de transactions de travail Oracle : Cette option permet de spcifier le nombre
maximum de transactions simultanes pouvant mettre jour un bloc de donnes affect
la table de travail. La valeur pour cette option peut tre comprise entre 1 et 255.

Configuration des paramtres de l'application 49


Valeur de consignation de table de segments Oracle : Cette valeur permet d'activer la
connexion ou dconnexion des tables de segments.
Nom de tablespace d'index de table de travail Oracle : Cette option permet de dfinir le
nom de tablespace d'index de table de travail FDM. La valeur par dfaut de cette option est
Utilisateurs .
Segment de mappage de donnes Oracle - Nom de tablespace : Cette option permet de
dfinir le nom de tablespace de la table de segments de mappage de donnes FDM. La valeur
par dfaut de cette option est Utilisateurs .
Segment de mappage de donnes Oracle - Clause de stockage : Cette option permet de
spcifier les lments de stockage par dfaut pour le tablespace de la table de segments de
mappage de donnes. Ces valeurs crasent les valeurs par dfaut du systme et deviennent
les valeurs par dfaut pour les objets crs dans le tablespace spcifi.
Segment de mappage de donnes Oracle - Pourcentage libre : Cette option permet de
spcifier la portion du bloc de donnes n'tant pas remplie par des lignes insres dans la
table de segments de mappage de donnes, mais rserves pour une mise jour ultrieure
des lignes de ce bloc. La valeur de pourcentage libre par dfaut est 10 %. Vous pouvez utiliser
des valeurs comprises entre 0 et 99 inclus, tant que la somme du pourcentage libre et du
pourcentage utilis ne dpasse pas 100.
Segment de mappage de donnes Oracle - Nb initial de transactions : Cette option permet
de spcifier le nombre initial d'entres de transaction affect aux tablespaces de mappage de
donnes. La valeur de cette option peut tre comprise entre 1 et 255. Chaque transaction
mettant jour un bloc requiert une entre de transaction. La taille d'une entre de transaction
dpend de votre systme d'exploitation. Ce paramtre garantit qu'un nombre minimum de
transactions simultanes peut mettre jour le bloc et permet aussi d'viter le temps inactif
engendr par l'affectation dynamique d'une entre de transaction.
Segment de mappage de donnes Oracle - Nb max. de transactions : Cette option permet
de spcifier le nombre maximum de transactions simultanes pouvant mettre jour un bloc
de donnes affect la table de segments de mappage de donnes. La valeur pour cette
option peut tre comprise entre 1 et 255.
Segment de donnes Oracle - Nom de tablespace : Nom de tablespace pour les tables de
segments de donnes FDM. La valeur par dfaut de cette option est Utilisateurs .
Segment de donnes Oracle - Clause de stockage : Cette option permet de spcifier les
lments de stockage par dfaut pour le tablespace de la table de segments de donnes. Ces
valeurs crasent les valeurs par dfaut du systme et deviennent les valeurs par dfaut pour
les objets crs dans le tablespace spcifi.
Segment de donnes Oracle - Pourcentage libre : Cette option permet de spcifier la portion
du bloc de donnes n'tant pas remplie par des lignes insres dans la table de segments de
donnes, mais rserves pour une mise jour ultrieure des lignes de ce bloc. La valeur de
pourcentage libre par dfaut est 10 %. Vous pouvez utiliser des valeurs comprises entre 0 et
99 inclus, tant que la somme du pourcentage libre et du pourcentage utilis ne dpasse pas
100.
Segment de donnes Oracle - Nb initial de transactions : Cette option permet de spcifier
le nombre initial d'entres de transaction affect aux tables de segments de donnes. La

50 Configuration des paramtres systme


valeur de cette option peut tre comprise entre 1 et 255. Chaque transaction mettant jour
un bloc requiert une entre de transaction. La taille d'une entre de transaction dpend de
votre systme d'exploitation. Ce paramtre garantit qu'un nombre minimum de
transactions simultanes peut mettre jour le bloc et permet aussi d'viter le temps inactif
engendr par l'affectation dynamique d'une entre de transaction.
Segment de donnes Oracle - Nb max. de transactions : Cette option permet de spcifier le
nombre maximum de transactions simultanes pouvant mettre jour un bloc de donnes
affect la table de segments de donnes. La valeur pour cette option peut tre comprise
entre 1 et 255.

Autres options de configuration gnrales


Autorise l'ajout d'une description personnalise dans une priode : Cette option permet
aux administrateurs de crer des descriptions de priode personnalises.
Indicateur de recherche : Donnes du systme cible : Cette option permet de spcifier le
caractre de fin devant tre utilis par les rgles de validation qui extraient des donnes des
systmes cible. Le caractre par dfaut est une barre verticale (|).
Indicateur de recherche : Donnes converties par du systme FDM : Cette option permet
de spcifier le caractre de fin devant tre utilis par les rgles de validation qui extraient des
donnes converties par FDM. Le caractre par dfaut est un accent grave (`).
Indicateur de recherche : Donnes source FDM : Cette option permet de spcifier le
caractre de fin devant tre utilis par les rgles de validation qui extraient des donnes source
FDM. Le caractre par dfaut est un tilde (~).

Configuration des paramtres de l'application 51


52 Configuration des paramtres systme
Affectation de la scurit FDM
5 et gestion des utilisateurs

Dans ce chapitre
Scurit.....................................................................................................................................................................53
Gestion des utilisateurs .............................................................................................................................................54

Scurit
FDM permet de scuriser la quasi totalit des lments de menu, boutons, crans et rapports.
Les fonctions de scurit sont rserves aux administrateurs. FDM propose deux niveaux de
scurit :
Scurit des objets d'application : permet de contrler l'accs aux formulaires et aux
commandes de formulaires.
Scurit d'emplacement : permet de contrler l'accs aux emplacements.
Les niveaux de scurit sont appliqus aux utilisateurs et aux objets d'application. Les niveaux
affects aux utilisateurs et aux objets sont compars lors de l'excution. Lorsque le niveau de
scurit affect l'utilisateur est suprieur ou gal au niveau affect l'objet auquel l'utilisateur
tente d'accder, l'objet est accessible. Les tches de maintenance des objets s'effectuent dans le
client Web.

Affectation de la scurit aux objets d'application


Utilisez le formulaire Maintenance des objets du client Web FDM pour affecter des droits de
scurit minimum aux objets d'application FDM et pour contrler les proprits de texte de
lgende et d'outil des objets. Le formulaire Maintenance des objets rpertorie les objets
d'application et les commandes associes.

Pour affecter ou modifier la scurit des objets d'application, procdez comme suit :
1 Dans le client Web FDM, slectionnez Administration > Maintenance des objets.
L'cran Maintenance des objets s'affiche.

Scurit 53
2 Slectionnez un objet d'application dans la grille suprieure.
3 Slectionnez une commande pour l'objet dans la grille infrieure.
4 Cliquez deux fois dans la colonne Niveau de scurit et slectionnez un niveau de scurit.
La scurit d'application se base sur un schma numrique. Les niveaux de scurit initiaux des
utilisateurs et des objets sont dfinis sur Tous, ce qui quivaut la valeur 99. Le niveau 1 est
affect aux administrateurs, tandis que les niveaux compris entre 2 et 98 sont affects aux
utilisateurs. Plus la valeur du niveau utilisateur est faible, plus l'accs aux objets et rapports
d'application est tendu.
5 Facultatif : pour modifier le texte de lgende ou d'outil, entrez une valeur dans le champ appropri.
Lorsque vous modifiez la lgende d'une commande, procdez aux tests ncessaires afin de vrifier
la lisibilit de l'ensemble du texte. La taille des commandes ne s'adapte pas la lgende.

Scurit d'emplacement
La configuration de la scurit d'emplacement de FDM s'effectue l'aide des options de
maintenance utilisateur.

Gestion des utilisateurs


Accdez au formulaire Maintenance utilisateur partir du client Web. Le formulaire
Maintenance utilisateur permet d'excuter les tches suivantes :
Ajouter des utilisateurs

54 Affectation de la scurit FDM et gestion des utilisateurs


Dfinir les droits de l'utilisateur
Supprimer des utilisateurs
Changer les mots de passe du systme cible

Ajout d'utilisateurs
Pour ajouter des utilisateurs, procdez comme suit :
1 Dans le client Web, slectionnez Administration > Maintenance utilisateur.
Le formulaire Maintenance utilisateur s'affiche.
2 Cliquez sur Nouvel utilisateur.
La bote de dialogue Nouvel utilisateur s'affiche.
3 Entrez un nom d'utilisateur dans la zone Nom d'utilisateur.
4 Facultatif : pour affecter un mot de passe de systme cible, slectionnez Utiliser le mot de passe du
systme cible, puis entrez et confirmez le mot de passe.
Vous devez affecter un mot de passe de systme cible si vous utilisez un mode d'authentification
autre que le protocole LDAP et si vous souhaitez que FDM transmette les informations de
connexion au systme cible lorsque vous utilisez la connexion unifie pour l'intgration.
5 Cliquez sur OK.
La bote de dialogue Droits de l'utilisateur s'affiche.

Configuration des droits d'application


Les droits d'application contrlent l'accs aux formulaires et leurs commandes. Les
administrateurs ont accs tous les emplacements, formulaires et commandes. La scurit
d'application associe chaque utilisateur un niveau de scurit valu par rapport au niveau de
scurit des objets d'application. Ce processus dtermine les composants de l'interface auxquels
chaque utilisateur peut accder.

Pour attribuer des droits d'application, procdez comme suit :


1 Dans le client Web, slectionnez Administration > Maintenance utilisateur.
L'cran Droits de l'utilisateur s'affiche.
2 Cliquez deux fois sur un utilisateur.
3 Excutez une action :
Pour attribuer des droits administrateur, dans Niveau utilisateur, slectionnez
Superutilisateur.
Pour attribuer des droits non administrateur, dans Niveau utilisateur, slectionnez un
groupe d'utilisateurs.
4 Cliquez sur OK.

Gestion des utilisateurs 55


5 Facultatif : pour attribuer les droits administrateur relatifs aux contrles financiers, slectionnez Vrificateur.

Configuration des droits d'emplacement


Au moins un emplacement doit tre affect chaque utilisateur. Tous les emplacements sont
accessibles aux utilisateurs bnficiant du niveau Superutilisateur. Les utilisateurs bnficiant
des droits d'application peuvent accder uniquement aux emplacements affects aux profils
d'utilisateurs.

Pour affecter des emplacements aux utilisateurs, procdez comme suit :


1 Dans le client Web, slectionnez Administration > Maintenance utilisateur.
L'cran Droits de l'utilisateur s'affiche.
2 Cliquez deux fois sur un utilisateur.
3 Cliquez sur Ajouter.
4 Sur la nouvelle ligne, cliquez deux fois dans la colonne Emplacement et slectionnez un emplacement.
5 Facultatif : pour dfinir l'emplacement slectionn en tant qu'emplacement par dfaut de l'utilisateur,
slectionnez Par dfaut.
6 Cliquez sur Mettre jour la grille.

Remarque :
Chaque utilisateur peut recevoir plusieurs emplacements, mais un seul emplacement par dfaut.
Slectionnez Accorder l'accs tous les emplacements pour permettre aux utilisateurs non-
administrateurs d'accder aux emplacements.

Alternative de scurit pour les emplacements


Le champ Niveau de scurit permet aux administrateurs de configurer des droits d'application
alternatifs pour les emplacements affects. Pour chaque emplacement, le niveau indiqu dans
le champ Niveau de scurit est utilis la place du niveau dfini pour l'utilisateur.
Par exemple, trois emplacements sont affects un utilisateur ayant des droits d'application par
dfaut de niveau Intermdiaire-7. Si un des emplacements a le niveau de scurit
Intermdiaire-5, les droits d'application de l'utilisateur sont dfinis sur Intermdiaire-5 lorsque
le PDV est dfini sur l'emplacement Intermdiaire-5.

Adresse e-mail
Le champ Adresse e-mail contient l'adresse e-mail de l'utilisateur. Vous pouvez crer un script
permettant d'envoyer des e-mails aux utilisateurs concernant l'tat de chargement des
emplacements FDM.

56 Affectation de la scurit FDM et gestion des utilisateurs


Suppression d'utilisateurs
Pour supprimer des utilisateurs, procdez comme suit :
1 Dans le client Web, slectionnez Administration > Maintenance utilisateur.
L'cran Maintenance utilisateur s'affiche.
2 Cliquez sur Supprimer en regard d'un nom d'utilisateur.
3 Cliquez sur Mettre jour la grille.

Changement des mots de passe du systme cible


Lorsque la scurit LDAP n'est pas active, les utilisateurs peuvent modifier leurs mots de passe
de systme cible.

Pour modifier les mots de passe, procdez comme suit :


1 Dans le client Web, slectionnez Outils > Modifier le mot de passe du systme cible.
2 Entrez et confirmez l'ancien et le nouveau mot de passe.
3 Cliquez sur OK.

Gestion des utilisateurs 57


58 Affectation de la scurit FDM et gestion des utilisateurs
Dimensions
6
Dans ce chapitre
Activation des dimensions mappables.......................................................................................................................59
Libells de dimension................................................................................................................................................60

Activation des dimensions mappables


L'activation des dimensions s'effectue partir du client Web. Slectionnez Mtadonnes >
Dimensions pour configurer les dimensions mappables du systme cible charges par FDM. Lors
du chargement de Hyperion Enterprise, la procdure standard consiste activer uniquement
les dimensions Compte et Entit. Lors du chargement d'autres systmes cible, chaque dimension
FDM peut tre charge. L'cran Dimensions contient cinq colonnes :
Dimension
Alias
Squence de calcul
Active
Utiliser pour la recherche

Dimension
La colonne Dimension contient l'ensemble des dimensions FDM prdfinies. Le nom des
dimensions ne peut pas tre modifi.

Alias
La colonne Alias permet de dfinir la dimension avec un autre libell. Entrez l'alias de dimension
correspondant au nom de dimension du systme cible. FDM affiche l'alias dans la zone de liste
dans les tables de mappage et dans les crans Valider et Exporter.

Activation des dimensions mappables 59


Squence de calcul
La colonne Squence de calcul permet aux administrateurs FDM de remplacer l'ordre par dfaut
de calcul de dimensions. Utilisez cette option pour le mappage conditionnel. L'ordre par dfaut
est celui dans lequel les comptes sont affichs dans l'cran Dimensions.

Active
Slectionnez Active pour activer la dimension slectionne. Lorsqu'une dimension est active,
vous pouvez importer, mapper et charger des donnes dans celle-ci.

Utiliser pour la recherche


La colonne Utiliser pour la recherche permet aux administrateurs d'utiliser une dimension pour
une table personnalise. Lorsque cette option est choisie, le champ Active ne peut pas tre
slectionn. La dimension de recherche personnalise est utilise uniquement pour le script
personnalis.

Libells de dimension
Slectionnez Mtadonnes > Libells de dimension pour affecter des libells source et cible aux
dimensions FDM. Vous ne pouvez pas modifier le nom des dimensions, mais seulement leur
libell. Les libells de dimension sont affichs dans les tables de mappage et dans l'cran Formats
d'importation.

1. Libell source
2. Libell cible

60 Dimensions
Manipulation des tables de
7 contrle

Dans ce chapitre
A propos des tables de contrle.................................................................................................................................61
Configuration des priodes.........................................................................................................................................61
Configuration des catgories......................................................................................................................................64
Configuration des codes de devise.............................................................................................................................66

A propos des tables de contrle


Les tables de contrle permettent aux administrateurs systme de contrler les options systme
et les valeurs de PDV que les utilisateurs peuvent slectionner. Pour chaque systme cible, FDM
utilise deux tables de contrle (Priodes et Catgories). Une troisime table, la table Devises, est
commune tous les systmes cible. Utilisez le client Web pour configurer et tenir jour les tables
de contrle.

Configuration des priodes


Vous faites appel la table de contrle Priodes pour dfinir les priodes fiscales utilises par
FDM.

A propos des tables de contrle 61


Les valeurs de la table Priodes reprsentent les priodes pouvant tre slectionnes depuis le
PDV de priode. Chaque priode FDM est associe une priode du systme cible. Si la priode
FDM change, l'emplacement de chargement des donnes dans le systme cible change galement.
Priode : Valeur de date stocke dans la base de donnes lors du processus de chargement
de la balance comptable, valeur qui fait alors partie intgrante d'une cl identifiant un
ensemble d'enregistrements de la balance comptable.
Cl de date antrieure : Cl de priode fiscale antrieure utilise lors de l'exportation pour
dterminer si une entre de 0,00 EUR doit tre cre dans Hyperion Enterprise 4.3 ou version
antrieure afin d'viter l'apparition d'entres fantmes. L'entre doit tre cre si les valeurs
YTD ont t charges dans une catgorie priodique.
Description texte : Description de la cl de date sous forme de texte. Le format du texte
descriptif est dtermin par la configuration systme du masque de format de date. Le format
mensuel est slectionn par dfaut, mais il peut tre modifi afin de permettre le chargement
d'un nombre de priodes suprieur douze.
Grce l'option Autorise l'ajout d'une description personnalise dans une priode , les
administrateurs peuvent crer des descriptions de priode personnalises qui suppriment les
valeurs par dfaut. Les restrictions concernant l'option de suppression de texte s'appliquent la
suppression du texte descriptif (la valeur ne peut pas correspondre une date) et au masque de
format de date cl de priode (l'option doit tre dfinie sur MM-JJ-AAAA).
Les options suivantes identifient la priode cible dans laquelle les donnes sont charges et
correspondent respectivement aux mois, trimestres, annes ou jours :
Cible par (M)
Cible par (T)
Cible par (A)
Cible par (J)

62 Manipulation des tables de contrle


Pour insrer des priodes dans les tables, procdez comme suit :
1 Dans le client Web, slectionnez Mtadonnes > Tables de contrle.
L'cran Tables de contrle s'affiche.
2 Dans la liste droulante Table de contrle, slectionnez Priodes.
3 Slectionnez Ajouter.
4 Slectionnez la cellule dans laquelle vous souhaitez ajouter des informations ou modifier les informations
existantes.
5 Dans la colonne Priode, slectionnez Parcourir et choisissez une priode cible.

L'icne s'affiche gauche de la ligne pour indiquer qu'une modification est en attente.
6 Cliquez sur Mettre jour la grille.
L'icne indiquant qu'une modification est en attente est supprime.

Pour supprimer des priodes dans une table, procdez comme suit :
1 Slectionnez une ligne.
2 Cliquez sur Supprimer.

L'icne indiquant qu'une suppression est en attente s'affiche gauche de la ligne.


3 Cliquez sur Mettre jour la grille.

Pour annuler des modifications en attente, procdez comme suit :

1 Cliquez sur ou gauche de la ligne.


2 Slectionnez Annuler les modifications de ligne.

Configuration des tables de contrle de priode pour les


adaptateurs de suppression
La procdure Configuration des priodes la page 61 illustre une configuration utilisant
l'adaptateur d'intgration global (par dfaut). Une table de contrle Priodes doit tre cre pour
chaque adaptateur de suppression utilis dans l'application.

Pour configurer les tables de contrle des adaptateurs de suppression, procdez comme suit :
1 Slectionnez Mtadonnes > Tables de contrle.
L'cran Tables de contrle s'affiche.
2 Dans la liste droulante Table de contrle, slectionnez Priodes.
3 Dans la liste Adaptateur, slectionnez un adaptateur d'intgration.
Une nouvelle table de contrle Priodes s'affiche. Seule la colonne Priode est renseigne.

Configuration des priodes 63


4 Configurez la table intgrer l'application cible de suppression.

Remarque :
Les adaptateurs de suppression ne figurant pas dans la liste des adaptateurs n'ont pas t imports
dans l'application FDM et n'y ont pas t configurs. Pour plus d'informations sur l'ajout
d'adaptateurs aux applications, reportez-vous au guide d'installation.

Remarques sur la maintenance des donnes


Les priodes supprimes sont retires de toutes les catgories au sein de tous les emplacements.
Le systme doit tre verrouill avant la suppression. Aprs la suppression, la base de donnes
doit tre compresse. L'administrateur de la base de donnes se charge de compresser la base.

Configuration des catgories


La table Catgories contient les dfinitions de catgories de donnes (conteneurs au sein desquels
les donnes peuvent tre charges).

Les valeurs de la table identifient les catgories pouvant tre slectionnes depuis le lien PDV de
catgorie. Chaque catgorie FDM est associe une catgorie systme cible. Modifier la catgorie
FDM permet de changer l'emplacement de chargement des donnes dans le systme cible.
Cl de catgorie : Cls de catgorie stockes lors du processus de chargement de la balance
comptable et gnres par FDM (chaque valeur identifie un ensemble d'enregistrements de
la balance).
Catgorie : Nom de la catgorie FDM.
Description : Description de la catgorie FDM.
Catgorie cible : Catgorie au sein de laquelle les donnes sont charges dans le systme
cible.
Frquence : Frquence de la catgorie.

Pour insrer des catgories dans des tables, procdez comme suit :
1 Dans le client Web, slectionnez Mtadonnes > Tables de contrle.
L'cran Tables de contrle s'affiche.
2 Dans la liste droulante Table de contrle, slectionnez Catgories.

64 Manipulation des tables de contrle


3 Slectionnez Ajouter.
4 Slectionnez la cellule dans laquelle vous souhaitez ajouter des informations ou modifier les informations
existantes.
5 Dans la colonne Catgorie, slectionnez Parcourir.
6 Slectionnez la colonne Catgorie cible et choisissez une catgorie cible.

L'icne s'affiche gauche de la ligne pour indiquer qu'une modification est en attente.
7 Cliquez sur Mettre jour la grille.
L'icne indiquant qu'une modification est en attente est supprime.

Pour supprimer des catgories dans une table, procdez comme suit :
1 Slectionnez une ligne.
2 Cliquez sur Supprimer.

L'icne indiquant qu'une suppression est en attente s'affiche gauche de la ligne.


3 Cliquez sur Mettre jour la grille.
Les lignes supprimes n'apparaissent plus l'cran.

Pour annuler des modifications en attente, procdez comme suit :

1 Cliquez sur ou gauche de la ligne.


2 Slectionnez Annuler les modifications de ligne.

Configuration des tables de contrle de catgorie pour les


adaptateurs de suppression
Pour configurer les tables de contrle des adaptateurs de suppression, procdez comme suit :
1 Slectionnez Mtadonnes > Tables de contrle.
L'cran Tables de contrle s'affiche.
2 Dans la liste droulante Table de contrle, slectionnez Catgories.
3 Dans la liste Adaptateur, slectionnez un adaptateur d'intgration.
Une nouvelle table de contrle Catgories s'affiche. Seule la colonne Priode est renseigne.
4 Configurez la table intgrer l'application cible de suppression. Pour plus d'informations sur la
configuration de catgories, reportez-vous la section Configuration des catgories la page 64.

Remarque :
Si l'adaptateur de suppression que vous souhaitez slectionner ne figure pas dans la liste des
adaptateurs, cela signifie que l'adaptateur n'a pas t import et configur dans l'application

Configuration des catgories 65


FDM. Pour plus d'informations sur l'ajout d'adaptateurs l'application, reportez-vous au guide
d'installation.

Remarques sur la maintenance des donnes


Les priodes supprimes sont retires de toutes les catgories au sein de tous les emplacements.
Le systme doit tre verrouill avant la suppression. Aprs la suppression, la base de donnes
doit tre compresse. L'administrateur de la base de donnes se charge de compresser la base.

Configuration des codes de devise


La table Codes de devise contient la liste des codes de devise. Les codes de devise sont affects
des emplacements et sont affichs dans les rapports. Les codes de devise n'tant utiliss que pour
la notation, ils n'ont aucune incidence sur les calculs.
Code de devise : brve description de la devise
Description : description dtaille de la devise

Pour insrer des devises dans la table Codes de devise, procdez comme suit :
1 Dans le client Web, slectionnez Mtadonnes > Tables de contrle.
L'cran Tables de contrle s'affiche.
2 Dans la liste droulante Table de contrle, slectionnez Devises.
3 Cliquez sur Ajouter.
4 Ajoutez les informations propos de la devise dans la nouvelle ligne.
5 Cliquez sur Mettre jour la grille.

66 Manipulation des tables de contrle


Utilisation des emplacements de
8 chargement des donnes

Dans ce chapitre
A propos des emplacements de chargement des donnes.........................................................................................67
Types d'emplacements FDM.......................................................................................................................................67
Cration d'emplacements FDM...................................................................................................................................68
Changements organisationnels...................................................................................................................................71

Remarque :
Ce chapitre traite uniquement des emplacements de chargement des donnes FDM. Pour plus
d'informations sur les emplacements de validation des contrles, reportez-vous au Chapitre 12,
Contrles financiers .

A propos des emplacements de chargement des donnes


Un emplacement de chargement des donnes est une unit de reporting responsable de l'envoi
de donnes source au systme cible. Gnralement, il existe un emplacement FDM pour chaque
fichier source charg dans le systme cible.
L'administrateur systme autorise l'utilisateur final accder un ou plusieurs emplacements,
et un de ces emplacements est dsign comme emplacement par dfaut. Lorsqu'un utilisateur
se connecte FDM, le PDV est celui de son emplacement par dfaut. L'utilisateur final peut
accder uniquement aux emplacements autoriss par l'administrateur.

Types d'emplacements FDM


FDM comporte deux types d'emplacements : Chargement des donnes et Validation des
contrles.
Chargement des donnes : emplacement auquel les donnes du systme source sont
charges. Un emplacement de chargement des donnes peut galement tre associ aux
contrles financiers. Les emplacements de chargement des donnes doivent tre des enfants,
et non des parents, dans la structure des contrles. Les emplacements de chargement des
donnes sont indiqus par l'icne .
Validation des contrles : emplacement associ exclusivement aux contrles financiers.
Aucune donne n'est charge en provenance de ou vers les emplacements de validation des

A propos des emplacements de chargement des donnes 67


contrles. Les emplacements de validation des contrles sont gnralement parents dans la
structure des contrles. Un emplacement de validation des contrles peut galement tre
l'enfant d'un autre emplacement de validation des contrles. Les emplacements de validation
des contrles sont indiqus par l'icne .

Cration d'emplacements FDM


Lorsqu'une nouvelle application FDM est cre, un exemple d'emplacement de contrles
financiers nomm ControlsReview est cr, ainsi qu'un exemple d'emplacement de chargement
des donnes nomm Sample. L'emplacement de validation des contrles est utilis uniquement
dans le cadre de la fonctionnalit de contrles financiers de FDM. Les emplacements doivent
tre crs dans le client Web.

Pour crer des emplacements de chargement des donnes, procdez comme suit :
1 Dans le client Web, slectionnez Mtadonnes > Emplacements.
L'cran Emplacements s'affiche.
2 Cliquez avec le bouton droit sur l'emplacement Validation des contrles dans l'arborescence et slectionnez
Ajouter un enfant.
3 Dans Type d'emplacement, slectionnez Chargement des donnes.
4 Saisissez le nom de l'emplacement FDM.
5 Cliquez sur OK.
Les noms d'emplacements doivent comporter uniquement des caractres alphanumriques sans
espace. Aprs avoir cr un emplacement, vous ne pouvez pas changer son nom. Il est donc
prudent de mettre en place une convention d'attribution de nom avant de commencer.

Cration de rpertoires d'emplacements


Lors de la cration d'emplacements dans l'cran Emplacement, FDM cre un dossier dans le
rpertoire Inbox pour chaque emplacement de chargement des donnes ajout. Cette fonction
est commande par l'option Paramtres d'application > Crer un dossier d'emplacement.
Lorsque cette option est active, FDM cre un rpertoire pour tous les emplacements
(chargement des donnes et validation des contrles).

68 Utilisation des emplacements de chargement des donnes


Attributs d'emplacement
L'cran Emplacement comporte quatre onglets : Gnral, Comportements du workflow,
Contrles financiers et Options d'intgration.

Onglet Gnral
Description : informations complmentaires concernant l'emplacement, utiles pour
effectuer le suivi des systmes GL utiliss ou autres informations systme sur un
emplacement. Lors de la cration d'un emplacement, la description par dfaut est le nom
de l'emplacement.
Devise : devise charge dans l'emplacement, utilise uniquement des fins d'identification
dans certains rapports FDM et d'autres formulaires d'affichage de donnes. FDM ne prend
pas en charge la conversion des devises. Par consquent, le code de devise n'influence pas
les calculs (facultatif).
Emplacement du parent : un emplacement auquel est affect un parent utilise la mme table
de mappage que le parent. Un parent peut tre partag par plusieurs emplacements (utile
lorsque plusieurs emplacements utilisent un mme plan comptable). Lorsqu'une table de
mappage parent ou enfant est modifie, les modifications sont appliques l'ensemble des
emplacements parent et enfant (facultatif).
Type de chargement : chaque emplacement de chargement des donnes utilise un type de
chargement (Insertion SQL ou Insertion de bloc). Insertion SQL est le mode de chargement
par dfaut et doit tre utilis pour les emplacements qui chargent des fichiers de petite taille
(6 000 enregistrements maximum). Le type de chargement Insertion de bloc est plus efficace
pour charger les fichiers plus volumineux.
Mappage de squence : par dfaut, les mappages avec caractres gnriques FDM (Comme,
Dans, Entre) sont classs dans le formulaire Mappages dans l'ordre alphabtique par nom
de rgle. L'option Mappage de squence permet de trier et de traiter les mappages selon une
valeur numrique et non selon la valeur par dfaut. Utilisez cette option pour les
emplacements aux rgles de conversion compliques ncessaires dans l'ordre de traitement
(par exemple, lorsqu'un compte source est inclus dans plusieurs mappages avec caractres
gnriques, l'ordre de tri du mappage est important pour dterminer en fonction de quel
mappage le compte doit tre trait). Utilisez cette option uniquement pour les emplacements
qui utilisent des rgles de conversion complexes. Cochez la case Mappage de squence pour
afficher un nouveau champ de squencement dans le formulaire Mappages. Entrez un
nombre dans ce champ pour affecter un ordre de tri numrique chaque mappage
(facultatif).
Balise groupe : entrez une valeur dans ce champ pour grouper plusieurs emplacements.
Dans certains rapports de moniteur de processus, les emplacements groups sont affichs
selon leur ordre de groupement et non par ordre alphabtique (facultatif).
Valeur de donnes : dimension supplmentaire utilise uniquement lors de l'intgration
dans des systmes cible multidimensionnels. La dimension est associe un emplacement
FDM. Lorsque FDM cre le fichier de chargement, la valeur de dimension est entre pour
chaque ligne de donnes charge par l'emplacement concern. Par exemple, la dimension
Valeur de donnes est associe la dimension Valeur dans Financial Management. Par

Cration d'emplacements FDM 69


dfaut, si ce champ n'est pas renseign, la Valeur de donnes <devise de l'entit> est dfinie
par dfaut lors de l'intgration dans Financial Management.
Adaptateur cible (Adaptateur par emplacement) : lorsque la valeur [Aucun] est dfinie,
l'emplacement utilise l'adaptateur global dfini au cours du processus de configuration de
l'adaptateur. Toute slection remplace l'adaptateur global pour l'emplacement. Ce
paramtre permet FDM de s'intgrer plusieurs applications cible. Chaque emplacement
peut charger des donnes dans une application cible unique.

Remarque :
Dans les crans FDM qui permettent de parcourir les catgories cible, FDM navigue en utilisant
l'adaptateur slectionn pour l'emplacement en cours. Sauf si les systmes cible contiennent des
membres communs de catgorie et de priode, les tables de contrle (Catgories et Priodes) ne
sont pas partitionnes par adaptateur et ncessitent des entres distinctes pour chaque
adaptateur.

Onglet Comportements du workflow


Format d'importation : chaque emplacement de chargement de donnes doit tre associ
un format d'importation en vue du chargement de fichiers source. Le format d'importation
dfinit la structure du fichier source. Lors de la cration d'un emplacement, il n'est pas
ncessaire d'associer un format d'importation. Vous pouvez configurer l'ensemble des
emplacements de reporting sans connatre toutes les structures de fichiers source
(obligatoire).
Groupe logique : les groupes logiques contiennent un ou plusieurs comptes logiques gnrs
aprs le chargement du fichier source. Les comptes logiques sont des comptes calculs drivs
des donnes source (facultatif).
Rgles de validation : un groupe de rgles de validation contient un ensemble de rgles de
validation figurant dans le rapport de validation. Ces rgles de validation sont utilises par
FDM pour extraire des donnes de systme source de l'application cible aprs un chargement
de donnes (facultatif).
Entits de validation : un groupe d'entits de validation contient un ensemble d'entits de
validation de systme cible pouvant tre consolides et affiches dans le rapport de validation
(facultatif).

Onglet Contrles financiers


Pour plus d'informations sur les emplacements de validation des contrles, reportez-vous au
Chapitre 12, Contrles financiers .

Onglet Options d'intgration


Cet cran contient les options d'adaptateur personnalises pour chaque emplacement.

70 Utilisation des emplacements de chargement des donnes


Changements organisationnels
Vous pouvez ajouter, supprimer et dplacer des emplacements. Pour enregistrer la structure
d'organisation au moment de l'envoi, FDM consigne la structure d'organisation de chaque
priode dans la table tDataSubmitHierarchy.

Changements organisationnels 71
72 Utilisation des emplacements de chargement des donnes
Comptes logiques
9
Dans ce chapitre
Comptes logiques......................................................................................................................................................73
Cration de groupes logiques.....................................................................................................................................73

Comptes logiques
Les comptes logiques sont des comptes gnrs de manire dynamique et qui permettent de
calculer des valeurs supplmentaires non fournies dans le fichier source. Les comptes logiques
peuvent tre mapps et chargs dans le systme cible comme tout autre compte source. Les
comptes logiques fournissent diverses fonctions :
Chargement statistique : mappage d'un compte source unique avec plusieurs comptes cible.
Mappage conditionnel : mappage d'un compte source selon sa valeur.
Mappage arithmtique : oprations arithmtiques sur les valeurs source.
Les comptes logiques sont crs dans FDM, ce qui exclut des analyses rtrospectives dtailles
des valeurs de compte logique. Pour accder l'cran Comptes logiques, slectionnez
Mtadonnes > Groupes logiques.

Cration de groupes logiques


La premire tape de la cration d'un compte logique consiste crer un groupe logique.
Plusieurs comptes logiques peuvent tre associs chaque groupe logique. Le groupe logique
est ensuite associ un ou plusieurs emplacements. Lorsqu'un emplacement a t associ un
groupe logique, les comptes logiques correspondants sont gnrs lors du chargement d'un
fichier source l'emplacement concern.

Type de logique
Les groupes logiques doivent tre dfinis comme simples ou complexes. Les groupes logiques
simples permettent aux lments logiques d'tre uniquement drivs de la dimension de compte
source. Les groupes logiques complexes permettent aux lments logiques d'tre drivs de
n'importe quelle combinaison de dimensions.

Comptes logiques 73
Comptes logiques simples
Lorsqu'un groupe logique simple a t dfini, vous pouvez spcifier des comptes logiques
individuels pour le groupe concern. Les diffrents lments logiques sont les suivants :

Elment
Entrez le nom de l'lment logique dans le champ Elment. Le champ Elment se trouve dans
la zone Compte de l'cran Importer. Il est conseill de faire prcder le nom de l'lment logique
de la lettre L afin de distinguer les comptes logiques des comptes source standard. Si le compte
logique est charg dans le systme cible, il doit tre mapp avec un compte cible.

Description
Entrez la description de l'lment logique. La description apparat dans le champ Description
du compte du formulaire Importer.

Type/Critres
L'oprateur du champ Type fonctionne en parallle avec le compte source dfini dans le champ
Critres, afin de dterminer les comptes source desquels les lments logiques sont drivs. Un
seul lment logique peut tre driv de plusieurs comptes source. Les tableaux ci-aprs
prsentent des exemples de valeurs d'oprateurs et de critres.
Oprateur Entre : Utilisez l'oprateur Entre pour dfinir une plage de comptes source dans le
champ Critres. Sparez les comptes par une virgule.

Champ Type Champ critres

Entre 1000,1999

74 Comptes logiques
Oprateur Comme : Utilisez l'oprateur Comme si les comptes source du champ Critres
contiennent des caractres gnriques. Utilisez des points d'interrogation (?) pour les espaces
rservs, et utilisez un astrisque (*) pour indiquer un nombre indtermin de caractres de
compte.

Champ Type Champ critres

Comme 1??0

Comme 10*

Oprateur Dans : Utilisez l'oprateur Dans pour inclure un compte source unique ou une liste
de comptes source non squentielle.

Champ Type Champ critres

Dans 1000

Dans 1000,1005,2001

Groupement par centre


Par dfaut, un compte logique distinct est cr pour chaque centre source issu de la balance
comptable.

Champ critres Rsultat

12300 Un compte logique est cr pour chaque centre source associ au compte 12300.

Vous pouvez crer un compte logique unique qui synthtise plusieurs centres source en plaant
un point virgule aprs le compte dans le champ Critres, et en entrant une valeur correspondant
au nombre de caractres du centre par rapport auquel vous souhaitez effectuer le groupement.

Champ critres Rsultat

12300;4 Un compte logique synthtique est cr pour le compte 1230. Ce compte logique synthtique
inclut l'ensemble des centres source dont le nom commence par les quatre mmes caractres. Le
centre associ ce compte logique correspond ces quatre caractres.

12300;3,4 Un compte logique synthtique est cr pour le compte 12300. Ce compte inclut l'ensemble des
centres source dont le nom commence par les mmes trois caractres, partir de la position 4.
Le centre associ ce compte logique correspond ces trois caractres, partir de la position 4.

Vous pouvez crer un compte logique qui synthtise l'ensemble des centres source en plaant
un point virgule aprs le compte dans le champ Critres, et en entrant une valeur textuelle. Cette
valeur textuelle code en dur devient le nouveau centre du compte logique synthtique.

Cration de groupes logiques 75


Champ critres Rsultat

12300;Dept100 Un compte logique synthtique est cr pour le compte 12300, incluant l'ensemble des centres
source. Le centre associ ce compte logique est Dept100 .

Champ Squence
Ce champ indique l'ordre dans lequel les comptes logiques seront traits. Cela permet un
compte logique d'tre utilis par un autre compte logique, condition que le compte dpendant
ait t trait en premier.

Champ Exporter
Bascule Oui/Non qui permet de dterminer si le compte logique doit ou non tre considr
comme un compte d'exportation et soumis au processus de validation de la table de conversion.
Lorsque Oui est slectionn, le compte logique doit tre mapp dans la table de conversion de
compte.

Champs Oprateur et Valeur/Exp

Dfinition des champs Oprateur et Valeur/Exp


Pour effectuer des calculs et driver des valeurs pour le compte logique, slectionnez un
oprateur dans le champ Oprateur utiliser avec la valeur du champ Valeur/Expression.

Oprateurs numriques
Utilisez un oprateur numrique pour effectuer des calculs mathmatiques simples.
+ Addition
- Soustraction
* Multiplication
/ Division
S.O. (sans oprateur)
Lorsqu'un oprateur numrique est dfini dans le champ Oprateur, une valeur numrique doit
tre entre dans le champ Valeur/Exp, sauf si l'oprateur est S.O. . Dans ce cas, les comptes
source spcifis dans le champ Valeur de critre sont ajouts.
Oprateur (Fun) : Permet d'excuter une fonction logique personnalise dfinie dans le champ
Valeur/Exp. Pour crire une fonction, cliquez deux fois dans le champ Valeur/Exp pour ouvrir
l'diteur de fonction logique. Les fonctions logiques sont normalement utilises pour le mappage
conditionnel et d'autres oprations complexes impliquant plusieurs comptes source. Les
fonctions logiques permettent d'utiliser des instructions variables et conditionnelles pour

76 Comptes logiques
permettre le mappage conditionnel. La fonction de recherche FDM peut galement tre utilise
dans une fonction logique.
Les paramtres de fonction suivants peuvent tre utiliss :
CurVal : valeur de l'opration de compte logique
StrLocation : nom de l'emplacement actif
strCenter : centre de compte logique
strCatKey : cl de catgorie FDM active (pas le nom)
strPerKey : priode FDM active

Affectation de valeurs de renvoi de fonction


Le rsultat d'une fonction logique doit tre associ au mot cl RESULT.
RESULT = CURVAL + (|810| * .5)

Si aucune valeur n'est associe au mot cl de rsultat, le moteur logique dfinit automatiquement
une valeur de rsultat nulle. Le calcul est ignor et le compte logique n'est pas cr.
La fonction ci-aprs associe le rsultat du calcul de compte logique ( l'aide du paramtre
CURVAL) au compte logique (RESULT) si le calcul de compte logique renvoie une valeur
suprieure zro.

If CURVAL > 0 Then


RESULT = CURVAL
Else
Result=Skip
End If

Il s'agit d'un exemple de mappage conditionnel. Si le nombre de comptes source spcifi dans
la colonne de critres est infrieur zro, le compte logique n'est pas cr en raison de la prsence
du mot cl Skip . Ce compte logique doit tre mapp avec un compte cible.
Un autre compte logique est ensuite cr afin de stocker le rsultat du calcul de compte logique
(si le rsultat est infrieur zro). Ce compte logique est ensuite mapp avec un compte cible
diffrent.

If CURVAL < 0 Then


RESULT = CURVAL
Else
Result=Skip
End If

La fonction ci-aprs associe uniquement le rsultat du calcul de compte logique au compte


logique si la cl de catgorie FDM active est 10 .

If strCatKey = 10 then
RESULT = CURVAL
Else
Result=Skip
End If

Cration de groupes logiques 77


Cette fonction associe le rsultat du calcul de compte logique au compte logique uniquement si
le centre de compte de critres est 000 .

If strCenter = 000 then


RESULT = CURVAL * 100
Else
Result=Skip
End If

Cette fonction utilise la fonction de recherche FDM pour ajouter un compte source la valeur
du compte logique si la priode FDM en cours est Dec 2003 .

If strPerKey = 12/31/2003 then


RESULT = CURVAL + |810|
Else
Result=Skip
End If

Cette fonction utilise la fonction de recherche FDM pour ajouter un compte source issu d'un
centre source, d'une catgorie FDM et d'une priode FDM diffrents la valeur du compte
logique si l'emplacement actif est Texas .

If strLocation = Texas then =


RESULT = CURVAL + |000,10,09/30/01,810|
Else
Result=Skip
End If

Oprateur (Exp) : Permet d'excuter une expression logique personnalise dfinie dans le champ
Valeur/Exp. Les expressions logiques sont plus simples que les fonctions logiques, mais elles ne
peuvent pas utiliser de variables ou d'instructions conditionnelles (If). Les expressions n'ont
pas de paramtres intgrs, sauf |CURVAL|, qui doit tre place entre barres verticales. Il n'est
pas ncessaire d'associer la valeur d'une expression la constante RESULT =, comme c'est le cas
dans les fonctions logiques. Les expressions s'excutent plus rapidement que les fonctions
logiques. La fonction de recherche FDM peut tre utilise dans une expression de la mme
manire que dans une fonction logique. Pour crire une expression personnalise, cliquez deux
fois dans le champ Valeur/Exp pour ouvrir l'diteur de fonction logique.
Voici des exemples d'expressions logiques personnalises :
|CURVAL| + |810| + |238|
Cette fonction fait appel la fonction de recherche FDM pour ajouter deux comptes source la
valeur du compte logique. Notez que le paramtre CURVAL peut tre utilis dans les expressions
comme dans les fonctions logiques, sauf qu'il doit tre plac entre barres verticales.
(|CURVAL| + |000,10,09/30/01,810|) * 100

Cette fonction utilise la fonction de recherche FDM pour ajouter un compte source issu d'un
centre, d'une catgorie FDM et d'une priode FDM diffrents la valeur du compte logique, et
multiplie le rsultat par 100.
Fonction de recherche FDM : Utilisez cette fonction pour renvoyer la valeur d'un compte source
rsidant dans FDM. Cette fonction peut tre utilise dans une fonction ou une expression
logique.

78 Comptes logiques
Pour renvoyer une valeur d'un compte source pour le centre source, la catgorie FDM et la
priode FDM du compte logique actif, respectez le format suivant :

Syntax: |GLAcct|
Example: |810|

Pour renvoyer la valeur d'un compte GL pour un centre GL, une cl de catgorie FDM et une
priode FDM diffrents, respectez le format suivant :

Syntax: |GLDept , CategoryKey , PeriodKey , GLAcct|


Example: |000, 10, 12/31/01, 810|

Vous pouvez galement associer plusieurs formats. L'exemple ci-aprs utilise le centre source et
la priode FDM par dfaut, mais dfinit une cl de catgorie FDM spcifique.
|, 10 , , 810|

Cration de comptes logiques complexes


Les lments logiques individuels sont dfinis dans un groupe logique complexe. Les champs de
logique complexe fonctionnent de la mme manire que les champs de logique simple, sauf les
champs Valeur de critre et Inclure les valeurs calcules.

Valeur du critre
Pour entrer un critre pour chaque dimension, cliquez dans le champ Valeur de critre pour
ouvrir un nouveau formulaire. L'lment logique est cr uniquement partir des lments de
ligne source qui correspondent aux critres dfinis pour chaque dimension. Les champs de
critres de logique complexe sont les suivants :

Cration de groupes logiques 79


Dimension
Ce champ permet de slectionner une dimension source active. Chaque dimension ne peut tre
slectionne qu'une fois.

Type de critre
Ce champ fonctionne en parallle avec les champs Source Dimension et Valeur de critre pour
dterminer les valeurs source desquelles les lments logiques sont drivs. Les types de critres
disponibles sont Dans, Entre et Comme. Le type de critre dtermine la manire dont la valeur
de critre est interprte.

Valeur de critre
Ce champ contient la valeur utilise par le type de critre pour dterminer les membres inclure
dans le calcul logique pour une dimension logique donne.

Grouper par
Lorsque l'lment logique driv est affich dans l'cran Importer, le champ Grouper par permet
l'lment logique de supprimer le membre affich dans le champ de dimensions appropri. La
suppression du membre permet de grouper la dimension par rapport la valeur entre dans le
champ Grouper par. Ce champ permet de coder en dur le membre renvoy, ou d'ajouter des
valeurs codes en dur aux membres d'origine en entrant un membre cod en dur et un
astrisque (*) dans le champ Grouper par.
Par exemple, lorsque le mot Cash est indiqu sur la ligne o la dimension Compte est
slectionne, le formulaire Importer affiche Cash dans le champ Compte pour l'lment
logique concern. Lorsque L-* est indiqu dans le champ Grouper par, le formulaire Importer
affiche L-1100 , o 1100 est le compte d'origine qui correspond au critre logique.
Si aucune valeur n'est indique dans le champ Grouper par, aucun groupement n'est excut
pour la dimension, et un lment logique distinct est cr pour chaque membre de dimension.

80 Comptes logiques
Niveau groupe
Lorsque l'lment logique est affich dans l'cran Importer, le champ Niveau groupe fonctionne
avec le champ Grouper par pour supprimer le membre affich dans le champ de dimensions
appropri. Ce champ accepte exclusivement les valeurs numriques.
Le fait d'entrer la valeur 3 dans le champ Niveau groupe renvoie les trois premiers caractres
du champ Grouper par. Si aucune valeur n'est entre dans le champ Grouper par, le fait d'entrer
la valeur 3 dans le champ Niveau groupe renvoie les trois premiers caractres du membre de
dimension source d'origine.
Les lments logiques affichs dans le formulaire Importer peuvent tre groups au niveau
souhait l'aide des champs Grouper par et Niveau groupe. Par exemple, lorsque L-* est
indiqu dans le champ Grouper par, l'lment logique s'affiche dans le formulaire Importer sous
la forme L-1100, , o 1100 est le compte d'origine qui correspond au critre logique. Si la
valeur de Niveau groupe 2 est entre sur la mme ligne, le formulaire Importer affiche L-11 .
Si la valeur de Niveau groupe 1 est entre sur cette ligne, le formulaire Importer affiche L-1 .

Champ Inclure les valeurs calcules


S'il est conforme au critre d'lment logique, le champ Inclure les valeurs calcules permet
l'lment logique de prendre en compte dans ses calculs des valeurs FDM prcdemment
calcules.

Remarque :
Chaque lment logique est associ une squence, et les lments logiques sont calculs selon
cette squence. Si ce champ est activ pour le second lment logique (ou pour les suivants), les
lments logiques prcdemment calculs sont pris en compte ( condition qu'ils soient
conformes au critre logique).

Logique complexe : exemple 1

La premire ligne indique que tous les comptes qui commencent par 11 seront inclus dans
le rsultat du calcul pour Calc Item: CashTx . La seconde ligne prcise davantage les rsultats
en indiquant que pour l'enregistrement source, l'entit doit tre gale TX . La troisime ligne
restreint les rsultats aux enregistrements source dont la valeur ICP se situe entre 00 et 09. La
dernire ligne restreint les rsultats aux enregistrements source dont la valeur de dimension

Cration de groupes logiques 81


libre 1 (UD1) est 00, 01 ou 02. Les lignes source importes non conformes aux critres sont
exclues des rsultats du calcul.
Comme le montre le tableau ci-aprs, un seul lment logique est driv de plusieurs
enregistrements source. En utilisant l'exemple graphique prcdent comme critre logique, et
la premire grille ci-aprs comme lments de ligne source, vous pouvez constater la manire
dont FDM drive la valeur d'un lment logique individuel. Observez le champ Grouper par.
Chaque champ Grouper par contient une valeur code en dur. Par consquent, pour chaque
ligne conforme aux critres dfinis, le membre import d'origine est remplac par le membre
indiqu dans le champ Grouper par.

Exemples de valeurs importes

Compte Entit ICP UD1 Montant Inclure/Exclure

1150 TX 07 01 50 401,07 Inclure

1176 TX 04 02 10 996,00 Inclure

1201 TX 01 00 500,00 Exclure

Membres logiques crs

Compte Entit ICP UD1 Montant

Cash Texas ICP UD1 50 401,07

Cash Texas ICP UD1 10 996,00

FDM regroupe et synthtise les lignes sur lesquelles tous les membres sont identiques, et cre le
rsultat final suivant :

Rsultat final des membres logiques

Compte Entit ICP UD1 Montant

Cash Texas ICP UD1 61 397,07

82 Comptes logiques
Logique complexe : exemple 2

La premire ligne de l'exemple prcdent indique que tous les comptes qui commencent par
11 doivent tre inclus dans le rsultat du calcul pour Calc Item: CashTx . La seconde ligne
prcise davantage les rsultats en indiquant que pour l'enregistrement source, l'entit doit tre
gale TX . La troisime ligne restreint les rsultats aux enregistrements source dont la valeur
ICP se situe entre 000 et 100. La dernire ligne restreint les rsultats aux enregistrements source
dont la valeur de dimension libre 1 (UD1) est 00 , 01. ou 02. . Les lignes importes non
conformes aux critres sont exclues des rsultats du calcul.
Comme le montrent les tableaux suivants, deux lments logiques sont drivs des
enregistrements source grce aux valeurs entres dans les champs Grouper par et Niveau groupe.
Deux des champs Grouper par contiennent des valeurs codes en dur, et deux d'entre eux
contiennent un astrisque. Par consquent, pour chaque ligne conforme aux critres dfinis, les
membres imports d'origine pour les dimensions Compte et Entit sont remplacs par le
membre indiqu dans le champ Grouper par. Les autres dimensions renvoient l'ensemble ou
une partie des membres d'origine selon la valeur du champ Niveau groupe.

Exemples de valeurs importes

Compte Entit ICP UD1 Montant Inclure/Exclure

1150 TX 070 01 50 401,07 Inclure

1176 TX 040 02 10 996,00 Inclure

1121 TX 045 02 9 050,41 Inclure

1201 TX 100 00 500,00 Exclure

Membres logiques crs

Compte Entit ICP UD1 Montant

Cash Texas 07 UD1-01 50 401,07

Cash Texas 04 UD1-02 10 996,00

Cash Texas 04 UD1-02 9 050,41

FDM regroupe et synthtise les lignes sur lesquelles tous les membres sont identiques, et cre le
rsultat suivant :

Cration de groupes logiques 83


Rsultat final des membres logiques

Compte Entit ICP UD1 Montant

Cash Texas 07 UD1-01 50 401,07

Cash Texas 04 UD1-02 20 046,41

84 Comptes logiques
Formats d'importation
10
Dans ce chapitre
Prsentation...............................................................................................................................................................85
Cration de groupes d'importation.............................................................................................................................85
Dfinition des champs pour les groupes d'importation...............................................................................................86
Affectation de formats d'importation..........................................................................................................................87
Fonctions d'importation avances..............................................................................................................................88
Cration de scripts d'importation................................................................................................................................94
Cration de scripts d'intgration.................................................................................................................................94

Prsentation
Chaque emplacement de chargement de donnes doit tre associ un groupe d'importation
en vue de l'importation de fichiers de donnes. Les groupes d'importation fournissent FDM
le mode d'interprtation des fichiers de donnes, ainsi que le mode de transformation de ces
derniers en donnes pouvant tre charges dans la structure de donnes FDM.
L'cran Formats d'importation prsente une structure hirarchique. La grille suprieure affiche
les groupes d'importation, et la grille infrieure permet de dfinir les champs pour les groupes.
Aprs avoir cr le format d'importation, il est important de ne pas modifier la mise en page du
fichier source. Si le format du fichier source subit des modifications, vous devez mettre jour
le format d'importation.

Cration de groupes d'importation


Pour crer des groupes d'importation, procdez comme suit :
1 Slectionnez Mtadonnes > Formats d'importation.
L'cran Formats d'importation s'affiche.
2 Cliquez sur Ajouter.
Une ligne est ajoute dans le tableau suprieur de l'cran Formats d'importation.
3 Indiquez le nom et la description du groupe d'importation.
4 Dans le champ Type de fichier, slectionnez Fixe ou Dlimit.

Prsentation 85
5 Si le type de fichier est dlimit, slectionnez dans la colonne Sparateur le type de sparateur utilis dans
le fichier.
6 Cliquez sur Mettre jour la grille.

Remarque :
En slectionnant Script ou Adaptateur dans la colonne Type de fichier, vous pouvez galement
crer un script d'intgration ou utiliser un adaptateur de systme cible pour importer les donnes
de grand livre directement partir d'une source de donnes compatible ODBC au lieu d'importer
un fichier texte.

Dfinition des champs pour les groupes d'importation


Chaque ligne de la grille infrieure de l'cran Formats d'importation correspond un champ
d'importation. Vous pouvez associer plusieurs champs source un mme nom de champ FDM.
FDM concatne automatiquement les valeurs chane lors du processus de chargement de fichiers.
Pour ignorer des enregistrements contenant certaines valeurs, slectionnez Ignorer et entrez
une valeur textuelle dans le champ Expression.

Dfinition des champs pour les groupes d'importation fixes


Nom du champ : champ dans lequel importer.
Dbut : emplacement de dbut du champ importer.
Longueur : longueur du champ.
Expression : indiquez une expression. Cette valeur remplace la valeur existante, sauf si
l'option Ignorer est dfinie pour le champ.

Dfinition des champs pour un groupe d'importation dlimit


Nom du champ : nom du champ dans lequel importer.
Numro du champ : numro du champ importer.
Nombre de champs : nombre total de champs par ligne dans le fichier texte.
Expression : cette valeur remplace la valeur existante, sauf si l'option Ignorer est dfinie pour
le champ.

Dfinition du champ Glisser-dposer


Au lieu de calculer le dbut et la longueur des champs, vous pouvez crer une dfinition de
champ l'aide de la fonction Glisser-dposer du Gnrateur de formats d'importation.

86 Formats d'importation
Pour utiliser la fonction Glisser-dposer pour crer un format d'importation, procdez comme
suit :
1 Dans la grille Format d'importation, slectionnez le champ modifier.
2 Cliquez sur le bouton Crer situ au-dessus du tableau infrieur.
L'cran Gnrateur de formats d'importation s'affiche.
3 Dans l'cran Gnrateur de formats d'importation, cliquez sur Slectionner un fichier.
4 Localisez et slectionnez le fichier importer.
5 Cliquez sur OK.
Aprs l'importation, le contenu du fichier s'affiche dans la fentre Gnrateur de formats
d'importation.

6 Dans l'cran Gnrateur de formats d'importation, mettez en surbrillance le texte importer pour le champ.
7 Cliquez dans le champ en surbrillance et faites-le glisser dans la zone Faites glisser et dposez le texte
ici.
Les champs Numro du champ et Nombre de champs sont renseigns automatiquement.
8 Rptez les tapes 5 et 6 pour chaque nom de champ.
Un nom de champ peut tre utilis plusieurs fois. FDM concatne automatiquement les noms
de champs multiples lors du processus de chargement.

Affectation de formats d'importation


Les formats d'importation sont utiliss seulement lorsqu'ils ont t associs un emplacement.

Affectation de formats d'importation 87


Pour attribuer des formats d'importation des emplacements, procdez comme suit :
1 Slectionnez Mtadonnes > Emplacements.
L'cran Emplacements s'affiche.
2 Cliquez sur l'onglet Comportements du workflow.
3 Dans Format d'importation, slectionnez le format d'importation utiliser pour l'emplacement slectionn.
Ce format est utilis chaque fois qu'une balance comptable est importe pour l'emplacement.
Un seul format d'importation peut tre utilis pour plusieurs emplacements. Si votre entreprise
dispose d'un format de fichier de balance comptable standard, tous les emplacements peuvent
partager le mme format d'importation.

Fonctions d'importation avances

Ajout d'expressions et de scripts d'importation


FDM dispose d'un ensemble d'expressions d'importation puissantes qui permet de lire et
d'analyser la quasi-totalit des fichiers de balance comptable dans la base de donnes FDM. Les
expressions avances sont entres dans la colonne Expression de la grille Champs. Les expressions
et scripts d'importation agissent sur la valeur lue dans le fichier d'importation.
Dans les exemples de formats d'importation prcdents, des expressions taient utilises pour
coder en dur la valeur Centre. Une expression d'importation avance (sign=,cr) est utilise
pour le champ de montant S.O. afin de distinguer les soldes crditeurs.

Pour ajouter des expressions ou des scripts d'importation, procdez comme suit :
1 Dans le formulaire Importer, cliquez deux fois dans la colonne Expression.
2 Slectionnez Ajouter une expression.
La bote de dialogue Ajouter une expression s'affiche.
3 Dans Type d'expression, slectionnez le type d'expression utiliser.
Le nombre d'options et leur type indiqus dans le champ dpendent du champ modifi dans le
formulaire Importer (Compte, Description du compte, Montant, etc.).
4 Entrez la valeur accompagnant l'expression.
5 Cliquez sur OK.
La nouvelle expression figure dans le champ Expression du formulaire Importer.

Sign
Utilisez cette expression pour traiter les conventions de signes numriques non standard. FDM
interprte les signes moins de dbut ou de fin et les parenthses en tant que nombres ngatifs.
Cependant, certains fichiers utilisent d'autres caractres pour indiquer un montant ngatif. Pour

88 Formats d'importation
dfinir un signe personnalis, l'expression doit respecter le format suivant : Sign =
[Positive String],[Negative String].

Exemple
Les nombres positifs sont suivis de DR (1,000.00DR), et les nombres ngatifs sont suivis de
CR (1,000.00CR).
Expression : Sign=DR,CR.
Les nombres positifs n'ont pas de signe (1,000.00), et les nombres ngatifs sont suivis de
CR (1,000.00CR).
Expression : Sign=,CR.

DRCRSplit = (colonnes Dbit et Crdit fractionnes)


DRCRSplit permet d'analyser les colonnes numriques fractionnes. Par dfaut, FDM considre
que toute valeur numrique trouve dans la position dfinie pour le champ Montant est un
dbit. Cependant, dans de nombreux fichiers, les valeurs de dbit sont positionnes gauche du
champ et les valeurs de crdit droite.
Run Date: 03/10/2004 FDM Training Page: 1

G/L Date: 03/10/2004TRIAL BALANCE FOR PERIOD ENDING 01/31/04 Time: 03:38
PM

NUMERO DE COMPTE DESCRIPTION DEBIT CREDIT

1000-000-00 Compte de caisse 68 603,91

1010-000-00 Cash-FANB-AP 177 216,16

1100-000-00 Comptes dbiteurs 3 165 909,94

1200-000-00 Moins-value pour crance douteuse 487 652,89

1210-000-00 Moins-value pour ajustement contractuel 266 683,46

1211-000-00 Moins-value pour escomptes d'admin. 33 811,30

1212-000-00 Moins-value pour assurance maladie 214 895,97

Fonctions d'importation avances 89


NUMERO DE COMPTE DESCRIPTION DEBIT CREDIT

1250-000-00 Stocks 65 056,55

1265-000-00 Autres charges prpayes 9 184,72

1301-000-00 Autres actifs court terme - Autres RA 152 073,14

1400-000-00 Terrain 2 180 000,32

1420-000-00 Btiments - 40 ans 6 142 095,26

1440-000-00 Matriel - 5 ans 128 789,35

1450-000-00 Matriel - 5 ans 47 487,37

1540-000-00 Amort. cumul - Matriel - 10 ans 200 775,20

1600-000-00 Fonds commercial 1 382 384,29

2000-000-00 Comptes fournisseurs - Systme 315 540,69

2002-000-00 Soldes crditeurs 263 607,00

2301-000-00 WH-Medical Premium 29 832,35

2400-000-00 Salaires courus 328 324,68

L'expression DRCRSplit permet FDM de dterminer le mode d'interprtation du


positionnement et d'affecter le signe appropri. L'expression DRCRSplit respecte le format
suivant : DRCRSplit = [Point central des colonnes DR et CR].
La colonne Montant du fichier source commence la colonne 46 et comprend 31 caractres. Le
point central du champ Montant est 16. Tous les chiffres gauche du point central correspondent
au dbit, et tous les chiffres droite du point central correspondent au crdit. Par consquent,
l'expression au format d'importation pour le champ Montant est DRCRSplit=16.

Aprs l'importation du fichier, les montants de crdit sont indiqus par un signe ngatif et les
montants de dbit restent inchangs.

Fill=EuroToUS
Le mot cl Fill=EuroToUS est utilis avec le champ Montant pour dclencher une conversion
de format de nombre du format (.,) au format (,.).

90 Formats d'importation
FillL = (remplissage gauche)
Utilisez cette expression pour complter un champ avec un caractre particulier (remplissage
gauche). Cette expression value la valeur texte lue dans le fichier. Si la valeur est plus courte
que l'expression FillL, la valeur est complte selon l'expression de remplissage. L'exemple ci-
aprs prsente un fichier de donnes avec des chiffres de diffrentes longueurs :

L'expression FillL est utilise de la manire suivante :

L'exemple ci-aprs prsente le fichier aprs importation l'aide de l'expression FillL.

Fill = (remplissage droite)


Utilisez cette expression pour complter un champ avec un caractre particulier. Cette
expression value la valeur texte lue dans le fichier. Si la valeur est plus courte que l'expression
Fill, la valeur est complte en fonction de l'expression de remplissage. Par exemple, si le numro
de compte de la premire ligne est 103950-, ce numro apparat au format 103950-000 aprs
importation.

Fonctions d'importation avances 91


Factor = (valeur)
Utilisez cette expression pour factoriser le montant lu dans le fichier source par une valeur dfinie
par l'utilisateur. Pour dfinir un facteur personnalis, l'expression doit respecter le format
suivant : Factor = [Value]. L'exemple ci-aprs prsente un fichier de donnes importer
l'aide de l'expression Factor.

CA,10000.005,56701
CA,10000.015,110000
CA,10000.020.1200
CA,12000.005,6272205
CA, 12000.999,1237241
CA,125000.MI,4714954
CA,125000.GER,12632247

L'exemple ci-aprs montre l'expression Factor utilise dans le champ Expression. Tous les
montants imports sont multiplis par 1 000.

La fonction Factor permet galement de multiplier par des dcimales pour diviser les valeurs
source.

NZP (non-suppression des zros)


Utilisez cette expression pour dsactiver la suppression des zros au cours du processus de
chargement des donnes. Par dfaut, FDM ignore les comptes de la balance comptable dont le
solde est nul. Dans certains cas, vous pouvez charger des donnes dans tous les comptes pour
vous assurer que les valeurs devant tre nulles seront remplaces dans le systme de consolidation
cible. Entrez NZP dans la colonne Expression du champ Montant pour dsactiver la non-
suppression des zros.

Excel
Utilisez cette expression pour transmettre une valeur de champ un fichier Excel en vue d'une
analyse complmentaire. FDM utilise cette expression pour automatiser Excel, pour transmettre
la valeur de champ dans la cellule A1 et pour renvoyer la valeur trouve dans la cellule A2. Cela
permet d'utiliser une feuille de calcul Excel en tant qu'outil d'valuation personnalis. La valeur
de la cellule A2 peut contenir des fonctions Excel standard et des fonctions VBA personnalises.
Pour dfinir une expression d'analyse Excel, respectez le format suivant : Excel=
[YourFileName].xls. Configurez le fichier Excel de manire ajouter Excel la description
importe l'aide de la valeur de =A1&Excel pour la valeur de la cellule A2. L'expression Excel
ajoute Excel la description importe.

92 Formats d'importation
Notes
Le fichier Excel doit se trouver dans le rpertoire <application name>\Data\Scripts
\Import\.
Cette expression peut consommer une grande quantit de ressources systme, car Excel doit
tre dmarr et excut au cours du processus de chargement. Dans la plupart des cas,
l'expression Script= doit tre utilise la place de Excel=.
Excel doit tre install sur le serveur d'application.

Script
Utilisez cette expression pour transmettre une valeur de champ dans un fichier de script FDM
en vue d'une analyse complmentaire. FDM utilise cette expression pour charger et interprter
un script d'importation personnalis, qui sera excut sur chaque ligne du fichier d'importation.
Les fichiers de script sont bass sur le langage de script Visual Basic (VB) de Microsoft et
permettent l'utilisateur final d'tendre la fonctionnalit et la flexibilit du processus
d'importation FDM.

L'exemple ci-aprs montre l'utilisation de l'expression Script pour arrondir la valeur du champ
Montant et supprimer les dcimales.

Fonctions d'importation avances 93


Remarque :
Le fichier de script doit se trouver dans le sous-rpertoire <application name>\Data
\Scripts\Import\. Le nom du fichier de script doit tre identique celui de la fonction
contenue dans le fichier. Cette expression pointe sur un fichier de script qui contient une fonction
personnalise excute sur chaque ligne du fichier d'importation. Cette fonction accepte un
argument, la valeur lue pour le champ dans le fichier de balance comptable et renvoie la valeur
de cet argument aprs l'excution de la fonction.

Cration de scripts d'importation


Lorsqu'une expression d'importation prdfinie ne permet pas d'excuter l'action souhaite,
vous pouvez crer un script d'importation. Les scripts d'importation sont entrs dans la colonne
Expression de la ligne laquelle l'expression s'applique.

Pour crer des scripts d'importation, procdez comme suit :


1 Cliquez deux fois dans la colonne Expression de l'lment pour lequel vous souhaitez crer un script.
2 Slectionnez Crer un script.
La bote de dialogue Nouveau script s'affiche.
3 Cliquez sur Nouveau.
4 Dans Type de script, slectionnez Importer (Pompe donnes).
5 Saisissez un nom pour le script.
6 Cliquez sur OK.
L'diteur de script s'affiche.
7 Crez le script d'importation dans l'diteur de script.
8 Cliquez sur Enregistrer.
9 Dans l'cran Groupes d'importation, suivez les instructions de la section Ajout d'expressions et de scripts
d'importation la page 88 pour ajouter le script dans le champ Expression.

Cration de scripts d'intgration


Au lieu d'importer un fichier texte, vous pouvez crer un script d'intgration pour importer les
donnes de grand livre directement partir d'une source de donnes compatible ODBC. Les
scripts d'intgration peuvent tre excuts uniquement en slectionnant Script dans la colonne
Type de fichier de la grille Groupes d'importation (grille suprieure).

Pour crer des scripts d'intgration, procdez comme suit :


1 Cliquez deux fois dans la colonne Expression de l'lment pour lequel vous souhaitez crer un script.
2 Slectionnez Crer un script.
L'diteur de script s'affiche.

94 Formats d'importation
3 Cliquez sur Nouveau.
La bote de dialogue Nouveau script s'affiche.
4 Dans Type de script, slectionnez Importer (Intgration).
5 Entrez un nom de script.
6 Cliquez sur OK.
L'diteur de script s'affiche.
7 Crez le script d'intgration dans l'diteur de script.
8 Cliquez sur Enregistrer.
9 Dans l'cran Groupes d'importation, suivez les instructions de la section Ajout d'expressions et de scripts
d'importation la page 88 pour ajouter le script d'intgration dans le champ Expression.
Voici un exemple de script d'intgration qui utilise une connexion ADO pour se connecter
une base de donnes de serveur SGBDR et qui ajoute les donnes de grand livre la table de
balance comptable de l'emplacement FDM :
Function SQLIntegration(strLoc, lngCatKey, dblPerKey, strWorkTableName)
------------------------------------------------------------------
FDM Integration Import Script:

Created By: wladmin
Date Created: 04/19/2004 2:18:39 PM

Purpose: Pull data directly from SQL DB
------------------------------------------------------------------
Dim objSS ADODB.Connection
Dim strSQL SQL string
Dim rs Recordset
Dim rsAppend tTB table append rs object
Initialize objects
Set cnSS = CreateObject(ADODB.Connection)
Set rs = CreateObject(ADODB.Recordset)
Set rsAppend = DW.DataAccess.farsTable(strWorkTableName)
Connect to SQL Server database
cnss.open Provider=SQLOLEDB.1;Integrated Security=SSPI;Persist Security
Info=False;Initial Catalog=WLDemo;Data Source=DBServerName;
Create query string
strSQL = Select *
strSQL = strSQL & FROM tGL
Get data
rs.Open strSQL, cnSS

Check for data


If rs.bof And rs.eof Then
RES.PlngActionType = 2
RES.PstrActionValue = No Records to load!
Exit Function
End If
Loop through records and append to tTB table in locations DB
If Not rs.bof And Not rs.eof Then
Do While Not rs.eof
rsAppend.AddNew
rsAppend.Fields(PartitionKey) = RES.PlngLocKey

Cration de scripts d'intgration 95


rsAppend.Fields(CatKey) = RES.PlngCatKey
rsAppend.Fields(PeriodKey) = RES.PdtePerKey
rsAppend.Fields(DataView) = YTD
rsAppend.Fields(CalcAcctType) = 9
rsAppend.Fields(Amount) = rs.fields(dblAmt).Value
rsAppend.Fields(Desc1) = rs.fields(txtAcctDes).Value
rsAppend.Fields(Account) = rs.fields(txtAcct).Value
rsAppend.Fields(Entity) = rs.fields(txtCenter).Value
rsAppend.Update
rs.movenext
Loop
End If
Records loaded
RES.PlngActionType = 6
RES.PstrActionValue = SQL Import successful!
Assign Return value
SQLIntegration = True
End Function

Utilisation de groupes d'importation d'adaptateur


Au lieu d'importer dans un fichier texte, vous pouvez utiliser un adaptateur d'intgration pour
importer les donnes de grand livre directement partir d'une source de donnes compatible
ODBC. Configurez un adaptateur d'intgration en slectionnant Adaptateur dans la liste
droulante de la colonne Type de fichier de la grille Groupes d'importation (grille suprieure).
Vous pouvez importer de nouveaux adaptateurs d'intgration source dans l'application FDM
en utilisant la fonction Import XML (Fichier > Importer).

Empilement d'expressions et ordre de traitement


Un champ peut utiliser plusieurs expressions d'importation. Pour empiler des expressions,
sparez les expressions par des points-virgules. Prenez en compte l'ordre de traitement des
expressions.

Syntaxe d'empilement d'expressions


Champ : Compte GL
Expression List: Script=ParseAcct.txt;Fill=0000000

Lorsque des expressions sont empiles, FDM traite les expressions dans l'ordre indiqu. Notez
que l'ordre de traitement est diffrent pour le champ Montant.

Ordre de traitement

Tous les champs, sauf le champ Montant


1. Script

96 Formats d'importation
2. Excel
3. Fill ou FillL

Champ Montant
1. DRCRSplit
2. Fill (avec le mot cl EuroToUS uniquement)
3. Script
4. Excel
5. Sign
6. Factor
7. Scale
8. NZP

Cration de scripts d'intgration 97


98 Formats d'importation
Tables de mappage
11
Dans ce chapitre
Prsentation...............................................................................................................................................................99
Types de mappage.....................................................................................................................................................99
Ordre de traitement des mappages..........................................................................................................................108
Copie de tables de mappage...................................................................................................................................109
Restauration de mappages......................................................................................................................................109
Recalcul des mappages et des comptes logiques....................................................................................................110
Importation de tables de mappage..........................................................................................................................110

Prsentation
Les tables de mappage mettent en correspondance les membres de dimension source avec les
membres de dimension du systme cible.
Pour ouvrir l'cran Mappages, slectionnez Activits > Mappages.
Le formulaire Mappages contient une liste qui permet de slectionner la dimension mapper.
FDM n'affichant dans la liste des dimensions cible que les valeurs de saisie valides, vous ne pouvez
mapper des membres source qu' des valeurs de saisie cible valides.
La table de mappage de la dimension Compte contient un champ supplmentaire qui permet
de contrler la conversion de signes. Ce champ est intitul - et contient une option qui inverse
le signe du solde du compte entrant.

Remarque :
Pour viter les problmes de mappage, n'utilisez pas les caractres suivants dans les comptes
source ou cible : esperluette (&), astrisque (*), point d'interrogation (?), suprieur (>),
infrieur (<) ou apostrophe (').

Types de mappage
Les comptes GL peuvent tre convertis selon un mappage un un ou selon un mappage avec
un caractre gnrique. Le mappage un un est dit mappage explicite . Les mappages Dans,
Entre et Comme sont des conversions avec caractre gnrique. Il existe quatre types de mappage
pour chaque dimension : Explicite, Entre, Dans et Comme. Utilisez la liste Type pour
slectionner le type de mappage.

Prsentation 99
Mappage explicite (un un)
Le mappage explicite est utilis pour les conversions de un un (chaque compte entrant est
associ un compte cible).

Le mappage d'un compte source un compte cible commence par l'identification de la structure
du compte GL entrant. Par consquent, chaque segment de compte doit tre identifi et
document. Il vous appartient de choisir quel niveau le compte sera converti en compte du
systme de consolidation cible.

Exemple de structure de compte


TT = Type de compte = Division
PP = Code de compte principal = Emplacement
SS = Sous-compte = Dpartement

Exemples de compte
001100 Espces - Dcaissements
001101 Espces - Recouvrements
223500 Compte Fournisseurs - Opration
223501 Compte Fournisseurs - Intragroupe
Cet exemple de structure de compte peut tre mapp deux niveaux diffrents : si, dans le systme
cible, la structure est agrge de faon ne pas diffrencier les postes Espces Dcaissements et
Espces Recouvrements, le compte source entrant peut tre coup aprs le segment de compte
principal. En revanche, si, dans le systme cible de consolidation, la structure de compte a un
niveau de dtail quivalent au grand livre entrant, le compte doit tre mapp au niveau de sous-
compte le plus dtaill. Ce cas de figure est illustr par l'exemple de mappage ci-aprs.

100 Tables de mappage


Mappage au niveau principal (TTPP)
GL Primary Account, Consolidation Account
0011, Cash
2235, AP
Sub Account Level Map (TTPPSS)
GL Primary Account / Sub-Account, Consolidation Account
001101, Cash.01
001102, Cash.02
223501, AP.01
223502, AP.02

Mappage avec caractre gnrique


FDM offre une remarquable souplesse de mappage entre enregistrements source et
enregistrements cible grce des rgles de conversion utilisant un caractre gnrique. Ces rgles
permettent de rduire le travail de maintenance de la table de conversion.
Tous les enregistrements entrants convertis sont associs la rgle de conversion qui a servi
tablir les valeurs cible. Ce processus cre un mappage statique pour chaque combinaison
emplacement - catgorie - priode, fournissant en mme temps une analyse rtrospective
statique.
FDM propose encore plus de flexibilit et de puissance en matire de mappage des comptes. Les
comptes de grand livre peuvent tre regroups dans un compte calcul qui, son tour, sera
mapp au compte cible appropri. Trois types de critres de base sont applicables pour crer un
compte calcul avec caractre gnrique.
Le processus de cration de comptes avec caractre gnrique est le mme que pour un mappage
de compte standard. Toutefois, il convient de crer paralllement un nom de rgle de caractre
gnrique et une dfinition correspondante, puis d'associer un compte cible la rgle.

Mappage Entre

Lors de la cration d'un mappage Entre, vrifiez que chaque ct du mappage a la mme
longueur. Par exemple, 2000.000, 2991.999 est un mappage correct, contrairement

Types de mappage 101


2000.000, 2991. Cet aspect est particulirement important si un autre mappage doit
intercepter des lments non mapps. Ainsi, 2000.000, 2991 ne parviendrait pas inclure les
valeurs 2991.000 2991.999.
En outre, les mappages Entre doivent tre de la mme longueur pour garantir que les comptes
utilisent le modle de mappage correct. Par exemple, si les mappages 1530, 1540 et
1530000, 1540000 existent et si le compte 1540 est import, il sera trait par le deuxime
mappage (1530000, 1540000).

Mappage Dans

Les mappages Dans permettent de mettre en correspondance une liste de comptes source non
squentiels avec un compte cible unique. Il est possible de mapper plusieurs comptes un seul
compte au sein d'une rgle unique, ce qui vite la cration de plusieurs rgles comme dans le
mappage explicite. L'exemple prcdent montre que les comptes source 1503, 1510 et 1515 sont
mapps au compte cible 15000010.

Mappage Comme

Pour les mappages Comme, utilisez les caractres gnriques * et ? . L'astrisque quivaut
un espace rserv prvu pour recevoir une variable correspondant n'importe quel nombre

102 Tables de mappage


de caractres. Dans cet exemple, 1190* mappe les comptes 1190, 1190100 et 1190-200 au compte
cible Espces.
Le point d'interrogation correspond un seul caractre. Par exemple, 119? mappe uniquement
les comptes source qui contiennent quatre caractres et uniquement ceux qui commencent par
119.

Utilisation de caractres gnriques pour un mappage automatique


FDM permet la drivation du compte ou de l'entit cible ; il suffit de placer les caractres
gnriques (* et ?) dans les deux dimensions, source et cible, de la table de mappage. Lorsqu'une
table de mappage contient une entre prsentant des caractres gnriques dans les colonnes
source et cible, l'enregistrement fait l'objet d'un mappage automatique.

Exemple de mappage automatique

Nom de la rgle Desc. de la rgle Valeur de la rgle Compte cible

w0011-- Cash Accts 0011?? Cash.??

Exemple d'enregistrements de balance comptable de grand livre

Compte GL Centre Description Montant

001100 0160000 Espces Banque 1000,00

001101 0000000 Espces Org. LB 2000,00

001116 0001000 Fonds de caisse 1000,00

223500 0160000 CF 5000,00

Rsultat de la conversion

Description du compte GL Compte Hyperion

001100 0160000 Cash.00

001101 0000000 Cash.01

001116 0160000 Cash.16

Explication
Le critre pour l'entre de mappage automatique (Comme 0011??) extrait les trois premiers
enregistrements de la balance comptable du grand livre. Du fait que cette entre contient des
caractres gnriques dans le champ du compte cible, FDM doit explorer le compte source afin
de remplacer les caractres gnriques du compte cible par l'quivalent rel du compte source.

Types de mappage 103


Les caractres reprsents par les deux -- dans le compte source ont t utiliss pour remplacer
les deux points d'interrogation (?) figurant dans le compte cible. Ensuite, FDM vrifie que les
nouveaux comptes cible (Cash.00, Cash.01 et Cash.16) sont valides. S'ils le sont, les valeurs
drives sont affectes la balance comptable comme valeurs du compte cible.

Mappage conditionnel
Le mappage conditionnel permet de mapper une valeur de dimension source une expression
de script plutt qu' un membre de dimension incorpor du systme cible.
Le mappage conditionnel n'est possible que pour le mappage bas sur des rgles (Entre, Dans et
Comme). Pour activer le mappage conditionnel, placez la valeur #Script dans la colonne
Membre cible. Le script figurant dans la colonne Script est alors excut.
Le script est crit dans la colonne Script. La logique de mappage conditionnel est crite en
VBScript et offre toutes les fonctionnalits du langage VBScript ainsi que l'accs l'instance en
cours de l'API. En utilisant le mappage conditionnel conjointement l'ordre de traitement des
dimensions, il est possible de baser le mappage sur les rsultats du mappage de dimensions qui
ont t mappes avant les dimensions actuelles en cours de traitement.

Exemple
Si les dimensions Compte et Entit sont traites avant la dimension ICP et si la dimension ICP
utilise une rgle de mappage conditionnel, le tableau varValues contient les valeurs mappes
pour Compte et Entit lors du traitement de la dimension ICP, mais les valeurs mappes de
toutes les autres dimensions sont nulles.
Exemple d'entre de mappage conditionnel pour la dimension ICP :

Explication du script
Le script conditionnel de la dimension ICP vrifie la valeur mappe de la dimension COMPTE
pour dterminer comment mapper ICP.

104 Tables de mappage


Check element 14 of the varValue array to get converted/mapped account
If varValues(14) = InterCoAP Then
Mapped value = InterCoAP map to Michigan
Result = [Michigan]
Else
All others, map to none
Result = [ICP None]
End If

Le tableau suivant dfinit les variables prdfinies disponibles dans une expression de script
conditionnel :

Valeurs
API : rfrence d'objet l'API en cours
strLoc : valeur de chane contenant le nom de l'emplacement en cours de traitement
VarValues : tableau de variantes contenant les valeurs d'enregistrement mappes et des valeurs
pour traiter les dimensions dj mappes

Variable Valeur mappe de l'enregistrement Type de variable

varValues(1) = ID d'emplacement actuel Entier long

varValues(2) = ID de catgorie actuel Entier long

varValues(3) = Cl de priode actuelle Date

varValues(4) = Vue de donnes actuelle Chane, par dfaut = YTD

varValues(5) = Cl de devise associe l'emplacement Chane

varValues(6) = Type de calcul pour l'enregistrement actuel Entier long, 9 = Base, 5 = Export de la logique,
-1 =

Logic (Pas d'exportation)

varValues(7) = Indicateur de changement de signe pour Boolen, 0 = Faux, -1 = Vrai


l'enregistrement actuel

varValues(8) = ID de journal pour l'enregistrement actuel Chane, valeur nulle si ce n'est pas un journal

varValues(9) = Montant pour l'enregistrement actuel Double

varValues(10) = Montant supplmentaire pour l'enregistrement Double, 0 sauf si un script personnalis


actuel fournit une autre valeur

varValues(11) = Description du compte pour l'enregistrement Chane


actuel

varValues(12) = Description du compte supplmentaire pour Chane, valeur nulle sauf si un script
l'enregistrement actuel personnalis fournit une autre valeur

varValues(13) = Compte source Chane

Types de mappage 105


Variable Valeur mappe de l'enregistrement Type de variable

varValues(14) = Compte cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(15) = Entit source Chane

varValues(16) = Entit cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(17) = ICP source Chane

varValues(18) = ICP cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(19) = UD1 source Chane

varValues(20) = UD1 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(21) = UD2 source Chane

varValues(22) = UD2 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(23) = UD3 source Chane

varValues(24) = UD3 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(25) = UD4 source Chane

varValues(26) = UD4 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(27) = UD5 source Chane

varValues(28) = UD5 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(29) = UD6 source Chane

varValues(30) = UD6 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(31) = UD7 source Chane

varValues(32) = UD7 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(33) = UD8 source Chane

varValues(34) = UD8 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(35) = UD9 source Chane

106 Tables de mappage


Variable Valeur mappe de l'enregistrement Type de variable

varValues(36) = UD9 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(37) = UD10 source Chane

varValues(38) = UD10 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(39) = UD11 source Chane

varValues(40) = UD11 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(41) = UD12 source Chane

varValues(42) = UD12 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(43) = UD13 source Chane

varValues(44) = UD13 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(45) = UD14 source Chane

varValues(46) = UD14 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(47) = UD15 source Chane

varValues(48) = UD15 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(49) = UD16 source Chane

varValues(50) = UD16 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(51) = UD17 source Chane

varValues(52) = UD17 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(53) = UD18 source Chane

varValues(54) = UD18 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(55) = UD19 source Chane

varValues(56) = UD19 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(57) = UD20 source Chane

Types de mappage 107


Variable Valeur mappe de l'enregistrement Type de variable

varValues(58) = UD20 cible Chane, valeur nulle si cette dimension n'a


pas encor t traite

varValues(59) = ID de document archive pour cet enregistrement Entier long

Ordre de traitement des mappages


FDM traite les mappages dans un ordre spcifique. Cet ordre est important si la mme valeur
source peut appartenir plusieurs types de mappage (par exemple Explicite et Entre) ou si elle
apparat plusieurs fois dans le mme type de mappage.

Ordre de traitement en prsence de plusieurs types de


mappage
Lorsque la mme valeur source apparat dans plusieurs types de mappage, FDM observe l'ordre
suivant :
1. Explicite
2. Entre
3. Dans
4. Comme
Les mappages explicites ont la priorit sur les autres types. Les mappages Entre prennent le pas
sur les mappages Dans et Comme. Les mappages Dans ont la priorit sur les mappages Comme.

Ordre de traitement dans un mme type de mappage


Lorsque la mme valeur source apparat plusieurs fois dans le mme type de mappage, FDM
procde comme suit.

Mappages Entre
Si un compte source est valide dans plusieurs mappages Entre, il est associ au dernier mappage
Entre dans la table de mappage.

Mappages Dans
Si un compte source est valide dans plusieurs mappages Dans, il est associ au premier mappage
Dans dans la table de mappage.

108 Tables de mappage


Mappages Comme
Si un compte source est valide dans plusieurs mappages Comme, il est associ au premier
mappage Comme dans la table de mappage.
Par dfaut, les mappages FDM avec caractre gnrique (Comme, Dans, Entre) sont tris
alphabtiquement par nom de rgle. Si vous souhaitez que FDM trie et traite les mappages par
valeur numrique et non par nom de rgle dans l'ordre alphabtique, activez le traitement
squentiel des mappages dans le formulaire Emplacements.

Copie de tables de mappage


Pour copier des tables de mappage, procdez comme suit :
1 Attribuez au PDV la valeur de l'emplacement copier.
2 Slectionnez Activits > Mappages.
3 Slectionnez Copier.
Vous tes invit indiquer l'emplacement cible.
4 Slectionnez l'emplacement.
5 Cliquez sur OK.
Une fois l'emplacement cible slectionn, FDM copie uniquement la table de conversion active
vers l'emplacement cible.

Remarque :
Seule la table de conversion de la dimension active est copie.

Restauration de mappages
Chaque fois qu'un fichier est import pour une catgorie ou une priode, FDM sauvegarde une
copie du fichier de mappage avec le fichier d'importation.

Pour restaurer un mappage utilis dans une catgorie ou une priode prcdente, procdez
comme suit :
1 Cliquez sur Restaurer. La bote de dialogue Mappage : restauration s'affiche. Cette bote de dialogue inclut
des mappages pour toutes les priodes et/ou catgories utilises pour l'emplacement actuel.
2 Slectionnez le mappage restaurer dans le PDV en cours.
3 Cliquez sur OK.

Remarque :
Seule la table de conversion de la dimension active est copie.

Copie de tables de mappage 109


Recalcul des mappages et des comptes logiques
FDM doit recalculer le mappage d'un emplacement chaque fois qu'une modification du
mappage a lieu ou qu'un compte logique est modifi. Lors de ce recalcul, tous les comptes
logiques sont traits, puis toutes les donnes source importes sont nouveau mappes vers les
tables de mappage existantes. Lorsque FDM dtecte la ncessit de procder un recalcul, une
icne Calculer de couleur orange apparat en bas gauche de la barre PDV.
Dans ce cas, FDM vous interdit de charger des donnes dans le systme cible tant que vous n'avez
pas valid les donnes comptables en cliquant sur le lien Valider. Vous pouvez aussi cliquer
directement sur l'icne Calculer pour imposer un recalcul. Mais mme dans ce cas, FDM impose
une revalidation. Si l'emplacement recalcul est un emplacement parent, le fait de cliquer sur
l'icne Calculer entrane l'affichage d'un message invitant recalculer galement tous les
emplacements enfant.
Le recalcul n'a lieu que pour la catgorie et la priode actives dfinies dans le PDV. Ainsi, l'analyse
rtrospective du mappage reste intacte pour les priodes antrieures et les autres catgories. Si
un mappage ou un compte logique est modifi et si vous voulez appliquer la modification aux
autres priodes ou catgories, vous devez changer de PDV et effectuer un recalcul manuel en
cliquant sur Activits > Traiter logique/mappages. FDM retraite tous les comptes logiques et
mappe nouveau les donnes source importes en fonction du mappage actuel. Le recalcul n'a
lieu que pour la catgorie et la priode actives dfinies dans le PDV.

Importation de tables de mappage

Tables de conversion LedgerLink


FDM peut lire et importer des tables de conversion Compte et Nom de Hyperion LedgerLink.
Les tables de conversion LedgerLink doivent avoir l'extension (*.tra) ou (*.trn). Si des plages
sont utilises dans les tables de conversion LedgerLink, FDM les interprte comme des caractres
gnriques et gnre l'entre approprie. Les dlimiteurs de champ admis sont la barre verticale
(|), le point-virgule (;), le point d'exclamation (!) et la virgule (,).

Remarque :
Du fait que les extractions LedgerLink ne contiennent pas d'ID d'emplacement ou de dimension,
l'emplacement figurant dans le PDV et la dimension du mappage charger doivent tre dfinis
avant l'importation. FDM importe les fichiers .tra et .trn dans le PDV et la dimension
slectionns.

Pour importer une table de conversion LedgerLink, procdez comme suit :


1 Dans Dimension, slectionnez la dimension dans laquelle charger la table de mappage.
2 Cliquez sur l'onglet Tlcharger le fichier.
3 Vous pouvez slectionner la table de mappage de deux faons :

110 Tables de mappage


Si la table n'est pas dj dans la bote de rception de l'application, recherchez-la en
parcourant les dossiers.
Cliquez sur Slectionner un fichier dans l'onglet Bote de rception si la table s'y trouve.
4 Cliquez sur Importer pour importer le fichier de mappage.
Le mappage import s'affiche dans la table de mappage.
5 Rptez les tapes 1 4 pour charger tous les mappages.

Tables de conversion Hyperion Enterprise


FDM peut lire et importer des tables de conversion Compte et Entit Hyperion Enterprise. Ces
fichiers doivent avoir l'extension *.asc. Les dlimiteurs de champ admis sont la barre verticale
(|), le point-virgule (;), le point d'exclamation (!) et la virgule (,).

Format de table de conversion de compte / Equivalent FDM


Le mot sub signifie que le signe de ce compte doit tre modifi, ce qui est indiqu par une
coche dans la colonne Moins dans la grille de la table de conversion de compte. Les autres valeurs
utilisables pour indiquer un changement de signe sont le signe Moins (-), True et Yes .
Le mot add signifie que le signe de ce compte ne doit pas tre modifi, ce qui est indiqu par
l'absence de coche dans la colonne Moins de la grille de la table de conversion de compte. Les
autres valeurs utilisables pour indiquer que le changement de signe n'est pas ncessaire sont le
signe Plus (+), False et No .

Exemple de table de compte Hyperion Enterprise


54300.018!54300.018.USL!SUB 002!002.INP
54300.033!54300.033.US!ADD 005!005.INP

LedgerLink TRA / Equivalent FDM


0011|CASH.01

Cette ligne est un mappage un un.


0100|-AP.01

Le signe (-) est utilis pour convertir le signe en cas d'exportation dans Hyperion Enterprise.
0011>0099|CASH.01

Le signe (>) spcifie une plage dans LedgerLink et est converti en mappage Entre dans FDM.
0011*|CASH.01

Le signe (*) spcifie une instruction like dans LedgerLink et est converti en mappage Comme
dans FDM.
00110?|CASH.0?

Importation de tables de mappage 111


Ceci est une entre de compte de mappage automatique, convertie en mappage Comme dans
FDM.

LedgerLink TRN / Equivalent FDM


200|DET_INP

Cette ligne est un mappage un un.


220>250|CHI_INP

Le signe (>) spcifie une plage dans LedgerLink et est converti en mappage Entre dans FDM.
30*|MIL_INP

Le signe (*) spcifie une instruction like dans LedgerLink et est converti en mappage Comme
dans FDM.
40?|DET40?

Il s'agit d'une entre de nom de mappage automatique, convertie en mappage Comme dans
FDM.

Importation de descriptions au format LedgerLink


Lors de l'importation d'un fichier de mappage au format LedgerLink (*.tra ou *.trn), vous
pouvez galement importer des descriptions de centre/de compte. La description doit tre place
dans le dernier champ du fichier de mappage.
0011,CASH.01,Bank America Acct

Ou
0011|CASH.01|Bank America Acct

Tables de conversion Hyperion Enterprise


FDM peut lire et importer des tables de conversion Compte et Entit Hyperion Enterprise. Ces
fichiers doivent avoir l'extension *.asc. Les dlimiteurs de champ admis sont la barre verticale
(|), le point-virgule (;), le point d'exclamation (!) et la virgule (,).

Format de table de conversion de compte / Equivalent FDM


Le mot sub signifie que le signe de ce compte doit tre modifi, ce qui est indiqu par une
coche dans la colonne Moins dans la grille de la table de conversion de compte. Les autres valeurs
utilisables pour indiquer un changement de signe sont le signe Moins (-), True et Yes .
Le mot add signifie que le signe de ce compte ne doit pas tre modifi, ce qui est indiqu par
l'absence de coche dans la colonne Moins de la grille de la table de conversion de compte. Les
autres valeurs utilisables pour indiquer que le changement de signe n'est pas ncessaire sont le
signe Plus (+), False et No .

112 Tables de mappage


Exemple de table de compte Hyperion Enterprise
54300.018!54300.018.USL!SUB 002!002.INP
54300.033!54300.033.US!ADD 005!005.INP

Importation de mappages Excel


Au lieu d'utiliser la fonctionnalit Importation XLS, vous pouvez importer un mappage Excel
au moyen du formulaire Mappages, en cliquant sur le bouton Importer et en slectionnant le
mappage Excel. Au sein de la feuille de calcul Excel, ce sont les mmes rgles de mise en forme
que celles utilises par la fonctionnalit Importation XLS qui s'appliquent. Des modles de
mappage Excel avec la mise en forme adquate sont inclus dans le rpertoire Outbox/
Templates.

Importation de tables de mappage 113


114 Tables de mappage
Contrles financiers
12
Dans ce chapitre
Cration de groupes de contrles.............................................................................................................................115
Explorateur de processus.........................................................................................................................................123

Utilisez des groupes de contrles financiers pour configurer des contrles financiers associs aux
emplacements de validation. Les groupes de contrles contribuent au respect de certaines
exigences de la Loi Sarbanes-Oxley.
Utilisez des groupes de contrles pour grer et organiser les informations de certification et
d'valuation. Le formulaire Groupes de contrles comporte deux zones principales :
Certification (302) et Evaluation (404). Chaque zone contient une corbeille de questions. Pour
accder l'cran Groupes de contrles, slectionnez Mtadonnes > Groupes de contrles.

Cration de groupes de contrles


Les groupes Certification (302) et Evaluation (404) peuvent tre organiss en groupes de
contrles distincts. Les groupes de contrles peuvent ensuite tre organiss en sections. Chaque
section contient des questions.

Pour crer des groupes de contrles, procdez comme suit :


1 Slectionnez Mtadonnes > Groupes de contrles.
L'cran Proprits du groupe de contrles s'affiche.
2 Cliquez avec le bouton droit sur le groupe Certification ou Evaluation et slectionnez Ajouter un groupe
de contrles.
L'cran d'ajout de groupe de Certification (302) ou d'Evaluation (404) s'affiche.
3 Entrez le nom et la description du groupe de contrles.
4 Cliquez sur OK.
Exemple de groupes de contrles de Certification (302) :

Cration de groupes de contrles 115


Sections
Les groupes de contrles sont composs de sections. Chaque groupe de contrles peut tre
organis en autant de sections que ncessaire.

Pour ajouter des sections aux groupes de contrles, procdez comme suit :
1 Cliquez avec le bouton droit sur un groupe de contrles et slectionnez Ajouter une section de
contrles.
La bote de dialogue Proprits de la section de contrles s'affiche.
2 Entrez le nom et la description de la section.
3 Cliquez sur OK.

Remarque :
Chaque section doit avoir un nom unique.

Dans l'exemple ci-aprs, 1Financial Reporting contient les sections Review et Completeness :

116 Contrles financiers


Questions
Les sections sont composes de questions. Chaque section peut contenir autant de questions
que ncessaire.

Pour ajouter des questions dans les sections, procdez comme suit :
1 Mettez une section en surbrillance.
Le tableau de questions slectionn s'affiche.
2 Cliquez sur Ajouter.
Entrez les informations concernant la question :
ID : chaque question DOIT AVOIR UN IDENTIFIANT UNIQUE, quelle que soit la section.
L'ID ne doit pas contenir de points.
Objectifs : indiquez l'objectif que vous souhaitez atteindre l'aide de la question.
Type : indiquez le type de question (Financier, Oprations ou Conformit). Vous pouvez
slectionner plusieurs types.
Risques : indiquez les risques qui pourraient empcher d'atteindre l'objectif fix.
Niveau : indiquez le niveau de risque associ une rponse non attendue la question. Le
niveau de risque varie de faible (L) lev (H).
Question/Elment cibl : indiquez la question ou le point cibl.
Frq. (Frquence) : indiquez la frquence laquelle la question doit recevoir une rponse.
Slectionnez M (mensuelle), T (trimestrielle) ou A (annuelle) dans la liste droulante.
Sq. (Squence) : indiquez l'ordre dans lequel vous souhaitez prsenter les questions.

Cration de groupes de contrles 117


Rponse obligatoire : slectionnez l'option si une rponse la question est requise avant de
terminer la validation de section.
Rponse attendue : slectionnez dans la liste droulante la rponse attendue la question.
La rponse attendue peut tre Oui ou Non.
Inactif : slectionnez l'option si vous souhaitez ne plus afficher la question et y rpondre.
L'exemple ci-aprs montre une question associe la section Review sous 1Financial Reporting :

Importation de questions depuis Excel


Vous pouvez crer des questions dans Excel et les importer dans FDM.

Pour importer des questions depuis Excel, procdez comme suit :


1 Slectionnez Outils > Importation XLS.
2 Accdez au fichier importer :
Importation partir de la bote de rception de l'application : dans l'onglet Bote de
rception, cliquez sur Slectionner un fichier.
Importation partir d'un autre emplacement : dans l'onglet Tlcharger le fichier, cliquez
sur Parcourir.
3 Slectionnez le fichier et excutez une action :
Importation partir de l'onglet Bote de rception : cliquez sur OK, puis sur Importer.
Importation partir de l'onglet Slectionner un fichier dans la bote de rception : cliquez
sur OK.

118 Contrles financiers


L'exemple ci-aprs prsente le format d'un modle d'importation de questions. Le nom de la
table est tControlsItem. La table est une illustration et ne contient pas tous les champs
disponibles. Le nom de la plage d'importation doit respecter le format suivant : upsxxxxx.

Dans l'exemple, le nom de la plage est upsfr.


Les champs disponibles sont les suivants :
ControlsItemKey : cl de champ numrique (obligatoire)
ControlsItemTag : ID de question (obligatoire)
ControlsGroupKey : groupe (obligatoire)
ControlsSectionKey : numro de section (obligatoire)
ControlsItemObjective : objectifs
ControlsItemType : F (Financier), O (Oprations), C (Conformit)
ControlsItemRisks : risque associ la question ou l'objectif
ControlsItemRiskLikelihood : 1 5
ControlsItemFocus : questions
ControlsItemCommentRequired : Vrai ou Faux
ControlsItemSequence : ordre de prsentation des questions
ControlsItemHasLinks : Vrai ou Faux (associ la question de certification ?) (obligatoire)
ControlsItemInactive : Vrai ou Faux (obligatoire)
ControlsItemExpectedRespones : Oui ou Non
ControlsItemActivationDate : date d'entre en vigueur (obligatoire)
ControlsItemDeactivationDate : date laquelle l'lment de contrle n'est plus utilis
(obligatoire)
Chaque champ importer doit tre inclus dans la plage upsxxx. Il n'est pas obligatoire
d'importer tous les champs. Vous pouvez importer la structure gnrale des questions et faire
la mise jour dans FDM si ncessaire.

Remarque :
Indiquez les dates au format texte dans le fichier Excel.

Cration de groupes de contrles 119


Date d'entre en vigueur
Chaque question peut tre associe une date d'entre en vigueur. La date d'entre en vigueur
dtermine le moment auquel la question est prsente pour la premire fois. La date d'entre en
vigueur n'est pas obligatoire si vous souhaitez que la question soit prsente pour toutes les
priodes.

Pour dfinir la date d'entre en vigueur pour chaque question, procdez comme suit :
1 Cliquez sur le lien du champ ID de la question pour laquelle vous souhaitez dfinir une date d'entre en
vigueur.
2 Entrez la date d'entre en vigueur.
3 Cliquez sur OK.

Corbeille
Il existe une corbeille pour les questions de certification et une corbeille pour les questions
d'valuation. Les questions supprimes d'une section de certification sont places dans la
corbeille de certification et les questions supprimes d'une section d'valuation sont places dans
la corbeille d'valuation.
Un groupe, une section ou une question peut tre envoy(e) dans la corbeille.
Les lments prsents dans la corbeille peuvent tre restaurs, contrairement aux lments
supprims de la corbeille.

Suppression de groupes, de sections ou de questions

Pour envoyer des groupes dans la corbeille, procdez comme suit :


1 Cliquez avec le bouton droit sur un groupe et slectionnez Supprimer le groupe de contrles.
2 Slectionnez OK.

Pour envoyer des sections dans la corbeille, procdez comme suit :


1 Cliquez avec le bouton droit sur une section et slectionnez Supprimer la section de contrles.
2 Slectionnez OK.

Pour envoyer une question dans la corbeille, procdez comme suit :


1 Mettez en surbrillance la section qui contient la question supprimer.
2 Slectionnez une question dans le tableau.
3 Cliquez sur Supprimer.

L'icne de suppression ( ) apparat gauche de la ligne et indique une suppression en attente.


4 Slectionnez Mettre jour la grille.

120 Contrles financiers


Restauration de groupes, de sections ou de questions

Pour restaurer des groupes partir de la corbeille, procdez comme suit :


1 Cliquez sur la corbeille (Certification ou Evaluation) partir de laquelle vous souhaitez restaurer un groupe.
2 Cliquez avec le bouton droit sur le groupe et slectionnez Restaurer le groupe de contrles.
3 Cliquez sur OK.

Pour restaurer des sections partir de la corbeille, procdez comme suit :


1 Cliquez sur la corbeille (Certification ou Evaluation) partir de laquelle vous souhaitez restaurer une section.
2 Cliquez sur le dossier *Sections supprimes.
3 Cliquez avec le bouton droit sur une section et slectionnez Restaurer la section de contrles.
4 Slectionnez OK.
La bote de dialogue Slectionner un groupe de contrles s'affiche.
5 Dans Slectionner un groupe de contrles, indiquez sous quel groupe de contrles vous souhaitez restaurer
la section.
6 Cliquez sur OK.

Pour restaurer des questions partir de la corbeille, procdez comme suit :


1 Cliquez sur la corbeille (Certification ou Evaluation) partir de laquelle vous souhaitez restaurer une question.
2 Cliquez sur le dossier *Sections supprimes.
3 Cliquez sur le dossier *Supprimer questions.
Les questions supprimes apparaissent dans la grille infrieure de l'cran Groupes de contrles.

4 Cliquez sur l'icne de la corbeille ( ) dans la colonne Restaurer.


5 Cliquez sur OK.
La bote de dialogue Slectionner une section de contrles s'affiche.
6 Dans Slectionner une section de contrles, indiquez sous quelle section de contrles vous souhaitez
restaurer la section.

Profils de questions
Les groupes de contrles de questions peuvent tre organiss en profils de questions qui vous
permettent d'affecter un jeu de questions diffrent chaque emplacement. Un ou plusieurs
groupes de contrles peuvent tre associs pour crer des profils. Chaque profil cr est soit un
profil de certification, soit un profil d'valuation.

Pour ajouter un profil, procdez comme suit :


1 Slectionnez Mtadonnes > Emplacements.

Cration de groupes de contrles 121


L'cran Emplacements s'affiche.
2 Slectionnez l'onglet Contrles financiers.
3 Slectionnez un emplacement.
4 Cliquez sur Modifier sous le menu Certification (302) ou Evaluation (404).
La bote de dialogue Profil certification ou Profil valuation s'affiche.
5 Cliquez sur Ajouter.
La bote de dialogue Saisir un nom de profil s'affiche. Vous pouvez crer un profil pour chaque
emplacement ou utiliser un profil unique pour plusieurs emplacements.
6 Entrez le nom du nouveau profil.
7 Cliquez sur OK.
8 Dans la bote de dialogue Profil certification, ajoutez des groupes de contrles au profil :
a. Dans Groupes disponibles, slectionnez un groupe ajouter au profil.

b. Cliquez sur pour ajouter le groupe la table Profil groupe.


c. Cliquez sur OK.

Expditeur et proxy
Chaque emplacement est associ un expditeur et un proxy (expditeur de sauvegarde).
L'expditeur ou le proxy envoie la certification ou l'valuation aprs la validation de toutes les
sections.
Si la certification dpend du chargement des donnes, l'expditeur ne peut rien envoyer tant que
les donnes n'ont pas t charges et que toutes les sections n'ont pas t valides.

Pour affecter des expditeurs et des proxy aux emplacements, procdez comme suit :
1 Dans l'onglet Contrles financiers de l'cran Emplacements, slectionnez le menu Expditeur ou Proxy.
2 Slectionnez un utilisateur.
3 Cliquez sur Enregistrer.
Les utilisateurs configurs dans la scurit FDM en tant que rviseurs et expditeurs de contrles
sont dirigs directement vers l'Explorateur de processus au moment de la connexion.

Rviseurs et proxy
Un rviseur et un proxy (rviseur de sauvegarde) sont affects chaque section. Le rviseur ou
le proxy rpond aux questions dans les sections qui lui sont affectes. Il existe des rviseurs de
certification et des rviseurs d'valuation.
Chaque section peut avoir son propre rviseur, ou un rviseur unique peut tre affect plusieurs
sections.

122 Contrles financiers


Pour affecter des rviseurs et des proxy aux sections, procdez comme suit :
1 Dans la grille Rviseurs certification ou Rviseurs valuation, cliquez deux fois dans la colonne
Rviseur ou Proxy d'une section.
2 Slectionnez un utilisateur.
3 Cliquez sur Mettre jour la grille.
Les utilisateurs configurs dans la scurit FDM en tant que rviseurs de contrles sont dirigs
directement vers le bureau de l'Explorateur de processus au moment de la connexion.

Identification du niveau de risque


Ce champ dfinit les cas dans lesquels des balises rouges sont affiches pour les questions recevant
une rponse inattendue. Les questions sont associes un niveau de risque de faible (L) lev
(H). Dfinissez l'identification du niveau de risque pour indiquer les cas dans lesquels des balises
rouges doivent tre affiches pour les questions recevant une rponse inattendue.
Par exemple, un emplacement associ l'identification de niveau de risque M (Moyen) gnre
des balises rouges pour les questions de niveau de risque M (Moyen) ou plus lev qui reoivent
des rponses inattendues. Les questions de niveau de risque L (Faible) L-M (Faible-Moyen)
ne gnrent pas de balises rouges pour les rponses inattendues dans des emplacements associs
l'identification de niveau de risque M (Moyen).

Explorateur de processus
Pour accder l'Explorateur de processus, slectionnez Analyse > Explorateur de processus dans
le client Web ou cliquez sur l'icne du Bloc-notes qui s'affiche aprs le chargement de donnes
par un emplacement. Les emplacements sont affichs dans le volet gauche de l'Explorateur de
processus, et les questions de la zone de contrles slectionne sont affiches dans le volet droit.
Le menu situ au-dessus du volet gauche permet de contrler les lments affichs dans l'cran
de l'Explorateur de processus.
Le menu de navigation de l'Explorateur de processus comporte les lments suivants :
Questions de certification (Vrifier la certification)
Questions d'valuation (Vrifier l'valuation)
Rapports de certification
Rapports d'valuation
Copie des rponses d'valuation depuis la priode prcdente vers la priode en cours
Evaluation audit, Analyse de l'cart et Plans d'action
Rapport d'tat
Afficher les entres du journal
Afficher les modifications de mappage

Explorateur de processus 123


Ajout de mmos et de documentation
Vous pouvez joindre de la documentation une question ou un point cibl. WebLink organise
la documentation en deux groupes :
Documentation gnrale : tout utilisateur ayant les droits de scurit appropris peut joindre
des documents ce groupe.
Documentation d'audit : seuls les utilisateurs ayant le statut de vrificateur peuvent joindre
des documents ce groupe. Le statut d'auditeur est configur partir de la scurit FDM.
Le groupe Audit Documentation comprend trois sections :
Evaluation
Analyse de la diffrence
Plans d'action
Vous pouvez ajouter un nombre illimit de mmos chaque question ou point cibl. Chaque
mmo peut tre associ dix documents de support.

Pour ajouter des mmos et joindre de la documentation, procdez comme suit :


1 Dans le client Web, slectionnez Analyse > Explorateur de processus.
L'cran de l'Explorateur de processus s'affiche.
2 Dans le volet gauche de l'Explorateur de processus, slectionnez un emplacement de validation des contrles
ou de chargement des donnes.
3 Dans Section (volet de droite), slectionnez une section.

4 Cliquez sur le lien Mmo ( ) dans la colonne Mmo ( dans l'en-tte de la colonne).
La bote de dialogue Elment de mmo s'affiche.
5 Cliquez sur Ajouter (bouton situ dans la partie infrieure gauche de la bote de dialogue Elment de mmo).
6 Entrez la description de l'lment de mmo et cliquez sur OK.
7 Entrez le texte du mmo dans la section Mmo.
8 Pour joindre des documents, cliquez sur Ajouter droite du champ Pice jointe, accdez la pice jointe
et cliquez sur OK.
9 Cliquez sur Mettre jour.
10 Cliquez sur Fermer.
11 Pour fermer l'Explorateur de processus, slectionnez Fichier > Accueil.
Le groupe Audit comporte une zone de responsabilit supplmentaire pour le suivi et le reporting
des lments de mmo d'audit. Vous pouvez dsigner un utilisateur Affect : et Affect par : .
Vous pouvez galement dfinir une date cible de fin et vrifier le moment auquel l'lment est
termin. Les lments de mmo d'Analyse de la diffrence et de Plans d'action peuvent tre
associs l'lment de mmo Evaluation duquel ils sont issus. Une analyse de la diffrence peut
tre associe une valeur indiquant l'importance ou l'importance relative de la diffrence
identifie.

124 Contrles financiers


Processus de certification
Le processus de certification consiste valider et soumettre des questions dfinies par l'utilisateur
chaque niveau d'une organisation. Chaque emplacement d'une hirarchie de structure des
contrles peut comporter un seul groupe de questions. Vous pouvez galement dvelopper un
groupe de questions standard affect tous les emplacements. Des groupes de questions
supplmentaires peuvent ensuite tre affects aux emplacements qui ncessitent des questions
supplmentaires ou uniques.

Explorateur de processus 125


126 Contrles financiers
Rgles et entits de validation
13
Dans ce chapitre
Cration d'un groupe de rgles de validation............................................................................................................128
Cration d'une rgle de validation............................................................................................................................128
Groupes d'entits de validation................................................................................................................................140

Les rgles de validation permettent aux administrateurs systme de dfinir un ensemble de rgles
et d'annotations destines assurer l'intgrit des donnes au cours du processus de collecte des
donnes. Un ensemble de rgles de validation est cr dans un groupe de rgles de validation.
Lorsqu'un groupe de rgles de validation est affect un emplacement, le rapport de validation
est gnr suite au chargement des donnes dans le systme cible. Le rapport de validation
s'excute pour toutes les entits dfinies dans le groupe d'entits de validation s'il est galement
affect l'emplacement. Si aucun groupe d'entits de validation n'est affect l'emplacement,
le rapport de validation s'excute alors pour chaque entit cible charge dans le systme cible.
Les rapports de validation FDM rcuprent des valeurs directement depuis le systme cible, les
donnes source FDM ou les donnes converties FDM.
Les rapports de validation sont automatiquement gnrs au cours du processus de chargement
des donnes mais peuvent galement tre excuts manuellement. Les rapports ont pour
fonction principale de permettre aux emplacements de reporting d'valuer la qualit des
informations envoyes. Les rsultats d'un rapport de validation pour les emplacements sont
analyss par FDM et une entre de statut global est enregistre dans la table de contrle des
processus. Pour qu'un emplacement dispose d'un tat Vrai pour la validation, chaque rgle du
rapport de validation doit tre accepte. Si une rgle n'est utilise qu' des fins d'avertissement,
aucune logique de rgle n'est affecte la ligne.
Cliquez sur l'icne Vrifier de la barre d'outils FDM ou cliquez sur Workflow > Vrifier pour
afficher le rapport Validation du chargement. Ce rapport est bas sur les rgles de validation
affectes l'emplacement en cours. La capture d'cran ci-aprs reprsente un rapport de
validation.

127
Cration d'un groupe de rgles de validation
Pour crer un groupe de rgles de validation, procdez comme suit :
1 Dans le client Web, slectionnez Mtadonnes > Rgles de validation.
L'cran Rgles de validation s'affiche.
2 Cliquez sur le bouton Ajouter situ au-dessus de la grille du haut.
Une nouvelle ligne s'ajoute dans la grille du haut.
3 Cliquez deux fois dans la colonne Groupe de validation, puis indiquez un nom pour le groupe de validation.
4 Cliquez deux fois dans la colonne Description, puis entrez la description du groupe de validation.
5 Cliquez sur Mettre jour la grille.

Remarque :
Une date sera automatiquement ajoute la colonne Date de cration du nouveau groupe de
validation.

Cration d'une rgle de validation


Chaque ligne du rapport de validation reprsente une rgle de validation.

Pour crer une rgle de validation, procdez comme suit :


1 Dans le client Web, slectionnez Mtadonnes > Rgles de validation.
L'cran Rgles de validation s'affiche.

128 Rgles et entits de validation


2 Dans la grille du haut, slectionnez le groupe de rgles de validation auquel vous souhaitez ajouter les rgles
de validation.
3 Cliquez sur le bouton Ajouter situ au-dessus de la grille du bas.
Une nouvelle ligne s'ajoute dans la grille du bas.
4 Entrez les informations relatives la rgle de validation dans chacun des champs.
Les informations dtailles d'une rgle de validation sont explicites ci-aprs.
5 Cliquez sur Mettre jour la grille.

Une rgle de validation comporte les champs suivants :


Valeur affiche
Description
Nom de la rgle
Texte de la rgle
Type
Catgorie
Squence
(Facultatif) Logique de la rgle

Cration d'une rgle de validation 129


Valeur affiche
Cette colonne contrle la manire dont FDM met en forme chaque ligne de donnes du rapport
de validation. Elle peut tre utilise pour slectionner un compte cible ou un code de format
pour le rapport, ou pour crer une expression personnalise.
Le contenu de cette colonne est trait selon les rgles suivantes :
Si le champ contient un code de format pour le rapport, aucune recherche de valeur n'est
excute.
Si la colonne contient un tout autre lment qu'un code de format pour le rapport, le rsultat
de l'expression personnalise (logique de la rgle) s'affiche alors dans la colonne Valeur
affiche. Cette colonne est limite 75 caractres.
Cliquez deux fois sur le champ Valeur affiche pour afficher le menu contenant les trois lments
Zoom, Rechercher un compte cible et Slectionner un code de format.
Tant qu'une rgle est en mode Edition, les liens Zoom, Rechercher un compte cible et
Slectionner un code de format de la colonne Valeur affiche sont actifs.

Zoom...
Cette option permet d'afficher le texte de la cellule dans un diteur de texte. Elle est utile quand
il s'agit d'entrer ou d'diter de grandes quantits de texte.

Rechercher un compte cible


Slectionnez cette option pour afficher l'cran Recherche de comptes cible de rgles de
validation. Dans cet cran, slectionnez le compte dans la liste des comptes d'application du
systme cible pour l'ajouter la grille Rgles de validation. En plus de renseigner le numro du
compte dans le champ Valeur affiche, vous devez entrer une expression personnalise pour que
la valeur s'affiche.

Slectionner un code de format


En plus de slectionner les comptes cible, vous pouvez entrer des codes de format dans la colonne
Compte cible. Ces codes permettent de matriser la mise en forme du rapport de validation.
Utilisez cette option pour slectionner le code souhait dans l'cran Slectionner un code de
format. Le tableau ci-dessous prsente les diffrents codes de format pouvant tre utiliss dans
une rgle de validation.

Code Description

#ModeList Dfinit le mode de rapport sur Liste. Ce mode permet d'afficher les champs Valeur affiche, Description
et Montant.

#ModeRule (Par dfaut) Dfinit le mode de rapport sur Rgle. Ce mode permet d'afficher les champs Nom de la
rgle, Texte de la rgle et Montant. Le rapport value l'expression de la colonne Logique de la rgle
et teste la condition Vrai ou Faux de la rgle. Le statut de la rgle (OK ou Erreur) s'affiche dans le

130 Rgles et entits de validation


Code Description
rapport pour chacune des rgles. Les colonnes Compte cible et Description ne s'affichent pas dans
ce mode.

#Title Ce code permet d'insrer une ligne de titre dans le rapport. Lorsque le code #Title est utilis, le
texte entr dans le champ Description s'affiche comme un titre.

#Subtitle Ce code permet d'insrer une ligne de sous-titre dans le rapport. Lorsque le code #Subtitle est
utilis, le texte entr dans le champ Description s'affiche sous la forme d'un groupe de sous-titres.
Les sous-titres permettent de regrouper les rapports. Ils sont insrs dans l'arborescence de navigation
du rapport de validation.

Description
Cette colonne permet d'afficher les descriptions, les titres ou les sous-titres de compte. Ce champ
ne s'affiche dans le rapport de validation que si le code de format #ModeList est utilis pour le
rapport.
Exemple de description
Out-of-Balance Account

Nom de la rgle
Cette colonne permet de stocker l'identifiant de la rgle de validation. Ce champ ne s'affiche
dans le rapport que si le code de format #ModeRule est utilis pour le rapport. La valeur entre
dans cette colonne doit tre unique et facile identifier.
Exemple de nom de rgle
Vrification dsquilibre

Texte de la rgle
Ce champ permet de dfinir la base ou la logique d'une rgle. Le texte de cette colonne est
l'lment principal affich dans le rapport de validation. Ce champ ne s'affiche dans le rapport
de validation que si le code de format #ModeRule est utilis pour le rapport.
Exemple de texte de rgle
Ce compte doit tre compris entre [+10 et 10].

Type
Le champ Type correspond au champ Type du formulaire Entits de validation. Slectionnez
l'option Tous pour que cette rgle s'affiche pour toutes les entits du rapport de validation. Dans
le champ Type, dfinissez si cette rgle doit s'afficher dans le rapport de validation uniquement
pour les entits de base ou les entits parent ou pour toutes les entits.

Cration d'une rgle de validation 131


S'il s'agit d'une rgle de validation parent, la rgle de validation ne s'affiche dans le rapport
de validation que pour les entits dont le type est dfini sur Parent ou Tous dans l'cran
Entits de validation.
S'il s'agit d'une rgle de validation de base, la rgle de validation ne s'affiche dans le rapport
de validation que pour les entits dont le type est dfini sur De base ou Tous dans l'cran
Entits de validation.
S'il s'agit d'une rgle de validation s'appliquant toutes les entits (Tous), la rgle de
validation s'affiche dans le rapport de validation pour toutes les entits, quel que soit le type
d'entit (Parent ou De base) dfini dans l'cran Entits de validation.

Catgorie
Dans le champ Catgorie, slectionnez une catgorie FDM afin de restreindre la rgle de
validation une catgorie FDM spcifique. La rgle de validation ne s'affiche dans le rapport de
validation que si la catgorie FDM slectionne dans ce champ est identique la catgorie FDM
active dfinie dans le PDV. Pour afficher la rgle de validation dans le rapport de validation,
quelle que soit la catgorie dfinie dans le PDV, slectionnez l'option Tous.

Squence
La valeur de cette colonne permet de matriser l'ordre de traitement des rgles. Le numro de
squence dtermine l'ordre dans lequel les codes de format et les rgles sont traits. Nous vous
recommandons d'incrmenter les numros de squence de 10 en 10 afin de vous laisser la
possibilit d'insrer de nouveaux codes de format et de nouvelles rgles.

Logique de la rgle
La colonne Logique de la rgle permet de crer une recherche multi-dimension, une expression
de rgle de validation ou une fonction de rgle de validation plus avance. Les recherches multi-
dimension affichent une valeur dans le champ Montant du rapport de validation. Les expressions
et les fonctions des rgles de validation sont habituellement utilises pour valider les soldes des
comptes du systme cible. Le champ Logique de la rgle n'est trait que si le code de format
#ModeRule ou #ModeList est utilis pour le rapport.

Les expressions et les fonctions des rgles de validation utilisent des expressions standard du
langage VBScript de Microsoft. Les expressions et les fonctions des rgles de validation testent
si une condition est vraie ou fausse. Aprs avoir trait la logique de la rgle, FDM analyse le
rsultat de la rgle et indique si elle est accepte ou non (passage ou chec) dans le rapport de
validation.

Expressions des rgles de validation


Les expressions des rgles de validation sont normalement utilises pour valider les soldes des
comptes du systme cible. Ces expressions retournent le rsultat Vrai ou Faux. Vous pouvez
utiliser la fonction de recherche Hyperion Enterprise (lors de l'intgration avec Hyperion

132 Rgles et entits de validation


Enterprise) ou la fonction de recherche multi-dimension (lors de l'intgration de systmes cible
multi-dimensions). Pour obtenir davantage de fonctionnalits avances, utilisez les fonctions
de rgles avances.
Exemple 1
Si le Solde du compte cible est suprieur 10 EUR et infrieur 10 EUR, la rgle est alors
indique comme OK dans le rapport de validation. Si le solde du compte n'est pas compris
dans cette fourchette de valeurs, la rgle est alors indique en Erreur dans le rapport de
validation.
|Balance| >= -10.00 AND |Balance| <= 10.00

Exemple 2
L'exemple ci-dessous permet de vrifier que le solde du compte cible 1000.100 + 100 000 EUR
est gal au solde du compte cible 1000.400 .
|1000.100| + 100000 = |1000.400|

Fonction de recherche Hyperion Enterprise


L'exemple d'expression de rgle de validation ci-aprs utilise la fonction de recherche Hyperion
Enterprise. Si le Solde du compte cible est suprieur 10 EUR et infrieur 10 EUR, la rgle
est alors indique comme OK dans le rapport de validation. Si le solde du compte n'est pas
compris dans cette fourchette de valeurs, la rgle est alors indique en Erreur dans le rapport
de validation.
Exemple 1
|Balance| >= -10.00 AND |Balance| <= 10.00

Exemple 2
L'exemple ci-dessous permet de vrifier que le solde du compte cible 1000.100 + 100 000 EUR
est gal au solde du compte cible 1000.400 .
|1000.100| + 100000 = |1000.400|

Fonction de recherche multi-dimension


La fonction de recherche multi-dimension permet de rcuprer les valeurs des comptes du
systme cible, les donnes source FDM ou les donnes converties FDM. Les recherches multi-
dimensions peuvent tre utilises dans les champs Logique de la rgle et Valeur affiche du
formulaire Rgles de validation.

Sources de donnes des rgles


FDM peut rcuprer des donnes depuis trois sources diffrentes :
Donnes du systme cible : rcupration des valeurs depuis le systme cible.
Donnes source FDM : rcupration des valeurs depuis les donnes qui ont t charges
dans FDM aprs avoir t mappes aux membres cible.

Cration d'une rgle de validation 133


Donnes converties FDM : rcupration des valeurs issues des donnes qui ont t charges
dans FDM.

Donnes du systme cible


Ce format permet FDM de rcuprer des valeurs du systme cible pour n'importe quelle
dimension. Ce type de rgle utilise une barre verticale (|) comme caractre de dbut et de fin de
la rgle. Les paramtres ci-aprs peuvent tre utiliss pour le rfrencement d'un compte du
systme cible. Sauf indication contraire, tous les paramtres sont facultatifs.
|Scenario, Period, Year, View, Value, Entity, Account (Required), ICP,
Custom1, Custom2,Custom3, Custom4, Custom5, Custom6, Custom7, Custom8,
Custom9, Custom10, Custom11, Custom12, Custom13, Custom14, Custom15,
Custom16, Custom17, Custom18, Custom19, Custom20|

Les exemples ci-dessous prsentent les diffrentes faons de rcuprer les valeurs depuis le
systme cible. Les virgules doivent tre utilises comme des variables pour les dimensions non
rfrences.
Exemple 1
Recherchez la valeur du Solde du compte cible pour la priode cible et le scnario (catgorie)
cible en cours dfinis dans le PDV et pour chaque entit du groupe d'entits de validation FDM
qui est affect l'emplacement. Dans cet exemple, la rgle est valide si le solde du compte cible
est compris entre 10 EUR et 10 EUR.
|,,,,,Balance,,,,,,,,,,,,,,,,,,,,,,| > -10.00 AND
|,,,,,Balance,,,,,,,,,,,,,,,,,,,,,,| < 10.00

Exemple 2
Recherchez la valeur du Solde du compte cible pour les dimensions fournies.
|Actual,March,2002,YTD,Ohio,Balance,Michigan,Engines,Ford,Trucks,
[None],,,,,,,,,,,,,,,,,USD| > 0

Exemple 3
Recherchez la valeur du Solde du compte cible pour les dimensions fournies et la priode
prcdente.
|Actual,-1,2002,YTD,Ohio,Balance,Michigan,Engines,Ford,Trucks,
[None],,,,,,,,,,,,,,,,,USD| > 0

Exemple 4
Recherchez la valeur du Solde du compte cible pour la priode cible et le scnario (catgorie)
cible en cours dfinis dans le PDV FDM et pour chaque entit du groupe d'entits de validation
FDM qui est affect l'emplacement. Toutes les dimensions personnalises manquantes sont
dfinies par dfaut sur [Aucun] , la dimension ICP est dfinie par dfaut sur [ICP-None] ,
la dimension Anne est dfinie par dfaut sur l'anne en cours dans le PDV, la dimension Devise
est dfinie par dfaut sur 0 et la dimension Affichage est dfinie par dfaut sur Cumul .
|,-1,,,,Balance,,,,,,,,,,,,,,,,,,,,,,| > 0

134 Rgles et entits de validation


Donnes source FDM
Cette mthode permet de rcuprer les valeurs issues des donnes charges dans FDM, une fois
qu'elles ont t mappes au membre cible. Ce type de rgle utilise un tilde (~) comme caractre
de dbut et de fin de la rgle. Les paramtres ci-aprs peuvent tre utiliss pour le rfrencement
d'un compte du systme cible. Sauf indication contraire, tous les paramtres sont facultatifs. Les
paramtres UD# sont des paramtres dfinis par l'utilisateur.
~FDM Category, FDM Period, Year (Field Not Applicable), FDM View, FDM
Location, Source Entity, Source Account(Required), Source ICP, Source UD1,
Source UD2, Source UD3, Source UD4, Source UD5, Source UD6, Source UD7,
Source UD8, Source UD9, Source UD10, Source UD11, Source UD12, Source UD13,
Source UD14, Source UD15, Source UD16, Source UD17, Source UD18, Source
UD19, Source UD20~

Donnes converties FDM


Cette mthode permet de rcuprer des valeurs issues des donnes charges dans FDM. Ce type
de rgle utilise un accent grave (`) comme caractre de dbut et de fin de la rgle. Les paramtres
ci-aprs peuvent tre utiliss pour le rfrencement d'un compte du systme cible. Sauf
indication contraire, tous les paramtres sont facultatifs.
`FDM Category, FDM Period, Year (Field Not Applicable), FDM View, FDM
Location, Entity, Account(Required), ICP, Custom1, Custom2, Custom3,
Custom4, Custom5, Custom6, Custom7, Custom8, Custom9, Custom10, Custom11,
Custom12, Custom13, Custom14, Custom15, Custom16, Custom17, Custom18,
Custom19, Custom20`

Remarque :
Les caractres de dbut et de fin de chacune des sources de donnes des rgles ne sont pas imposs
et peuvent tre modifis. Vous pouvez modifier ces caractres dans l'cran Paramtres de
configuration.

Fonctions des rgles de validation


Dans le champ Logique de la rgle, vous pouvez utiliser des fonctions avances offrant une
souplesse supplmentaire lors de l'valuation des donnes du systme cible. Les rgles de
validation FDM peuvent utiliser des procdures VBScript. Vous pouvez donc dfinir deux
champs de chanes personnaliss et deux champs d'options numriques qui peuvent tre valus
par un script ou un rapport personnalis. Dans une rgle, vous pouvez galement raliser des
validations par rapport des sources de donnes diffrentes de celles du systme cible (utilisez
une valeur de compte logique FDM par exemple).
Pour utiliser une fonction dans une rgle de validation, la rgle doit dbuter par le mot-cl
Fun. Cette valeur de mot-cl dclenche l'API qui interprte la rgle comme une fonction plutt
qu'une expression. Pour dfinir la valeur de retour de la fonction, dfinissez le mot-cl
Result sur Vrai ou Faux. La rgle de validation est indique comme OK dans le rapport si
la fonction retourne la valeur Vrai. La rgle de validation est indique en Erreur dans le
rapport si la fonction retourne la valeur Faux.

Cration d'une rgle de validation 135


Paramtres des fonctions des rgles de validation
Les fonctions des rgles de validation utilisent les paramtres ci-aprs qui peuvent tre valus
afin de dterminer si une rgle de validation en particulier doit tre accepte pour le PDV en
cours.
API : Il s'agit de l'objet de programmation principal de l'API FDM. Ce paramtre permet
d'utiliser toutes les donnes FDM et les fonctions de l'API interne.
strEntity : entit cible
strTargCat : catgorie cible
strTargPer : priode cible
strTargYear : anne cible
strTargFreq : frquence cible

Proprits des logiques de rgle facultatives


Vous pouvez dfinir les proprits de l'objet RES qui, son tour, dfinit les valeurs des 14 champs
personnaliss du tableau tDataCheck. Vous pouvez accder aux champs dfinis par l'utilisateur
au moyen des scripts. Un champ dfini par l'utilisateur peut tre utilis dans les rapports pour
les messages d'avertissement et les indications.
L'exemple ci-dessous est une fonction de logique de rgle.
Fun: If strEntity = TEXAS.GL Then
Rule not required
Result = True
Set Messages and Switches
RES.PstrCheckMessage1 = Rule does not apply to & strEntity
RES.PstrCheckMessage2 = Do not fret!
RES.PblnCheckWarning = True
RES.PblnCheckClearData = True
Else
Check Cash
IF |1000| <= 0 Then
Result = True
Set Messages and Switches
RES.PstrCheckMessage1 = strEntity & is Good!
RES.PstrCheckMessage2 = 2
Else
Result = False
Set Messages and Switches
RES.PstrCheckMessage1 = strEntity & is Bad!
RES.PstrCheckMessage2 = 2
End If
End If

Editeur de validation
L'Editeur de rgles de validation permet de crer plus facilement et plus rapidement des rgles
de validation. Il vous assiste dans le dveloppement de la logique de la rgle associe aux lments
dfinis dans les codes de format #Modelist ou #Moderule. Vous pouvez crer des rgles de

136 Rgles et entits de validation


validation sans ncessairement connatre le rle de chacun des champs de rcupration FDM.
Cliquez deux fois dans le champ Logique de la rgle du formulaire Rgles de validation et
slectionnez l'option Editeur de validation pour ouvrir l'Editeur de rgles de validation.
L'Editeur de rgles de validation n'est accessible qu' partir du client Web et comporte les trois
onglets suivants :
Rgle
Rechercher
Test

Rgle
L'onglet Rgle permet de crer l'expression logique de la rgle de validation. Cet onglet s'affiche
de la faon suivante dans l'Editeur de validation :

Rgle : Ce champ permet de crer et de tester la rgle.


Affichage : Ce champ permet de crer la valeur retourner au rapport de validation. Cette
valeur peut tre diffrente de la valeur tester dans la rgle.
Mettre jour : Ce bouton permet d'enregistrer le contenu des champs Rgle et Affichage
dans les rgles de validation en cours de modification.
Annuler : Ce bouton permet de fermer l'Editeur de validation sans enregistrer les
modifications apportes.

Cration d'une rgle de validation 137


Onglet Rechercher
Cet onglet permet aux utilisateurs de slectionner des dimensions de rcupration directement
partir du systme cible. Cela permet de s'assurer que les dimensions requises sont entres
correctement et dans le bon ordre pour que la fonction de rcupration fonctionne correctement.

L'onglet Rechercher s'affiche de la faon suivante dans l'Editeur de validation :


Rgle : Ce champ permet d'afficher la rgle en cours de cration. La rgle se compose de
fonctions de rcupration et d'appels de script VBA. Chaque fonction de rcupration
s'affiche sur une ligne distincte de celles des fonctions de script VBA. Cela permet au crateur
de la rgle de slectionner les fonctions de rcupration individuelles afin de les utiliser.
Afficher : Ce champ permet d'afficher la rgle en cours de cration. La rgle se compose de
fonctions de rcupration et d'appels de script VBA. Chaque fonction de rcupration
s'affiche sur une ligne distincte de celles des fonctions de script VBA. Cela permet au crateur
de la rgle de slectionner les fonctions de rcupration individuelles afin de les utiliser.
Intersection de rgle : Lorsqu'une fonction de rcupration est slectionne dans le champ
Rgle ou Afficher, l'arborescence Intersection de rgle est active. Ce champ permet aux
utilisateurs d'entrer les valeurs pour chaque dimension de la fonction de rcupration. Le
texte li chaque dimension active apparat en bleu alors que celui des dimensions inactives
apparat en gris. Cliquez deux fois sur une dimension pour afficher la liste des slections
valides.

138 Rgles et entits de validation


Copier l'arborescence/Coller dans l'Editeur : Ce bouton permet de copier les valeurs dans
toutes les dimensions pour la rgle slectionne. Une fois la copie effectue, le texte du
bouton devient Coller dans l'Editeur . Pour coller les valeurs dans une rgle diffrente,
slectionnez la nouvelle rgle aprs avoir effectu la copie, puis cliquez sur le bouton Coller
dans l'Editeur.

Onglet Test
L'onglet Test permet d'effectuer des tests sur la rgle en cours/la valeur affiche pour s'assurer
que les rsultats corrects sont gnrs avant de crer la nouvelle rgle. Cet onglet s'affiche de la
faon suivante dans l'Editeur de validation.

Slectionner une entit de test : Cette liste droulante permet de slectionner l'entit tester.
Expression : Ce champ permet d'afficher la rgle en cours de test.
Expression aprs substitution de la recherche (Bloc-notes) : Ce champ retourne les rsultats
de l'expression en cours de test aprs excution de la recherche. Ce champ peut galement
servir d'emplacement de stockage temporaire en mettant du texte en surbrillance dans le
champ et en cliquant sur le bouton droit.
Erreurs de recherche : Ce champ permet d'afficher les erreurs dtectes dans la rgle en cours
de test.
Rsultat expression : Ce champ permet d'afficher les rsultats du test de la rgle (Vrai ou
Faux) (si l'emplacement test avec la rgle en cours a rempli les critres de la rgle de
validation).
Tester la rgle : Ce bouton permet d'excuter la rgle en cours dans le champ Rgle. Aprs
avoir cliqu sur le bouton, FDM affiche une slection de tous les emplacements cible

Cration d'une rgle de validation 139


disponibles. Cette slection est alors utilise pour extraire des valeurs et retourner les
rsultats de la rgle.
Tester l'affichage : Ce bouton permet d'excuter la rgle en cours dans le champ Affichage.
Aprs avoir cliqu sur le bouton, FDM affiche une slection de tous les emplacements cible
disponibles. Cette slection est alors utilise pour extraire des valeurs et retourner les
rsultats de l'affichage.
Rinitialiser : Ce bouton permet de rinitialiser tous les champs de l'onglet Rgle de l'cran
Editeur de validation.
Evaluation d'expression : Ce bouton permet de calculer les expressions dans le champ
Expression aprs substitution de la recherche (Bloc-notes).

Groupes d'entits de validation


Les groupes d'entits de validation se composent d'une ou de plusieurs entits du systme cible
que vous souhaitez consolider et afficher dans le rapport de validation. Vous pouvez activer un
groupe d'entits de validation en les affectant un emplacement.
Pour ouvrir l'cran Entits de validation, slectionnez Mtadonnes > Entits de validation dans
le client Web FDM.

Dfinition des entits de validation


Vous pouvez affecter plusieurs entits de validation un groupe d'entits de validation. Pour
plus d'informations sur chacun des champs d'une entit de validation, reportez-vous aux
rubriques ci-dessous.

Organisation / Entit parent


Pour les systmes cible Hyperion Enterprise, slectionnez l'organisation dans laquelle l'entit est
consolide. Pour tous les autres systmes cible, slectionnez l'entit parent de l'entit
consolider. Ce champ n'a aucun impact si l'option Consolider n'est pas active.

Entit
Le champ Entit contient l'entit cible consolider, puis afficher dans le rapport de validation.
Si l'option Consolider est active, cette entit est consolide avant d'tre incluse au rapport de
validation.

Consolider
Ce champ d'option permet d'indiquer qu'une entit doit tre consolide avant d'tre affiche
dans le rapport de validation.

140 Rgles et entits de validation


Priode de dbut
La priode de dbut permet de contrler comment FDM excute le processus de consolidation
au sein du systme cible. Si la priode de dbut est dfinie sur 0 , seule la priode en cours est
consolide. Si la priode de dbut est dfinie sur une valeur suprieure la priode en cours,
seule la priode en cours est consolide. Si la priode de dbut est dfinie sur la valeur 1 , FDM
doit consolider les priodes comprises entre la priode 1 et la priode en cours.

Type
Le champ Type du formulaire Entit de validation correspond au champ Type de rgle du
formulaire Rgles de validation. Dans le champ Type, indiquez s'il s'agit d'une entit de base ou
d'une entit parent. Slectionnez l'option Tous (valeur par dfaut) si vous ne souhaitez pas faire
la distinction entre entit de base et entit parent et si vous souhaitez que cette entit s'affiche
toujours dans le rapport de validation pour chaque rgle de validation.
Par exemple, s'il s'agit d'une entit parent, elle s'affiche dans le rapport de validation uniquement
pour les rgles de validation dont le champ Type est dfini sur la valeur Parent ou Tous.
S'il s'agit d'une entit de base, elle s'affiche dans le rapport de validation uniquement pour les
rgles de validation dont le champ Type est dfini sur la valeur De base ou Tous.
S'il s'agit d'une entit s'appliquant toutes les rgles (Tous), elle s'affiche dans le rapport de
validation pour toutes les rgles de validation, quel que soit leur type.

Le champ Type du formulaire Entit de validation (grille du haut) correspond au champ Type
de rgle du formulaire Rgles de validation (grille du bas).

Groupes d'entits de validation 141


Inclure dans le rapport
Slectionnez cette option pour inclure cette entit au rapport de validation. Si cette option n'est
pas slectionne mais que l'option Consolider l'est, l'entit est consolide mais elle n'est pas
affiche dans le rapport de validation.

Squence
Cette colonne permet de matriser l'ordre de traitement des entits. Le numro de squence
dtermine l'ordre dans lequel les entits sont consolides et incluses au rapport de validation.
Nous vous recommandons d'incrmenter les numros de squence de 10 en 10 afin de vous
laisser la possibilit d'insrer de nouvelles entits.

142 Rgles et entits de validation


Flux de processus
14
Dans ce chapitre
Importation de donnes source................................................................................................................................143
Validation des donnes source................................................................................................................................146
Exportation dans le systme cible............................................................................................................................148
Consolidation du systme cible................................................................................................................................150
Validation des donnes du systme cible (Vrifier)...................................................................................................151

Importation de donnes source


Aprs avoir dfini un format d'importation et affect ce dernier un emplacement, vous pouvez
importer un fichier source. Dans le client Web FDM, slectionnez Workflow > Importer pour
afficher l'cran Importer. Lorsque le formulaire est ouvert, FDM utilise les informations de PDV
en cours pour dterminer l'emplacement, la catgorie et la priode chargs lors de l'importation
d'un fichier.

Mthode de chargement (Type d'importation)


L'cran Importer contient le menu Type d'importation, qui comprend deux options :
Remplacer : (par dfaut) avant de charger un fichier de donnes, les donnes existantes sont
supprimes de l'emplacement, de la catgorie et de la priode en cours.
Ajouter : ajoute le nouveau fichier de donnes aux donnes existantes associes
l'emplacement, la catgorie et la priode en cours. L'ajout FDM ne fusionne pas les
donnes. Les lignes de donnes ajoutes n'ont aucun impact sur les lignes existantes.

Flux du processus d'importation


Pour importer des donnes source, procdez comme suit :
1 Dans FDM Workbench, slectionnez Workflow > Importer.
2 Slectionnez la mthode d'importation :
Pour charger le fichier partir du dossier Inbox de l'application, cliquez sur l'onglet
Slectionner un fichier dans la bote de rception.

Importation de donnes source 143


Pour charger un fichier partir d'un autre emplacement, slectionnez l'onglet Tlcharger
le fichier.
3 Cliquez sur Slectionner un fichier ou sur Parcourir (selon l'onglet choisi l'tape 1) pour localiser et
slectionner le fichier de GL importer.
4 Cliquez sur Importer dans le formulaire Importer.
FDM utilise le format d'importation associ l'emplacement. Cette action lance le flux de
traitement suivant :
a. Lorsque l'option Remplacer est slectionne, le fichier source existant est supprim.
b. Le nouveau fichier source est charg.
c. Les comptes logiques sont traits (le cas chant).
d. Les dimensions source sont mappes aux dimensions cible.
L'illustration suivante montre un exemple de formulaire Importer aprs l'importation d'un
fichier source.

Affichage des rgles de conversion (Explorer le niveau


suprieur)
Le formulaire Importer comporte une fonction d'analyse du niveau suprieur. Cliquez sur le
lien dans le champ Montant de la ligne de dtail et slectionnez Afficher les rgles de conversion
pour voir o chaque ligne de dtail est mappe.

Archivage des donnes


FDM archive tous les fichiers source, journaux d'importation, entres de journaux, fichiers
chargement multiple, fichiers de chargement de systme cible et documents de mmos associs

144 Flux de processus


imports. Ces fichiers sont stocks dans le rpertoire Data de l'application et reoivent un nom
unique. Ces fichiers peuvent tre extraits partir de l'cran Importer et fournissent une analyse
rtrospective.

Affichage des informations de fichier source


Pour afficher les informations du fichier source, cliquez sur le lien dans le champ Montant et
slectionnez Afficher les informations de l'archive. Les informations du fichier source s'affichent.

Ouverture d'un document source


Pour ouvrir le fichier source, cliquez sur le lien dans le champ Montant de la ligne de dtail et
slectionnez Ouvrir le document source. Le fichier de grand livre source, le journal ou le modle
de chargements multiples d'origine s'affichent.

Ouverture du journal
Pour afficher le journal d'importation cr lors du chargement du fichier de grand livre source,
cliquez sur le lien dans le champ Montant de la ligne de dtail et slectionnez Ouvrir le journal
de traitement. Le fichier de grand livre charg s'affiche.

Restauration du fichier source et du journal


Pour restaurer un fichier source partir du rpertoire d'archives, cliquez avec le bouton droit
sur la ligne de dtail et slectionnez Restaurer le document source. Le fichier source et le journal
d'importation associ sont restaurs dans le rpertoire Inbox\ArchiveRestore.

Ajout de mmos sur les lignes de dtail


Vous pouvez ajouter des mmos et des documents de support sur les lignes de dtail dans le
formulaire Importer.

Pour ajouter un mmo, procdez comme suit :


1 Dans le formulaire Importer, cliquez dans la premire colonne d'une ligne de dtail.
La bote de dialogue Mmo s'affiche.
2 Cliquez sur Ajouter.
3 Saisissez un texte de mmo et cliquez sur Ajouter.
4 (Facultatif) Pour joindre des documents de support, cliquez sur Ajouter.
a. Accdez au fichier de support joindre.
b. Entrez la description du document de support dans la zone de texte gauche du bouton
Ajouter.
Vous pouvez ajouter jusqu' dix documents de support pour chaque ID de mmo.

Importation de donnes source 145


5 Cliquez sur Mettre jour pour enregistrer les modifications.
Aprs l'ajout d'un mmo sur une ligne de dtail, une icne de mmo s'affiche dans la premire
colonne du formulaire Importer.
Les documents joints sont stocks dans le rpertoire Data de l'application.
Pour consulter les documents joints ou pour les restaurer, ouvrez la bote de dialogue Mmo
en cliquant sur l'icne Mmo sur la ligne de dtail.
Pour afficher les informations de base concernant la pice jointe, cliquez sur le nom du
fichier joint et slectionnez Afficher les informations de l'archive.
Pour afficher le document dans son format d'origine, cliquez sur Afficher le document.
Pour restaurer le document dans le rpertoire Inbox\ArchiveRestore, slectionnez
Restaurer le document.

Pour supprimer un mmo et les pices jointes associes, procdez comme suit :
1 Mettez le mmo en surbrillance.
2 Cliquez sur l'onglet Gnral.
3 Cliquez sur Supprimer.

Pour supprimer une pice jointe, procdez comme suit :


1 Mettez le mmo en surbrillance.
2 Slectionnez l'onglet Document de support.
3 Cliquez sur le bouton Supprimer situ ct du document joint.

Drill up des attributs


En plus des dimensions personnalises UD1 UD20, FDM comprend 14 dimensions d'attribut
personnalises. Ces dimensions ne sont pas mappables, mais peuvent tre utilises dans le cadre
des tches d'entreposage personnalis des donnes.
Chaque ligne de dtail du formulaire Importer peut contenir des attributs chargs lors du
processus d'importation. Les donnes charges dans les dimensions d'attributs peuvent tre
affiches uniquement partir du formulaire Importer, en ouvrant le formulaire Drill up des
attributs. Pour afficher le formulaire Drill up des attributs, cliquez sur le lien dans le champ
Montant de la ligne de dtail et slectionnez Afficher les attributs.

Validation des donnes source


FDM valide les donnes source par rapport aux tables de mappage. Chaque dimension source
doit tre correctement mappe avant le chargement du systme cible. Pour lancer le processus
de validation, cliquez sur le lien Validation dans la partie suprieure de l'cran principal de FDM.
Pour afficher l'cran de validation sans excuter le processus de validation, cliquez sur le lien
Valider dans le menu Workflow.

146 Flux de processus


L'tape de validation compare le mappage des dimensions au fichier de GL import et recherche
la prsence dimensions non mappes. Si un fichier a t import avec des dimensions non
mappes, ces dimensions sont rpertories. Le processus ne peut pas se poursuivre tant que
chaque dimension non mappe n'a pas t mappe une dimension cible.

Formulaire de validation : absence d'erreurs de mappage


Lorsque la validation est russie, un poisson de validation orange s'affiche dans l'en-tte.

Formulaire de validation : prsence d'erreurs de mappage


L'ajout de nouveaux comptes au systme de GL peut gnrer une erreur de validation. La
prsence d'un nouveau compte dans un fichier source peut provoquer une erreur de mappage.
En prsence d'un nouveau compte sans mappage, le poisson de validation est blanc. L'cran de
validation indique le nombre d'lments non mapps, et donc non dfinis.

Le processus de validation affiche le formulaire de validation qui rpertorie les valeurs de


dimension manquantes dans les tables de conversion correspondantes.

Pour corriger les erreurs dans la table de conversion, procdez comme suit :
1 Mettez en surbrillance la ligne corriger.
2 Cliquez sur Corriger.
Le formulaire de mappage s'affiche et l'lment non mapp est ajout dans la colonne Source.
3 Cliquez sur Parcourir et recherchez le mappage source appropri.

Validation des donnes source 147


4 Rptez les tapes 2 et 3 pour corriger chaque lment incorrect.
5 Cliquez sur Valider pour actualiser le formulaire de validation.
Les donnes source qui ont pass le processus de validation peuvent tre charges dans le systme
cible.

Exportation dans le systme cible


Aprs la validation des donnes source, le fichier de chargement est cr.

Pour exporter vers le systme cible, procdez comme suit :


1 Cliquez sur Exporter dans le formulaire principal.
FDM cre le fichier d'exportation (au format requis par le systme cible) et place ce dernier dans
le rpertoire Outbox de l'application.
La bote de dialogue Chargement du systme cible s'affiche.

Remarque :
Pour afficher l'cran d'exportation sans excuter le processus d'exportation, cliquez sur le lien
Exporter dans le menu Workflow.

Les options affiches dans la bote de dialogue Chargement du systme cible sont spcifiques
l'adaptateur (options de chargement du systme cible). Reportez-vous la documentation de
l'application cible pour obtenir des informations sur les options d'exportation de la bote de
dialogue Chargement du systme cible.
2 Cliquez sur OK.

Analyse drill down


Le formulaire d'exportation comporte une fonctionnalit d'analyse drill down. Cliquez sur un
montant dans la grille du formulaire d'exportation pour afficher les comptes source indiquant
le solde de l'lment de ligne cible.

Ajout de mmos et extraction des donnes source


Pour ajouter un mmo ou un document de support sur une ligne de dtail, cliquez dans la
premire colonne d'un enregistrement du formulaire Drill Down. Pour afficher les fichiers,
cliquez avec le bouton droit sur une ligne de dtail et slectionnez l'option souhaite dans le
menu Drill Down. Cette fonctionnalit est identique celle du formulaire d'importation. Pour
plus d'informations, reportez-vous la section Archivage des donnes la page 144.

148 Flux de processus


Drill back partir de Financial Management
Financial Management permet d'effectuer des drill back dans FDM pour afficher la source de
chargement d'une intersection Financial Management. Lorsque des donnes sont affiches dans
Financial Management, cliquez avec le bouton droit sur un montant et slectionnez Audit
Intersection.

Le volet suprieur de la fentre de drill back affiche les sources charges dans l'intersection
Financial Management. Le volet infrieur (onglet Synthse) donne des informations
supplmentaires sur l'lment slectionn dans le volet suprieur.

Exportation dans le systme cible 149


Dans la fentre de drill back, accdez la fentre FDM d'exploration du niveau suprieur en
cliquant sur le montant dans une ligne du formulaire suprieur. Reportez-vous la section
Analyse drill down la page 148 pour obtenir des informations dtailles sur l'utilisation de
la fonction d'exploration du niveau suprieur.

Consolidation du systme cible


Slectionnez Activits > Consolider pour consolider dans le systme cible. FDM excute
galement une consolidation aprs le chargement du systme cible ( condition qu'un groupe
d'entits de validation soit associ l'emplacement). Les entits consolides sont spcifies dans
le groupe d'entits de validation associ l'emplacement actif.

Paramtres de consolidation
Pour activer les consolidations, dfinissez le paramtre Enable Consolidations Configuration
sur Activ via l'option Administration > Paramtres d'intgration > Activer la consolidation.
FDM utilise le groupe d'entits de validation associ l'emplacement FDM pour dterminer les
entits consolides pour un emplacement spcifique. Le PDV en cours dtermine la catgorie
ou la priode du systme cible consolid.

150 Flux de processus


Erreurs de consolidation
FDM consolide uniquement la priode en cours. Si des priodes prcdentes ont t affectes
pour l'entit et la catgorie consolides ou si un autre utilisateur accde une des entits du
chemin de consolidation, une erreur est renvoye.

Validation des donnes du systme cible (Vrifier)


Les rapports de validation FDM extraient des valeurs directement du systme cible, des donnes
FDM source ou des donnes FDM converties. La cration de rapports de validation dpend de
deux composants : un groupe de rgles de validation, qui comprend les lignes du rapport de
validation et un groupe d'entits de validation, qui dtermine les entits cible auxquelles les rgles
de validation s'appliquent.
Les rapports de validation sont produits automatiquement dans le flux du processus de
chargement et peuvent galement tre excuts manuellement. La fonction principale des
rapports consiste permettre aux emplacements de reporting de valider la qualit des
informations envoyes.
Les rsultats du rapport de validation pour les emplacements sont analyss par FDM et une
entre d'tat global est ajoute dans la table de contrle du processus. Pour qu'un emplacement
possde l'tat Vrai dans le cadre de la validation, chaque rgle du rapport de validation doit tre
respecte. Si une rgle est utilise des fins exclusives d'avertissement, aucune logique de rgle
n'est associe la ligne.

Validation des donnes du systme cible (Vrifier) 151


152 Flux de processus
Importation d'autres fichiers de
15 donnes

Dans ce chapitre
Journaux..................................................................................................................................................................153
Fichiers de balance comptable Excel........................................................................................................................158
Fichiers de chargement multiple...............................................................................................................................159

Journaux
Le modle du journal est une feuille de calcul Microsoft Excel mise en forme tel un cran de
saisie d'entres de journal. La feuille de calcul comporte un en-tte compos de mtadonnes
indiquant FDM comment interprter les donnes contenues dans le modle.
Les modles de journaux FDM sont habituellement utiliss dans le cadre des ajustements ci-
dessous :
Ajustements GAAP sur les grands livres
Ventilation des montants bruts des comptes collectifs dans la priode intercalaire (Db.,
Ajout, Supp., Fin)
Saisie de donnes rsiduelles (effectifs, ratios, etc.)
Le modle de journal (journal.xls) se trouve dans le menu Outils > Modles. Un chantillon
du modle de journal se trouve dans le rpertoire \\Hyperion\FDM\<NomAppFDM>\Outbox
\Templates, o NomAppFDM reprsente le rpertoire dans lequel l'application a t cre sur
la machine.

Dfinition d'un modle de journal


Pour dfinir un modle de journal FDM, vous devez dfinir les mtadonnes que FDM utilise
pour interprter les donnes contenues dans le modle. Les mtadonnes sont un ensemble de
balises indiquant quelle colonne contient le numro de compte ou dans quelle priode effectuer
le chargement.
Les balises de mtadonnes doivent tre prsentes sous forme de tableau spcifique. L'ordre
des lignes de mtadonnes est important, contrairement celui des colonnes qui importe peu.
Les cinq premires lignes de donnes (en-tte) contiennent les balises de mtadonnes du tableau
de donnes.

Journaux 153
Le modle de journal prsent ci-dessous contient l'en-tte de mtadonnes (lignes 1 5) et deux
lignes de donnes importes (lignes 6 et 7).

Pour dfinir le modle final dans Excel, vous devez crer un nom de plage qui inclut toutes les
mtadonnes et les cellules de donnes. Le nom de la plage doit commencer par le prfixe ups .
Par exemple, vous pouvez crer un nom de plage pour dfinir un modle standard et le nommer
[upsStandardJV (A1 D7)]

Structure des mtadonnes


L'en-tte de mtadonnes (lignes 1 5) indique comment rechercher les segments de donnes
pertinents partir du modle. Les explications ci-dessous dcrivent comment chaque portion
de mtadonnes est utilise par FDM.

Ligne 1 (ID du journal et balise d'emplacement)


Cette ligne permet de dfinir l'ID du journal et l'emplacement FDM dans lequel les donnes sont
charges. L'ID du journal doit tre plac sur la ligne 1 de la colonne Compte. La balise
d'emplacement doit tre plac sur la ligne 1 de la colonne Montant.

Remarque :
L'ID du journal est limit dix caractres.

Ligne 2 (Balise de catgorie FDM)


Cette ligne permet de dfinir la catgorie FDM que le journal charge. Il doit s'agir d'une catgorie
FDM valide et elle doit tre place dans la colonne Montant.

Ligne 3 (Balise de priode FDM)


Cette ligne dfinit la priode dans laquelle les donnes sont charges. Il doit s'agir d'une priode
FDM valide et elle doit tre place dans la colonne Montant.

Ligne 4 (Balise de mthode de chargement)


Cette ligne dfinit la mthode de chargement du journal dans FDM. Entrez la lettre A pour
ajouter le journal un journal existant portant le mme ID de journal. Si un journal portant le
mme ID de journal existe dans le mme PDV FDM, le nouveau journal est alors ajout celui
envoy prcdemment.

154 Importation d'autres fichiers de donnes


Entrez la lettre R pour remplacer un journal existant portant le mme ID de journal. Si un
journal portant le mme ID de journal existe dans le mme PDV, le nouveau journal remplace
le journal prcdent. Cette balise doit tre place dans la colonne Montant.
Le tableau ci-dessous rpertorie les balises de mtadonnes pouvant tre utilises dans la ligne 4.

Mthode Balise

Ajouter le journal A, Append

Remplacer le journal (par dfaut) R, Replace

Ajouter le journal : suppression des zros AZ

Remplacer le journal : suppression des zros RZ

Balises de dimension
Les balises de la ligne 5 du modle de journal dfinissent les dimensions dans lesquelles les
montants sont chargs. Le tableau ci-dessous rpertorie les balises de dimension.

Tableau 1 Balises de dimension FDM

Dimension Balise

Compte (Obligatoire) A, Account, SrcAcctKey

Centre (Obligatoire) C, Center, SrcCenterKey

Description (Facultatif) D, Description, SrcAcctDesc

Contrepartie IC (Facultatif) I, IC, ICCoParty

Dfinie par l'utilisateur 1 (Facultatif) 1, UD1, UserDefined1

Dfinie par l'utilisateur 2 (Facultatif) 2, UD2, UserDefined2

Dfinie par l'utilisateur 3 (Facultatif) 3, UD3, UserDefined3

Dfinie par l'utilisateur 4 (Facultatif) 4, UD4, UserDefined4

Dfinie par l'utilisateur 5 (Facultatif) 5, UD5, UserDefined5

Dfinie par l'utilisateur 6 (Facultatif) 6, UD6, UserDefined6

Dfinie par l'utilisateur 7 (Facultatif) 7, UD7, UserDefined7

Dfinie par l'utilisateur 8 (Facultatif) 8, UD8, UserDefined8

Dfinie par l'utilisateur 9 (Facultatif) 9, UD9, UserDefined9

Dfinie par l'utilisateur 10 (Facultatif) 10, UD10, UserDefined10

Dfinie par l'utilisateur 11 (Facultatif) 11, UD11, UserDefined11

Dfinie par l'utilisateur 12 (Facultatif) 12, UD12, UserDefined12

Journaux 155
Dimension Balise

Dfinie par l'utilisateur 13 (Facultatif) 13, UD13, UserDefined13

Dfinie par l'utilisateur 14 (Facultatif) 14, UD14, UserDefined14

Dfinie par l'utilisateur 15 (Facultatif) 15, UD15, UserDefined15

Dfinie par l'utilisateur 16 (Facultatif) 16, UD16, UserDefined16

Dfinie par l'utilisateur 17 (Facultatif) 17, UD17, UserDefined17

Dfinie par l'utilisateur 18 (Facultatif) 18, UD18, UserDefined18

Dfinie par l'utilisateur 19 (Facultatif) 19, UD19, UserDefined19

Dfinie par l'utilisateur 20 (Facultatif) 20, UD20, UserDefined20

Montant (Obligatoire) V, Amount, SrcAmount

La capture d'cran ci-dessous reprsente un modle de journal. Notez que dans ce modle les
mtadonnes ne sont pas dans les lignes 1 5, mais dans les lignes 16 20. Le modle dispose
d'une gamme ups commenant partir de la ligne 16. Ainsi, les lignes 16 20 sont les cinq
premires lignes de la gamme ups.
Les lignes 4 14 sont une interface simple permettant aux utilisateurs de crer l'en-tte de
mtadonnes. Les informations concernant les mtadonnes sont entres ici et rfrences par
l'en-tte de mtadonnes.

Le modle de journal peut contenir les dimensions suivantes :


Centre : peut tre le centre du systme source ou cible (obligatoire).
Compte : peut tre le compte du systme source ou cible (obligatoire).
Montant (obligatoire)

156 Importation d'autres fichiers de donnes


Description (facultatif)
Intragroupe (facultatif sauf si cette dimension est en cours d'utilisation par Financial
Management)
Dimensions personnalises UD1-20 (facultatif sauf si la dimension est en cours d'utilisation
par le systme cible)

Validation des donnes du journal

Fonction UpCheck
Avant de charger un modle, FDM recherche dans le modle une fonction VBA personnalise
nomme UpCheck . Cette fonction force la validation des donnes personnalises avant le
chargement (exemple : restriction des utilisateurs des centres ou comptes particuliers que
l'utilisateur peut charger).
Cette fonction doit tre cre dans un nouveau module VBA au sein du modle. Si les conditions
personnalises que vous avez dfinies sont remplies, dfinissez alors la fonction sur
UpCheck=True. L'exemple ci-dessous est celui d'une fonction UpCheck.

-------------------------------------------
Public Function UpCheck() as Boolean
Place your validation code here If Validate = True Then
UpCheck = True
Else
UpCheck = False
End If End Function
-------------------------------------------

Evnements de chargement multiple


Dans l'diteur de script FDM, vous pouvez crire un script de validation dans l'vnement
MultiLoadAction. Cet vnement est excut avant et aprs la publication des journaux. Vous
pouvez valuer le paramtre strEventName pour dterminer quel vnement de chargement
multiple s'excute et crire un script de validation pour stopper le processus. Pour plus
d'informations sur cet vnement, reportez-vous au Chapitre 19, Script .

Traitement d'un modle de journal

Slection d'un journal

Pour slectionner un journal traiter, procdez comme suit :


1 Slectionnez Activits > Journal.
2 Cliquez sur Parcourir, puis slectionnez le journal.

Journaux 157
3 Cliquez sur Ouvrir.

Contrle d'un journal


Un journal doit tre contrl avant d'tre publi. Pour contrler un journal, cliquez sur
Contrler dans le coin suprieur droit de l'cran. FDM traite alors les balises de mtadonnes
du modle.
FDM examine tout d'abord le modle pour les noms de plage commenant par le prfixe ups .
Il examine et valide ensuite les balises de mtadonnes trouves dans chaque nom de plage
ups . Si un segment des mtadonnes d'une plage donne n'est pas valide, FDM ne contrle
pas ce segment et une erreur est ajoute la grille des erreurs de traitement.

Publication d'un journal


Aprs avoir control le journal, cliquez sur Publier pour envoyer le journal. La publication d'un
journal ajoute ou remplace les donnes dans l'cran Importer en fonction de la mthode de
chargement spcifie dans le modle de journal.

Scurit du journal
Les administrateurs et les utilisateurs finaux FDM ne peuvent publier les journaux que dans le
point de vue FDM gnral, moins que l'option Verrouillage du PDV ne soit dsactive.

Fichiers de balance comptable Excel

Prsentation
Une balance comptable Excel est une feuille de calcul Excel mise en forme selon une priode,
une catgorie et un emplacement uniques via l'cran Importer standard. Le modle Excel et le
fichier texte requirent des balises d'en-tte permettant d'indiquer FDM comment interprter
les donnes.

Chargement d'un fichier texte de balance comptable par


opposition au chargement d'un fichier Excel de balance
comptable
Lors de l'importation de fichiers texte standard et de balances comptables Excel, les deux types
de fichiers sont chargs dans le PDV en cours (catgorie et priode). De plus, les fichiers de
balance comptable Excel utilisent les mmes options Ajouter et Remplacer du formulaire
Importer que le fichier texte standard. Cependant, alors que les importations de fichier texte
doivent respecter le format d'importation standard de l'emplacement, chaque balance

158 Importation d'autres fichiers de donnes


comptable peut tre configure diffremment, dans la mesure o elle respecte la dfinition
correcte des modles Excel.

Dfinition d'un modle de balance comptable Excel


Pour dfinir un modle de balance comptable Excel, vous devez dfinir les mtadonnes que
FDM utilise pour interprter les donnes du modle. Les mtadonnes sont un ensemble de
balises indiquant FDM quelle colonne contient le numro de compte ou dans quelle priode
effectuer le chargement.
Les balises de mtadonnes doivent tre prsentes sous forme de tableau spcifique (en-tte de
mtadonnes). L'ordre des lignes de mtadonnes est important, contrairement celui des
colonnes qui importe peu. La premire ligne des donnes doit contenir les balises de
mtadonnes.
Le modle prsent dispose d'une ligne de mtadonnes (ligne 1) et de trois lignes de donnes
importes (lignes 5 7).

Structure des mtadonnes


L'en-tte de mtadonnes (ligne 1) dtermine comment trouver les segments de donnes
pertinents utiliss dans ce modle.

Ligne 5 (Balises de dimension)


Les balises de la ligne 5 dfinissent les donnes de dimension dans la colonne. Pour plus
d'informations sur les dimensions, reportez-vous la Tableau 1 la page 155.

Fichiers de chargement multiple


Un fichier de chargement multiple est une feuille de calcul Excel ou un fichier texte mis en forme
pour charger des priodes, des catgories et des emplacements multiples. Le modle requiert des
balises d'en-tte indiquant FDM comment interprter les donnes du modle.
Les modles de chargement multiple FDM sont gnralement utiliss pour le type de donnes
ci-dessous :
Collecte des donnes de plan (budget, prvision, etc.)

Fichiers de chargement multiple 159


Chargement des donnes d'historique
Maintenance des donnes administrateur

Chargement multiple de fichiers texte par opposition au


chargement multiple de fichiers Excel
En fonction de la quantit de donnes, FDM traite un fichier texte de chargement multiple plus
rapidement qu'un fichier Excel. Ainsi lors du traitement d'un fichier texte, FDM cre un fichier
de chargement unique et consolide une plage de priodes. Lors du traitement d'un fichier Excel,
FDM cre des fichiers de chargement distincts pour chaque priode et consolide une priode
la fois.

Dfinition des modles de chargement multiple


Pour dfinir un modle de chargement multiple FDM, vous devez dfinir les balises de
mtadonnes que FDM utilise pour interprter les donnes contenues dans le modle. Les balises
de mtadonnes dfinissent les colonnes que FDM va importer.
Les balises de mtadonnes du modle doivent tre prsentes sous forme de tableau spcifique.
L'ordre des lignes des balises de mtadonnes est important, contrairement celui des colonnes
qui importe peu. Les cinq premires lignes de donnes (pour les modles Excel) ou les six
premires lignes (pour les modles de fichier texte) doivent contenir les balises de mtadonnes.
Le modle Excel prsent dispose de cinq lignes de balises de mtadonnes et de quatre lignes
de donnes importes. Les lignes 1 5 contiennent les balises de mtadonnes et les lignes 8
11 contiennent les donnes.

Pour dfinir le modle final dans Excel, vous devez crer un nom de plage qui inclut toutes les
mtadonnes et les cellules de donnes. Le nom de la plage doit commencer par le prfixe ups .
Dans cet exemple, la plage est cre et nomme [upsBudget (A1 K11)].
Le fichier texte prsent ci-dessous dispose de six lignes de mtadones et de quatre lignes de
donnes importes. Les lignes 1 5 contiennent les balises de mtadonnes et les lignes 7 10
contiennent les donnes. Quel que soit le sparateur des dimensions de la ligne 6, il doit tre
utilis galement comme sparateur des donnes. Les sparateurs accepts sont la virgule, le
point-virgule, la barre verticale (|), la tabulation et le point d'exclamation.

1 Texas

160 Importation d'autres fichiers de donnes


2 Budget

3 01/31/2004

4 12

5 R,N,Y

6 A,C,D,V,V,V,V,V,V,V,V,V,V,V,V

7 1100,TX,Cash In Bank, 43,016 , 43,451 , 43,890 , 44,333 , 44,781

8 1100-101-000-00,TX,Dallas National Bank, 1,791 , 1,809 , 1,827 , 1

9 1100-102,TX,Houston Bank One, 5,959 , 6,020 , 6,080 , 6,142 , 6,

10 1100-103,TX,Midland Bank & Trust, 98,487 , 99,482 , 100,487 , 101,

11 1100-104,TX,First National Bank, (8,953), (9,044), (9,135), (9,227

12 1190,TX,Petty Cash, 448 , 452 , 457 , 461 , 466 , 471 , 475 , 480 , 485 ,

Structure des balises de mtadonnes


L'en-tte de mtadonnes (lignes 1 5 pour les modles Excel, lignes 1 6 pour les modles de
fichier texte) indique FDM comment rechercher les segments de donnes pertinents dans le
corps du modle.

Ligne 1 (Balises d'emplacement) : valide pour les colonnes Montant uniquement


Cette balise dfinit l'emplacement FDM dans lequel les donnes sont charges. Le nom de
l'emplacement doit tre celui d'un emplacement FDM.

Ligne 2 (Balises de catgorie) : valide pour les colonnes Montant uniquement


Ces balises dfinissent la catgorie FDM dans laquelle les donnes sont charges. Il doit s'agir
d'une catgorie FDM valide.

Ligne 3 (Balises de priode) : valide pour les colonnes Montant uniquement


Cette balise dfinit la priode FDM dans laquelle les donnes sont charges. Il doit s'agir d'une
priode FDM valide.

Ligne 4 (Balise du nombre de priodes) : modles de fichier texte uniquement


Cette balise dfinit le nombre de priodes (colonnes de donnes) devant tre charges. Cette
balise est associe la balise de priode de dbut pour dfinir la cl de priode relle utilise dans
le chargement. Cette balise n'est utilise que pour les modles de chargement multiple de fichiers
texte et doit tre place sur la ligne 4.

Fichiers de chargement multiple 161


Ligne 4/Ligne 5 (Balises de contrle de chargement) : modles Excel et fichiers texte
Les balises de contrle de chargement permettent de contrler les mthodes de chargement de
FDM et du systme cible. Les balises de contrle de chargement dpendent du systme cible que
FDM est en train de charger. Lorsque vous utilisez un modle Excel, ces balises doivent tre
placs sur la ligne 4 et lorsque vous utilisez un modle de fichier texte, ces balises doivent tre
places sur la ligne 5. Le tableau ci-dessous rpertorie les balises de contrle de chargement
pouvant tre utilises par FDM. Utilisez une virgule pour sparer les balises de chargement.

Nom des balises de contrle de


N balise de chargement chargement Description

1 Mthode de chargement FDM Mthode de chargement FDM

2 Mthode de chargement du systme cible Mthode de chargement du systme cible

3 Zone de liste 1 Varie en fonction de l'adaptateur


d'intgration

4 Zone de liste 2 Varie en fonction de l'adaptateur


d'intgration

5 Zone de liste 3 Varie en fonction de l'adaptateur


d'intgration

6 Case cocher Calc Active le calcul (O/N)

7 Case cocher 1 Varie en fonction de l'adaptateur


d'intgration (O/N)

8 Case cocher 2 Varie en fonction de l'adaptateur


d'intgration (O/N)

9 Case cocher 3 Varie en fonction de l'adaptateur


d'intgration (O/N)

10 Vue des donnes Spcifie si les donnes en cours de


chargement sont des donnes cumules,
priodiques ou cumules par trimestre

Balises de contrle de chargement Financial Management (Fichier Excel de chargement


multiple)
Les tableaux ci-dessous dtaillent les balises de contrle de chargement spcifiques Financial
Management. Financial Management n'utilise pas les balises n4, 5, 6 et 9. A la place de ces balises
inutilises, vous devez insrer une virgule. Si une balise Financial Management est manquante
(n2, 3, 7 ou 8), FDM tiendra compte des options de chargement de donnes par dfaut dfinies
dans les Paramtres d'intgration. La valeur par dfaut de la balise n1 est Replace et la valeur
par dfaut de la balise n10 est YTD .

Balise de chargement n1 : balise de mthode de chargement FDM Balise

Ajouter A

162 Importation d'autres fichiers de donnes


Balise de chargement n1 : balise de mthode de chargement FDM Balise

Remplacer (par dfaut) R

Ajouter : suppression des zros AZ

Remplacer : suppression des zros RZ

Balise de chargement n2 : mthode de chargement Financial Management Balise

Fusionner M, Merge

Remplacer R, Replace

Remplacer par la scurit RS

Cumuler A, Accumulate

Balise de chargement n3 : Processus de chargement Financial Management Balises valides

Chargement 0, Load

Analyse 1, Scan

Balise de chargement n4 :

Non utilise

Balise de chargement n5 :

Non utilise

Balise de chargement n6 :

Non utilise

Balise de chargement n7 : Cumuler dans le fichier Balise

Oui Y, Yes, True, T

Non N, No, False, F

Balise de chargement n8 : fichier comportant des donnes partages Balise

Oui Y, Yes, True, T

Non N, No, False, F

Fichiers de chargement multiple 163


Balise de chargement n9 :

Non utilise

Balise de chargement n10 : Vue des donnes Balise

Cumul (par dfaut) Y, YTD, Year-To-Date

Priodique P, Per, Periodic

Cumule par trimestre Q, QYTD, Qtr

Semestrielle H, HYTD, Half-Year

Remarque :
Vous pouvez crer une colonne Vue des donnes sur la ligne 5 (Modle de fichier Excel) ou sur
la ligne 6 (Modle de fichier texte) de faon ce que chaque ligne de donnes possde sa propre
balise de vue des donnes. L'exemple de modle prcdent prsente une colonne Vue des
donnes. Si aucune balise de vue des donnes n'est dfinie dans l'en-tte et qu'aucune colonne
Vue des donnes n'existe, la vue des donnes est dfinie par dfaut sur la valeur YTD .

Exemple de balises de contrle de chargement Financial Management (chargement multiple)


Cet exemple propose une balise pour chaque lment de contrle de chargement. Notez que les
virgules sont obligatoires en remplacement des balises non utilises (balises n4, 5, 6 et 9).
R,M,0,,,,Y,N,,YTD

Dans cet exemple, FDM utilise les paramtres de chargement par dfaut Financial Management
dfinis dans les Paramtres d'intgration car seule la balise de mthode de chargement FDM
(Ajouter) est prcise. La balise de vue des donnes (balise n10) est dfinie par dfaut sur la
valeur YTD. Il n'est pas ncessaire d'ajouter de virgules aprs le dernier argument fourni.
A

Dans l'exemple ci-dessous, seule la mthode de chargement FDM (Remplacer) et la mthode de


chargement Oracle's Hyperion Financial Management System 9 (Fusionner) sont prcises.
Les autres balises prennent les valeurs par dfaut dfinies dans les Paramtres d'intgration.
R,M

Balises de contrle de chargement Hyperion Enterprise (chargement multiple)


Les tableaux ci-dessous rpertorient les balises de contrle de chargement spcifiques Oracle's
Hyperion Enterprise. Hyperion Enterprise n'utilise pas les balises de chargement n5, 6, 8, 9
et 10. Vous devez remplacer ces dernires par une virgule. Si une balise Hyperion Enterprise est
manquante (n2, 3, 4 ou 7), FDM tiendra compte des options de chargement de donnes par
dfaut dfinies dans les Paramtres d'intgration. La valeur par dfaut de la balise n1 est
Replace .

164 Importation d'autres fichiers de donnes


Balise de chargement n1 : Mthode de chargement FDM Balise

Ajouter A

Remplacer (par dfaut) R

Ajouter : suppression des zros AZ

Remplacer : suppression des zros RZ

Balise de chargement n2 : Mthode de chargement Hyperion Enterprise Balise

Fusionner M, Merge

Remplacer R, Replace

Cumuler A, Accumulate

Balise de chargement n3 : Vue des donnes Balise

Catgorie C, Cat, Category

Priodique P, Per, Periodic

Cumule Y, YTD, Year-To-Date

Balise de chargement n4 : Echelle Balise

Aucune N, -1, None

Units U, 0, Units

Dizaines T, 1, Tens

Centaines H, 2, Hundreds

Milliers TH, 3, Thousands

Dizaines de milliers T-TH, 4, Ten Thousands

Centaines de milliers H-TH, 5, Hundred Thousands

Millions ML, 6, Millions

Dizaines de millions T-ML, 7, Ten Millions

Centaines de millions H-ML, 8, Hundred Millions

Milliards B, 9, Billions

Balise de chargement n5

Non utilise

Fichiers de chargement multiple 165


Balise de chargement n6

Non utilise

Balise de chargement n7 : Zro Pas de donnes Balise

Oui Y, Yes, True, T

Non N, No, False, F

Balise de chargement n8

Non utilise

Balise de chargement n9

Non utilise

Balise de chargement n10

Non utilise

Exemple de balises de contrle de chargement Hyperion Enterprise (chargement multiple)


L'exemple ci-dessous rpertorie une balise de mtadonnes pour chacun des lments de
contrle de chargement. Notez que les balises de chargement non utilises doivent tre
remplaces par des virgules (balises n5 et 6) Il n'est pas ncessaire d'ajouter des virgules aprs
le dernier argument fourni.
R,M,C,N,,,Y

Dans cet exemple, FDM utilise les paramtres de chargement par dfaut Hyperion Enterprise
dfinis dans les Paramtres d'intgration car seule la balise de mthode de chargement FDM
(Ajouter) est prcise.
A

Dans l'exemple ci-dessous, seule la balise de mthode de chargement FDM (Remplacer) et la


balise de mthode de chargement Hyperion Enterprise (Fusionner) sont prcises. Les autres
balises prennent les valeurs par dfaut dfinies dans les Paramtres d'intgration.
R,M

Balises de dimension
Ces balises dfinissent les donnes de dimension pouvant apparatre dans la colonne. Pour plus
d'informations sur les balises de chargement pouvant tre utilises dans l'en-tte de
mtadonnes, reportez-vous la Tableau 1.
Les dimensions doivent tre spares par un sparateur autoris. Quel que soit le sparateur des
dimensions de la liste, il doit tre utilis galement comme sparateur des donnes. Les
sparateurs accepts sont les suivants : virgule, point-virgule, barre verticale (|), tabulation et
point d'exclamation (!).

166 Importation d'autres fichiers de donnes


Remarque :
Si vous chargez des mmos partir du fichier de chargement multiple, le mmo est indiqu sur
cette ligne pour chaque mois.

Validation des donnes du modle Excel de chargement


multiple

Fonction UpCheck
Avant de charger un modle Excel de chargement multiple, FDM recherche dans le modle une
fonction VBA personnalise nomme UpCheck . Cette fonction permet de forcer les
validations de donnes personnalises avant le chargement (en d'autres termes, de restreindre
les catgories et les priodes que l'utilisateur peut charger). Cette fonction doit tre cre dans
un nouveau module VBA au sein du modle. Si les conditions personnalises que vous avez
dfinies sont remplies, dfinissez alors la fonction sur UpCheck=True. L'exemple ci-dessous est
celui d'une fonction UpCheck :

-------------------------------------------
Public Function UpCheck() as Boolean Place your validation code here
If Validate = True Then
UpCheck = True
Else
UpCheck = False
End If
End Function
-------------------------------------------

La capture d'cran ci-dessous est celle d'un modle Excel de chargement multiple.

Fichiers de chargement multiple 167


Evnements de chargement multiple
Vous pouvez crire un script de validation dans l'vnement MultiLoadAction. Cet vnement
s'excute avant et aprs chaque vnement au cours du processus de chargement multiple. Vous
pouvez valuer le paramtre strEventName pour dterminer quel vnement de chargement
multiple s'excute et crire un script de validation pour stopper le processus. Pour plus
d'informations sur cet vnement, reportez-vous au Chapitre 19, Script .

Contrle d'un fichier de chargement multiple


Le contrle d'un fichier de chargement multiple invite FDM traiter les balises de mtadonnes
dans le modle. Pour contrler un modle, cliquez sur le bouton Contrler, puis recherchez le
modle de fichier de chargement multiple Excel ou texte.
L'arborescence situe sur le ct gauche contient tous les ensembles de donnes traites. La
section Dtails du traitement situe sur la partie droite affiche les erreurs de validation et les
erreurs de rapport de validation au cours des processus de validation et de contrle.
Aprs avoir archiv un fichier de chargement multiple, le PDV FDM passe au mode Local. Pour
cet utilisateur, le PDV local est modifi pour chacun des PDV d'ensemble de donnes sur lesquels
l'utilisateur clique dans l'arborescence. Le passage au mode local vous permet de corriger les
erreurs de validation au cours du processus de validation et de visualiser les erreurs de rapport
de validation au cours du processus de contrle. Lorsque le formulaire de chargement multiple
est ferm, le PDV FDM passe nouveau en mode Global.
Si un segment des mtadonnes n'est pas valide, FDM n'archive pas ce segment et une erreur
est ajoute la grille des erreurs de traitement.
Dans l'onglet Tlcharger le fichier, cliquez sur Parcourir pour rechercher le fichier de
chargement multiple, puis slectionnez le fichier dans la fentre et cliquez sur Ouvrir. Le fichier
de chargement multiple peut tre un fichier texte (.txt) ou un fichier Excel (.xls).
Si le fichier a t tlcharg depuis l'onglet Tlcharger le fichier, il doit tre archiv. Cliquez sur
Contrler dans la partie suprieure droite de l'cran. Si le fichier de chargement multiple a t
tlcharg l'aide de l'option Slectionner un fichier dans la bote de rception, l'tape de
contrle n'est pas obligatoire.

Importation d'un fichier de chargement multiple


Aprs avoir contrl un modle de chargement multiple, vous pouvez l'importer en cliquant sur
le bouton Importer. L'importation d'un modle entrane l'criture des donnes dans le tableau
des emplacements FDM. En cas d'erreur, l'icne apparat dans l'arborescence situe sur le
ct gauche.

168 Importation d'autres fichiers de donnes


Validation d'un fichier de chargement multiple
Aprs avoir import un modle de chargement multiple, vous pouvez le valider en cliquant sur
le bouton Valider. La validation d'un modle permet de vrifier que tous les membres d'une
dimension existent dans leur table de mappage respective.

Vous pouvez visualiser les erreurs de validation de mappage en cliquant sur l'icne . Les
membres non mapps sont indiqus dans la grille Dtails du traitement sur le ct droit.
Tous les membres non mapps du fichier de chargement multiple doivent tre ajouts
manuellement. Pour ajouter les membres non mapps leur table de mappage respective, cliquez
sur le lien Mappages sous Activits. Poursuivez le mappage d'un membre non valide vers un
membre cible.

Remarque :
La table de mappage affiche est celle de l'emplacement de PDV en cours. Il se peut que cet
emplacement soit diffrent de celui en cours de chargement dans le fichier de chargement
multiple. Vrifiez toujours l'emplacement en cours avant de raliser les modifications de
mappage.

Chargement d'un fichier de chargement multiple


Aprs avoir valid un modle de chargement multiple, cliquez sur le bouton Exporter pour
l'exporter et le charger dans le systme cible. Lors du traitement d'un fichier texte de chargement
multiple, un fichier de chargement unique est cr et charg dans le systme cible. Lors du
traitement d'un fichier Excel de chargement multiple, un fichier de chargement distinct est cr
et charg pour chaque priode. En cas d'erreur, l'icne apparat dans l'arborescence situe
sur le ct gauche.

Consolidation d'un fichier de chargement multiple


Aprs avoir export et charg un modle de chargement multiple vers le systme cible, cliquez
sur le bouton Consolider pour lancer une consolidation pour chaque priode. En cas d'erreur,
l'icne apparat dans l'arborescence situe sur le ct gauche.

Excution de rapports de validation pour un fichier de


chargement multiple
Aprs avoir consolid un modle de chargement multiple, cliquez sur le bouton Vrifier pour
lancer les rapports de validation pour chaque priode. Les rapports de validation pour chaque
priode sont traits en arrire-plan.

Fichiers de chargement multiple 169


Cliquez sur l'icne pour chaque priode afin de visualiser les comptes dont le rapport de
validation n'a pas t accept. Les comptes n'ayant pas t valids apparaissent dans la grille
Dtails du traitement sur la droite.

Scurit du chargement multiple


Les utilisateurs finaux FDM peuvent charger un fichier de chargement multiple vers n'importe
quelle priode ou catgorie FDM, dans la mesure o ils ont un droit d'accs l'emplacement de
chargement concern. Les administrateurs FDM peuvent charger un fichier de chargement
multiple vers n'importe quel emplacement, priode ou catgorie.

Champs de donnes de chargement multiple


Tous les champs de donnes de montant doivent contenir une valeur. Les champs de montant
doivent contenir la valeur zro (0) s'ils ne contiennent pas d'autre valeur. En cas de champ de
montant vide dans le modle de chargement multiple, le processus de chargement multiple
chouera.

170 Importation d'autres fichiers de donnes


Rapports
16
Dans ce chapitre
Excution de rapports..............................................................................................................................................171
Gestion des rapports................................................................................................................................................172

Excution de rapports
Pour excuter un rapport, procdez comme suit :
1 Dans le client Web FDM, slectionnez Analyse > Rapports.
L'cran Rapports s'affiche.
2 Dans la zone Groupes, slectionnez le groupe de rapports afficher.
La bote de dialogue Rapports rpertorie les rapports associs au groupe de rapports en cours.
3 Slectionnez le format de sortie du rapport en cliquant dans le menu situ dans la partie suprieure droite
de l'cran.
4 Cliquez deux fois sur Publier.
5 Entrez les valeurs des paramtres (si vous y tes invit).

Afficheur de rapports

Navigation
Vous pouvez parcourir les pages des rapports en cliquant sur les boutons >> ou <<. Pour
rechercher une valeur dans un rapport, cliquez sur le bouton Rechercher, entrez le texte dans le
champ de recherche et cliquez sur Rechercher.

Affichage
Pour effectuer un zoom avant ou arrire, utilisez le menu droulant proposant plusieurs options
de zoom. L'afficheur de rapports peut galement tre redimensionn en fonction de la zone
affichable.

Excution de rapports 171


Impression et exportation
Pour imprimer le contenu d'un onglet, cliquez sur le bouton Imprimer. L'option qui consiste
exporter le rapport dans un fichier externe doit tre slectionne avant l'excution du rapport.
Pour slectionner le format d'exportation dans l'cran Rapports, slectionnez le menu en regard
du bouton Publier, entrez les paramtres ncessaires et cliquez sur Publier.

Gestion des rapports


Dans Workbench, slectionnez l'onglet Rapports pour modifier et crer des rapports. FDM
intgre un outil de cration de rapports qui permet de crer des rapports actifs. La cration et
l'intgration de rapports ncessite une excellente connaissance de la syntaxe SGBDR et le
composant Active-X Data Window de FDM Software.

Modification des descriptions


Pour grer les descriptions des groupes de rapports, les descriptions de rapports et les
descriptions de paramtres dans cet cran, cliquez avec le bouton droit sur le rapport concern
et slectionnez Proprits de dfinition du rapport pour modifier la description du rapport.
Cette fonction permet d'attribuer des noms explicites aux composants, et ne ncessite pas de
connaissances avances en matire de composants de reporting FDM.

Rapports du moniteur de processus


Dans l'onglet Rapports, dveloppez le groupe de rapports du moniteur de processus et
slectionnez le rapport de moniteur de processus. Ce rapport rpertorie les emplacements ainsi
que leur situation dans le processus de conversion des donnes. Cela est utile pour contrler
l'tat du processus de fermeture. Ce rapport est horodat afin de pouvoir dterminer quels
emplacements ont charg des donnes quel moment.

Conception de rapports
Pour afficher ou modifier un rapport actif, cliquez avec le bouton droit sur le rapport et
slectionnez Conception de rapports. Cette fonction permet de crer et de modifier des rapports.
Cette procdure ncessite une excellente connaissance des composants de reporting FDM.

Configuration de la scurit des groupes de rapports


Les groupes de rapports peuvent tre associs un niveau de scurit qui restreint l'accs aux
seuls utilisateurs dont le niveau de scurit autorise l'accs au groupe de rapports. La scurit
des groupes de rapports fonctionne de la mme manire que la scurit des objets d'application.

172 Rapports
Pour associer un niveau de scurit un groupe de rapports, procdez comme suit :
1 Dans Workbench, cliquez sur l'onglet Rapports.
Les rapports sont affichs dans le volet gauche du bureau Workbench.
2 Cliquez avec le bouton droit sur un groupe de rapports et slectionnez Proprits.
3 Dans Niveau de scurit, slectionnez le niveau minimum pour le groupe de rapports.
4 Cliquez sur OK.
Le niveau de scurit associ un groupe de rapports est valu par rapport au niveau de scurit
d'application qui est affect l'utilisateur final. L'accs aux rapports est ensuite attribu aux
utilisateurs dont le niveau de scurit d'application est infrieur ou gal au niveau associ au
rapport.
La scurit des rapports de l'Explorateur de processus peut tre dfinie individuellement selon
les rapports. Le niveau de scurit se dfinit de la mme manire, sauf que vous devez cliquer
avec le bouton droit sur un rapport, au lieu d'un groupe de rapports, pour modifier l'accs des
utilisateurs.

Gestion des rapports 173


174 Rapports
Chargeur de lots
17
Dans ce chapitre
Prsentation............................................................................................................................................................175
Prparation des fichiers du chargeur de lots.............................................................................................................175
Utilisation du chargeur de lots..................................................................................................................................176
Scripts du chargeur de lots......................................................................................................................................178

Prsentation
Le chargeur de lots s'excute partir de FDM Workbench ou du gestionnaire de tches FDM.
L'cran Traitement par lots permet de crer et d'excuter des scripts commandes. Les lots
excuts partir de l'cran Traitement par lots peuvent tre contrls afin de visualiser
l'avancement.

Remarque :
Le chargeur de lots est une fonctionnalit payante. Contactez votre reprsentant Hyperion pour
plus d'informations sur le prix du chargeur de lots.

Prparation des fichiers du chargeur de lots


Les fichiers de donnes doivent tre placs au format adapt dans des rpertoires spcifiques,
afin que le chargeur de lots puisse les localiser et les charger. Il existe deux rpertoires
d'exploitation des fichiers. L'un d'eux est utilis pour le traitement par lots des fichiers texte
standard, et l'autre pour le traitement par lots des fichiers chargement multiple.

Format des noms de fichiers


Les fichiers de lot de traitement standard doivent tre crs au format FDM correspondant. Le
nom de fichier est analys dans cinq segments diffrents : ID du fichier, Emplacement, Catgorie,
Priode et Mthode de chargement.
ID du fichier : Champ au format libre qui permet de contrler l'ordre de chargement des
fichiers de lot. Les fichiers de lot sont chargs dans l'ordre alphabtique par nom de fichier.
Pour qu'un fichier spcifique soit charg en premier, dfinissez l'ID du fichier l'aide d'une

Prsentation 175
valeur infrieure aux autres ID de fichiers du lot (par exemple,
a_Texas_Actuel04_Jan-2004_RR.txt / b_Texas_Actuel04_Jan-2004_RR.txt ).
Emplacement : Nom de l'emplacement FDM charger.
Catgorie : Nom de la catgorie FDM.
Priode : Nom de la priode FDM.
Mthode de chargement : Bascule deux caractres. Premier caractre = Ajouter/Remplacer
FDM (valeurs possibles : A ou R) ; deuxime caractre = Ajouter/Remplacer cible (valeurs
possibles : A ou R).
Exemple de nom de fichier format = a_Texas_Actuel04_Jan-2004_RR.txt .

Emplacement des fichiers de lot


Les fichiers standard charger l'aide du chargeur de lots doivent tre placs dans le rpertoire
OpenBatch du sous-rpertoire Inbox\Batches de l'application. Aprs le traitement du lot, un
nouveau dossier est cr et les fichiers du rpertoire OpenBatch sont dplacs dans ce nouveau
dossier. Le nouveau dossier est associ un ID de lot unique rfrenc dans le journal
d'importation.

Format des noms de fichiers chargement multiple


Les fichiers chargement multiple ne requirent pas de format spcifique. Les fichiers
chargement multiple contiennent des mtadonnes. Par consquent, ces fichiers doivent
simplement tre placs dans un rpertoire distinct.

Rpertoire de lots de fichiers chargement multiple


Les fichiers standard chargs l'aide du chargeur de lots doivent tre placs dans le rpertoire
OpenBatchML du sous-rpertoire Inbox\Batches de l'application. Aprs le traitement du lot,
un nouveau dossier est cr et les fichiers du rpertoire OpenBatch sont dplacs dans ce
nouveau dossier. Le nouveau dossier est associ un ID de lot unique rfrenc dans le journal
d'importation, et reoit le prfixe ML pour indiquer qu'il s'agit d'un lot chargement multiple.

Utilisation du chargeur de lots


Pour lancer le processus de chargement de lots, procdez comme suit :
1 Crez les fichiers de lot avec un nom au format appropri et placez-les dans le rpertoire FDM correspondant.
2 Lancez le processus de chargement de lots en procdant d'une des manires suivantes :
Dans Workbench, slectionnez Outils > Traitement par lots.
Dans le Gestionnaire de tches, slectionnez Dmarrer > Programmes > Hyperion >
Financial Data Quality Management > Gestionnaire de tches > Gestionnaire de tches.

176 Chargeur de lots


L'cran Traitement par lots s'affiche.
3 Dfinissez les commandes applicables aux lots.
Reportez-vous la section suivante.
4 Cliquez sur Excuter ou sur Crer un script.
Reportez-vous la section suivante pour obtenir des informations dtailles sur ces options.

Commandes applicables aux lots


Type de lot : Dtermine si le lot en cours d'excution est un lot standard ou chargement
multiple. Les fichiers de lot standard s'tendent sur un mois et sont normalement chargs par
l'intermdiaire de l'cran d'importation. Les fichiers de lot chargement multiple sont des
fichiers texte ou Excel contenant plusieurs priodes et emplacements.
Niveau de traitement : Dtermine le niveau de traitement excuter. Vous pouvez crer un lot
uniquement pour importer des fichiers, pour traiter des fichiers, pour excuter l'tape du rapport
de vrification ou toute autre tape intermdiaire.
Mthode de traitement : Dtermine si le lot est charg en mode srie ou parallle. Les lots en
srie traitent les fichiers de manire squentielle, l'un aprs l'autre. Les lots en parallle traitent
plusieurs fichiers simultanment.
Nb de processus parallles : Dtermine le nombre de processus utiliss simultanment par le lot
en mode de traitement parallle. Les fichiers de chaque processus sont excuts dans un lot en
srie.
Exemple :
Si le lot traiter contient 20 fichiers, et si le Nb de processus parallles est dfini sur la valeur 5,
cinq processus (chacun contenant quatre fichiers) seront excuts de manire squentielle.

Remarque :
Lors du traitement de fichiers de lot en parallle, FDM regroupe dans le mme processus les
fichiers qui se chargent dans le mme emplacement FDM. De cette manire, deux processus ne
peuvent pas tenter de charger des donnes dans un mme emplacement au mme moment, ce
qui pourrait gnrer des rsultats incorrects.

Equilibrage serveur : Permet l'administrateur de slectionner un serveur d'quilibrage de


charge configur dans le groupe de serveurs d'quilibrage de charge de Workbench. Il s'agit du
serveur d'quilibrage de charge utilis pour traiter le lot.
Correction automatique du mappage : Permet d'activer ou de dsactiver la correction
automatique du mappage pour le lot slectionn. Ce paramtre s'applique tous les fichiers du
lot trait. FDM peut mapper automatiquement tout lment des fichiers de chargement de lot
non inclus dans les mappages de dimensions. Les membres non mapps font l'objet d'une
nouvelle entre dans le mappage de l'emplacement, selon un compte temporaire prdtermin.
Pour dfinir le compte temporaire, un nouvel emplacement nomm AutoMapCorrect doit tre
ajout l'application FDM. Aprs avoir ajout cet emplacement, une nouvelle entre de mappage

Utilisation du chargeur de lots 177


doit tre cre dans le mappage explicite pour chaque dimension. La valeur source du mappage
doit tre nomme AutoCorrect et la valeur cible peut tre tout membre valide de la dimension.
Ces entres de mappage sont la base du mappage automatique de tous les membres non mapps
d'un chargement par lot.
Sparateur de noms de fichier : Dfinit le caractre utilis dans les noms des fichiers de lot
standard pour sparer les cinq segments du nom de fichier. Dans un traitement par lots standard,
le nom de fichier doit tre configur de manire prdfinie pour permettre FDM de dterminer
l'emplacement, la catgorie, la priode, la mthode de chargement et l'ordre de traitement. Le
fait de dfinir ces paramtres dans le nom de fichier permet FDM de traiter les fichiers de lot
de manire autonome. Dans le cas de fichiers de lot chargement multiple, il n'est pas ncessaire
de dfinir cette option, car les paramtres de traitement de fichiers chargement multiple sont
stocks dans le fichier lui-mme.
Excuter : Lance le processus de lots avec les paramtres slectionns. La section Suivi des lots
rpertorie les fichiers en cours de traitement et s'actualise l'aide des rsultats de chaque fichier.
Crer un script : Cre un script de traitement par lots avec les paramtres slectionns. FDM
invite l'utilisateur entrer un nom de script lorsqu'il slectionne ce bouton. Le script peut ensuite
tre ajout une tche planifie pour tre excut automatiquement.

Rsultats de l'cran Traitement par lots


Lors du traitement d'un lot dans l'cran Traitement par lots, le champ Suivi des lots affiche les
rsultats du lot. Les rsultats sont affichs au format graphique. Chaque lot termin comporte
un symbole qui permet l'administrateur de diffrencier les processus qui ont chou de ceux
qui ont abouti.

Etats de traitement

Corrig automatiquement : Une correction automatique est applique au processus.

Russi : Le processus s'est termin avec succs.

Echec : Le processus a chou lors d'une ou plusieurs tapes.

PDV incorrect : Le processus est charg dans une priode, une catgorie ou un
emplacement incorrects.

Scripts du chargeur de lots


Outre le lancement du processus dans Workbench, vous pouvez excuter le chargeur de lots
l'aide d'un environnement de script. Pour excuter le processus de chargement de lots
manuellement ou partir du Gestionnaire de tches, vous devez crer un script de chargement
de lots. Vous pouvez crer le script manuellement en copiant les scripts ci-aprs, ou partir de
l'cran Traitement par lots (section prcdente).

178 Chargeur de lots


Script de chargement de lots standard
Sub BatchLoad()
--------------------------------------------------------------------------
---
FDM Custom Script:

Created By: ADMIN


Date Created: 3/24/2006 09:00

Purpose: Execute a STANDARD Serial Processing FDM Batch


--------------------------------------------------------------------------
---
Declare Local Variables
Dim lngProcessLevel
Dim strDelimiter
Dim blnAutoMapCorrect
Initialize Variables
lngProcessLevel = 12 Up-To-Check
strDelimiter = _
blnAutoMapCorrect = 0
Create the file collection
Set BATCHENG.PcolFiles = BATCHENG.fFileCollectionCreate(CStr(strDelimiter))
Execute a Standard Serial batch
BATCHENG.mFileCollectionProcess BATCHENG.PcolFiles, CLng
(lngProcessLevel), , CBool(blnAutoMapCorrect)
End Sub

Aprs avoir cr un script, vous pouvez crer un vnement du Gestionnaire de tches FDM
pour excuter le chargeur de lots de manire planifie.

Script de chargement de lots en parallle


FDM prend en charge le traitement en parallle des fichiers de lot. Cela permet de traiter plusieurs
fichiers simultanment, et non de manire squentielle. FDM peut traiter jusqu' cinquante
fichiers simultanment. FDM regroupe dans des processus les fichiers traiter dans le lot. Les
fichiers de chaque processus sont traits en srie l'un aprs l'autre, et chaque processus s'excute
en parallle.
Exemple : Si le lot traiter contient 20 fichiers et si le Nb de processus parallles est dfini sur
la valeur 5, cinq processus (chacun contenant quatre fichiers) seront excuts de manire
squentielle.

Remarque :
Lors du traitement de fichiers de lot en parallle, FDM regroupe dans le mme processus les
fichiers qui se chargent dans le mme emplacement FDM. De cette manire, deux processus ne
peuvent pas tenter de charger des donnes dans un mme emplacement au mme moment, ce
qui pourrait gnrer des rsultats incorrects.

Sub ParallelBatch()
------------------------------------------------------------------

Scripts du chargeur de lots 179


FDM Custom Script:

Created By: Admin
Date Created: 3/23/2006 13:50

Purpose: Execute a FDM Batch Loader with parallel processing
------------------------------------------------------------------
Declare Local Variables
Dim lngProcessLevel
Dim strDelimiter
Dim blnAutoMapCorrect
Dim lngParallelProcessCount
Dim strLoadBalanceServerName
Initialize Variables
lngProcessLevel = 12 Up-To-Check
strDelimiter = _
blnAutoMapCorrect = 0
lngParallelProcessCount = 5
strLoadBalanceServerName = LocalHost
Create the file collection
Set BATCHENG.PcolFiles = BATCHENG.fFileCollectionCreate(CStr(strDelimiter))
Execute a Standard Parallel batch
BATCHENG.mFileCollectionProcessParallel BATCHENG.PcolFiles, CLng
(lngProcessLevel), CLng(lngParallelProcessCount), CStr
(strLoadBalanceServerName), , CBool(blnAutoMapCorrect)
End Sub

180 Chargeur de lots


Autres outils
18
Dans ce chapitre
Exportation au format XML.......................................................................................................................................181
Journal systme.......................................................................................................................................................182
Importation de donnes depuis Microsoft Excel........................................................................................................182
Convertisseur de mappage.......................................................................................................................................183
Editeur de tables......................................................................................................................................................184
Segments de donnes.............................................................................................................................................184
Editeur de texte........................................................................................................................................................185
Fonction Sauvegarder les fichiers d'application........................................................................................................185

Exportation au format XML


FDM permet d'exporter une application complte dans un fichier XML.

Pour exporter des applications, procdez comme suit :


1 Connectez-vous l'application l'aide de Workbench.
2 Slectionnez Fichier > Exporter.
La bote de dialogue Enregistrer le fichier d'exportation des mtadonnes s'affiche.
3 Entrez un nom pour le fichier export.
4 Cliquez sur Enregistrer.
La bote de dialogue Exporter s'affiche.
5 Slectionnez les composants exporter.
6 Cliquez sur Enregistrer.

Remarque :
Si vous exportez des emplacements, vous pouvez galement exporter les mappages associs en
slectionnant Exporter les mappages avec les emplacements dans l'onglet Options.

Exportation au format XML 181


Journal systme
Dans le client Web, slectionnez Analyse > Journal pour ouvrir le journal d'activit du systme.
Le journal rpertorie l'ensemble des transactions du systme.
Dans Cls de transaction, slectionnez le type de transaction afficher. Le journal indique les
activits qui ont eu lieu, les utilisateurs qui les ont excutes et quelle heure.
Trois champs donnent des informations dtailles sur chaque transaction :
Infos sur l'vnement : affiche des statistiques ou des informations sur l'vnement consign.
Infos sur l'erreur : affiche un code d'erreur Visual Basic ou Microsoft DAO. Cette
information peut tre demande par Hyperion pour dterminer la cause des erreurs en vue
de leur correction.
Source d'E/S (Entre/Sortie) : rpertorie les instructions SGBDR excutes pour
l'vnement, ainsi que les fichiers externes crs ou imports.

Importation de donnes depuis Microsoft Excel


L'outil Importation XLS permet d'importer des donnes directement dans une table de la base
de donnes FDM en cours. Par consquent, vous pouvez importer de grandes quantits de
donnes de configuration d'application (mtadonnes) sans entrer chaque ligne manuellement
dans les grilles de configuration du client Web. Pour qu'une feuille de calcul Excel puisse tre
utilise comme source d'importation, elle doit avoir une plage d'importation Excel valide
contenant le nom de table importer et le nom de chaque colonne de la plage.

La grille reprsente un nom de plage dans Excel (upsCategory). La premire cellule de la plage
doit contenir le nom de la table FDM dans laquelle importer. La deuxime ligne de la plage doit
contenir les noms des champs de la table. La troisime ligne et les suivantes doivent contenir les
donnes charger dans FDM.
Plusieurs plages peuvent tre identifies dans une feuille de calcul. Chaque plage doit commencer
par l'identifiant d'importation FDM (ups). Si les tables importes sont relies les unes aux autres,
la table parent doit tre importe avant la table enfant. Dans ce cas, nommez les plages Excel par
ordre alphabtique. Par exemple, le nom de plage upsAParent est trait avant le nom de plage
upsBEnfant .

Remarque :
Les dates doivent tre indiques au format texte.

182 Autres outils


Pour importer des donnes partir d'une feuille de calcul Excel, procdez comme suit :
1 Dans Workbench ou dans le client Web, slectionnez Outils > Importation XLS.
La bote de dialogue Importation XLS s'affiche.
2 Accdez au fichier Excel importer.
3 Cliquez sur Ouvrir.

Remplacement de donnes
Crez une fonction Visual Basic (VB) dans un module dans le fichier Excel nomm
UpReplace et dfinissez sa valeur de renvoi sur Vrai . Cette fonction indique FDM de
supprimer toutes les donnes de la table TDim avant d'en ajouter de nouvelles.
Exemple :

Public Function UpReplace() as Boolean


Set value to true to force delete prior to load
UpReplace = True
End Function

Remarque :
La fonction UpReplace peut uniquement tre utilise dans la table tDim.

Convertisseur de mappage
Le convertisseur de mappage permet de trianguler les mappages de dimensions lors du passage
une nouvelle application cible. Par exemple, s'il existe un mappage dans l'emplacement Texas
entre le grand livre et le systme cible actuel, et s'il existe un mappage dans l'emplacement
Michigan entre le systme cible actuel et le nouveau systme cible, le convertisseur de mappage
cre un nouveau mappage entre le grand livre et le nouveau systme cible.

Pour utiliser le convertisseur de mappage, procdez comme suit :


1 Dans Workbench ou le client Web, slectionnez Outils > Convertisseur de mappage.
L'cran Convertisseur de mappage s'affiche.
2 Slectionnez l'onglet Dimension.
3 Slectionnez la dimension qui contient le mappage convertir.
4 Slectionnez l'onglet Emplacement source.
5 Slectionnez l'emplacement FDM qui contient le nouveau mappage (entre le compte cible d'origine et le
nouveau compte cible).
6 Slectionnez l'onglet Emplacement cible.
7 Slectionnez l'emplacement FDM qui contient le mappage d'origine (GL > Compte cible d'origine).
8 Slectionnez l'onglet Aperu et conversion.

Convertisseur de mappage 183


9 Cliquez sur Aperu de la conversion.
L'option Aperu de la conversion permet d'afficher le mappage pour l'emplacement d'origine
sans effectuer le changement.
10 Cliquez sur Excuter la conversion pour convertir le mappage.
L'emplacement qui contenait le mappage d'origine (GL > Compte cible d'origine) est mis jour
pour stocker le mappage converti.

Editeur de tables
L'Editeur de tables permet d'ouvrir une table dans la base de donnes FDM en cours.

Pour ouvrir une table, procdez comme suit :


1 Dans Workbench ou le client Web, slectionnez Outils > Editeur de tables.
2 Dans Table, slectionnez la table modifier.
Cette fonctionnalit est utile lorsque des tables personnalises jointes l'application FDM
ncessitent une mise jour.

Remarque :
Utilisez l'Editeur de tables avec prudence. Les modifications peuvent crer des erreurs dans
l'application et invalider l'analyse rtrospective du systme.

Segments de donnes
Vous pouvez crer, supprimer, recrer et raffecter des segments de donnes dans Workbench.

Cration de segments
La fonction Crer des segments permet d'ajouter des tables de segments de donnes sans recrer
la totalit de la base de donnes.

Pour crer des segments de donnes, procdez comme suit :


1 Dans Workbench, slectionnez Outils > Grer les segments de donnes > Crer des segments.
La bote de dialogue Crer des segments s'affiche.
2 Dans la zone Segments, slectionnez le nombre de segments crer.
3 Cliquez sur Enregistrer et fermer.

184 Autres outils


Remarque :
Les emplacements dj crs sont associs aux nouveaux segments. Tous les emplacements crs
restent dans leur segment de donnes d'origine.

Suppression, recration et raffectation de segments de


donnes
Cette fonction permet de changer le nombre de segments de donnes actifs. Ce processus
raffecte galement les emplacements existants aux nouveaux segments de donnes. Les donnes
associes aux emplacements existants (y compris les mappages) sont ensuite supprimes.

Pour supprimer, recrer et raffecter des segments de donnes, procdez comme suit :
1 Dans Workbench, slectionnez Outils > Grer les segments de donnes > Supprimer, recrer et
raffecter tous les segments.
La bote de dialogue Recrer les segments s'affiche.
2 Dans la zone Segments, slectionnez le nombre de segments crer.
3 Cliquez sur Enregistrer et fermer.

Editeur de texte
L'Editeur de texte permet d'ouvrir et de modifier un fichier texte dans Workbench. Pour ouvrir
l'Editeur de texte, slectionnez Outils > Editeur de texte.

Fonction Sauvegarder les fichiers d'application


La fonction Sauvegarder les fichiers d'application compresse automatiquement les fichiers du
rpertoire FDM Application dans un fichier *.zip. Les fichiers inclus sont les suivants :
Scripts
Rapports
Modles Excel
Journaux
Archives
Autres fichiers crs ou enregistrs dans le rpertoire d'application
Cette fonctionnalit est utile pour l'archivage en cas de sauvegarde et pour le support en cas de
problme le cas chant.

Pour sauvegarder les fichiers d'application, procdez comme suit :


1 Dans Workbench, slectionnez Fichier > Sauvegarder les fichiers d'application.

Editeur de texte 185


2 Entrez un nom pour le fichier d'archive.
3 Cliquez sur OK.

186 Autres outils


Script
19
Dans ce chapitre
A propos du script....................................................................................................................................................187
Editeur de script.......................................................................................................................................................187
Scripts d'importation................................................................................................................................................189
Variables temporaires..............................................................................................................................................198
Scripts d'importation pour intgration......................................................................................................................201
Scripts personnaliss...............................................................................................................................................206
Scripts d'vnement................................................................................................................................................206
Concepteur de menu................................................................................................................................................210
Excution de scripts asynchrones.............................................................................................................................211

A propos du script
Remarque :
Ce chapitre fait rfrence au guide de l'API. Pour obtenir une copie de ce guide, contactez votre
reprsentant Hyperion ou votre consultant en installation informatique.

FDM utilise le moteur de script Visual Basic afin d'amliorer la flexibilit et la puissance du
produit. Les scripts sont crs selon la syntaxe VB Script standard. Le modle d'objets internes
(fonctions spcifiques FDM) peut galement tre rfrenc dans un script FDM (pour plus
d'informations, reportez-vous au Guide de l'API FDM).

Editeur de script
L'diteur de script permet de dfinir des scripts Visual Basic pouvant s'excuter suite un
vnement FDM, la slection d'un menu personnalis ou durant le processus d'importation
d'un fichier. Les scripts sont crs au moyen de l'diteur de script, sont enregistrs dans le
rpertoire Data\Scripts de l'application FDM et possdent une extension .uss. Vous pouvez
copier les scripts dans d'autres applications FDM. Vous pouvez galement diter des scripts au
moyen d'un diteur de texte ou de langage XML.

A propos du script 187


Client Web
L'diteur de script se lance automatiquement durant l'excution de certaines procdures lies
aux scripts. Pour accder directement l'diteur de script partir du client Web, slectionnez
Outils > Editeur de script.

Workbench
L'diteur de script se lance automatiquement durant l'excution de certaines procdures lies
aux scripts. Pour accder l'diteur de script de Workbench, cliquez sur l'onglet Scripts.
L'arborescence du haut, sur le ct gauche de l'cran, correspond aux rpertoires contenant les
trois types de scripts FDM. L'arborescence du bas correspond aux objets FDM accessibles.
Chaque objet FDM correspond un module de classe publique dans le fichier .dll FDM.
Chaque objet contient des sous-objets, des mthodes, des fonctions et des proprits accessibles
dans un script.
Lorsque vous cliquez deux fois sur une mthode, une fonction ou une proprit, le code
correspondant est insr directement dans le script. Tous les projets FDM peuvent tre
rfrences dans l'un des trois types de script, l'exception de l'objet de l'API qui ne peut pas
tre rfrenc dans un script d'importation.

Acclrateurs
L'diteur de script (Workbench uniquement) contient des acclrateurs dans la section
Navigateurs d'objets de la page de l'diteur de script. Les acclrateurs sont des modules de code
qui simplifient le processus de cration des scripts. Pour utiliser un acclrateur, cliquez deux
fois sur son nom. Cette action ajoute automatiquement le code de l'acclrateur au niveau de la
position du curseur dans le script ouvert.

188 Script
Scripts d'importation
Les scripts d'importation sont habituellement utiliss pour manipuler les donnes source lors
de l'importation d'un fichier source. Les scripts d'importation sont excuts au cours du
processus d'importation chaque fois que FDM lit une ligne source. Lorsque FDM lit un fichier
source, cette application ignore automatiquement toutes les lignes ne contenant pas un montant
valide. Les scripts du champ Montant sont tout de mme excuts. Ceci permet d'crire des
scripts pour les lignes que FDM ignorerait (en d'autres termes, cela permet de stocker des
variables qui ne peuvent pas tre rcupres dans des scripts affects d'autres champs
d'importation). Tous les objets FDM sont pris en charge dans les scripts d'importation,
l'exception de l'objet de l'API FDM.

Cration d'un script d'importation


Un script d'importation peut tre affect n'importe quel champ d'un format d'importation.

Pour crer un script d'importation, procdez comme suit :


1 Ouvrez l'cran Format d'importation en cliquant sur Mtadonnes > Formats d'importation.

Scripts d'importation 189


2 Cliquez avec le bouton droit dans le champ Expression de la ligne pour ajouter le script, puis slectionnez
Crer un script.
L'diteur de script s'affiche.
3 Cliquez sur Nouveau pour crer un nouveau script d'importation.
4 Dans Type de script, slectionnez Importer (Pompe donnes).
5 Dans Nom du fichier, entrez le nom du script.
6 Cliquez sur OK.

Paramtres de script d'importation


Il existe deux paramtres appliqus dans un script d'importation :
strField : Ce paramtre contient la valeur du champ dans le fichier source dfini dans le
format d'importation. Par exemple, si le script d'importation est affect au champ Montant,
ce paramtre contient alors le montant. Si le script d'importation est affect au champ
Compte, ce paramtre contient alors le compte.
strRecord : Ce paramtre contient la ligne entire (enregistrement) du fichier source en
cours d'analyse.

Les paramtres strField et strRecord s'appliquent au script.


Cliquez sur Enregistrer pour enregistrer le script.

190 Script
Valeur de retour de la fonction de script d'importation
Dans un script d'importation, vous devez affecter une valeur au nom de la fonction. Cette valeur
correspond ce que FDM importe. Dans l'exemple prcdent, si le montant source est ngatif,
le signe est alors invers et la nouvelle valeur est affecte au nom de la fonction. Cette valeur
modifie correspond la valeur importe.

Affectation d'un script d'importation un format


d'importation
Aprs avoir cr puis enregistr le script d'importation dans l'diteur de script, ajoutez le script
au champ Importer.

Pour ajouter un script d'importation un champ Importer, procdez comme suit :


1 Dans le client Web, slectionnez Mtadonnes > Formats d'importation.
L'cran Formats d'importation s'affiche.
2 Slectionnez un groupe de formats d'importation (grille du haut).
3 Cliquez avec le bouton droit dans le champ Expression de la ligne pour ajouter le script (grille du haut),
puis slectionnez Ajouter une expression.
L'diteur de script s'affiche.

4 Dans Type d'expression, slectionnez Script.


5 Recherchez le script d'importation, puis slectionnez-le.
6 Cliquez sur OK.

Scripts d'importation 191


Le script est affect au champ Importer. Le nom du script d'importation s'affiche dans la colonne
Expression.

Fonctions de script d'importation

Fonction Left
Left (string, # of characters)

L'exemple ci-dessous concerne le grand livre de l'Indiana. Le mappage de cet emplacement


n'utilise que les quatre premiers chiffres du numro de compte. Une solution consiste modifier
le mappage en ajoutant des caractres gnriques. L'autre solution consiste n'importer que les
quatre premiers caractres en utilisant un script d'importation.

192 Script
Le compte est compos des quatre premiers caractres en partant de la gauche du premier champ.
Utilisez la fonction Visual Basic Left afin de retourner les quatre premiers caractres du champ.

--------------------------------------------------------------------
Function Parse_Account [strField, strRecord]
------------------------------------------------------------------
FDM DataPump Import Script:
Created by: FDM_Admin
Date created: 2/28/2006
------------------------------------------------------------------
Parse_Account = Left (strField, 4)
End Function
--------------------------------------------------------------------

Le code affecte les quatre premiers chiffres du numro de compte la variable


Parse_Account.

Aprs avoir ajout ce script la colonne Expression du champ Compte du format d'importation,
il s'excute dsormais pour chaque ligne du fichier source. Le script Parse_Account remplace
la valeur du champ par le rsultat du script.

L'exemple ci-dessous prsente le fichier d'importation pour le format d'importation utilisant le


script Parse_Account dans le champ Compte.

Scripts d'importation 193


Fonction Mid
Mid (string, start character, # of characters)

Le fichier de l'exemple ci-dessous contient le centre de cots, le compte et la description du


compte sous la forme d'une chane continue dans le premier champ. Cette chane doit tre
spare dans des champs distincts. Le fichier source d'origine ne peut pas tre modifi mais vous
pouvez crire un script pour analyser les champs.

Le numro de compte dmarre la colonne 7 et se compose de quatre caractres. Utilisez la


fonction Mid pour retourner les caractres des colonnes 7 10.
--------------------------------------------------------------------
Function NY_ParseAccount [strField, strRecord]
------------------------------------------------------------------
FDM DataPump Import Script:
Created by: FDM_Admin
Date created: 2/28/2006
------------------------------------------------------------------
NY_ParseAccount = Mid (strField, 7,4)
End Function
--------------------------------------------------------------------

194 Script
La fonction Mid utilise dans ce script affecte la chane de caractres des colonnes 7 10 la
variable NY_ParseAccount.
Le script d'importation est affect au champ Compte (exemple suivant).

Fonction Right
Right (string, # of characters)

Dans ce fichier, le numro de compte correspond au quatre derniers chiffres du premier champ.

Le premier champ de ce fichier CSV (champs spars par une virgule) comprend la description
du compte, le centre de cots et le numro de compte. Le champ doit tre analys afin d'extraire
chacun des lments sparment.
Utilisez la fonction Right afin de retourner les quatre derniers caractres du premier champ.

--------------------------------------------------------------------
Function NJ_ParseAccount [strField, strRecord]
------------------------------------------------------------------
FDM DataPump Import Script:
Created by: FDM_Admin
Date created: 2/28/2006
------------------------------------------------------------------
NY_ParseAccount = Right (strField,4)

Scripts d'importation 195


End Function
--------------------------------------------------------------------

Ce script affecte les quatre derniers caractres du premier champ de chaque ligne du fichier la
variable NJ_ParseAccount.
Le script est affect au champ Compte.

Fonction d'analyse FDM


DW.Utilities.fParseString (string, total field count, field # to return,
delimiter)

La fonction fParseString n'est pas une fonction Visual Basic mais une fonction FDM utilise
pour analyser les chanes contenant un sparateur. Dans le fichier de l'exemple ci-dessous, le
sparateur de valeur du premier champ est un tiret (-). La fonction fParseString permet de
scinder ce champ en trois champs distincts en prcisant que le sparateur de valeurs est un tiret.
Utilisez la fonction fParseString pour rcuprer l'entit et les champs de description.

Dans le fichier source, l'entit correspond l'ensemble des chiffres placs avant le premier tiret
dans le premier champ.

--------------------------------------------------------------------
Function NY_ParseCenter [strField, strRecord]

196 Script
------------------------------------------------------------------
FDM DataPump Import Script:
Created by: FDM_Admin
Date created: 2/28/2006
------------------------------------------------------------------
NY_ParseCenter = DW.Utilities.fParseString (strField, 3, 1, -)
End Function
--------------------------------------------------------------------

La variable NY_ParseCenter retourne l'entit (ensemble de chiffres placs avant le premier


tiret dans le premier champ du fichier de donnes).
La description correspond au dernier ensemble de caractres placs aprs le deuxime tiret dans
le premier champ de la ligne du fichier source.

Function NY_ParseDesc [strField, strRecord]


------------------------------------------------------------------
FDM DataPump Import Script:
Created by: FDM_Admin
Date created: 2/28/2006
------------------------------------------------------------------
NY_ParseDesc = DW.Utilities.fParseString (strField, 3, 3, -)
End Function

La variable NY_ParseDesc retourne la description (ensemble de chiffres placs aprs le second


tiret dans le premier champ du fichier de donnes).
Les scripts sont affects aux champs Entit et Description.

Remarque :
Le script Parse_Account indiqu dans cet exemple a t cr dans un exemple prcdent.

Scripts d'importation 197


Fonction Skip (saut conditionnel)
RES.PblnSkip

La fonction RES.PblnSkip vous permet d'ignorer de faon conditionnelle des lignes du fichier
source. Cette fonction ignore la ligne complte qui n'est donc pas importe dans FDM. Dans
l'exemple ci-dessus du fichier source intitul New York, toute entit commenant par 06 doit
tre ignore.

Le script ci-dessous ignore toutes les entits commenant par 06 . Le script utilise la fonction
FDM fParseString pour analyser le champ d'entit. Une variable temporaire est galement
utilise dans ce script. Il s'agit d'une variable locale dont la valeur est perdue une fois le script
excut.

--------------------------------------------------------------------
Function NY_Skip06Center [strField, strRecord]
------------------------------------------------------------------
FDM DataPump Import Script:
Created by: FDM_Admin
Date created: 2/28/2006
------------------------------------------------------------------
Dim strEntity
Store first entity in a variable
strEntity = DW.Utilities.fParseString (strField, 3, 1, -)
Check first two characters of entity
If Left(strEntity, 2) = 06 then
Skip line
Res.PblnSKip = True
Else
NY_Skip06Center = strEntity
End if
End Function
--------------------------------------------------------------------

Le script ci-dessous ignore toutes les entits commenant par 06 .

Variables temporaires

Stockage des variables temporaires


RES.PvarTemp1RES.PvarTemp5

198 Script
Certains fichiers source contiennent des champs ne se rptant pas sur chaque ligne (champs
Entit et Description, par exemple). Lorsque FDM importe un fichier source, cette application
ignore automatiquement toutes les lignes ne contenant pas un montant valide. Les scripts du
champ Montant sont tout de mme excuts. Cela permet d'crire des scripts pour les lignes que
FDM ignorerait. Vous pouvez donc crire des scripts dans le champ Montant afin de stocker des
variables qui ne peuvent pas tre rcupres dans des scripts affects d'autres champs
d'importation. FDM peut stocker jusqu' cinq variables temporaires simultanment.
L'exemple de grand livre ci-dessous indique que l'entit ne se rpte pas sur chaque ligne. L'entit
est prsente dans l'en-tte de chaque section du rapport et apparat aprs le libell Bus Area/
Dept . Le compte, la description et le solde final peuvent facilement tre identifis. L'entit doit
tre stocke dans une variable temporaire et affecte chaque ligne du fichier d'exportation.

Le script ci-dessous utilise une condition If...Then et la fonction Mid pour vrifier que la ligne
contient le libell Bus Area/Dept: . Si la ligne contient bien le libell, le script va stocker l'entit
dans une variable temporaire. Le centre commence la position 33 et se compose de
quatre caractres. Si une ligne n'incluant pas le centre est lue, le paramtre strField est alors
affect au nom de la fonction (dans cet exemple, GeorgiaGetCenter=strField).
Les variables RES.PvarTemp1 RES.PvarTemp5 sont gnrales. Contrairement aux variables
locales qui perdent leur valeur lorsque le script en cours est ferm, ces variables temporaires ne
perdent pas leur tendue tant que la session FDM en cours est ouverte. Ainsi, FDM stocke les
valeurs d'un script et rcupre les valeurs d'un autre script.

Variables temporaires 199


--------------------------------------------------------------------
Function GeorgiaGetCenter [strField, strRecord]
------------------------------------------------------------------
FDM DataPump Import Script:
Created by: FDM_Admin
Date created: 2/28/2006
------------------------------------------------------------------
If Mid(strRecord, 15,16) = Bus Area / Dept: then
RES.PvarTemp1 = Mid(strRecord,33,4)
End if
GeorgiaGetCenter = strField
End Function
--------------------------------------------------------------------

Si la ligne du fichier de donnes commence par Bus Area / Dept: , la fonction Mid est alors
utilise pour stocker l'entit dans Temp Variable 1.
Etant donn que le champ Montant est la seule rgle qui s'excute mme si la ligne dans le code
source ne contient pas de montant valide, le script de l'exemple ci-dessous doit tre affect au
champ Montant dans le format d'importation.

Rcupration des variables temporaires


Aprs avoir stock l'entit dans une variable temporaire, un script est ncessaire pour affecter la
variable temporaire au champ Entit. Le script ci-dessous affecte la variable temporaire au nom
de la fonction.

--------------------------------------------------------------------
Function GeorgiaPutCenter [strField, strRecord]
------------------------------------------------------------------
FDM DataPump Import Script:
Created by: FDM_Admin
Date created: 2/28/2006
------------------------------------------------------------------
GeorgiaPutCenter = RES.PvarTemp1
End Function
--------------------------------------------------------------------

La variable temporaire PvarTemp1 est affecte la fonction GeorgiaPutCenter.


Le script est alors affect au champ Entit.

200 Script
Le script GeorgiaPutCenter tant affect au champ Entit, la valeur de la variable temporaire
est affecte l'entit qui n'a pas besoin d'tre lue partir du fichier source.
Ce format ncessite galement l'utilisation d'une fonction Skip car elle inclut des lignes de sous-
totaux qui ne peuvent pas tre importes. Configurez la fonction Skip de faon ce qu'elle ignore
les colonnes Compte vides (15 espaces vides). Utilisez la fonction glisser-dposer pour dfinir
les champs Dbut et Longueur. FDM ignore dsormais toutes les lignes ne possdant pas de
numro de compte.

Utilisez la fonction Skip pour ignorer les lignes de sous-totaux (identifies par la colonne vide
Compte) afin de finaliser le format d'importation du fichier d'exemple Georgia.

Scripts d'importation pour intgration


Les scripts d'importation pour intgration doivent tre utiliss lors de l'importation de donnes
directement partir de la source de donnes compatible ODBC/OLEDB (plutt qu'un fichier

Scripts d'importation pour intgration 201


ASCII). Ce script d'intgration est charg de se connecter aux donnes source et de les importer
directement du systme source dans la base de donnes FDM. Ce script s'excute lorsque vous
cliquez sur le bouton Importer de l'cran Importer. Tous les objets FDM sont pris en charge
dans les scripts d'importation pour intgration, l'exception des objets de l'API FDM.

Cration d'un script d'importation pour intgration


Lors de la dfinition du groupe d'importation, slectionnez le type de fichier Script. Ne spcifiez
pas de champs individuels dans le tableau du bas comme dans le cas d'un format d'importation.
A la place, vous trouverez seulement un champ dans lequel le script d'intgration est entr.

Pour crer un script d'importation pour intgration, procdez comme suit :


1 Dans le client Web, slectionnez Mtadonnes > Formats d'importation.
2 Slectionnez un groupe de formats d'importation dans la grille du haut.
Le groupe de formats doit tre configur avec le type de fichier Script.
3 Dans la grille du bas, cliquez sur la flche situe droite de la ligne, puis slectionnez Crer un script
dans le menu.
La bote de dialogue Editeur de script s'affiche.
4 Cliquez sur Nouveau.
5 Dans Type de script, slectionnez le script Importer (Intgration).
6 Entrez le nom du script.
7 Cliquez sur OK.

Paramtres de script d'importation pour intgration


Il existe quatre paramtres appliqus un script d'importation pour intgration :
strLoc : Ce paramtre contient la cl de l'emplacement FDM actif. Rfrencez ce paramtre
lorsque vous mettez jour la table de travail FDM avec les donnes source.
strLoc : Ce paramtre contient la cl de la catgorie FDM active. Rfrencez ce paramtre
lorsque vous mettez jour la table de travail FDM avec les donnes source.
dblPerKey : Ce paramtre contient la cl de srie de dates pour la priode FDM active.
Rfrencez ce paramtre lorsque vous mettez jour la table de travail FDM avec les donnes
source.
strWorkTableName : Ce paramtre contient le nom de la table de travail dans laquelle les
donnes source sont importes pour cet emplacement FDM.

202 Script
Champs de la table de travail FDM
Lors de la cration d'un script d'importation pour intgration, vous devez renseigner la table de
travail FDM au moyen des valeurs source rcupres des donnes source. Le tableau ci-dessous
rpertorie tous les champs disponibles de la table de travail FDM.

Tableau 2 Champs de la table de travail FDM

Nom du champ Infos sur le champ Remarque

PartitionKey [ Type=Long, Size=0, Required=Yes] Nom de l'emplacement FDM. Utilisez le paramtre


strLoc.

CatKey [ Type=Long, Size=0, Required=Yes] Cl de catgorie FDM. Utilisez le paramtre


lngCatKey.

PeriodKey [ Type=TimeStamp, Size=0, Required=Yes] Cl de priode FDM. Utilisez le paramtre dblPerKey.

DataView [ Type=VarWChar, Size=5, Required=Yes] Frquence de chargement. Dfinie par dfaut sur
YTD.

Amount [ Type=Double, Size=0, Required=Yes] Montant source

Desc1 [ Type=VarWChar, Size=75, Required=No] Description du compte source

Account [ Type=VarWChar, Size=75, Required=Yes] Compte source

Entity [ Type=VarWChar, Size=75, Required=Yes] Entit source

ICP [ Type=VarWChar, Size=75, Required= No] ICP source

UD1 [ Type=VarWChar, Size=75, Required= No] Dimension source dfinie par l'utilisateur 1

UD2 [ Type=VarWChar, Size=75, Required= No] Dimension source dfinie par l'utilisateur 2

UD3 [ Type=VarWChar, Size=75, Required= No] Dimension source dfinie par l'utilisateur 3

UD4 [ Type=VarWChar, Size=75, Required= No] Dimension source dfinie par l'utilisateur 4

UD5 [Type=VarWChar, Size=75, Required= No] Dimension source dfinie par l'utilisateur 5

UD6 [ Type=VarWChar, Size=75, Required= No] Dimension source dfinie par l'utilisateur 6

UD7 [ Type=VarWChar, Size=75, Required= No] Dimension source dfinie par l'utilisateur 7

UD8 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 8

UD9 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 9

UD10 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 10

UD11 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 11

UD12 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 12

UD13 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 13

UD14 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 14

Scripts d'importation pour intgration 203


Nom du champ Infos sur le champ Remarque

UD15 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 15

UD16 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 16

UD17 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 17

UD18 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 18

UD19 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 19

UD20 [ Type=VarWChar, Size=75, Required=No] Dimension source dfinie par l'utilisateur 20

Attr1 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 1

Attr2 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 2

Attr3 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 3

Attr4 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 4

Attr5 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 5

Attr6 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 6

Attr7 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 7

Attr8 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 8

Attr9 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 9

Attr10 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 10

Attr11 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 11

Attr12 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 12

Attr13 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 13

Attr14 [ Type=VarWChar, Size=20, Required=No] Dimension d'attribut source 14

ArchiveID [ Type=Bigint, Size=8, Required=No] S'il existe une archive associer, entrez le numro
d'identifiant de l'archive du rpertoire source.

Affectation d'un script d'importation pour intgration des


formats d'importation
Aprs avoir cr et enregistr le script d'importation pour intgration dans l'diteur de script,
vous devez ajouter le script au format d'importation comme vous le feriez pour un script
d'importation classique, c'est--dire en cliquant sur le lien Ajouter une expression et en
recherchant le fichier de script.

204 Script
Exemple de script d'importation pour intgration
L'exemple ci-dessous est celui d'un exemple de script d'importation pour intgration qui ouvre
une base de donnes du serveur SQL (base de donnes Northwind) et crit directement les
donnes dans FDM. Notez que la valeur Vrai est affecte la fonction si l'importation est un
succs. En cas d'erreur dans le script, affectez une valeur Faux la fonction.
-------------------------------------------------------------------
Function SQLIntegration(strLoc, lngCatKey, dblPerKey, strWorkTableName)
------------------------------------------------------------------
FDM Integration Import Script:
Created By: Admin
Date Created: 04/19/2004 2:18:39 PM
Purpose: This import integration script connects to the sample
Northwind SQL Server database and imports sample
source data from the Orders table into FDM.
-----------------------------------------------------------------
Dim cnSS ADO connection object
Dim strSQL SQL string
Dim rs Source system recordset
Dim rsAppend FDM recordset
Initialize ADO objects
Set cnSS = CreateObject(ADODB.Connection)
Set rs = CreateObject(ADODB.Recordset)
Open FDM work table recordset for appending
Set rsAppend = DW.DataAccess.farsTableAppend(strWorkTableName)
Connect to Northwind SQL Server database (our data source)
Dim strConn
strConn=Provider=SQLOLEDB.1;Integrated Security=SSPI;Persist Security
Info=False;
strConn=strConn & Initial Catalog=Northwind;Data Source=LocalHost;
cnss.open strConn
Create source query string
strSQL = Select *
strSQL = strSQL & FROM Orders
Open source recordset
rs.Open strSQL, cnSS
Check for data in source system
If rs.bof AND rs.eof Then
Give error message
RES.PlngActionType = 2
RES.PstrActionValue = No records to load!
Assign Return value of function
SQLIntegration = False
Exit Function
End If
Loop through source records in Northwind database (Orders table) and
append to FDM work table
If Not rs.bof And Not rs.eof Then
Do While Not rs.eof
rsAppend.AddNew
rsAppend.Fields(PartitionKey) = RES.PlngLocKey
rsAppend.Fields(CatKey) = lngCatKey
rsAppend.Fields(PeriodKey) = dblPerKey
rsAppend.Fields(DataView) = YTD
rsAppend.Fields(Amount) = rs.fields(Freight).Value
rsAppend.Fields(Account) = rs.fields(CustomerID).Value

Scripts d'importation pour intgration 205


rsAppend.Fields(Entity) = rs.fields(ShipCountry).Value
rsAppend.Fields(Desc1) = rs.fields(ShipName).Value
rsAppend.Update
rs.movenext
Loop
End If
Give success message
RES.PlngActionType = 2
RES.PstrActionValue = SQL Import successful!
Assign Return value
SQLIntegration = True
End Function
--------------------------------------------------------------------

Scripts personnaliss
Les scripts personnaliss peuvent tre excuts au moyen d'un lien personnalis dans le menu
Flux de tches. Les scripts personnaliss permettent aux utilisateurs et aux administrateurs
d'excuter un script manuellement. Tous les objets FDM sont pris en charge dans les scripts
personnaliss.

Cration d'un script personnalis


Pour crer un script personnalis, procdez comme suit :
1 Dans Workbench, slectionnez Fichier > Nouveau script.
La bote de dialogue Nouveau script s'ouvre.
2 Dans Type de script, slectionnez Personnalis (Web).
3 Dans Nom du script, entrez un nom pour le script.
4 Cliquez sur OK.
Il existe trois options de types de script personnalis : Gnral, Plug-in et Web. Les scripts
personnaliss de type Gnral sont destins n'tre utiliss que dans Workbench. Les scripts
personnaliss de type Web sont destins tre utiliss que dans le client Web FDM. Les scripts
personnaliss de type Plug-in sont gnralement des solutions d'intgration personnalises
proposes par Hyperion.
Aprs avoir ajout le script, FDM ajoute automatiquement un prfixe web au nom du script.

Scripts d'vnement
Les scripts d'vnement sont excuts suite des vnments FDM particuliers. Une liste des
vnements dclencheurs se situe dans le rpertoire Evnment de l'diteur de script. Pour plus
d'informations sur tous les vnements FDM, reportez-vous au guide de l'API. Tous les objets
FDM sont pris en charge dans les scripts d'vnement.

206 Script
Cration d'un script d'vnement
Pour crer un script d'vnement, ouvrez l'diteur de script de WorkBench FDM, puis cliquez
deux fois sur l'vnement pour dvelopper un script.

Paramtres de script d'vnement


Chaque script d'vnement FDM possde son propre ensemble de paramtres. Ces paramtres
peuvent tre utiliss dans le script au lieu d'appeler une fonction, une mthode ou une proprit
FDM qui retourne la mme valeur. Par exemple, le paramtre strLoc contient le nom de
l'emplacement FDM actif. Cette pratique est plus efficace que d'utiliser la proprit
API.POVMgr.PPOVLocation pour retourner le nom de l'emplacement FDM. Pour plus
d'informations sur tous les paramtres de script d'vnement, reportez-vous au guide de l'API
FDM.

Scripts d'vnement 207


Modification dynamique des formats d'importation
Vous pouvez modifier de faon dynamique le format d'importation pour un emplacement au
moyen de l'vnement BefFileImport. Dans l'exemple ci-dessous, le script modifie le groupe
d'importation en fonction du nom de fichier. Pour implmenter ce script, vous devez crer
deux formats d'importation et en affecter l'un des deux l'emplacement FDM. Le script analyse
le nom de fichier et modifie le format d'importation, le cas chant.

-------------------------------------------------------------------
Sub BefFileImport(strLoc, strCat, strPer, strFile)
------------------------------------------------------------------
Hyperion EVENT Script:

Created By: Admin
Date Created: 10/28/2004 4:29:54 PM

Purpose: Change the import group if importing the B/S

------------------------------------------------------------------
Check if the file name contains BS
If InStr(strFile,BS)>0 Then
Override default import group with B/S import group
RES.PblnImportGroupOverride=True
RES.PstrImportGroup=BSImportFormat
End If
End Sub
-------------------------------------------------------------------

Modification dynamique d'autres attributs d'emplacements


Vous pouvez utiliser des scripts d'vnement pour modifier de faon dynamique des groupes
de validation, des rgles de validation et des groupes logiques avant qu'ils ne soient traits. Pour

208 Script
plus d'informations sur les vnements et les proprits permettant de modifier un attribut
d'emplacement, reportez-vous au tableau ci-dessous.
Tableau 3 Evnements et proprits permettant de modifier un attribut d'emplacement

Nom de l'vnement Proprits FDM Rle

BefFileImport RES.PblnImportGroupOverride=Tr Modification du format d'importation avant


ue l'importation
RES.PstrImportGroup=MyNewImpo
rtFormat

BefProcLogicGrp RES.PblnLogicGroupOverride Modification du groupe logique avant le


=True traitement de la logique
RES.PstrLogicGroup
=MyNewLogicGroup

BefConsolidate RES.PblnValEntGroupOverride Modification du groupe d'entits de validation


=True avant la consolidation
RES.PstrValEntGroup=MyNewEnti
tyGroup

BefCheck RES.PblnValRuleGroupOverride=T Modification du groupe de rgles de validation


rue avant l'excution du rapport de validation
RES.PstrValRuleGroup=MyNewVal
RuleGroup

Utilisation de l'objet File System Object dans un script


d'vnement
Utilisez l'objet File System Object de Visual Basic pour traiter les fichiers et les dossiers. L'exemple
ci-dessous utilise l'objet File System Object pour crer un nouveau fichier et copie le contenu
d'un fichier existant dans le nouveau fichier.
-------------------------------------------------------------------
Sub AftExportToDat(strLoc, strCat, strPer, strTCat, strTPer, strFile)
------------------------------------------------------------------
FDM EVENT Script:

Created By: Admin


Date Created: 3/18/2004 4:17:58 PM

Purpose: This script loops through the newly created Hyperion


Enterprise .dat file And creates a new .dat file with
a different category and multiplies the amount by .75
------------------------------------------------------------------
Declare local variables
Dim strline
Dim fso
Dim f1
Dim f2
Dim strNewFileName
Dim strEntity

Scripts d'vnement 209


Dim strAcct
Dim dblAmt
Declare file system object
Set fso = CreateObject(Scripting.FileSystemObject)
Open existing dat file for reading
Set f1 = fso.OpenTextFile(strFile, 1)
Create new .dat file with a -FAS suffix
strNewFileName=Left(strFile,Len(strFile)-4) & -FAS & Right(strFile,4)
Set f2=fso.CreateTextFile(strNewFileName,True)
Write category and beginning and ending periods to new file
f2.writeLine FAS
f2.writeLine strTPer
f2.writeLine strTPer
Skip first 3 header lines of existing dat file
f1.SkipLine
f1.SkipLine
f1.SkipLine
Loop through existing .dat file
Do While f1.AtEndOfStream <> True
Store line in a variable
strline = f1.ReadLine
Parse the entity from the line
strEntity = DW.Utilities.fParseString(strline, 3, 1, ,)

Parse the account from the file


strAcct = DW.Utilities.fParseString(strline, 3, 2, ,)
Parse the amount from the file
dblAmt = DW.Utilities.fParseString(strline, 3, 3, ,)

Write out line to new .dat file but multiply amt by .75
f2.writeline strEntity & , & strAcct & , & dblAmt * .75
Loop
Close the files
f1.Close
f2.Close

Destroy file system object


Set fso=Nothing
End Sub
-------------------------------------------------------------------

Pour plus d'informations sur les scripts dans FDM, reportez-vous l'annexe A.

Concepteur de menu
Le concepteur de menu permet d'affecter des scripts personnaliss de nouvelles options de
menu. Il permet d'affecter les scripts un nom de menu significatif grce auquel les utilisateurs
peuvent appeler un script. Aprs avoir cr le script dans l'diteur de script, un lien vers le script
s'ajoute dans l'interface du client Web afin de vous permettre de lancer manuellement le script.

Pour ajouter le script l'cran Flux de tches, procdez comme suit :


1 Dans le client Web, slectionnez Outils > Concepteur de menu.

210 Script
L'cran Concepteur de menu apparat.
2 Cliquez sur Ajouter.
Une nouvelle ligne s'ajoute dans la grille.
3 Dans la colonne Lgende du menu, entrez une lgende pour le menu.
4 Cliquez deux fois dans la colonne Script associ, puis slectionnez le script Web dans le menu.
Le champ de squence contrle l'ordre de tous les scripts personnaliss de type Web tels qu'ils
apparaissent dans l'cran Flux de tches.
5 Cochez la case Actif pour afficher le script dans l'cran Flux de tches du client Web.

Pour excuter un script de l'cran Flux de tches, procdez comme suit :


1 Dans le client Web, slectionnez Outils > Flux de tches.
2 Cliquez sur le lien du script pour l'excuter.
Le script s'excute immdiatement.

Excution de scripts asynchrones


FDM peut excuter des scripts en parallle au moyen d'un objet d'interface de ligne de
commande. Lancez un script slectionn dans l'interface de scripts asynchrones, le script va
s'excuter en mode parallle.

Sub AsynchScript()
------------------------------------------------------------------
Oracle's Hyperion Financial Data Quality Management Custom Script:

Created By: Admin
Date Created: 3/23/2006 13:57

Excution de scripts asynchrones 211


Purpose: Asynchronous Script Processing

------------------------------------------------------------------
Declare Local Variables
Dim strScriptToRun
Dim strLoadBalanceServerName
Initialize variables Variables
strScriptToRun = YourScriptName Name of the script to execute (Type
Custom General Only)
strLoadBalanceServerName = LocalHost Load balance server for
Asynchronous process to use
Execute the script
If API.DataWindow.Utilities.fExecuteCustomScriptAsync(CStr
(strScriptToRun), CStr(strLoadBalanceServerName)) = True Then
Async Script Started, you can make another call while it is
executing
Else
Async process failed to start
End If
End Sub ------------------------------------------------------------------

Cette fonctionnalit est galement prise en charge par le Gestionnaire de tches qui permet aux
scripts de s'excuter simultanment dans une tche ou aux tches individuelles de se comporter
de faon asynchrone.

212 Script
Expressions de script Visual
A Basic les plus courantes

Dans cette annexe


Prsentation............................................................................................................................................................213
InStr........................................................................................................................................................................213
InStrRev...................................................................................................................................................................215
IsNumeric................................................................................................................................................................217
Len..........................................................................................................................................................................217
Left..........................................................................................................................................................................218
LCase......................................................................................................................................................................219
LTrim et RTrim..........................................................................................................................................................219
Mid..........................................................................................................................................................................220
MsgBox....................................................................................................................................................................221
Now.........................................................................................................................................................................222
Replace...................................................................................................................................................................222
Right........................................................................................................................................................................224
UCase......................................................................................................................................................................225
DoLoop.................................................................................................................................................................225
If...Then...Else..........................................................................................................................................................227
File System Object...................................................................................................................................................228
Lecture de fichiers....................................................................................................................................................230
Dplacement, copie et suppression de fichiers.........................................................................................................231

Prsentation
Cette annexe propose une liste des fonctions de script Visual Basic les plus courantes. Pour plus
d'informations concernant le script VB, reportez-vous au site Web de Microsoft l'adresse :
http:\\www.msdn.microsoft.com\\vbscript

InStr
Retourne la position de la premire occurrence d'une chane au sein d'une autre chane.
InStr([start, ]string1, string2[, compare])

Prsentation 213
Arguments

start
Expression numrique dfinissant la position de dpart pour chaque recherche. En l'absence
d'indication pour cet argument, la recherche commence au premier caractre. Si l'argument
start contient la valeur Null, une erreur survient. L'argument start est obligatoire si l'argument
compare (facultatif) est indiqu.

string1
Chane dans laquelle la recherche est effectue (obligatoire).

string2
Chane recherche (obligatoire).

compare
Valeur numrique indiquant le type de comparaison utiliser lorsque les sous-chanes sont
values. Pour connatre les valeurs possibles pour cet argument, reportez-vous la section
suivante. En l'absence d'indication pour cet argument, une comparaison binaire est effectue
(facultatif).

Paramtres
L'argument compare peut prendre les valeurs ci-dessous :

Constante Valeur Description

vbBinaryCompare 0 Comparaison binaire

vbTextCompare 1 Comparaison textuelle

Valeurs retournes
La fonction InStr retourne les valeurs ci-dessous :

Si InStr retourne

string1 ne comporte pas de caractre 0

string1 a la valeur Null Null

string2 ne comporte pas de caractre start

214 Expressions de script Visual Basic les plus courantes


Si InStr retourne

string2 a la valeur Null Null

string2 est introuvable 0

string2 est trouve dans string1 la position laquelle la correspondance est trouve

start > Len(string2) 0

Remarques
Les exemples ci-dessous utilisent la fonction InStr pour rechercher une chane :

Dim SearchString, SearchChar, MyPos


SearchString =XXpXXpXXPXXP String to search in.
SearchChar = P Search for P.
MyPos = InStr(4, SearchString, SearchChar, 1) A textual comparison
starting at position 4. Returns 6.
MyPos = InStr(1, SearchString, SearchChar, 0) A binary comparison
starting at position 1. Returns 9.
MyPos = InStr(SearchString, SearchCharb Comparison is binary by default
(last argument is omitted). Returns 9.
MyPos = InStr(1, SearchString, W) A binary comparison starting at
position 1. Returns 0 (W is not found).

Remarque :
La fonction InStrB permet d'utiliser les donnes d'octets contenus dans une chane. Au lieu de
retourner la position du caractre de la premire occurrence d'une chane au sein d'une autre,
la fonction InStrB retourne la position de l'octet.

InStrRev
Retourne la position d'une occurrence d'une chane au sein d'une autre, en partant de la fin de
la chane.
InStrRev(string1, string2[, start[, compare]])

Arguments

string1
Chane dans laquelle la recherche est effectue (obligatoire).

string2
Chane recherche (obligatoire).

InStrRev 215
start
Expression numrique dfinissant la position de dpart pour chaque recherche. En l'absence
d'indication pour cet argument, la valeur -1 est utilise, ce qui signifie que la recherche
commence la position du dernier caractre. Si l'argument start (facultatif) contient la valeur
Null, une erreur survient.

compare
Valeur numrique indiquant le type de comparaison utiliser lorsque les sous-chanes sont
values. En l'absence d'indication pour cet argument, une comparaison binaire est effectue.
Pour connatre les valeurs possibles pour cet argument (facultatif), reportez-vous la section
suivante.

Paramtres
L'argument compare peut prendre les valeurs ci-dessous :

Constante Valeur Description

vbBinaryCompare 0 Comparaison binaire

vbTextCompare 1 Comparaison textuelle

Valeurs retournes
La fonction InStrRev retourne les valeurs ci-dessous :

Si InStrRev retourne

string1 ne comporte pas de caractre 0

string1 a la valeur Null Null

string2 ne comporte pas de caractre start

string2 a la valeur Null Null

string2 est introuvable 0

string2 est trouve dans string1 la position laquelle la correspondance est trouve

start >Len(string2) 0

Remarques
Les exemples ci-dessous utilisent la fonction InStrRev pour rechercher une chane :

Dim SearchString, SearchChar, MyPos

216 Expressions de script Visual Basic les plus courantes


SearchString =XXpXXpXXPXXP String to search in.
SearchChar = P Search for P.
MyPos = InStrRev(SearchString, SearchChar, 10, 0) A binary comparison
starting at position 10. Returns 9.
MyPos = InStrRev(SearchString, SearchChar, -1, 1) A textual comparison
starting at the last position. Returns 12.
MyPos = InStrRev(SearchString, SearchChar, 8) Comparison is binary by
default (last argument is omitted). Returns 0.

Remarque :
La syntaxe utiliser pour la fonction InStrRev est diffrente de celle de la fonction InStr.

IsNumeric
Retourne une valeur boolenne indiquant si une expression peut tre value en tant que
nombre.
IsNumeric(expression)

L'argument expression peut tre n'importe quelle expression.

Remarques
IsNumeric retourne la valeur True si l'expression entire est un nombre. Dans le cas contraire,
elle retourne la valeur False. La fonction IsNumeric retourne la valeur False si l'expression est
une date.
L'exemple ci-dessous utilise la fonction IsNumeric pour dterminer si une variable peut tre
value en tant que nombre.

Dim MyVar, MyCheck


MyVar = 53 Assign a value.
MyCheck = IsNumeric(MyVar) Returns True.
MyVar = 459.95 Assign a value.
MyCheck = IsNumeric(MyVar) Returns True.
MyVar = 45 Help Assign a value.
MyCheck = IsNumeric(MyVar) Returns False.

Len
Retourne le nombre de caractres d'une chane ou le nombre d'octets ncessaires pour stocker
une variable.
Len(string | varname)

IsNumeric 217
Arguments

string
Toute chane valide. Si la chane string a la valeur Null, la valeur Null est retourne.

varname
Tout nom de variable valide. Si varname a la valeur Null, la valeur Null est retourne.

Remarques
L'exemple ci-dessous utilise la fonction Len pour retourner le nombre de caractres dans une
chane :

Dim MyString
MyString = Len(VBSCRIPT) MyString contains 8.

Remarque :
La fonction LenB permet d'utiliser les donnes d'octets contenus dans une chane. Au lieu de
retourner le nombre de caractres dans une chane, la fonction LenB retourne le nombre d'octets
utiliss pour reprsenter cette chane.

Left
Retourne un nombre spcifi de caractres partir de la gauche d'une chane.
Left(string, length)

Arguments

string
Chane dont un nombre spcifi de caractres est retourn, en partant de la gauche de cette
chane. Si la chane string a la valeur Null, la valeur Null est retourne.

length
Expression numrique indiquant le nombre de caractres retourner. Si cette expression est
gale 0, une chane vide est retourne (). Si cette expression est suprieure ou gale au nombre
de caractres de la chane, la chane entire est retourne.

218 Expressions de script Visual Basic les plus courantes


Remarques
Pour dterminer le nombre de caractres de la chane, utilisez la fonction Len.
L'exemple ci-dessous utilise la fonction Left pour retourner les trois premiers caractres de la
chane MyString :

Dim MyString, LeftString


MyString = VBScript
LeftString = Left(MyString, 3) LeftString contains VBS.

Remarque :
La fonction LeftB permet d'utiliser les donnes d'octets contenus dans une chane. Au lieu de
spcifier le nombre de caractres retourner, elle spcifie le nombre d'octets.

LCase
Retourne une chane passe en lettres minuscules.
LCase(string)

L'argument string doit tre une chane valide. Si la chane string a la valeur Null, la valeur Null
est retourne.

Remarques
Seules les lettres en majuscule sont passes en minuscule, toutes les lettres dj en minuscule ou
les caractres autres que des lettres restent inchangs.
L'exemple ci-dessous utilise la fonction LCase pour passer les lettres en majuscule en lettres en
minuscule :

Dim MyString
Dim LCaseString
MyString = VBScript
LCaseString = LCase(MyString) LCaseString contains vbscript.

LTrim et RTrim
Retourne la copie d'une chane nettoye de toute espace avant (LTrim) et de toute espace aprs
(RTrim), ou les deux (Trim).

LTrim(string)
RTrim(string)
Trim(string)

L'argument string doit tre une chane valide. Si la chane string a la valeur Null, la valeur Null
est retourne.

LCase 219
Remarques
L'exemple ci-dessous utilise les fonctions LTrim, RTrim et Trim pour supprimer,
respectivement, les espaces avant la chanes, les espaces aprs la chane et les espaces la fois
avant et aprs la chane.

Dim MyVar
MyVar = LTrim( vbscript ) MyVar contains vbscript
MyVar = RTrim( vbscript ) MyVar contains vbscript
MyVar = Trim( vbscript ) MyVar contains vbscript

Mid
Retourne un nombre spcifi de caractres d'une chane.
Mid(string, start[, length])

Arguments

string
Chane partir de laquelle les caractres sont retourns. Si la chane string a la valeur Null, la
valeur Null est retourne.

start
Position du caractre de la chane partir duquel les caractres sont retourns. Si l'argument
start est suprieur au nombre de caractres de la chane, Mid retourne une chane vide ().

length
Nombre de caractres retourner. En l'absence d'indication pour cet argument ou si l'indication
est suprieure au nombre de caractres suivant le caractre de dpart (inclus), tous les caractres
suivant le caractre de dpart jusqu' la fin de la chane sont retourns.

Remarques
Pour dterminer le nombre de caractres de la chane, utilisez la fonction Len.
L'exemple ci-dessous utilise la fonction Mid pour retourner six caractres partir du 4me
caractre de la chane :

Dim MyVar
MyVar = Mid(VBScript is fun!, 4, 6) MyVar contains Script.

220 Expressions de script Visual Basic les plus courantes


Remarque :
La fonction MidB permet d'utiliser les donnes d'octets contenus dans une chane. Au lieu de
spcifier un nombre de caractres, les arguments spcifient le nombre d'octets.

MsgBox
Affiche un message sous la forme d'une bote de dialogue, attend que l'utilisateur clique sur un
bouton, et retourne une valeur indiquant sur quel bouton l'utilisateur a cliqu.
MsgBox(prompt[, buttons][, title][, helpfile, context])

Remarque :
La fonction MsgBox ne fonctionne pas dans le client Web. Les messages utilisant le client Web
doivent tre affichs dans une nouvelle fentre. Pour ce faire, utilisez l'acclrateur d'affichage
de messages du navigateur d'objets Workbench.

Arguments

prompt
Chane correspondant au message affich dans la bote de dialogue. La longueur maximum de
la chane prompt est environ 1 024 caractres, en fonction de la largeur de caractre utilise. Si
la chane prompt se compose de plusieurs lignes, vous pouvez les sparer par un retour chariot
(Chr(13)), un saut de ligne (Chr(10)) ou la combinaison d'un retour chariot et d'un saut de
ligne (Chr(13)) et (Chr(10)) entre deux lignes.

buttons
Expression numrique correspondant la somme des valeurs spcifiant le nombre et le type de
boutons afficher, le style d'icne afficher, le bouton par dfaut et les modalits de la bote de
dialogue. En l'absence d'indication pour cet argument, la valeur par dfaut du bouton est 0.

title
Chane correspondant au texte affich dans la barre de titre de la bote de dialogue. En cas
d'absence d'indication du titre, la barre de titre contient le nom de l'application.

helpfile
Chane identifiant le fichier d'aide utiliser pour fournir une aide contextuelle pour la bote de
dialogue. Si l'argument Helpfile est fourni, l'argument context doit galement tre fourni. Cet
argument n'est pas disponible dans les plates-formes 16 bits.

MsgBox 221
context
Expression numrique identifiant le numro affect par l'auteur de l'aide la rubrique de l'aide
concerne. Si l'argument context est fourni, l'argument helpfile doit galement tre fourni. Cet
argument n'est pas disponible dans les plates-formes 16 bits.
Remarques
Lorsque les deux arguments helpfile et context sont fournis, l'utilisateur peut appuyer sur la
touche F1 pour afficher la rubrique d'aide correspondant au contexte.
Si la bote de dialogue propose un bouton Annuler, l'utilisateur peut galement appuyer sur la
touche Echap pour annuler. Si la bote de dialogue contient un bouton Aide, une aide
contextuelle est fournie pour la bote de dialogue. Cependant, aucune valeur n'est retourne
jusqu' ce que l'utilisateur ait cliqu sur l'un des autres boutons.
Lorsque la fonction MsgBox est utilise avec Microsoft Internet Explorer, le titre des botes de
dialogue contient toujours VBScript: afin de les diffrencier des botes de dialogue standard
du systme.
L'exemple ci-dessous utilise la fonction MsgBox pour afficher un message et retourner une valeur
dcrivant sur quel bouton l'utilisateur a cliqu.

Dim MyVar
MyVar = MsgBox (Hello World!, 65, MsgBox Example)
MyVar contains either 1 or 2, depending on which button is clicked.

Now
Retourne la date et l'heure actuelles en fonction de la configuration de l'horloge de votre
ordinateur.
Now

Remarques
L'exemple ci-dessous utilise la fonction Now pour retourner la date et l'heure actuelles :

Dim MyVar
MyVar = Now MyVar contains the current date and time

Replace
Retourne une chane dans laquelle une sous-chane spcifie est remplace par une autre, un
nombre de fois spcifi.
Replace(expression, find, replacewith[, start[, count[, compare]]])

222 Expressions de script Visual Basic les plus courantes


Arguments

expression
Chane contenant la sous-chane remplacer (obligatoire).

find
Sous-chane recherche (obligatoire).

replacewith
Chane de remplacement (obligatoire).

start
Position dans l'expression laquelle la recherche doit commencer. En l'absence d'indication
pour cet argument, il prend la valeur 1 par dfaut. Cet argument doit tre associ un argument
count (facultatif).

count
Nombre de remplacements de chane effectuer. En l'absence d'indication pour cet argument,
la valeur par dfaut -1 est dfinie, ce qui signifie que toutes les substitutions sont possibles. Cet
argument doit tre associ un argument start (facultatif).

compare
Valeur numrique indiquant le type de comparaison utiliser lorsque les sous-chanes sont
values. Pour connatre les valeurs possibles pour cet argument, reportez-vous la section
suivante. En l'absence d'indication pour cet argument, la valeur par dfaut 0 est dfinie par
dfaut, ce qui signifie qu'une comparaison binaire est effectue (facultatif).

Paramtres
L'argument compare peut prendre les valeurs ci-dessous :

Constante Valeur Description

vbBinaryCompare 0 Comparaison binaire

vbTextCompare 1 Comparaison textuelle

Replace 223
Valeurs retournes
La fonction Replace retourne les valeurs ci-dessous :

Si Replace retourne

expression ne comporte pas de caractre une chane vide ()

expression a la valeur Null une erreur

find ne comporte pas de caractre une copie de l'expression

replacewith ne comporte pas de caractre une copie de l'expression avec toutes les occurrences de la chane
find trouve.

start > Len(expression) une chane vide

l'argument count est gal 0 une copie de l'expression

Remarques
La valeur retourne par la fonction Replace est une chane, une fois les remplacements effectus,
qui commence la position spcifie par l'argument start et se termine la fin de la chane. Il
ne s'agit pas d'une copie de la chane originale du dbut la fin.
L'exemple ci-dessous utilise la fonction Replace pour retourner une chane :

Dim MyString
A binary comparison starting at the beginning of the string.
MyString = Replace(XXpXXPXXp, p, Y)
Returns XXYXXPXXY.
A textual comparison starting at position 3.
MyString = Replace(XXpXXPXXp, p, Y, 3, -1, 1)
Returns YXXYXXY.

Right
Retourne un nombre spcifi de caractres partir de la droite d'une chane.
Right(string, length)

Arguments

string
Chane dont un nombre spcifi de caractres est retourn, en partant de la droite de cette chane.
Si la chane string a la valeur Null, la valeur Null est retourne.

224 Expressions de script Visual Basic les plus courantes


length
Expression numrique indiquant le nombre de caractres retourner. Si cette expression est
gale 0, une chane vide est retourne. Si cette expression est suprieure ou gale au nombre
de caractres de la chane, la chane entire est retourne.

Remarques
Pour dterminer le nombre de caractres de la chane, utilisez la fonction Len.
L'exemple ci-dessous utilise la fonction Right pour retourner un nombre spcifi de caractres,
en partant de la droite de la chane :

Dim AnyString, MyStr


AnyString = Hello World Define string.
MyStr = Right(AnyString, 1) Returns d.
MyStr = Right(AnyString, 6) Returns World.
MyStr = Right(AnyString, 20) Returns Hello World.

Remarque :
La fonction RightB permet d'utiliser les donnes d'octets contenus dans une chane. Au lieu de
spcifier le nombre de caractres retourner, elle spcifie le nombre d'octets.

UCase
Retourne une chane passe en lettres majuscules.
UCase(string)

L'argument string doit tre une chane valide. Si la chane string a la valeur Null, la valeur Null
est retourne.

Remarques
Seules les lettres en minuscule sont passes en majuscule, toutes les lettres dj en majuscule ou
les caractres autres que des lettres restent inchangs.
L'exemple ci-dessous utilise la fonction UCase pour retourner la chane en lettres majuscules :

Dim MyWord
MyWord = UCase(Hello World) Returns HELLO WORLD.

DoLoop
Rpte un bloc d'instructions tant qu'une condition est vraie (valeur True) ou jusqu' ce qu'une
condition devienne vraie (valeur True).

Do [{While | Until} condition]

UCase 225
[statements]
[Exit Do]
[statements]
Loop

Vous pouvez galement utiliser la syntaxe ci-dessous :

Do
[statements]
[Exit Do]
[statements]
Loop [{While | Until} condition]

Arguments

condition
Expression numrique ou chane ayant la valeur True ou False. Si l'argument condition a la
valeur Null, la condition est considre comme ayant la valeur False.

statements
Une ou plusieurs instructions rptes tant que la condition est vraie (Valeur True).

Remarques
L'instruction Exit Do ne peut tre utilise qu'avec une structure de contrle Do...Loop afin
de fournir une alternative la sortie de la fonction Do...Loop. Tout chiffre dans l'instruction
Exit Do doit tre plac dans la fonction Do...Loop, peu importe o. Souvent utilise pour
l'valuation de certaines structure de condition ( If...Then, par exemple), Exit Do transfre
immdiatement le contrle l'instruction suivant la Loop.
Lorsqu'elle est utilise dans des fonctions Do...Loop imbriques, l'instruction Exit Do
transfre le contrle la boucle de niveau suprieur.
Les exemples ci-dessous utilisent la fonction Do...Loop :

Do Until DefResp = vbNo


MyNum = Int(6 * Rnd + 1) Generate a random integer between 1 and 6.
DefResp = MsgBox (MyNum & Do you want another number?, vbYesNo)
Loop
Dim Check, Counter
Check = True: Counter = 0 Initialize variables.
Do Outer loop.
Do While Counter < 20 Inner loop.
Counter = Counter + 1 Increment Counter.
If Counter = 10 Then If condition is True...
Check = False set value of flag to False.
Exit Do Exit inner loop.
End If
Loop

226 Expressions de script Visual Basic les plus courantes


Loop Until Check = False Exit outer loop immediately.

If...Then...Else
Excute de faon conditionnelle un groupe d'instructions en fonction de la valeur d'une
expression.
If condition Then statements [Else elsestatements ]

Vous pouvez galement utiliser la syntaxe en blocs ci-dessous :

If condition Then
[statements]
[ElseIf condition-n Then
[elseifstatements]] . . .
[Else
[elsestatements]]
End If

Arguments

condition
Un ou plusieurs des types d'expression ci-dessous :
Expression numrique ou chane dterminant la valeur True ou False d'un lment. Si
l'argument condition a la valeur Null, la condition est considre comme ayant la valeur False.
Expression de la forme TypeOf objectname Is objecttype. L'lment objectname correspond
la rfrence d'un objet et objecttype correspond tout type d'objet valide. L'expression a la
valeur True si le type de l'objet objectname est celui spcifie par objecttype. Dans le cas
contraire, la valeur est False.

statements
Une ou plusieurs instructions spares par un point-virgule (;) et excutes si la condition a la
valeur True.

condition-n
Identique l'argument condition.

elseifstatements
Une ou plusieurs instructions excutes si l'argument condition-n a la valeur True.

If...Then...Else 227
elsestatements
Une ou plusieurs instructions excutes si aucun argument condition prcdent ou argument
condition-n n'a la valeur True.

Remarques
Vous pouvez utiliser la syntaxe en ligne unique pour les tests courts et simples. Cependant, la
structure en blocs est plus structure et souple que la syntaxe en ligne. Elle est en gnral plus
facile lire, modifier ou corriger.

Remarque :
Avec la syntaxe en ligne, il est possible d'excuter plusieurs instructions suite au rsultat de la
condition If...Then, mais ces instructions doivent tre sur la mme ligne et spares par un point-
virgule, comme dans l'exemple ci-dessous :

If A > 10 Then A = A + 1 : B = B + A : C = C + B

Lors de l'excution d'un bloc If (deuxime syntaxe), la condition est teste. Si la condition a la
valeur True, les instructions suivant l'lment Then sont excutes. Si la condition a la valeur
False, chaque lment ElseIf (le cas chant) est valu son tour. Lorsqu'une condition a la
valeur True, les instructions suivant l'lment Then associ sont excutes. Si aucun des lments
ElseIf n'a la valeur True (ou s'il n'y aucun lment ElseIf), les instructions suivant l'lment
Else sont excutes. Aprs avoir excut les instructions suivant l'lment Then ou Else,
l'excution du script continue avec l'instruction suivant l'lment End If.
Les lments Else et ElseIf sont facultatifs. Vous pouvez insrer autant d'lments ElseIf
que vous le souhaitez dans un bloc If, mais aucun ne doit apparatre aprs l'lment Else. Les
instructions du bloc If peuvent tre imbriques.
Ce qui suit l'lment Then est examin pour dterminer s'il s'agit ou non d'une instruction de
bloc If. Si aucun autre lment qu'un commentaire n'apparat aprs l'lment Then sur la mme
ligne, l'instruction est traite comme une instruction If unique.
Une instruction de bloc If doit tre la premire de la ligne. Le bloc If doit s'achever par l'lment
End If.

File System Object


Le modle d'obje FileSystemObject (FSO) vous permet d'utiliser la syntaxe usuelle
object.method avec un ensemble trs complet de proprits, de mthodes, d'vnements pour
le traitement de dossiers et de fichiers.

228 Expressions de script Visual Basic les plus courantes


Cration des fichiers
Il existe trois possibilits diffrentes pour crer un fichier texte vide (parfois appel text
stream ).
La premire possibilit consiste utiliser la mthode CreateTextFile. L'exemple ci-dessous
indique comment crer un fichier texte au moyen de la mthode CreateTextFileMethod.

[VBScript]
Dim fso, f1
Set fso = CreateObject(Scripting.FileSystemObject)
Set f1 = fso.CreateTextFile(c:\testfile.txt, True)

La deuxime possibilit consiste utiliser la mthode OpenTextFile de l'objet


FileSystemObject avec l'ensemble d'indicateurs ForWriting.

[VBScript]
Dim fso, ts
Const ForWriting = 2
Set fso = CreateObject(Scripting.FileSystemObject)
Set ts = fso.OpenTextFile(c:\test.txt, ForWriting, True)

La troisime possibilit consiste utiliser la mthode OpenAsTextStream avec l'ensemble


d'objets ForWriting.

[VBScript]
Dim fso, f1, ts
Const ForWriting = 2
Set fso = CreateObject(Scripting.FileSystemObject)
fso.CreateTextFile (c:\test1.txt)
Set f1 = fso.GetFile(c:\test1.txt)
Set ts = f1.OpenAsTextStream(ForWriting, True)

Ajout de donnes dans un fichier


Une fois le fichier texte cr, ajoutez les donnes dans le fichier en procdant comme suit :
1. Ouvrez le fichier texte.
2. Ecrivez les donnes.
3. Fermez le fichier.
Pour ouvrir un fichier existant, utilisez la mthode OpenTextFile de l'objet
FileSystemObject ou la mthode OpenAsTextStream.

Pour crire les donnes dans un fichier texte ouvert, utilisez les mthodes Write, WriteLine
ou WriteBlankLines de l'objet TextStream, en fonction des tches prsentes dans le tableau
suivant.

Tche Mthode

Ecriture des donnes dans un fichier texte ouvert sans saut de ligne final. Write

File System Object 229


Tche Mthode

Ecriture des donnes dans un fichier texte ouvert avec saut de ligne final. WriteLine

Ecriture d'une ou plusieurs lignes vierges dans un fichier texte. WriteBlankLines

Pour fermer un fichier ouvert, utilisez la mthode Close de l'objet TextStream.

Remarque :
Le saut de ligne se compose d'un ou de plusieurs caractres (en fonction du systme
d'exploitation) pour placer le curseur au dbut de la ligne suivante (retour chariot/saut de ligne).
Notez que la fin de certaines chanes peut dj contenir des caractres n'apparaissant pas
l'impression.

L'exemple ci-dessous explique comment ouvrir un fichier, utiliser les trois mthodes d'criture
pour ajouter des donnes un fichier, puis fermer le fichier :

[VBScript]
Sub CreateFile()
Dim fso, tf
Set fso = CreateObject(Scripting.FileSystemObject)
Set tf = fso.CreateTextFile(c:\testfile.txt, True)
Write a line with a newline character.
tf.WriteLine(Testing 1, 2, 3.)
Write three newline characters to the file.
tf.WriteBlankLines(3)
Write a line.
tf.Write (This is a test.)
tf.Close
End Sub

Lecture de fichiers
Pour lire des donnes dans un fichier texte, utilisez les mthodes Read, ReadLine ou
ReadAll de l'objet TextStream. Le tableau ci-dessous indique la mthode utiliser en fonction
des tches.

Tche Mthode

Lecture d'un nombre spcifi de caractres dans un fichier. Read

Lecture d'une ligne entire (jusqu'au saut de ligne, non inclus) ReadLine

Lecture du contenu entier d'un fichier texte ReadAll

Si vous utilisez les mthodes Read ou ReadLine et que vous souhaitez ignorer une partie des
donnes en particulier, utiliser les mthodes Skip ou SkipLine. Le texte rsultant des mthodes
de lecture est stock dans une chane pouvant tre affiche dans un contrle, analyse par des
fonctions traitant des chanes (Left, Right et Mid, par exemple), concatne, etc.

230 Expressions de script Visual Basic les plus courantes


L'exemple ci-dessous indique comment ouvrir un fichier et y crire et y lire des donnes.

[VBScript]
Sub ReadFiles
Dim fso, f1, ts, s
Const ForReading = 1
Set fso = CreateObject(Scripting.FileSystemObject)
Set f1 = fso.CreateTextFile(c:\testfile.txt, True)
Write a line.
Response.Write Writing file <br>
f1.WriteLine Hello World
f1.WriteBlankLines(1)
f1.Close
Read the contents of the file.
Response.Write Reading file <br>
Set ts = fso.OpenTextFile(c:\testfile.txt, ForReading)
s = ts.ReadLine
Response.Write File contents = & s &
ts.Close
End Sub

Dplacement, copie et suppression de fichiers


Le modle d'objet FSO dispose de deux mthodes pour dplacer, copier et supprimer des fichiers,
comme le montre le tableau suivant.

Tche Mthode

Dplacement d'un fichier File.Move or FileSystemObject.MoveFile

Copie d'un fichier File.Copy or FileSystemObject.CopyFile

Suppression d'un fichier File.Delete or FileSystemObject.DeleteFile

L'exemple ci-dessous cre un fichier texte en racine du lecteur C, y crit des donnes, dplace le
fichier dans un dossier nomm \tmp, en fait une copie dans un rpertoire nomm \temp, puis
supprime les copies des deux rpertoires.
Pour lancer l'exemple ci-dessous, crez deux rpertoires nomms \tmp et \temp en racine du
lecteur C:.

[VBScript]
Sub ManipFiles
Dim fso, f1, f2, s
Set fso = CreateObject(Scripting.FileSystemObject)
Set f1 = fso.CreateTextFile(c:\testfile.txt, True)
Response.Write Writing file <br>
Write a line.
f1.Write (This is a test.)
Close the file to writing.
f1.Close
Response.Write Moving file to c:\tmp <br>
Get a handle to the file in root of C:\.
Set f2 = fso.GetFile(c:\testfile.txt)

Dplacement, copie et suppression de fichiers 231


Move the file to \tmp directory.
f2.Move (c:\tmp\testfile.txt)
Response.Write Copying file to c:\temp <br>
Copy the file to \temp.
f2.Copy (c:\temp\testfile.txt)
Response.Write Deleting files <br>
Get handles to files current location.
Set f2 = fso.GetFile(c:\tmp\testfile.txt)
Set f3 = fso.GetFile(c:\temp\testfile.txt)
Delete the files.
f2.Delete
f3.Delete
Response.Write All done!
End Sub

232 Expressions de script Visual Basic les plus courantes

Potrebbero piacerti anche