Fichiers Outil
Lorsque vous installez d'autres serveurs Altova en parallèle de FlowForce Server, un fichier .tool est installé pour chaque application pouvant fonctionner sous la gestion de FlowForce Server. Vous pouvez installer ces produits serveur en les sélectionnant dans l'assistant d'installation de FlowForce Server ou en les installant ultérieurement à l'aide de leurs programmes d'installation autonomes. Les produits Altova suivants peuvent fonctionner sous la gestion de FlowForce Server :
Vous n’avez pas besoin de configurer les fichiers .tool, sauf si vous devez modifier les variables d’environnement requises par MapForce Server ou StyleVision Server (par exemple, CLASSPATH).
Répertoires d’installation et de données d’instance
FlowForce Server utilise les fichiers .tool pour localiser et configurer l’exécution des autres applications serveur placées sous sa gestion. FlowForce Server recherche d’abord les fichiers .tool dans INSTANCEDIR, puis dans INSTALLDIR. Les tableaux ci-dessous indiquent les chemins d’accès à ces répertoires sur différents systèmes d’exploitation. Les répertoires indiqués pour INSTANCEDIR correspondent aux chemins d’accès par défaut. Lors de la configuration de FlowForce Server, vous pouvez définir un chemin d’accès personnalisé pour INSTANCEDIR.
Répertoire des données d’instance FlowForce Server (INSTANCEDIR) | |
|---|---|
Linux | /var/opt/Altova/FlowForceServer/data |
Windows | C:\ProgramData\Altova\FlowForceServer\data |
Répertoire d’installation de FlowForce Server (INSTALLDIR) | |
|---|---|
Linux | /opt/Altova/FlowForceServer2027/ |
Windows | C:\Program Files\Altova\FlowForceServer2027\ C:\Program Files (x86)\Altova\FlowForceServer2027\ |
Le répertoire INSTANCEDIR\tools est généralement vide. Vous pouvez y placer des fichiers Outil personnalisés. Le répertoire INSTALLDIR est géré par le processus d’installation, et les fichiers .tool qu’il contient ne doivent pas être modifiés.
Ordre d'installation
Vous pouvez trouver des fichiers .tool dans le répertoire INSTALLDIR si MapForce Server ou StyleVision Server est installé après FlowForce Server. Si le fichier .tool n'existe ni dans INSTANCEDIR, ni dans INSTALLDIR, il est possible que FlowForce Server ait été installé après MapForce Server ou StyleVision Server. Dans ce cas, vous pouvez trouver le fichier .tool dans le répertoire etc relatif au répertoire d'installation de MapForce Server ou StyleVision Server.
Messages d'information
FlowForce Server regroupe les instances de traitement d'outils exécutés et les gère, telles que configurées dans les fichiers .tool. FlowForce Server gère les processus qu’il lance pour d’autres applications serveur. Les événements suivants peuvent générer des messages d’information dans le journal :
Démarrage de l'instance {id} de {tool} pour {session}. Lancer {commandline}. L’instance {id} de {tool} pour {session} est désormais inactive. Arrêt de l’instance {id} de {tool} pour {session} ; inactivité prolongée. Arrêt de l’instance {id} de {tool} pour {session} ; nombre maximal de réutilisations atteint. L’instance {id} de {tool} pour {session} a interrompu la communication de manière inattendue. L’instance {id} de {tool} pour {session} est associée à l’instance de tâche {instanceid}. |
Si des étapes ou des tâches échouent, cela génère un message de journal distinct.
Édition du fichier Outil
Les fichiers portant l’extension .tool peuvent être modifiés dans un éditeur de texte (par exemple, Notepad++). Les options d'édition suivantes sont disponibles :
1.[Tool] : dans cette section, vous pouvez modifier le chemin d’accès à l’exécutable de l’outil. Par exemple, vous devrez peut-être mettre à jour le chemin d’accès pour utiliser une version différente du fichier exécutable.
2.[Environment] : vous pouvez ajouter ou modifier cette section pour définir les variables d’environnement requises par l’outil. Pour plus d’informations, consultez la section Variables d’environnement ci-dessous.
Important :
•Lorsque vous modifiez un fichier .tool dans INSTANCEDIR, les modifications prennent effet immédiatement. Vous ne devez pas relancer FlowForce Server.
•Ne modifiez aucun paramètre de fichier .tool autre que ceux mentionnés ci-dessus, sauf si conseillé par Altova Support.
•Il n'est pas possible de définir des outils personnalisés.
Variables d’environnement
Lorsque les mappages MapForce Server ou les feuilles de style StyleVision Server s’exécutent sous la gestion de FlowForce Server, ils peuvent nécessiter la définition de variables d’environnement. Par exemple, vous devez définir CLASSPATH pour spécifier l’emplacement des pilotes JDBC lors de la connexion à une base de données.
Pour définir les variables d'environnement requises par les mappages MapForce Server ou les transformations de StyleVision Server, modifiez le fichier .tool du produit serveur Altova correspondant. Avant de modifier le fichier .tool, vérifiez s’il existe déjà dans le répertoire INSTANCEDIR. Si ce n’est pas le cas, copiez-le depuis INSTALLDIR de FlowForce Server.
CLASSPATH
Vous pouvez ajouter les variables d'environnement sous la section [Environment] dans le fichier .tool. Les variables d'environnement définis dans le fichier .tool remplacent les variables d'environnement définis par d'autres moyens. L’exemple suivant de fichier .tool (Linux) définit la variable CLASSPATH :
[Environment]
CLASSPATH=.:/usr/local/jdbc/oracle/ojdbc6.jar
PYTHONHOME et VIRTUAL_ENV
Pour exécuter un mappage contenant des fonctions Python personnalisées avec FlowForce Server, configurez l'environnement Python dans le fichier .tool de MapForce Server et rendez le module Python accessible sur la machine où s'exécute FlowForce Server.
Note : tous les répertoires et fichiers requis par le mappage doivent être accessibles en lecture par l'utilisateur sous les identifiants duquel la tâche FlowForce s'exécute.
Pour plus d’informations sur l’utilisation de fonctions Python personnalisées dans MapForce, consultez la rubrique Bibliothèques Python personnalisées dans la documentation de MapForce (https://www.altova.com/fr/documentation#mapforce).
Par défaut, MapForce Server recherche le module Python dans le répertoire à partir duquel il a été importé dans MapForce lors de la conception. Si FlowForce Server s’exécute sur une autre machine et que le module n’y est pas disponible, copiez le module sur cette machine et assurez-vous que Python puisse le trouver. Pour plus d’informations sur la manière dont Python localise les modules, consultez la documentation Python.
Windows
Si vous utilisez un environnement virtuel Python, définissez VIRTUAL_ENV sur l’environnement virtuel et PYTHONHOME sur l’installation de base de Python dans la section [Environment] du fichier .tool de MapForce Server. Par exemple :
[Environment]
VIRTUAL_ENV=C:\Users\<User>\.venv
PYTHONHOME=C:\Python314
MapForce Server recherche l’installation de Python dans l’ordre suivant :
1.VIRTUAL_ENV
2.PYTHONHOME
3.PATH
Linux
Sous Linux, créez un environnement virtuel Python et spécifiez-le dans le fichier .tool de MapForce Server. Un environnement virtuel est recommandé car l’installation de modules Python dans les répertoires système peut nécessiter un accès root.
MapForce Server recherche l’installation de Python dans l’ordre suivant :
1.VIRTUAL_ENV
2.PATH
Pour créer un environnement virtuel Python, utilisez la commande suivante :
python3 -m venv ./.venv
Pour spécifier l’environnement virtuel, modifiez le fichier .tool de MapForce Server comme suit :
[Environment]
VIRTUAL_ENV=/home/<user>/.venv
Vous pouvez placer le module dans le répertoire site-packages de l’environnement virtuel. Par exemple, pour Python 3.14, le répertoire sous Linux pourrait être :
~/.venv/lib/python3.14/site-packages/
Vous pouvez également installer le module Python à l’aide de pip, par exemple :
pip install -e .
Cette commande nécessite un fichier de configuration TOML qui spécifie l’emplacement du code source Python. L’installation ajoute automatiquement le chemin d’accès du module à sys.path.