Altova MapForce 2025 Professional 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é. Pour générer le code pour tout le projet, définir la cible /GENERATE (voir /{target} ci-dessous) et saisir le chemin du projet comme <filename> (par ex., 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 suivantes sont prises en charge.

•/XSLT

•/XSLT2

•/XSLT3

•La commande /COMPILE[:compileoptions] compile un mappage vers un fichier d’exécution de MapForce Server (.mfx). Vous pouvez aussi fournir les options suivantes séparées par une virgule :

oL’option JDBC transforme toutes les connexions de bases de données en JDBC utilisant le pilote JDBC et l'URL de base de données défini dans le dialogue Paramètres de composant de base de données.

oL’option NOXMLSIGNATURES masque la génération de signatures numériques dans le fichier d’Exécution de MapForce Server. Notez que les signatures numériques ne sont pas appuyées par MapForce Server.

•La commande /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 (.mfp) en tant que <filename>.

•/XQuery

•/JAVA

•La commande /CS génère un code C#. Cette commande permet de définir les options de génération de code suivants :

/CS[:{VS2013|VS2015|VS2017|VS2019|VS2022|DOTNETCORE31|DOTNET50|DOTNET60}]

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ération de code.

•La commande /CPP génère un code C++ Cette commande permet de définir les options de génération de code suivants :

/CPP[:{VS2013|VS2015|VS2017|VS2019|VS2022|DOTNETCORE31|DOTNET50|DOTNET60},{MSXML|XERCES3},{LIB|DLL},{MFC|NoMFC}]

Le premier groupe d’options précise l’environnement de développement (par ex., VS2022 signifie Visual Studio 2022).

Le deuxième groupe d'options spécifie la bibliothèque XML ciblée par le code généré. Les valeurs suivantes sont valides :

oMSXML (génère du code pour MSXML 6.0)

oXERCES3 (génère un code pour Xerces 3)

Le troisième groupe des options spécifie si les bibliothèques statiques par rapport aux bibliothèques dynamiques doivent être générées. Les valeurs valides incluent ce qui suit :

oLIB (génère des bibliothèques statiques LIB)

oDLL (génère des bibliothèques DLL)

Le quatrième groupe d’options spécifie si le code doit être généré avec ou sans prise en charge MFC. Les valeurs valides incluent ce qui suit :

oMFC (active la prise en charge MFC)

oNoMFC (désactive la prise en charge MFC)

Si les options ci-dessous ne sont pas spécifiées, le code sera généré en utilisant la version Visual Studio définie dans les options de génération 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 le paramètre <outputdir> n’est pas défini, le langage de génération de code et le chemin de sortie de chaque mappage sont fournis par les paramètres définis pour chaque dossier à l’intérieur du projet (voir Gérer Dossier de projet).

Lorsque la La section 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

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.

•L’option [/MFXVERSION[:<version>] est applicable si la cible est /COMPILE. Cette option compile le fichier MapForce Server Execution (.mfx) pour une version particulière de MapForce Server. Vous pouvez fournir toute version de MapForce Server, commençant par 2013r2 et supérieure. Voir aussi Compiler des mappages pour une version MapForce Server spécifique.

•L’option /LIBRARY <libname> (...) est utilisée ensemble 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 Gérer les Bibliothèques de fonction.

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