Altova MapForce 2027 Basic Edition

Cet exemple vous guide à travers les étapes nécessaires à l'exécution d'un mappage qui prend des paramètres d'entrée lors de l'exécution. Le fichier de conception du mappage utilisé dans cet exemple est disponible à l'emplacement suivant : <Documents>\Altova\MapForce2027\MapForceExamples\FileNamesAsParameters.mfd.

Ce mappage lit les données d'un fichier XML source et les écrit dans un fichier XML cible. Les données sont écrites dans le fichier cible pratiquement sans modification ; seuls les attributs PrimaryKey et Name sont renseignés avec certaines valeurs constantes issues du mappage. L'objectif principal de ce mappage est de permettre à l'appelant de spécifier le nom du fichier d'entrée et celui du fichier de sortie, en tant que paramètres de mappage, lors de l'exécution du mappage.

Pour ce faire, le mappage comporte deux composants d'entrée : InputFileName et OutputFileName. Ces paramètres fournissent le nom du fichier d'entrée (et, respectivement, le nom du fichier de sortie) des fichiers XML source et cible. C'est pourquoi ils sont liés à l'élément File : Item <dynamic>. Vous pouvez basculer un composant dans ce mode en cliquant sur le bouton Fichier ( ) , puis en sélectionnant Utiliser les noms de fichiers dynamiques fournis par le mappage.

FileNamesAsParameters.mfd (MapForce Enterprise Edition)

Si vous double-cliquez sur la barre de titre de l’un des composants InputFileName et OutputFileName, vous pouvez afficher ou modifier leurs propriétés. Par exemple, vous pouvez spécifier le type de données du paramètre d’entrée ou modifier le nom du paramètre d’entrée, comme décrit dans la section Paramètres des composants à entrée simple. Dans cet exemple, les paramètres d'entrée et de sortie sont configurés comme suit :

•Le paramètre InputFileName est de type "string" et sa valeur par défaut est fournie par une constante définie dans le même mappage. La constante est de type "string" et sa valeur est "Altova_Hierarchical.xml". Par conséquent, lors de l'exécution de ce mappage, celui-ci tentera de lire les données à partir d'un fichier nommé "Altova_Hierarchical.xml", à condition que vous ne fournissiez pas d'autre valeur en tant que paramètre.

•Le paramètre OutputFileName est de type "string" et possède également une valeur par défaut fournie par une constante définie dans le même mappage. La constante est de type "string" et sa valeur est "Altova_Hierarchical_output.xml". Par conséquent, le mappage créera un fichier de sortie XML nommé "Altova_Hierarchical_output.xml" lors de son exécution, à condition que vous ne fournissiez pas une autre valeur en tant que paramètre.

Les sections suivantes expliquent comment exécuter le mappage et fournir des paramètres dans les langages de transformation suivants :

•XSLT 2.0, avec RaptorXML Server

XSLT 2.0

Si vous générez du code en XSLT 1.0, XSLT 2.0 ou XSLT 3.0, un fichier batch DoTransform.bat est créé dans le répertoire cible choisi, en plus du fichier XSLT. Le fichier DoTransform.bat vous permet d’exécuter le mappage avec RaptorXML Server ; voir Automatisation avec RaptorXML Server.

Pour utiliser un fichier d’entrée (ou de sortie) différent, modifiez le fichier DoTransform.bat afin d’y inclure les paramètres requis, comme suit :

1.Commencez par générer le code XSLT. Par exemple, pour générer du code XSLT 2.0, sélectionnez la commande de menu Fichier | Générer le code en | XSLT 2.0.

2.Copiez le fichier Altova_Hierarchical.xml depuis <Documents>\Altova\MapForce2027\MapForceExamples\ vers le répertoire dans lequel vous avez généré le code XSLT 2.0 (dans cet exemple, c:\codegen\examples\xslt2). Comme indiqué précédemment, le mappage tentera de lire ce fichier si vous ne fournissez pas de valeur personnalisée au paramètre InputFileName.

3.Modifiez le fichier DoTransform.bat afin d’inclure le paramètre d’entrée personnalisé avant ou après %*. Notez que la valeur du paramètre est placée entre des guillemets simples. Les paramètres d’entrée disponibles sont répertoriés dans la section rem (Remarque). Supposons que vous souhaitiez générer un fichier de sortie nommé output.xml. Pour ce faire, modifiez le fichier DoTransform.bat comme suit :

Lorsque vous exécutez le fichier DoTransform.bat, RaptorXML Server effectue la transformation en utilisant Altova_Hierarchical.xml comme fichier d'entrée. Si vous avez suivi les étapes ci-dessus, le nom du fichier de sortie généré sera output.xml.