Altova FlowForce Server 2026 Advanced Edition

Les Ressources globales d’Altova sont des alias pour des fichiers, dossiers et ressources de bases de données. Chaque alias peut avoir de multiples configurations et chaque configuration correspond à une seule ressource. Pour cette raison, quand vous utilisez une ressource globale, vous pouvez basculer entre ses configurations. Par exemple, vous pouvez créer une ressource "database" avec deux configurations : développement et production. Dépendant de vos objectifs, vous pouvez basculer entre ces configurations. Dans FlowForce Server, vous pouvez ensuite aisément extraire des données soit de la base de données de développement ou de production, en fournissant la configuration désirée à la fonction de mappage.

Les Ressources globales peuvent être utilisées dans toutes les différentes applications d’Altova (voir la sous-section ci-dessous).

Ressources globales dans d’autres produits d’Altova

Lorsqu'ils sont stockés en tant que Ressources globales, les détails de connexion à la base de données deviennent réutilisables et disponibles dans plusieurs applications d’Altova. Par exemple, si vous avez souvent besoin d'ouvrir le même fichier dans plusieurs applications desktop Altova, vous pourriez le définir en tant que Ressources globales. Si vous devez modifier le chemin de fichier, vous allez devoir le changer à un endroit uniquement. Actuellement, les Ressources globales peuvent être définies et utilisées dans les produits Altova suivants :

•Altova Authentic

•DatabaseSpy

•MobileTogether Designer

•MapForce

•StyleVision

•XMLSpy

•FlowForce Server

•MapForce Server

•RaptorXML Server et RaptorXML+XBRL Server.

Pour plus d'informations sur la création de ressources globales, reportez-vous au chapitre « Ressources globales Altova » de la documentation MapForce.

Ressources dans FlowForce Server

Dans FlowForce Server, les ressources globales ne sont pas stockées dans un fichier XML comme dans les applications desktop. Dans FlowForce, chaque ressource est un objet réutilisable qui peut contenir des chemins de fichier ou de dossier ou des détails de connexion de base de données. Les ressources peuvent être copiées, exportées et importées, et sont sujettes au même mécanisme d'accès d'utilisateur que d'autres objets de FlowForce Server. Ceci signifie que tout utilisateur FlowForce peut utiliser toute ressource dans ses fonctions de mappage, s'il est doté des permissions exigées.

Une fois que vous avez créé un mappage avec des ressources globales dans MapForce, vous pouvez le déployer sur FlowForce Server. Au moment du déploiement, vous pouvez choisir si le mappage doit utiliser des ressources globales, cochant alors la case Utiliser les ressources dans le dialogue de déploiement. Si vous ne cochez pas la case, toutes les ressources globales utilisées par le mappage seront résolues, basées sur la configuration sélectionnée actuellement. Si vous avez coché la case, la fonction de mappage nécessitera aussi des ressources dans FlowForce Server. La capture d’écran ci-dessous est un exemple de fonction de mappage déployée vers FlowForce qui exige que les ressources soient exécutées. Veuillez noter que le premier paramètre obtient un chemin par défaut de la ressource.

Dans FlowForce Server, c'est la fonction de mappage qui utilise des ressources globales, et non la tâche. La fonction de mappage lit le chemin du premier fichier d'entrée depuis la ressource. Cela signifie que toutes les tâches employant cette fonction utiliseront le même chemin, à moins que vous ne contourniez le chemin depuis la page de configuration de la tâche.

Vous pouvez aussi déployer des Ressources globales dans FlowForce Server en tant qu'objets autonomes. Cela signifie il n'est pas nécessaire de déployer d'abord un mappage pour pouvoir déployer une ressource globale. Pour plus d'informations concernant le déploiement des Ressources globales sur FlowForce Server, voir la documentation MapForce la documentation MapForce.

Structure des ressources

Dans toutes les applications de bureau Altova, les ressources globales sont gérées sous forme de fichiers XML. Le fichier par défaut s'appelle GlobalResources.xml ; vous le trouverez dans le répertoire C:\Users\<username>\Documents\Altova sur l'ordinateur où MapForce est installé. Un fichier de ressources globales peut contenir plusieurs ressources, également appelées « alias ». Un alias est soit un chemin d'accès à un fichier, soit un chemin d'accès à un répertoire, soit un ensemble d'informations de connexion à une base de données. Les alias peuvent à leur tour avoir plusieurs configurations. Comme décrit précédemment, les configurations vous permettent de changer de chemin d'accès ou de base de données. Pour mieux comprendre, examinez la structure du fichier de ressources globales suivant (notez que certaines données ont été omises pour plus de simplicité) :

Le fichier ci-dessus définit trois ressources (alias) : un chemin de fichier appelé « MyFile », un chemin de répertoire appelé « MyDirectory » et une base de données SQLite appelée « MyDatabase ». Chaque alias dispose de deux configurations : une configuration par défaut utilisée pour les tests et une configuration de production.

Dans FlowForce Server, en raison des spécificités de l'environnement serveur multi-utilisateurs, les ressources fonctionnent de manière légèrement différente. Plus précisément, un fichier de ressources XML tel que celui ci-dessus devient un objet de ressource dans FlowForce. À l'intérieur de l'objet de ressource, il peut y avoir plusieurs alias, comme dans les applications de bureau. Cependant, chaque alias n'a qu'une seule configuration, à savoir celle que vous avez sélectionnée lors du déploiement de la ressource depuis MapForce vers FlowForce Server.

Par exemple, si vous avez déployé le fichier de ressources globales ci-dessus, la configuration « Default » ou « Production » sera déployée sur le serveur (mais pas les deux en même temps). Si vous choisissez la configuration « Default », l'objet ressource se présentera comme suit dans FlowForce Server :

Dans FlowForce, toute fonction de mappage peut utiliser une configuration spécifique d'une ressource globale. Par conséquent, dans cet exemple, si vous avez besoin de la configuration « Production » sur le serveur, vous devez déployer à nouveau le même fichier de ressources, en sélectionnant cette fois la configuration « Production » dans le dialogue de déploiement de MapForce. Vous pouvez également créer une ressource directement sur le serveur, comme décrit ci-dessous, et modifier la fonction de mappage pour qu'elle pointe vers cette ressource plutôt que vers la ressource « Default ». Notez toutefois que cette autre approche est possible avec les ressources de type fichier et répertoire, mais pas avec les bases de données.

Modifier la ressource d'une fonction de mappage

Dans FlowForce, les objets de ressource sont identifiés par l'icône . Par conséquent, si vous avez déployé les configurations « Default » et « Production » de l'exemple ci-dessus, les ressources correspondantes dans FlowForce Server peuvent apparaître comme suit :

Pour modifier la ressource utilisée par une fonction de mappage :

1.Accédez au conteneur dans lequel la fonction de mappage a été déployée et cliquez pour ouvrir la fonction.

2.Sous « Ressources », sélectionnez un nouveau chemin d'accès à la ressource. La sélection des ressources fonctionne de la même manière que pour les autres objets FlowForce tels que les fonctions, les informations d'identification, etc.

Si la fonction de mappage ne comporte pas de section « Ressources », cela signifie que ce mappage n'a pas été configuré pour les ressources globales dans MapForce (ou que la case à cocher Utiliser les ressources n'a pas été sélectionnée lors du déploiement).

Toute fonction de mappage peut utiliser n'importe quelle ressource, si les conditions suivantes sont remplies :

•Le type de ressource est compatible avec la fonction. Par exemple, une ressource « dossier » ne convient pas si la fonction de mappage nécessite une ressource « fichier ».

•Le nom d'alias de la ressource est celui requis par la fonction de mappage. Vous sélectionnez normalement le nom d'alias au moment de la conception du mappage, dans MapForce, mais vous pouvez également le remplacer dans FlowForce, comme décrit plus en détail ci-dessous.

Ressources et configuration des tâches

Comme indiqué précédemment, les ressources sont consommées au niveau de la fonction de mappage, et non au niveau de la configuration des tâches. Lorsqu'une tâche s'exécute, elle consomme les ressources globales qui sont définies dans la fonction appelée par la tâche. Ainsi, lorsque vous modifiez une tâche à partir de la page de configuration des tâches, vous ne disposez que d'options de configuration très limitées en ce qui concerne les ressources, telles que « Remplacer l'alias de la ressource » (décrit plus en détail ci-dessous).

Dans certains cas, il est possible de référencer une ressource (comme un dossier ou un fichier) directement à partir de la page de configuration de la tâche. Notez que cela peut ne pas fonctionner dans tous les contextes et doit généralement être évité, sauf si vous avez une très bonne raison d'utiliser de telles références.

Note : il n'est pas possible de référencer une ressource à partir du paramètre « Répertoire de travail » d'une étape d'exécution. En effet, le traitement des ressources nécessite que le processus MapForce Server soit déjà lancé, alors que le répertoire de travail est défini avant le démarrage de MapForce Server.

Remplacer l'alias de ressource

Même si une ressource de type fichier ou dossier peut avoir plusieurs alias, un seul d'entre eux est utilisé lors de l'exécution de la tâche. L'alias utilisé lors de l'exécution est celui sélectionné dans MapForce lors de la conception du mappage. Par exemple, le composant MapForce suivant est configuré pour générer output.csv dans un alias de répertoire appelé « MyDirectory ». Si vous déployez ce mappage sur FlowForce Server, la fonction de mappage sur le serveur doit également pointer vers une ressource contenant l'alias « MyDirectory ».

Au lieu de modifier le mappage dans MapForce chaque fois que vous devez changer l'alias, vous pouvez également remplacer l'alias dans FlowForce Server, à partir de la page de configuration de la tâche. Pour remplacer les alias de fichiers ou de dossiers dans une tâche, utilisez la syntaxe suivante, en remplaçant MyFile ou MyDirectory par le nom d'alias requis :

Par exemple, dans la configuration de tâche ci-dessous, l'alias de répertoire a été remplacé par « TestDir ».

Note : la modification de l'alias comme indiqué ci-dessus n'est pas prise en charge pour les ressources de base de données. Si vous avez plusieurs alias de base de données, passez à l'alias de base de données requis dans MapForce avant de déployer le mappage vers FlowForce Server.

Créer des ressources

Vous pouvez uniquement créer des ressources de type fichier ou dossier dans FlowForce Server. Pour créer une ressource globale dans FlowForce Server, ouvrez le conteneur de votre choix et cliquez sur Créer | Créer une ressource.

Note : la création de ressources de base de données n'est pas prise en charge dans un environnement serveur. Pour créer des ressources de base de données, utilisez l'éditeur de ressources globales de MapForce ou toute autre application de bureau Altova prenant en charge les ressources globales, puis déployez les ressources depuis MapForce vers FlowForce Server.

L'alias de la ressource doit correspondre à celui requis par la fonction de mappage dans laquelle vous utiliserez cette ressource. Sinon, vous devrez modifier manuellement les tâches afin qu'elles pointent vers l'alias correct, comme décrit ci-dessus dans « Remplacer l'alias de ressource ».

Au sein d'un même objet ressource, vous pouvez créer plusieurs alias si nécessaire, en cliquant sur les boutons Nouvelle ressource de fichier ou Nouvelle ressource de dossier. Cette opération est toutefois facultative. Si vous créez plusieurs alias, n'oubliez pas que vous devrez modifier les tâches afin d'indiquer l'alias à utiliser.

Modifier des ressources

Vous pouvez modifier les ressources fichier ou dossier directement dans FlowForce Server, au lieu de le faire dans MapForce et de les déployer à nouveau. Pour modifier une ressource, cliquez sur l'enregistrement correspondant, mettez à jour les chemins d'accès (ou les détails de connexion à la base de données), puis cliquez sur Enregistrer.

Note : dans le cas des ressources de base de données, vous ne pouvez modifier dans FlowForce que certains champs tels que la chaîne de connexion ou la base de données par défaut. Il n'est toutefois pas possible de modifier le fournisseur de la base de données et la méthode de connexion.