Compiler des Mappages sur les fichiers d’exécution MapForce Server
Lorsque la langue cible d'un mappage créé dans MapForce est définie sur BUILT-IN, celui-ci peut être exécuté non seulement par MapForce, mais aussi par MapForce Server (voir À propos de MapForce Server). Il existe deux façons d'exécuter un mappage avec MapForce Server :
•si MapForce Server s'exécute en mode autonome (c'est-à-dire qu'aucun FlowForce Server n'est installé), le mappage doit être compilé en un fichier d'exécution serveur (.mfx), comme illustré ci-dessous. Vous pouvez ensuite exécuter le fichier .mfx à partir de la ligne de commande, à l'aide de la commande run. Vous pouvez aussi exécuter le mappage en invoquant la méthode run de l'API de MapForce Server. Pour plus d'informations, voir la documentation MapForce Server (https://www.altova.com/fr/documentation).
•Si MapForce Server est exécuté sous la gestion de FlowForce Server, vous pouvez déployer le mappage sur un ordinateur où MapForce Server et FlowForce Server sont tous deux exécutés. Pour plus d'informations sur ce scénario, voir Déployer des mappages vers FlowForce Server.
Prérequis
Voir Préparer des mappages pour l'exécution du serveur.
Pour compiler un mappage vers un fichier d'exécution MapForce Server (.mfx) :
1.ouvrez un mappage dans MapForce (par exemple, myMapping.mfd).
2.Dans le menu Fichier, cliquez sur Compiler vers un fichier d'exécution MapForce Server.
3.Sélectionnez le dossier dans lequel vous souhaitez placer le fichier .mfx et modifiez le nom du fichier si nécessaire.
4.Cliquez sur Enregistrer. Le fichier d'exécution MapForce Server myMapping.mfx est généré dans le dossier sélectionné.
Pour compiler un mappage vers un fichier d'exécution MapForce Server (.mfx) à l'aide de la ligne de commande :
•exécutez MapForce à partir de la ligne de commande, puis spécifiez le fichier de mappage et l'option de ligne de commande /COMPILE.
Par exemple, la commande suivante compile le mappage C:\Users\altova\Documents\Altova\MapForce2026\MapForceExamples\SimpleTotal.mfd dans un fichier d'exécution MapForce Server qui sera créé dans le répertoire de sortie cible C:\Users\altova\Desktop.
"C:\Program Files (x86)\Altova\MapForce2026\MapForce.exe" "C:\Users\altova\Documents\Altova\MapForce2026\MapForceExamples\SimpleTotal.mfd" /COMPILE "C:\Users\altova\Desktop" |
Voir aussi Interface de ligne de commande MapForce.
Contenu du fichier .mfx
Le fichier .mfx contient les données suivantes :
•l'algorithme de mappage, qui inclut toutes les fonctions définies par l'utilisateur (UDF) importées à partir d'autres mappages.
•Les noms des fichiers d'entrée et de sortie référencés à partir des composants. Les chemins d'accès sont absolus ou relatifs selon les paramètres de mappage, voir Chemins d'accès dans différents environnements d'exécution.
•Si le mappage contient des composants XML, les informations relatives au schéma XML nécessaire à l'exécution du mappage sont encodées dans l'algorithme de mappage.
•Les détails de connexion à la base de données, si le mappage inclut des connexions à une base de données. Les mots de passe sont cryptés.
•Informations1 dérivées des éléments suivants, selon le cas pour chaque mappage :
oconfigurations EDI et FlexText
oschémas JSON
ofichiers .proto
•Si le mappage inclut des informations d'identification, les champs sensibles sont inclus, sous forme cryptée, si vous avez coché la case Inclure dans le fichier d'exécution MapForce Server et le déploiement de mappage. Sinon, les champs sensibles sont ignorés. Pour plus de détails, voir Identifiants.
Notes de bas de page :
1.Les informations issues des configurations EDI ou FlexText, des schémas JSON ou des fichiers .proto sont intégrées au fichier .mfx sous une forme compilée et traitée. Il n'est pas possible d'obtenir les fichiers source d'origine à partir d'un fichier .mfx compilé. Les données sont compilées dans l'état où elles se trouvent au moment de la compilation ; si vous les modifiez par la suite, le fichier .mfx doit être recompilé.
Les fichiers d'instance d'entrée (XML, CSV, Texte, EDI, Excel, JSON, XBRL) utilisés par le mappage ne sont pas inclus dans le fichier .mfx compilé. Il en va de même pour les bases de données basées sur des fichiers telles qu'Access ou SQLite. Si le mappage fait référence à des taxonomies XBRL liées à la prise en charge des tables XBRL, les informations de taxonomie ne sont pas compilées dans le fichier .mfx. Pour plus d'informations, voir Préparer les mappages pour l'exécution de serveur.
Compiler des mappages pour une version spécifique de MapForce Server
Si votre MapForce Server dispose d'une version antérieure à MapForce, il se peut que le premier ne puisse pas exécuter les fichiers .mfx créés avec une version plus récente de MapForce, car de nouvelles fonctionnalités ont probablement été ajoutées entre-temps. Dans ce cas, vous pouvez compiler le fichier .mfx pour une version spécifique de MapForce Server, comme suit :
1.Dans le menu Outils, cliquer sur Options, puis cliquer sur Génération.
2.Sous Fichier d'exécution du serveur, à côté de Générer pour la version MapForce Server, sélectionnez la version requise de MapForce Server dans la liste déroulante.
Une fois que vous disposez d'une version plus récente de MapForce Server, n'oubliez pas de modifier cette option en conséquence. Si vous n'avez aucune raison particulière de compiler pour une version spécifique de MapForce Server, sélectionnez l'option « la plus récente » (il s'agit de l'option par défaut). Lorsque cette option est sélectionnée, le fichier .mfx est compilé pour la version la plus récente de MapForce Server et peut bénéficier des dernières fonctionnalités et améliorations qui pourraient ne pas être disponibles dans les versions précédentes.
Pour spécifier une version cible de MapForce Server à partir de la ligne de commande, exécutez la commande /COMPILE avec le commutateur /MFXVERSION, par exemple :
"C:\Program Files (x86)\Altova\MapForce2026\MapForce.exe" /COMPILE /MFXVERSION:2026 |
Voir aussi Interface de ligne de commande MapForce.
Autres options
La compilation des fichiers d'exécution MapForce Server est également affectée par les options suivantes :
convertir toutes les connexions de base de données ADO et ODBC en JDBC | Si cette option est activée, les connexions de base de données ADO, ADO.NET et ODBC sont transformées en JDBC à l'aide du pilote JDBC et de l'URL de base de données définis dans le dialogue Paramètres de composant de base de données (voir Paramètres de composant de base de données).
La connexion JDBC sera utilisée implicitement si la machine cible est un serveur Linux. |
Ignorer les signatures numériques (non prises en charge par MapForce Server) | Cette option s'applique uniquement à MapForce Enterprise. Elle est activée par défaut. Si le mappage utilise des signatures numériques XML, les informations de signature numérique sont ignorées, car MapForce Server ne prend pas en charge les signatures numériques XML. |
Pour afficher ou modifier ces options :
•dans le menu Outils, cliquez sur Options, puis cliquez sur Génération.
Ces options sont également disponibles depuis l'interface de ligne de commande. Voir aussi Interface de ligne de commande MapForce.