Ligne de commande MapForce Server
MapForce Server fournit une interface de ligne de commande que vous pouvez utiliser pour des tâches administratives telles que la gestion des licences, et pour exécuter les fichiers d’exécution de mappage (.mfx). Les commandes disponibles sont recensées ci-dessous.
•assignlicense : (uniquement Windows) télécharge une licence vers le LicenseServer et attribue la licence à MapForce Server.
•exportresourcestrings : exporte tous les strings de ressource d’application vers un fichier XML.
•help : affiche des informations sur la commande qui est soumise comme argument (ou sur toutes les commandes si aucun argument n’est soumis).
•licenseserver : Enregistre MapForce Server avec un LicenseServer sur le réseau local.
•run : exécute un fichier d’exécution de mappage (.mfx) compilé avec MapForce.
•setdeflang : définit la langue par défaut de MapForce Server.
•verifylicense : (uniquement Windows) vérifie si la version actuelle de MapForce Server est sous licence et, en option, si la version est sous licence avec la clé de licence donnée.
•version : affiche le numéro de la version de MapForce Server.
Pour appeler MapForce Server dans la ligne de commande, vous devrez connaître le chemin du programme d'exécution tel qu'applicable dans votre système d'exploitation. Par défaut, le programme d'exécution MapForce Server est installé sur le chemin suivant :
Linux | /opt/Altova/MapForceServer2025/bin/mapforceserver |
macOS | /usr/local/Altova/MapForceServer2025/bin/mapforceserver |
Windows | C:\Program Files\Altova\MapForceServer2025\bin\MapForceServer.exe |
Note: | Si MapForce Server 32-bit est installé sur Windows 64-bit, changer C:\Program Files en C:\Program Files (x86). |
Par convention, cette documentation omet le chemin complet du programme d'exécution lors de la description d'une commande donnée et utilise mapforceserver au lieu du nom du programme d'exécution, par exemple :
mapforceserver help |
mapforceserver est le chemin du programme d'exécution. Veuillez noter que, si vous utilisez un chemin absolu, vous pourrez exécuter des commande quelque soit le répertoire actuel dans lequel votre fenêtre (terminal) d'invite de commande se trouve. Néanmoins, si vous souhaitez appeler le programme d'exécution en ne saisissant que son nom, veuillez vous assurer de suivre l'une des deux étapes auparavant :
•Changer le répertoire actuel du terminal dans le répertoire d'installation de MapForce Server
•Ajouter le répertoire dans lequel le programme d'exécution se trouve à la variable d'environnement PATH.
Ces deux scénarios sont décrits en détail ci-dessous.
Trucs et astuces
Si vous ne maîtrisez pas encore la ligne de commande, nous vous proposons les astuces suivantes.
•Pour connaître le répertoire actuel dans lequel se trouve la ligne de commande, saisir pwd sur Linux et macOS. Sur Windows, saisir echo %CD%.
•Utilisez la touche Tab pour vous déplacer rapidement dans les chemins de dossier ou de répertoire sans devoir les saisir en entier. Par exemple, si vous saisissez cd c:\prog dans la ligne de commande, puis que vous appuyez sur Tab, C:\Program Files sera rempli automatiquement (ou peut-être un autre répertoire sous C:\ dont le nom commence avec "Prog").
•Lorsque vous saisissez des chemins qui contiennent un espace blanc, comme C:\Program Files sur Windows, veillez à les contenir dans des guillemets.
•Si vous voyez un message semblable à "Cette commande n'est pas reconnue en tant que commande interne ou externe, programme opérable ou fichier batch", il s'agit probablement d'une erreur d'écriture du chemin ou de la commande.
•Sur Linux, veuillez vous assurer que vous utilisez la casse correcte pour les noms de dossier ou de répertoire. Par exemple, la saisie d'un chemin comme /home/nikita/downloads retournera une erreur si le nom du répertoire est en fait /home/nikita/Downloads.
•Lorsque vous saisissez un chemin sur Linux ou sur macOS, utiliser la barre oblique vers l'avant, contrairement aux barres obliques vers l'arrière sur Windows.
Comment exécuter une commande
1.Ouvrir une fenêtre d'invite de commande.
a.Pour ouvrir une invite de commande sur Windows, appuyer sur la touche Windows et commencer à saisir cmd. Cliquer sur la suggestion Command Prompt qui apparaît.
b.Pour ouvrir un terminal sur Mac, cliquer sur l'icône Finder, puis sélectionner Go > Utilities depuis le menu. Double-cliquer sur l'icône Terminal dans la fenêtre Utilities.
c.Si vous exécutez Linux depuis une interface d'utilisateur graphique, situer et exécuter la commande Terminal telle qu'applicable à votre distribution . Si vous exécutez Linux depuis une interface de ligne de commande, ignorer cette étape.
2.Saisir le chemin complet vers le programme d'exécution, suivi par la commande que vous souhaitez exécuter. Par exemple, la commande ci-dessous propose de l'aide dans la ligne de commande.
Linux | /opt/Altova/MapForceServer2025/bin/mapforceserver help |
macOS | /usr/local/Altova/MapForceServer2025/bin/mapforceserver help |
Windows | C:\Program Files (x86)\Altova\MapForceServer2025\bin\MapForceServer.exe help |
Dans l'exemple ci-dessus, la commande help était exécutée sans options ou arguments. D'autres commandes peuvent avoir des arguments et des options, et ces arguments et options peuvent être obligatoires ou optionnelles. Par exemple, la commande run a un argument obligatoire qui vous permet de fournir le nom du chemin ou du fichier du fichier .mfx que vous souhaitez exécuter. Consultez la section de référence pour plus de détails concernant chaque commande .
Appeler MapForce Server dans le répertoire d'installation
Pour appeler le programme d'exécution sans devoir saisir le chemin complet, changer le répertoire actuel dans le répertoire sur lequel le programme d'exécution MapForce Server a été installé, par exemple :
Linux | cd /opt/Altova/MapForceServer2025/bin |
macOS | cd /usr/local/Altova/MapForceServer2025/bin |
Windows | cd "C:\Program Files (x86)\Altova\MapForceServer2025\bin\MapForceServer.exe" |
Vous pouvez maintenant exécuter toute commande en saisissant uniquement le nom du programme d'exécution, par exemple :
Linux | ./mapforceserver help |
macOS | ./mapforceserver help |
Windows | MapForceServer.exe help |
Note : | Sur les systèmes Linux et macOS, le préfixe ./ indique que le programme d'exécution se trouve dans le répertoire actuel. |
Appeler MapForce Server depuis tout répertoire
Pour appeler le programme d'exécution depuis tout répertoire, référez-vous-y en utilisant le chemin absolu. En alternative, si vous souhaitez appeler le programme en saisissant uniquement le nom du programme d'exécution, vous pouvez éditer la variable d'environnement PATH de votre système d'exploitation de manière à ce qu'il inclut le chemin complet vers le répertoire d'installation MapForce Server. Pour consulter les différents moyens de modifier la variable d'environnement PATH, se référer à la documentation de votre système d'exploitation.
Note: | Une fois avoir changé la variable d'environnement PATH, vous devrez éventuellement fermer la fenêtre de terminal et en ouvrir une nouvelle, pour que les modifications prennent effet. |