Altova MapForce 2027 Professional Edition

L'interface de ligne de commande de MapForce vous permet d'automatiser des tâches telles que :

•L’ouverture de mappages

•La génération de code de mappage

•La compilation de mappages pour MapForce Server (éditions Professional et Enterprise)

•La génération de code pour les projets (éditions Professional et Enterprise)

•La création de fichiers journaux

•La comparaison de deux mappages

Syntaxe

La syntaxe de la ligne de commande est la suivante :

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

Comment exécuter des commandes

Pour exécuter des commandes à partir de la ligne de commande, accédez au répertoire d’installation de MapForce. Par exemple :

C:\Program Files\Altova\MapForce2027

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>

Fait référence au design de mappage (.mfd) ou au 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é. Le tableau ci-dessous récapitule les cibles de génération de code prises en charge.

<outputdir>

Paramètre facultatif qui spécifie le répertoire de sortie. S'il n'est pas fourni, le répertoire de travail actuel est utilisé. Les chemins relatifs s’entendent par rapport au répertoire de travail actuel.

Lorsque la cible est définie sur /GENERATE, les règles suivantes s’appliquent :

•Si <outputdir> n’est pas spécifié, le langage de génération de code et le chemin de sortie définis pour chaque dossier de projet sont utilisés (voir Dossiers de projet).

•Si <outputdir> est spécifié, il remplace le répertoire de sortie défini au niveau racine du projet, mais pas les paramètres de génération de code définis pour les dossiers de projet individuels.

/options

Une ou plusieurs des options suivantes peuvent être définies.

Notes

•Les chemins relatifs s'entendent par rapport au répertoire courant de l'application qui appelle MapForce. Cela s'applique aux chemins d'accès aux fichiers .mfd et .mfp, au répertoire de sortie, au fichier journal et au fichier de ressources globales.

•N’utilisez pas de barre oblique inversée à la fin de la ligne de commande, avant le guillemet de fermeture (par exemple, "C:\My directory\"). L’analyseur de ligne de commande interprète la barre oblique inversée et le guillemet de fermeture comme un guillemet double littéral. Si un chemin d’accès contient des espaces et doit être placé entre guillemets, utilisez une double barre oblique inversée avant le guillemet de fermeture (par exemple, "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 2027, et réprimant les signatures XML :

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