Altova MapForce 2025 Basic Edition

La syntaxe générale d'une commande MapForce sous la ligne de commande :

MapForce.exe <filename> [/{target} [[<outputdir>] [/options]]]

Pour plus d’information sur chaque paramètre de la commande, voir Parameters ci-dessous.

Notation

Les annotations suivantes sont utilisées pour indiquer une syntaxe de ligne de commande :

Paramètres

<filename>

Le fichier de design de mappage (.mfd) ou le projet de mappage (.mfp) (éditions Professional et Enterprise) à partir duquel le code doit être généré.

/{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 suivantes sont prises en charge.

•/XSLT

•/XSLT2

•/XSLT3

<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.

/options

Les /options ne sont pas exclusives mutuellement. Une ou plusieurs des options suivantes peuvent être définies :

•L’option /GLOBALRESOURCEFILE <filename> 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 globales 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.

•L’option /GLOBALRESOURCECONFIG <config> 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.

•L’option /LOG <logfilename> génère un fichier log dans le chemin spécifié. Le chemin <logfilename> peut être un chemin absolu. 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.

Notes

•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, 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. Il est recommandé d’éviter les espaces et les guillemets. Si les espaces apparaissent dans la ligne de commande et si vous avez besoin de guillemets, utilisez les barres obliques inverses doubles (par ex., "c:\My Directory\\").

Exemples

1) Pour lancer MapForce et ouvrir le mappage <filename>.mfd, utilisez la commande suivante :

MapForce.exe <filename>.mfd

2) Pour générer un code XSLT 2.0 et créer un fichier log portant le nom <logfilename>, utilisez la commande suivante :

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>

Exemple d’éditions Professional et Enterprise

1) Pour générer une application C# pour Visual Studio 2022 et sortir un fichier log, utilisez la commande suivante :

MapForce.exe <filename>.mfd /CS:VS2022 <outputdir> /LOG <logfilename>

2) 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>

3) Pour générer une application C++ pour Visual Studio 2022, MSXML, avec des bibliothèques statiques, prise en charge de MFC et pas de fichier log, utilisez la commande suivante :

MapForce.exe <filename>.mfd /CPP:VS2022,MSXML,LIB,MFC

4) Pour générer une application C++ pour Visual Studio 2022, Xerces, avec des bibliothèques dynamiques, pas de prise en charge MFC et un fichier log, utilisez la commande suivante :

MapForce.exe <filename>.mfd /CPP:VS2022,XERCES,DLL,NoMFC <outputdir> /LOG <logfilename>

5) Pour générer une application Java et sortir un fichier log, utilisez la commande suivante :

MapForce.exe <filename>.mfd /JAVA <outputdir> /LOG <logfilename>

6) 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), utilisez la commande suivante :

MapForce.exe <filename>.mfp /GENERATE /LOG <logfilename>

7) Pour générer un code Java pour tous les mappages dans le fichier de projet, utilisez la commande suivante :

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.

8) Pour fournir des fichiers d'entrée et de sortie dans la ligne de commande pour un mappage Java compilé précédemment, utilisez les commandes suivantes :

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).

9) Pour compiler un mappage dans un fichier d'exécution MapForce Server, pour la version MapForce Server 2025, et réprimant les signatures XML :

MapForce.exe <filename>.mfd /COMPILE:NOXMLSIGNATURES <outputdir> /MFXVERSION:2025 /LOG <logfilename>