Altova RaptorXML+XBRL Server 2025

Ab RaptorXML+XBRL Server 2024 steht die Python API als natives Python Wheel-Paket für Python 3.11.8 zur Verfügung. Das Python Wheel-Paket kann als Erweiterungsmodul in der Python 3.11.8 Distribution Ihrer Wahl (z.B. von python.org) installiert werden. Einige Python 3 Distributions (z.B. von jupyter.org, anaconda.org und SciPy.org) enthalten eine breite Palette an Erweiterungsmodulen für große Datenmengen, mathematische, wissenschaftliche, technische und grafische Anwendungen. Diese Module stehen RaptorXML+XBRL Server nun zur Verfügung, ohne dass diese speziell für RaptorXML+XBRL Server erstellt werden müssen. Das Wheel-Paket funktioniert auf dieselbe Art wie die mit RaptorXML+XBRL Server inkludierte RaptorXMLXBRL-python.exe Applikation.

In den nachstehenden Abschnitten finden Sie Informationen zur Installation des RaptorXML+XBRL Server-Pakets:

•Name der Wheel-Datei

•Pfad der Wheel-Datei

•Installation einer Wheel-Datei mit pip

•Behebung von Fehlern bei der Installation

•Die Root-Katalogdatei

•Die JSON-Konfigurationsdatei

Informationen zur Verwendung der Python API von RaptorXML+XBRL Server finden Sie in der Python API-Referenz sowie den Beispielen. Beispiel-Skripts zur Verwendung der Python API von Raptor finden Sie auch unter https://github.com/altova.

Name der Wheel-Datei

Wheel-Dateien werden nach dem folgenden Muster benannt:

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

Beispiel:

raptorxmlserver-2.10.0-cp35-cp35m-win_amd64.whl

Pfad der Wheel-Datei

Im Installationspaket von RaptorXML+XBRL Server ist eine Wheel-Datei enthalten. Sie befindet sich im bin-Ordner Ihrer Applikation:

Installation einer Wheel-Datei mit pip

Um das RaptorXML+XBRL Server-Paket als Python-Modul zu installieren, verwenden Sie den pip-Befehl:

pip install <wheel-file>.whl

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

Wenn Sie Python 3.11.8 oder höher von python.org installiert haben, so ist pip bereits auf Ihrem Rechner installiert. Andernfalls müssen Sie zuerst pip installieren. Nähere Informationen dazu finden Sie unter https://docs.python.org/3/installing/.

Behebung von Fehlern bei der Installation

Falls Sie ältere Versionen des Python Interpreters verwenden, müssen Sie Ihre Installation eventuell anpassen, damit unter Windows die neuesten vcruntime-Bibliotheken oder unter Unix die C++-Standardbibliotheken verwendet werden. Diese Bibliotheken werden mit RaptorXML+XBRL Server bereitgestellt und können wie unten beschrieben verwendet werden.

Windows

Falls die vcruntime140_1.dll fehlt, kopieren Sie sie aus dem Ordner Programme\Altova\RaptorXMLXBRLServer2025\bin in den Python-Installationsordner (den Ordner, der die python.exe-Datei enthält). (D.h. der Python Interpreter muss wissen, wo sich die DLLs oder die gemeinsam verwendeten Bibliotheken befinden).

Linux

Wenn die C++-Bibliothek Ihres Systems veraltet ist, muss Ihr Python Interpreter wissen, wo er die neuere, von dem mit RaptorXML+XBRL Server bereitgestellten RaptorXML+XBRL Server-Python-Paket verwendete C++-Bibliothek findet. Verwenden Sie dazu $LD_LIBRARY_PATH, um auf die neuere Bibliothek im RaptorXML+XBRL Server-Ordner zu verweisen: $ export LD_LIBRARY_PATH=/opt/Altova/RaptorXMLXBRLServer2025/lib.

macOS

Wenn die C++-Bibliothek Ihres Systems veraltet ist, muss Ihr Python Interpreter wissen, wo er die neuere, von dem mit RaptorXML+XBRL Server bereitgestellten RaptorXML+XBRL Server-Python-Paket verwendete C++-Bibliothek findet. Verwenden Sie dazu $DYLD_LIBRARY_PATH, um auf die neuere Bibliothek im RaptorXML+XBRL Server-Ordner zu verweisen: $ export DYLD_LIBRARY_PATH=/usr/local/Altova/RaptorXMLXBRLServer2025/lib.

Die Root-Katalogdatei

Das RaptorXMLXBRL-Modul Für Python muss in der Lage sein, RootCatalog.xml, die in Ihrem RaptorXML+XBRL Server-Installationsordner gespeicherte Root-Katalogdatei, zu finden, damit das RaptorXMLXBRL-Modul die verschiedenen Ressourcen wie Schemas und andere Spezifikationen, die das Modul zur Ausführung von Funktionen wie Validierung und Transformation referenziert, anhand des Katalogs findet. Wenn der Pfad der Katalogdatei nach der Installation von RaptorXML+XBRL Server nicht geändert wurde, findet das RaptorXMLXBRL-Modul die Datei RootCatalog.xml automatisch.

Wenn Sie Ihre RaptorXML+XBRL Server-Umgebung verschieben oder ändern oder wenn Sie RootCatalog.xml aus dem ursprünglichen Installationsordner verschieben, können Sie den Pfad zur Katalogdatei mit Hilfe von Umgebungsvariablen und der JSON-Konfigurationsdatei des RaptorXMLXBRL-Moduls definieren. Die verschiedenen Methoden, wie Sie dies tun können, sehen Sie in der Liste unten. Mit dem RaptorXMLXBRL-Modul wird der Pfad zur RootCatalog.xml durch Überprüfung der folgenden Ressourcen in der angegebenen Reihenfolge ermittelt.

Die JSON-Konfigurationsdatei

Sie können eine JSON-Konfigurationsdatei für das RaptorXMLXBRLServer-Modul erstellen. Diese Datei wird von den Optionen 5 bis 8 in der obigen Tabelle verwendet, um die Root-Katalogdatei zu finden. Die JSON-Konfigurationsdatei muss eine Zuordnung mit dem Schlüssel "CatalogPath" enthalten, der einen Wert hat, der dem Pfad zur Root-Katalogdatei entspricht.

Codefragment der JSON-Konfigurationsdatei

{

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

}