Intégration avec RaptorXML Server
Si vous intégrez RaptorXML Server et FlowForce Server, les fonctions de RaptorXML Server deviennent disponibles en tant que fonctions intégrées de FlowForce Server. Cela signifie que vous pouvez créer des tâches qui valident ou contrôlent la bonne formation des documents XML et XML, taxonomies XBRL et fichiers d’instance Vous pouvez aussi exécuter des transformations XSLT et exécuter des documents XQuery. Pour plus d’information sur la fonction RaptorXML, voir la documentation de RaptorXML Server.
Information sur la compatibilité
RaptorXML Server et FlowForce Server de la même release sont garantis être compatibles. Toutefois, il peut y avoir des soucis de compatibilté si vous utilisez différentes versions de ces produits. Vous pouvez vérifier la compatibilité en exécutant le script d'intégration (comme décrit dans Intégration ci-dessous).
Fonctions RaptorXML génériques vs spécifiques à la release
Lorsque vous intégrez une fonction RaptorXML avec FlowForce Server, vous obtiendrez deux ensembles de fonctions : des fonctions génériques et spécifiques à la release.
Fonctions génériques
Les fonction génériques du conteneur /RaptorXML prennent en charge un ensemble de fonction basique qui pourrait ne pas fournir toutes les fonctions de la dernière version installée de RaptorXML Server (par ex., une fonction générique peut prendre en charge uniquement un paramètre, tandis que le même fonction de la dernière release peut avoir de multiples paramètres). Ces fonctions ne changent jamais et se comportent de manière identique pour chaque version du RaptorXML Server.
Fonctions spécifiques à la release
Les fonctions spécifiques à la release du conteneur /RaptorXML/{Release} ont les derniéres fonctions de la release RaptorXML.
Intégration
Une fois que vous avez installé RaptorXML Server, ensemble avec FlowForce Server (disponible sur Windows) ou comme produit autonome (disponible sur une plateforme), vous allez devoir intégrer les fonctions de RaptorXML dans FlowForce Server. Les possibles options d’intégration sont recensées ci-dessous :
•par le biais de la page de configuration FlowForce Server
•par le biais des commandes CLI
•par le biais du script d’intégration
Pour les détails, voir les sous-sections ci-dessous.
Intégration via la page de configuration
Il s’agit de la manière la plus rapide et la plus simple d’intégrer la fonction de RaptorXML dans FlowForce Server. Procédez comme suit :
1.Ouvrez la page de configuration. Dépendant de votre plateforme, les instructions varient :
2.Sur la page de configuration, cliquez sur le bouton Intégrer Outils pour l’instance de serveur pertinente.
3.Dans le dialogue qui s’ouvre, cliquez sur Intégrer. Le journal affichera les détails d’intégration, tel qu’indiqué dans la capture d'écran ci-dessous.
Il est recommandé d’intégrer RaptorXML Server avant installing les services FlowForce Server et FlowForce Web Server. Vous pouvez intégrer RaptorXML à une étape ultérieure. Notez, toutefois, que vous devez arrêter les services avant de pouvoir cliquer sur le bouton Intégrer Outils.
Intégration par le biais de CLI
Vous pouvez utilisez plusieurs commandes CLI avec les options --integratetools afin d’intégrer les fonctions RaptorXML dans une nouvelle instance (avec createdb, initdb ou migratedb) ou une instance existante (avec initdb ou upgradedb) de FlowForce.
Intégration par le biais du script
Une autre manière d’intégrer TaptorXML est d’exécuter le script disponible dans le chemin suivant :
{RaptorXML installation directory}\etc\functions\integrate.bat
| Note : | sur les systèmes Unix, le nom de script est integrate.cs. Les privilèges Superuser (sudo) sont requis pour exécuter ce script. |
Ce script prend deux arguments : le chemin vers le répertoire d’installation FlowForce Server et le chemin vers le répertoire des données d’instance de FlowForce Server. Lorsque vous exécutez le script, les événements suivants se produisent :
•Toutes les fonctions spécifiques à la release de la version du serveur RaptorXML intégrée deviennent disponibles dans FlowForce Server. Les fonctions spécifiques à la release qui ont toutes les dernières fonctions de cette release.
•Les fonctions génériques de RaptorXML seront mises à jour de telle manière qu’elles mapperont vers une version nouvellement intégrée. Ceci signifie que les fonctions génériques utiliseront la nouvelle version RaptorXML pour fournir la fonction générique, mais ils ne prendront pas en charge une fonction définie au-delà de la fonction générique.
Pour les détails sur les fonctions spécifiques à la release et aux fonctions de RaptorXML, voir Fonctions RaptorXML génériques vs. Spécifiques à la release ci-dessus.
Si le script retourne des erreurs, les définitions de fonction de la version intégrée de RaptorXML ne sont pas compatibles avec FlowForce Server. Dans le cas improbable où cela se produirait, veuillez contacter le SAV.
Comment appeler les fonctions RaptorXML
Une fois que RaptorXML a été intégrée dans FlowForce, toutes les fonctions de RaptorXML Server deviennent disponibles dans le conteneur /RaptorXML de FlowForce (capture d’écran ci-dessous). Dans le cas de RaptorXML+XBRL Server, le nom du conteneur est /RaptorXMLXBRL.
Vous pouvez appeler les fonctions de RaptorXML d’une des méthodes suivantes :
•En navigant vers le conteneur /RaptorXML (ou /RaptorXMLXBRL), ouvrez une fonction d’intérêt, puis cliquez sur Créer tâche. Vous pouvez sélectionner des fonctions génériques comme /RaptorXML/valjson ou des fonctions spécifiques à la release comme /RaptorXML/2025/valjson. Les différences entre les deux sont décrites ci-dessous.
•En créant une nouvelle étape d'exécution et appelant la fonction RaptorXML désirée depuis une étape d'exécution. Par exemple, l'étape ci-dessous appelle la fonction valjson :
Pour des exemples de tâches qui appellent RaptorXML Server, voir :
•Valider un document avec RaptorXML
•Valider XML avec le logging d'erreur
•Utiliser RaptorXML pour passer des paires de paramètre Clé/Valeur
Pour information sur les fonctions RaptorXML disponibles, voir la documentation de RaptorXML Server.
Comment mettre à jour les fonctions RaptorXML spécifiques à la release pour une version plus récente
Si vos tâches se réfère aux fonctions spécifiques à la release de versions plus anciennes (par ex., 2022), et que vous avez intégré une version plus récente de RaptorXML Server (par ex., 2024), les fonctions plus anciennes spécifiques à la release ne seront pas mises à jour automatiquement dans vos tâches. Pour mettre à jour vers une version plus récente des fonctions RaptorXML, vous pouvez utiliser les méthodes suivantes :
•Vous pouvez allez manuellement dans chaque tâche et remplacer manuellement les fonctions RaptorXML des versions plus anciennes avec les versions les plus récentes.
•De manière alternative, vous pouvez copier le fichier RaptorXML_<release>.tool depuis le répertoire {INSTALLDIR}\etc de RaptorXML Server de la dernière release installée au répertoire {INSTANCEDIR}\tools de FlowForce Server. Après, vous devrez renommer le fichier à renommer la version de la release à lquelle vos tâches se réfèrent. Par exemple, si l’ancienne release est RaptorXML Server 2022, alors dénommez le fichier RaptorXML_2022.tool. Toutes les tâches existantes continueront à avoir l’aspect comme si elles appelaient des fonctions de RaptorXML 2022, tandis que le nouveau fichier .tool mappera en fait vers RaptorXML Server 2024 exécutable.
Si vos tâches référence les fonctions génériques de RaptorXML nous n’avons pas le droit de prendre des mesures.
Information sur les fichiers .tool
FlowForce Server utilise les fichiers .tool pour trouver d’autres produits de serveur d’Altova qui sont exécutés sous sa gestion. Les fichiers Outils sont une partie essentielle de l’intégration de RaptorXML, car ils permettent à FlowForce Server de trouver le serveur RaptorXML pertinent exécutable et de situer différentes version de RaptorXML. Ces fichiers peuvent être utilisés pour définir des variables d’environnement. Un fichier .tool séparé existe pour chaque release de RaptorXML Server. Pour plus d'informations concernant les fichiers .tool, voir Fichiers Outils.