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; il représente principalement un mappage compilé pour l'exécution de serveur.
Tout fichier d'entrée requis par le mappage est censé se trouver dans le chemin spécifié au niveau du moment de design de mappage dans MapForce. Si MapForce Server n'est pas exécuté sur le même système d'exploitation en tant que MapForce, les fichiers d'entrée requis par le mappage doivent être copiés sur l'appareil cible avec le fichier .mfx, et doivent être référencé avec un chemin relatif. Pour plus d'informations concernant la configuration un mappage par rapport aux chemins relatifs ou absolus, se référer à la documentation MapForce (https://www.altova.com/fr/documentation#mapforce). Les autres exigences préalables peuvent s'appliquer, selon la manière dont vous avec conçu le mappage, voir Préparer les mappages pour l'Exécution de serveur.
Si le mappage retourne une valeur simple, cette sortie est écrite dans le stream stdout (sortie standard). D'un autre côté, le succès et les messages d'erreur sont disponibles dans le stream stderr (erreur standard). Si vous ne souhaitez pas afficher le stream de sortie standard sur l'écran avec les messages de réussite ou d'erreur, rediriger soit le stream de sortie standard, soit le stream d'erreur the standard (ou les deux) vers les fichiers. Si ni les streams stdout ni stderr ne sont redirigés, ils sont tous les deux affichés sur l'écran.
Par exemple, pour rediriger le stream de sortie standard vers un fichier, utilisez :
mapforceserver run MyMapping.mfx > MyOutput.txt |
Pour rediriger le stream d'erreur standard sur un fichier, utiliser :
mapforceserver run MyMapping.mfx 2> Diagnostics.log |
Pour rediriger les deux streams simultanément, utiliser :
mapforceserver run MyMapping.mfx > MyOutput.txt 2> Diagnostics.log |
Pour plus d'informations concernant la redirection de stream, veuillez vous référer à la documentation de votre shell de commande du système d'exploitation.
Syntaxe
Windows | MapForceServer run [options] MfxFile |
Linux | mapforceserver run [options] MfxFile |
Mac | mapforceserver run [options] MfxFile |
Options de commande
| --catalog | Spécifie le chemin absolu vers un fichier de catalogue racine qui n'est pas le fichier de catalogue racine installé. La valeur par défaut est le chemin absolu vers le fichier de catalogue racine installé, voir Fichiers Catalogue. Forme : --catalog=FILE |
--cert | --certificatespath | Cette commande s'applique au Serveur MapForce Server qui marche sur Linux. Il spécifie le chemin vers le répertoire où les fichiers de certificats requis par le mappage sont stockés. Forme : --certificatespath=DIRECTORY
Voir aussi Digital Certificate Management. |
--cred | --credential=KEY:VALUE | La configuration de cette option est utile si le mappage contient des identifiants que vous avez définis au moment de la conception du mappage dans MapForce. KEY est le nom d'identifiant tel qu'il a été défini dans MapForce. VALUE consiste en une ou plusieurs paires nom-valeur, par exemple :
name1=value1&name2=value2
Où name est un des suivants :
•username •password •oauth:token
Lorsque vous utilisez plusieurs paires nom-valeur séparées par une esperluette, vous devrez contenir la partie the KEY:VALUE entre guillemets. Pour plus de détails, voir Identifiants. |
--gc | --globalresourceconfig | Cette option est applicable si le mappage consomme des Ressources globales. Elle spécifie le nom de la configuration de ressource globale. Cette option doit être utilisée avec l'option --globalresourcefile. |
--gr | --globalresourcefile | Cette option est applicable si le mappage consomme des Ressources globales. Elle spécifie le chemin du fichier de définition de la ressource globale. Cette option doit être utilisée avec l'option --globalresourceconfig. |
--l | --lang | La langue utilisée pour afficher les messages. |
--p | --param | Cette option est applicable si le mappage a été conçu pour prendre des paramètres d'entrée. Elle attribue une valeur à un paramètre défini dans le mappage. Forme: --param=ParamName:ParamValue. Le switch --param doit être utilisé avant chaque paramètre. Utiliser des guillemets si ParamName ou ParamValue contient un espace. Par exemple : --p=company:"Nanonull Inc".
Pour plus d'informations concernant les mappage qui prennent des paramètres d'entrée, veuillez vous référer à la documentation MapForce (https://www.altova.com/fr/documentation#mapforce). |
| --taxonomy-package | Spécifie le chemin absolu vers un paquet de taxonomie XBRL supplémentaire tel que décrit dans les recommandations de Taxonomy Packages 1.0. La valeur de FILE (Fichier) indique l'emplacement du paquet de taxonomie. Ajouter l'option plusieurs fois pour spécifier plus d'un paquet de taxonomie. Forme : --taxonomy-package=FILE |
| --taxonomy-packages-config-file | Spécifie le chemin vers un fichier de configuration appelé TaxonomyPackagesConfig.json, utilisé pour charger les paquets de taxonomie XBRL. Ce fichier de configuration est mis à jour à chaque fois que vous ajoutez, supprimez, activez ou désactivez les paquets de taxonomie XBRL depuis l'interface d'utilisateur graphique d'Altova XMLSpy, MapForce ou StyleVision. Si vous avez rajouté des paquets de taxonomie personnalisés XBRL avec un des produits ci-dessus, le fichier est situé sous C:\Users\<username>\Documents\Altova. Forme : --taxonomy-packages-config-file=FILE |
Exemples
Cet exemple vous montre comment exécuter un fichier d'exécution de mappage (.mfx) avec MapForce Server sur 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).
D'abord, générons le fichier d'exécution MapForce Server (.mfx), comme suit :
1.Exécutez MapForce et ouvrez le fichier de design MapForce suivant (fichier .mfd): C:\Users\<user>\Documents\Altova\MapForce2024\MapForceExamples\ChainedPersonList.mfd.
2.Dans le menu Fichier, cliquer sur Compiler sur le fichier d'exécution de MapForce Server.
3.Sur invitation, enregistrer le fichier .mfx sur le répertoire C:\temp. Ce sera le répertoire de travail où le mappage sera exécuté par MapForce Server.
Ensuite, ouvrons une invite de ligne de commande et modifier le répertoire de travail dans C:\temp\.
cd C:\temp |
Enfin, appelez la commande pour exécuter ChainedPersonList.mfx. Dans cet exemple, MapForce Server est appelé en utilisant un chemin absolu. (Pour l'appeler avec un chemin relatif, ajouter le chemin de l'exécutable dans votre variable d'environnement PATH de votre système).
"C:\Program Files (x86)\Altova\MapForceServer2024\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. De manière plus importante, ce mappage est configuré pour utiliser les chemins absolus, ce qui est pourquoi le mappage a été exécuté avec succès et ne nécessite pas que le fichier d'entrée Employees.xml existe dans le répertoire de travail. Le fichier Employees.xml existe réellement dans le dossier MapForce Examples mentionné ci-dessus et est référencé par le biais d'un chemin absolu. Pour spécifier si des chemins doivent être traités en tant que chemins absolus ou relatifs, cliquer avec la touche de droite sur la mappage dans MapForce, sélectionner Mapping Settings, puis sélectionner ou supprimer la case à cocher Rendre les chemins absolus dans le code généré. Si vous modifiez les paramètres de mappage, assurez-vous de re-compiler le mappage sur .mfx. Pour plus d'informations, voir Préparer des mappages pour l'exécution de serveur.