Altova RaptorXML Server 2024

À partir de RaptorXML Server 2024, l'API Python est disponible en tant que package wheel Python natif pour Python 3.11.5. Le package wheel Python peut être installé en tant que module d'extension avant votre distribution Python 3.11.5 préférée (par exemple, depuis python.org). Certaines distributions Python 3 (par exemple, provenant de jupyter.org, anaconda.org et SciPy.org) comprennent une palette étendue de modules d'extension pour les big data, les mathématiques, la science, l'ingénierie et les graphiques. Ces modules sont maintenant disponibles pour RaptorXML Server sans qu'il soit nécessaire de générer ces modules spécifiquement pour RaptorXML Server. Sinon, le package wheel fonctionne de la même manière que l'application RaptorXMLXBRL-python.exe qui est contenue dans RaptorXML Server.

L'information nécessaire pour installer correctement le package RaptorXML Server est indiquée dans les sections ci-dessous :

•Nom du fichier wheel

•Emplacement du fichier wheel

•Installer un wheel avec pip

•Dépannage de l’installation

•Le fichier root catalog

•Le fichier de config JSON

Pour plus d'informations concernant l'utilisation de l'API Python de RaptorXML Server, voir référence API Python et exemples. Voir aussi les scripts d'exemple qui utilisent l'API Python de Raptor sous https://github.com/altova.

Nom du fichier wheel

Les fichiers wheel sont nommés conformément au motif suivant :

raptorxmlserver-{version}(-{build tag})?-{python tag}-{abi tag}-{platform tag}.whl

Exemple:

raptorxmlserver-2.9.0-cp35-cp35m-win_amd64.whl

Emplacement du fichier wheel

Un fichier wheel est contenu avec votre installation de RaptorXML Server. Il se trouve dans le dossier bin de l'application :

Installer un wheel avec pip

Pour installer le package RaptorXML Server en tant que module Python, utiliser la commande pip :

pip install <wheel-file>.whl

python -m pip install <wheel-file>.whl  

Quand vous avez installé Python 3.11.5 ou la version plus élevée depuis python.org, alors pip sera déjà installée. Sinon, vous devrez tout d'abord installer pip. Pour plus d'informations, voir https://docs.python.org/3/installing/.

Dépannage de l’installation

Dans le cas où vous utilisez des versions plus anciennes de l’interpréteur Python, vous allez éventuellement devoir ajuster votre installation pour utiliser les dernières bibliothèques vcruntime sur Windows ou des bibliothèques standard C++ sur Unix. Ces bibliothèques sont distribuées avec RaptorXML Serveret peuvent être utilisées tel que décrit ci-dessous.

Windows

Si vcruntime140_1.dll manque, copiez-le depuis le dossier Program Files\Altova\RaptorXMLServer2024\bin vers le dossier d’installation Python (le dossier contenant python.exe). (De manière plus générale, l’interpréteur Python doit savoir où il trouve les DLL ou les bibliothèques partagées.)

Linux

Si votre bibliothèque C++ de système est obsolète, alors votre interpréteur Python ne saura pas où trouver la bibliothèque C++ la plus récente qui est utilisée par le package Python RaptorXML Server et distribuée avec RaptorXML Server. Ceci peut être réglé en utilisant $LD_LIBRARY_PATH pour pointer vers la plus récente bibliothèque dans le dossier RaptorXML Server, tel que : $ export LD_LIBRARY_PATH=/opt/Altova/RaptorXMLServer2024/lib.

macOS

Si votre bibliothèque C++ de système est obsolète, alors votre interpréteur Python ne saura pas où trouver la bibliothèque C++ la plus récente qui est utilisée par le package Python RaptorXML Server et distribuée avec RaptorXML Server. Ceci peut être réglé en utilisant $DYLD_LIBRARY_PATH pour pointer vers la plus récente bibliothèque dans le dossier RaptorXML Server, tel que : $ export DYLD_LIBRARY_PATH=/usr/local/Altova/RaptorXMLServer2024/lib.

Le fichier root catalog

Le module RaptorXML pour Python doit pouvoir situer RootCatalog.xml, le fichier de catalogue root qui est stocké dans votre dossier d'installation RaptorXML Server. La raison est que le module RaptorXML peut utiliser le catalogue pour situer correctement les différentes ressources, comme des schémas et d'autres spécifications, que le module référence pour pouvoir effectuer des fonctions comme des validations et des transformations. Le module RaptorXML situera automatiquement RootCatalog.xml si l'emplacement du catalogue n'a pas été modifié après l'installation de RaptorXML Server.

Au cas où vous déplacez ou modifiez votre environnement RaptorXML Server, ou si vous déplacez RootCatalog.xml depuis son emplacement d'origine, vous pouvez spécifier l'emplacement du catalogue par le moyen des variables d'environnement et le fichier config JSON du module RaptorXML. Voir la liste ci-dessous pour consulter les moyens se trouvant à votre disposition. Le module RaptorXML détermine l'emplacement de RootCatalog.xml en consultant les ressources suivantes dans l'ordre donné.

Le fichier de config JSON

Vous pouvez créer un fichier de config JSON pour le module RaptorXMLServer. Ce fichier sera utilisé par les options 5 à 8 dans la table ci-dessus pour situer le fichier de catalogue root. Le fichier de config JSON doit contenir un map avec une clé "CatalogPath" qui a une valeur qui est le chemin vers le fichier de catalogue root.

Liste du fichier config JSON

{

  "CatalogPath": "/path/to/RootCatalog.xml"

}