Python API
L'API Python RaptorXML permet aux données contenues dans des documents XML et des documents de Schéma XML d'être accédés et manipulés dans des scripts Python. Voici quelques exemples types d'une utilisation des API Python :
•mise en œuvre des règles de validation personnalisées et messages d’erreur
•exporter du contenu depuis des documents XML vers une base de données
•exporter du contenu depuis des documents XML vers des formats de données personnalisés
•naviguer et interroger de manière interactive le modèle de données des documents XML dans un shell Python ou un notebook Jupyter (http://jupyter.org/)
Les API de Python
Les API de Python (pour XML et XSD) fournissent un accès à la méta-information, à l’information structurelle et aux données contenues dans XML et XSD. En guise de résultat, les scripts Python peuvent être créés qui utilisent les API pour accéder et traiter l’information de document. Par exemple, un script Python peut être passé à RaptorXML Server qui écrit les données d’un document XML vers une base de données ou un fichier CSV.
Les scripts d’exemple pour les API Python de Raptor sont disponibles sous : https://github.com/altova
Les API de Python sont décrites dans leurs références API :
| Note : | Python API v1 de Raptor est obsolète. Veuillez utiliser Python API v2. |
Pack RaptorXML Server pour Python
Dans votre installation de RaptorXML Server, vous trouverez aussi un Package de Python en format Roue. Vous pouvez utiliser la commande pip de Python pour installer ce package en tant que module de votre installation Python. Une fois que le module RaptorXML a été installé, vous pouvez utiliser les fonctions du module dans votre code. De cette manière, les fonctions de RaptorXML peuvent être utilisées aisément dans tout programme Python que vous écrivez, avec d'autres bibliothèques Python tierces comme des librairies de graphique.
Pour plus d'information concernant l'utilisation du package Python de RaptorXML Server, voir la section RaptorXML Server en tant que package Python.
| Note : | La roue Python est uniquement compatible avec la version Python 3.11.5. |
Scripts Python
Un script Python utilisé par l'utilisateur est soumis avec le paramètre --script des commandes suivantes :
Ces commandes invoquant des scripts Python peuvent être utilisées aussi bien sur l'Interface de ligne de commande (CLI) qu'avec l'interface HTTP. L'utilisation des scripts Python avec les API Python de RaptorXML Server est décrite sous : https://github.com/altova.
Rendre les scripts Python sûrs
Lorsqu'un script Python est spécifié dans une commande via HTTP pour RaptorXML Server, le script fonctionnera uniquement s'il est situé dans le répertoire de confiance. Le script est exécuté depuis le répertoire de confiance. La spécification d'un script Python provenant d'un autre répertoire quelconque résultera en une erreur. Le répertoire de confiance est spécifié dans le paramètre server.script-root-dir du fichier de configuration de serveur, et un répertoire de confiance doit être spécifié si vous souhaitez utiliser des scripts Python. Veuillez vous assurer que tous les scripts Python à utiliser soient sauvegardés dans ce répertoire.
Bien que toutes les sorties générées par le serveur pour les requêtes de tâche HTTP soient écrites dans le répertoire de sortie de tâche (qui est un sous-répertoire de output-root-directory), cette limitation ne s'applique pas aux scripts Python, qui peuvent écrire dans n'importe quel emplacement. L'administrateur de serveur doit revoir les scripts Python dans le répertoire de confiance en ce qui concerne des problèmes de vulnérabilité potentiels.