Interface de ligne de commande de MapForce
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 :
Notation | Description |
|---|---|
Texte sans crochets ou parenthèses | Items que vous devez saisir comme indiqué |
<Texte dans des crochets pointus> | 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 |
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é.
/{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.
Cible de génération de code | Description |
|---|---|
/XSLT | |
/XSLT2 | |
/XSLT3 |
<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.
Une ou plusieurs des options suivantes peuvent être définies.
Option | Description |
|---|---|
/DIFF | Vous permet de comparer une ancienne version et une nouvelle version d'un même mappage. Pour plus de détails, consultez la section Différence de mappage. Pour comparer deux versions de mappage à partir de la ligne de commande, utilisez la commande suivante :
MapForce.exe <newer-mapping>.mfd /DIFF <older-mapping>.mfd
|
/DIFFREPORT <report> | Génère un fichier XML décrivant les différences entre les mappages spécifiés avec l'option /DIFF.
Pour générer un rapport XML des différences entre deux mappages, vous devez utiliser conjointement les options /DIFF et /DIFFREPORT :
MapForce.exe <newer-mapping>.mfd /DIFF <older-mapping>.mfd /DIFFREPORT <report>.xml
Lorsque l’option /DIFFREPORT est utilisée, MapForce n’ouvre pas la fenêtre principale. Le fichier de rapport est généré, que les mappages soient identiques ou qu’ils présentent des différences.
La commande renvoie l’un des codes de sortie suivants :
•0 – Les mappages sont identiques. •1 – Les mappages sont différents. •2 – Une erreur s’est produite lors de la comparaison.
Note : lorsque vous exécutez MapForce à partir d’une invite de commande Windows, utilisez start /wait pour attendre que MapForce ait terminé avant de récupérer le code de sortie avec %ERRORLEVEL%. Par exemple :
start "" /wait MapForce.exe <newer-mapping>.mfd /DIFF <older-mapping>.mfd /DIFFREPORT <report>.xml echo %ERRORLEVEL%
Sinon, l’invite de commande risque de ne pas attendre la fin de l’exécution de MapForce, et %ERRORLEVEL% risque de ne pas contenir le code de sortie de MapForce. Dans un fichier batch, l’invite de commande attend que MapForce ait terminé ; l’option start /wait n’est donc pas nécessaire.
|
/GLOBALRESOURCEFILE <filename> | Applicable si le mappage utilise des ressources globales pour résoudre un fichier d’entrée/sortie, des chemins d’accès à des dossiers ou des bases de données. Pour plus d'informations, voir Ressources globales Altova. Spécifie le chemin d’accès à un fichier XML de ressources globales. Si l’option /GLOBALRESOURCEFILE est définie, l’option /GLOBALRESOURCECONFIG doit également l’être.
|
/GLOBALRESOURCECONFIG <config> | Spécifie le nom de la configuration des ressources globales. Si l’option /GLOBALRESOURCEFILE est définie, l’option /GLOBALRESOURCECONFIG doit également l’être.
|
/LOG <logfilename> | Génère un fichier journal à l'emplacement spécifié. Si un chemin absolu est indiqué, le répertoire doit exister. Si seul un nom de fichier est indiqué, le fichier journal est créé dans le répertoire actuel de l'invite de commande Windows.
|
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>