Éditions et interfaces
Éditions
RaptorXML est disponible dans les éditions suivantes :
•RaptorXML Server, un moteur de traitement XML rapide basé sur serveur pour la validation et le traitement de documents XML, XML Schema, XML Signature, XSLT et XQuery.
•RaptorXML+XBRL Server, qui offre toutes les fonctionnalités de RaptorXML Server ainsi qu'un large éventail de fonctionnalités de traitement XBRL.
Consultez ici la liste des spécifications prises en charge.
Interfaces
Une fois RaptorXML installé, vous pouvez y accéder de l'une ou plusieurs des manières suivantes :
•Interface de ligne de commande (CLI) : disponible pour les installations Windows et Linux de RaptorXML.
•Interface client HTTP REST : utilise l'interface HTTP de RaptorXML.
•Interface serveur COM/.NET (Windows) : utilise (i) l'API COM/.NET et (ii) l'interface HTTP REST de RaptorXML.
•Interface serveur Java (Windows, Linux) : utilise (i) l'API Java et (ii) l'interface HTTP REST de RaptorXML.
•Interface Altova XMLSpy : RaptorXML est accessible depuis l'interface utilisateur Altova XMLSpy.
•Interface moteur Python : utilise (i) une roue Python RaptorXML dans votre environnement Python et (ii) l'API Python de <%RXML%> dans votre script Python. De cette manière, les fonctionnalités de RaptorXML peuvent être utilisées dans des scripts Python avec des packages Python tiers.
•Interface du moteur .NET (Windows) : utilise (i) une DLL RaptorXML et (ii) l'API .NET de RaptorXML pour créer des applications .NET indépendantes qui utilisent les fonctionnalités de RaptorXML.
Ces sept interfaces peuvent être organisées en quatre groupes :
•Interface de ligne de commande (CLI)
•API serveur : HTTP, COM/.NET, Java
CLI, API serveur et Altova XMLSpy
L'accès via la CLI, les API serveur et Altova XMLSpy peut être visualisé comme dans le graphique ci-dessous.
RaptorXML+XBRL Server définit une interface HTTP REST, qui est utilisée par les clients pour envoyer des tâches de validation au serveur. Les clients peuvent soit accéder directement à l'interface HTTP REST, soit utiliser les API serveur COM/.NET et Java de haut niveau. Ces API fournissent des classes COM/.NET et Java faciles à utiliser qui gèrent la création et l'envoi des requêtes HTTP REST. De plus, Altova XMLSpy peut être configuré pour exécuter des tâches de validation sur un RaptorXML+XBRL Server distant.
Interface de ligne de commande (CLI)
•RaptorXML possède une licence sur la machine sur laquelle il est installé et cette instance est accessible via la ligne de commande.
•Peut être installé sur Windows et Linux.
•Fournit une utilisation de ligne de commande pour la validation et le traitement des documents XML, XML Schema, XML Signature, XBRL, XQuery et XSLT.
•Python 3.11.8 est fourni avec RaptorXML et sera utilisé lorsqu'un script Python est invoqué avec l'option --script.
Interface client HTTP REST
•RaptorXML possède une licence sur la machine sur laquelle il est installé et cette instance est accessible via une interface client HTTP REST.
•Les requêtes client sont effectuées au format JSON. Un répertoire de tâche est attribué à chaque requête sur le serveur, dans lequel les fichiers de sortie sont enregistrés. Les réponses du serveur au client comprennent toutes les informations pertinentes concernant la tâche.
•Python 3.11.8 est fourni avec RaptorXML et sera utilisé lorsqu'un script Python est invoqué avec l'option --script.
Interface COM/.NET
•Disponible uniquement sous Windows.
•RaptorXML est automatiquement enregistré en tant qu'objet serveur COM lors de son installation et peut donc être invoqué à partir d'applications et de langages de script prenant en charge la programmation des appels COM.
•RaptorXML est sous licence sur la machine sur laquelle il est installé.
•L'interface .NET est conçue comme une enveloppe autour de l'interface COM.
•L'API serveur COM/.NET de RaptorXML fournit des objets pouvant être utilisés dans les langages de script COM/.NET pour accéder aux fonctionnalités de RaptorXML.
•Python 3.11.8 est fourni avec RaptorXML et sera utilisé lorsqu'un script Python est invoqué avec l'option --script.
Interface Java
•RaptorXML possède une licence sur la machine sur laquelle il est installé et cette instance est accessible via un programme Java.
•Les fonctionnalités de RaptorXML sont disponibles dans l'API Java Server sous forme de classes Java pouvant être utilisées dans des programmes Java.
•Python 3.11.8 est fourni avec RaptorXML et sera utilisé lorsqu'un script Python est invoqué avec l'option --script.
Altova XMLSpy
•Si vous avez installé et obtenu une licence pour Altova XMLSpy et si XMLSpy peut accéder à RaptorXML+XBRL Server via un réseau, vous pouvez utiliser RaptorXML+XBRL Server à partir de l'interface graphique XMLSpy pour valider des documents XML et XBRL, ainsi que pour exécuter des transformations XSLT et XQuery.
•Vous pouvez valider le document actif ou tous les documents dans un dossier de projet XMLSpy.
•Les résultats de la validation s'affichent dans la fenêtre Messages de l'interface graphique XMLSpy.
•Dans XMLSpy, vous pouvez (i) valider des documents ou (ii) exécuter des transformations XSLT/XQuery à l'aide des moteurs XMLSpy ou RaptorXML Server.
•L'un des principaux avantages de l'utilisation de Raptor est que vous pouvez configurer des validations individuelles à l'aide d'un large éventail d'options de validation. De plus, vous pouvez enregistrer un ensemble d'options Raptor en tant que « configuration » dans XMLSpy, puis sélectionner l'une de vos configurations définies pour une validation Raptor particulière. L'utilisation de Raptor est également avantageuse lorsque de grandes collections de données doivent être validées.
API moteur
Les API moteur diffèrent des API serveur en ce sens que RaptorXML est contenu dans la roue Python et dans la DLL .NET qui sont utilisées, respectivement, par les programmes Python et les applications .NET (voir graphique ci-dessous). Ces programmes/applications doivent utiliser, respectivement, l'API Python de Raptor et l'API .NET de Raptor afin d'accéder à la fonctionnalité RaptorXML.
Note : les fonctionnalités fournies par l'API Python et l'API .NET sont considérablement plus étendues que celles fournies par l'API CLI ou l'API serveur ; par exemple, la possibilité de lire des documents et de manipuler des données.
Interface Python
•RaptorXML est disponible dans un package wheel Python qui peut être installé dans votre environnement Python 3.11.8.
•Un programme Python peut alors être écrit pour utiliser les objets de l'API Python de RaptorXML. Cette API offre beaucoup plus de fonctionnalités que celles disponibles dans l'interface CLI et peut être combinée avec les fonctionnalités fournies par des bibliothèques tierces dans votre environnement Python.
•Lorsque la fonctionnalité RaptorXML est appelée via le package wheel Python de RaptorXML, une vérification est effectuée pour s'assurer que la machine dispose d'une licence RaptorXML valide avant que la commande ne soit exécutée.
Interface .NET
•RaptorXML est disponible dans une DLL qui peut être intégrée dans une application prenant en charge le .NET Framework. Voir la section API .NET Framework pour plus d'informations sur l'API.
•L'API .NET de RaptorXML permet d'accéder à RaptorXML. Les fonctionnalités disponibles sont bien plus nombreuses que celles disponibles dans l'interface CLI RaptorXML.
•Lorsque la fonctionnalité RaptorXML est appelée via une application .NET, une vérification est effectuée pour s'assurer que la machine dispose d'une licence RaptorXML.