Interface de ligne de commande MapForce
La syntaxe générale d'une commande MapForce sous la ligne de commande :
MapForce.exe <filename> [/{target} [[<outputdir>] [/options]]] |
Légende
Les annotations suivantes sont utilisées pour indiquer une syntaxe de ligne de commande :
Notation | Description |
|---|---|
Texte sans crochets ou parenthèses | Items que vous devez saisir comme indiqué |
<Texte dans des des chevrons> | Caractère générique pour laquelle vous devez fournir une valeur |
[Texte dans des crochets] | Items optionnels |
{Texte dans des accolades} | Ensemble d'items requis ; en choisir un |
Barre verticale (|) | Le séparateur pour des items mutuellement exclusifs ; en choisir un |
Ellipse (...) | Items pouvant être répétés |
<filename>
Le fichier de design de mappage (.mfd) ou le projet de mappage (.mfp) à partir duquel le code doit être généré. Pour générer le code pour tout le projet, définir la cible /GENERATE (voir description ci-dessous) et saisir le chemin de projet sous <filename>, par exemple, MapForceExamples.mfp.
/{target}
Spécifie le langage cible ou l'environnement pour lequel le code doit être généré. Les cibles de génération de code suivants sont pris en charge.
Cible | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/COMPILE[:compileoptions] | Compile un mappage vers un fichier d'exécution MapForce Server (.mfx). En option, les options suivantes peuvent être fournies, délimitées par une virgule :
| ||||||||||||||||||||||
/GENERATE | Génère un code de projet pour tous les mappages dans le fichier de projet en utilisant les paramètres de dossier actuel, voir Gérer les dossiers de projet. Si vous choisissez cette cible, assurez-vous de fournir un projet MapForce (fichier .mfp) en tant que <filename>. | ||||||||||||||||||||||
/XSLT | Génère un code XSLT 1.0. | ||||||||||||||||||||||
/XSLT2 | Génère un code XSLT 2.0. | ||||||||||||||||||||||
/XSLT3 | Génère un code XSLT 3.0. | ||||||||||||||||||||||
/XQuery | Génère un code XQuery. | ||||||||||||||||||||||
/JAVA | Génère un code Java. | ||||||||||||||||||||||
/CS | Génère un code C#. Cette commande permet aussi en option de définir des options spécifiques pour la génération de code, concrètement :
/CS[:{VS2010|VS2013|VS2015|VS2017|VS2019}]
Si aucune version de Visual Studio n'est spécifiée, le code sera généré en utilisant la version Visual Studio définie dans les options de génération de code, voir Options de générateur de code. | ||||||||||||||||||||||
/CPP | Génère un code C++. Cette commande permet aussi en option de définir des options spécifiques pour la génération de code, concrètement :
/CPP[:{VS2010|VS2013|VS2015|VS2017},{MSXML|XERCES3},{LIB|DLL},{MFC|NoMFC}]
Le premier groupe d'option définit la version cible de Visual Studio. Valeurs valides :
Le deuxième groupe d'option spécifie la bibliothèque XML ciblée par le code généré. Valeurs valides :
Le troisième groupe d'option spécifie si les bibliothèques statiques par rapport aux bibliothèques dynamiques doivent être générées. Valeurs valides :
Le quatrième groupe d'option spécifie si le code doit être généré avec ou sans prise en charge MFC. Valeurs valides :
Si les options ci-dessous ne sont pas spécifiées, le code sera généré en utilisant la version Visual Studio définies dans les options de génération de code, voir Options de générateur de code. |
<outputdir>
Paramètre optionnel qui spécifie le répertoire de sortie. Si un chemin de sortie n'est pas fourni, le répertoire de travail actuel sera utilisé. Veuillez noter que tout chemin de fichier relatif sera relatif par rapport au répertoire de travail actuel.
Lorsque la cible est /GENERATE et que le paramètre <outputdir> n'est pas défini, le langage de génération de code, ainsi que le chemin de sortie de chaque mappage sont fournis par les paramètres définis pour chaque dossier dans le projet, voir Gérer les dossiers de projet.
Lorsque la cible est /GENERATE et que le paramètre <outputdir> est défini, la valeur <outputdir> fournie au niveau de la ligne de commande prend précédence sur le directoire de sortie définie au niveau du projet root. Néanmoins elle ne prend pas précédence sur les paramètres de génération de code définis dans chaque dossier dans le projet.
/options
/options ne sont pas exclusives mutuellement. Une ou plusieurs des options suivantes peuvent être définies.
Option | Description |
|---|---|
[/MFXVERSION[:<version>] | Cette option est applicable si la cible est /COMPILE. Elle compile le fichier MapForce Server Execution (.mfx) pour une version particulière de MapForce Server. Vous pouvez fournir en tant que valeur une version de MapForce Server, en commençant à partir de 2013r2, jusqu'à la version actuelle de MapForce. Voir aussi Compiler des mappages pour une version MapForce Server spécifique. |
/GLOBALRESOURCEFILE <filename> | Cette option est applicable si le mappage utilise des Ressources globales pour résoudre un fichier d'entrée ou de sortie ou des chemins de dossier ou des bases de données. Pour plus d'informations, voir Ressources globale Altova.
L'option /GLOBALRESOURCEFILE spécifie le chemin vers un fichier .xml de Ressources globales. Veuillez noter que, si /GLOBALRESOURCEFILE est défini, alors /GLOBALRESOURCECONFIG doit aussi être défini. |
/GLOBALRESOURCECONFIG <config> | Cette option spécifie le nom de la configuration de Ressource globale (voir aussi la version précédente). Veuillez noter que, si /GLOBALRESOURCEFILE est défini, alors /GLOBALRESOURCECONFIG doit aussi être défini. |
/LIBRARY <libname> (...) | Utiliser avec un langage cible de génération de code pour spécifier des bibliothèques de fonctions supplémentaires. Cette option peut être spécifiée plus d'une fois pour charger plusieurs bibliothèques. Voir aussi aGérer des Bibliothèques de fonction. |
/LOG <logfilename> | Génère un fichier de journal sous le chemin spécifié. <logfilename> peut être un nom de chemin complet, par exemple, il peut inclure un nom de répertoire et de fichier. Néanmoins, si un chemin complet est fourni, le répertoire doit exister pour que le fichier de journal soit généré. Si vous spécifiez uniquement le nom de fichier, celui-ci sera placé dans le répertoire actuel de l'invite de commande Windows. |
Remarques
•Les chemins relatifs sont relatifs par rapport au répertoire de travail, qui est le répertoire actuel de l'application appelant MapForce. Cela s'applique au chemin du nom de fichier .mfd, chemin du nom de fichier .mfp, au répertoire de sortie, au nom de fichier de journal, et au nom de fichier de ressource globale.
•Ne pas utiliser la barre oblique de la fin et les guillemets de fermeture au niveau de la ligne de commande (par exemple, "C:\My directory\"). Ces deux caractères sont interprétés par le parseur de ligne de commande en tant que double guillemet littéral. Utiliser les barres obliques renversées doubles \\ si les espaces se produisent au niveau de la ligne de commande et que vous devez utiliser les guillemets ("c:\My Directory\\"), ou essayer d'éviter d'utiliser les espaces et donc les guillemets.
Exemples
1) Pour lancer MapForce et ouvrir le mappage <filename>.mfd, utiliser :
MapForce.exe <filename>.mfd |
2) Pour générer un code XSLT 2.0 et créer un fichier log portant le nom <logfilename>, utiliser :
MapForce.exe <filename>.mfd /XSLT2 <outputdir> /LOG <logfilename> |
3) Pour générer un code XSLT 2.0 en prenant en compte la configuration de ressource globale <grconfigname> depuis le fichier de ressource globale <grfilename>, utiliser :
Mapforce.exe <filename>.mfd /XSLT2 <outputdir> /GLOBALRESOURCEFILE <grfilename> /GLOBALRESOURCECONFIG <grconfigname> |
4) Pour générer une application C# pour Visual Studio 2015 et sortir un fichier log, utiliser :
MapForce.exe <filename>.mfd /CS:VS2015 <outputdir> /LOG <logfilename> |
5) Pour générer une application C++ en utilisant les paramètres de génération de code définis dans Outils | Options, et sortir un fichier log, utiliser :
MapForce.exe <filename>.mfd /CPP <outputdir> /LOG <logfilename> |
6) Pour générer une application C++ pour Visual Studio 2015, MSXML, avec des bibliothèques statiques, prise en charge de MFC et pas de fichier log, utiliser :
MapForce.exe <filename>.mfd /CPP:VS2015,MSXML,LIB,MFC |
7) Pour générer une application C++ pour Visual Studio 2015, Xerces, avec des bibliothèques dynamiques, pas de prise en charge MFC et un fichier log, utiliser :
MapForce.exe <filename>.mfd /CPP:VS2015,XERCES,DLL,NoMFC <outputdir> /LOG <logfilename> |
8) Pour générer une application Java et sortir un fichier log, utiliser :
MapForce.exe <filename>.mfd /JAVA <outputdir> /LOG <logfilename> |
9) Pour générer un code pour tous les mappages dans le projet, en utilisant le langage et le répertoire de sortie définis dans les paramètres du dossier (de chaque dossier dans le projet), utiliser :
MapForce.exe <filename>.mfp /GENERATE /LOG <logfilename> |
10) Pour générer un code Java pour tous les mappages dans le fichier de projet, utiliser :
MapForce.exe <filename>.mfp /JAVA /LOG <logfilename> |
Veuillez noter que le langage de génération de code défini dans les paramètres de dossier sont ignorés et que Java est utilisé pour tous les mappages.
11) Pour fournir des fichiers d'entrée et de sortie dans la ligne de commande pour un mappage Java compilé précédemment, utiliser :
java -jar <mappingfile>.jar /InputFileName <inputfilename> /OutputFileName <outputfilename> |
Les paramètres /InputFileName et /OutputFileName sont les noms de composants d'entrée spéciaux dans le mappage MapForce qui vous permettent d'utiliser des paramètres dans l'exécution de la ligne de commande (voir Fournir des paramètres au mappage).
12) Pour compiler un mappage dans un fichier d'exécution MapForce Server, pour la version MapForce Server 2023, et réprimant les signatures XML :
MapForce.exe <filename>.mfd /COMPILE:NOXMLSIGNATURES <outputdir> /MFXVERSION:2023 /LOG <logfilename> |