run
La commande run exécute un fichier d'exécution MapForce Server (fichier .mfx) fourni en tant qu'argument. Le fichier d'exécution MapForce Server est créé avec MapForce et représente un mappage compilé pour être exécuté sur un serveur.
Tous les fichiers d'entrée requis par le mappage doivent se trouver dans le chemin spécifié lors de la conception du mappage dans MapForce. Si MapForce Server ne s'exécute pas sur le même système d'exploitation que MapForce, les fichiers d'entrée requis par le mappage doivent être copiés sur la machine cible avec le fichier .mfx et doivent être référencés à l'aide d'un chemin relatif. Pour plus d'informations sur les chemins relatifs ou absolus dans les mappages, consultez la documentation MapForce (https://www.altova.com/fr/documentation#mapforce). D'autres conditions préalables peuvent s'appliquer en fonction de la manière dont vous avez conçu le mappage. Pour plus d'informations, voir Préparer des mappages pour l'exécution de serveur.
Si le mappage renvoie une valeur simple telle qu'une chaîne, cette sortie est écrite dans le flux stdout (sortie standard). Les messages de réussite et d'erreur sont disponibles dans le flux stderr (sortie d'erreur standard). Si vous ne souhaitez pas que le flux de sortie standard s'affiche à l'écran avec les messages de réussite ou d'erreur, redirigez le flux de sortie standard ou le flux d'erreur standard (ou les deux) vers des fichiers. Si les flux stdout et stderr ne sont redirigés ni l'un ni l'autre, ils s'affichent tous deux à l'écran, combinés.
Par exemple, pour rediriger le flux de sortie standard vers un fichier, utilisez :
mapforceserver run MyMapping.mfx > MyOutput.txt |
Pour rediriger le flux d'erreur standard vers un fichier, utilisez :
mapforceserver run MyMapping.mfx 2> Diagnostics.log |
Pour rediriger les deux flux simultanément, utilisez :
mapforceserver run MyMapping.mfx > MyOutput.txt 2> Diagnostics.log |
Pour plus d'informations sur la redirection de flux, reportez-vous à la documentation du shell de commande de votre système d'exploitation.
Syntaxe
Windows | MapForceServer run [options] MfxFile |
Linux | mapforceserver run [options] MfxFile |
Options de commande
| --catalog=FILE | Spécifie le chemin absolu vers un fichier catalogue racine qui n'est pas le fichier catalogue racine installé. La valeur par défaut est le chemin absolu vers le fichier catalogue racine installé, voir Fichiers catalogue.
|
--cert | --certificatespath=FILE | S'applique à MapForce Server fonctionnant sous Linux. Spécifie le chemin vers le répertoire où sont stockés tous les fichiers de certificats requis par le mappage.
Voir aussi Gestion du certificat numérique.
|
--cp | --java-classpath=CLASSPATH | Spécifie le chemin de classe Java à utiliser (équivalent à l'option -cp lors du lancement de Java). MapForce Server transmet cette valeur au runtime Java.
|
--cred | --credential=KEY:VALUE | Il est utile de définir cette option si le mappage contient des informations d'identification que vous avez définies lors de la conception du mappage dans MapForce. KEY est le nom de l'information d'identification tel qu'il a été défini dans MapForce. VALUE se compose d'une ou plusieurs paires nom-valeur, par exemple :
name1=value1&name2=value2
Où name est l'un des éléments suivants :
•username •password •oauth:token
Lorsque vous utilisez plusieurs paires nom-valeur séparées par un esperluette, placez la partie KEY:VALUE entre guillemets. Pour des exemples, voir Identifiants.
|
--gc | --globalresourceconfig=VALUE | Cette option est applicable si le mappage utilise des ressources globales. Elle spécifie le nom de la configuration des ressources globales. Cette option doit être utilisée conjointement avec l'option --globalresourcefile. |
--gr | --globalresourcefile=FILE | Cette option est applicable si le mappage utilise des ressources globales. Elle spécifie le chemin d'accès au fichier de définition des ressources globales. Cette option doit être utilisée conjointement avec l'option --globalresourceconfig. |
| --java-ignore-codebase=true|false | Ignore le chemin d'accès à la base de code intégré dans le mappage, qui serait autrement utilisé pour localiser les fichiers de classe Java. Lorsqu'elle est définie sur true, seul le chemin d'accès à la classe Java est utilisé pour résoudre les classes. La valeur par défaut est false.
Utilisez --java-ignore-codebase=true avec --java-classpath pour vous assurer que seul le chemin d'accès à la classe spécifié est utilisé pour résoudre les classes Java.
|
--l | --lang | Langue utilisée pour afficher les messages.
|
--p | --param | Cette option est applicable si le mappage a été conçu pour accepter des paramètres d'entrée. Elle attribue une valeur à un paramètre défini dans le mappage. Forme : --param=ParamName:ParamValue. Le commutateur --param doit être utilisé avant chaque paramètre. Utilisez des guillemets si ParamName ou ParamValue contient un espace. Par exemple : --p=company:"Nanonull Inc".
Pour plus d'informations sur les mappages qui acceptent des paramètres d'entrée, consultez la documentation MapForce (https://www.altova.com/fr/documentation#mapforce).
|
| --taxonomy-package=FILE | Spécifie le chemin absolu vers un pack de taxonomie XBRL supplémentaire, comme décrit dans la recommandation Taxonomy Packages 1.0. La valeur de FILE indique l'emplacement du pack de taxonomie. Ajoutez cette option plusieurs fois pour spécifier plusieurs packs de taxonomie.
|
| --taxonomy-packages-config-file=FILE | Spécifie le chemin d'accès à un fichier de configuration nommé TaxonomyPackagesConfig.json, utilisé pour charger les packs de taxonomie XBRL. Ce fichier de configuration est mis à jour chaque fois que vous ajoutez, supprimez, activez ou désactivez des packs de taxonomie XBRL à partir de l'interface utilisateur graphique d'Altova XMLSpy, MapForce ou StyleVision. Si vous avez ajouté des packs de taxonomie XBRL personnalisés à l'aide de l'un des produits ci-dessus, le fichier se trouve à l'emplacement C:\Users\<username>\Documents\Altova.
|
Exemples
Cet exemple vous montre comment exécuter un fichier d'exécution de mappage (.mfx) avec MapForce Server sous Windows. Le mappage utilisé dans cet exemple lit un fichier d'entrée, Employees.xml, et produit deux fichiers de sortie (PersonList.xml et Contacts.xml).
Tout d'abord, générons le fichier d'exécution MapForce Server (.mfx) comme suit :
1.Exécutez MapForce et ouvrez le fichier de conception MapForce (.mfd) suivant : C:\Users\<user>\Documents\Altova\MapForce2026\MapForceExamples\ChainedPersonList.mfd.
2.Dans le menu Fichier, cliquez sur Compiler vers un fichier d’exécution (.mfx) de MapForce Server.
3.Lorsque vous y êtes invité, enregistrez le fichier .mfx dans le répertoire C:\temp. Ce sera le répertoire de travail dans lequel le mappage sera exécuté par MapForce Server.
Ensuite, ouvrez une invite de commande et changez le répertoire de travail en C:\temp\.
cd C:\temp |
Enfin, exécutez la commande suivante pour exécuter ChainedPersonList.mfx. Dans cet exemple, MapForce Server est appelé à l'aide d'un chemin absolu. (Pour l'appeler à l'aide d'un chemin relatif, ajoutez le chemin de l'exécutable à la variable d'environnement PATH de votre système).
"C:\Program Files (x86)\Altova\MapForceServer2026\bin\MapForceServer.exe" run ChainedPersonList.mfx |
Les deux fichiers de sortie (PersonList.xml et Contacts.xml) sont générés dans le répertoire de travail. Il est important de noter que ce mappage est configuré pour utiliser des chemins absolus, ce qui explique pourquoi il s'est exécuté avec succès et n'a pas nécessité la présence du fichier d'entrée Employees.xml dans le répertoire de travail. Le fichier Employees.xml existe en réalité dans le dossier MapForce Examples mentionné ci-dessus et est référencé via un chemin absolu. Pour spécifier si les chemins doivent être traités comme absolus ou relatifs, cliquez avec le bouton droit sur le mappage dans MapForce, sélectionnez Paramètres de mappage, puis cochez ou décochez la case Rendre les chemins absolus dans le code généré. Chaque fois que vous modifiez les paramètres de mappage, veillez à recompiler le mappage en .mfx. Pour plus d'informations, voir Préparer des mappages pour l'exécution de serveur.