Altova RaptorXML+XBRL Server 2024

RaptorXML+XBRL Server supports multiple Python API versions. Any previous Python API version is also supported by the current version of RaptorXML+XBRL Server. The Python API version is selected by the --script-api-version=MAJOR_VERSION command line flag. The default of the MAJOR_VERSION argument is always the current version. A new RaptorXML+XBRL Server Python API MAJOR_VERSION is introduced when incompatible changes or major enhancements are introduced. Users of the API do not need to upgrade their existing scripts when a new major version is released.

It is recommended that:

•You use the --script-api-version=MAJOR_VERSION flag to invoke utility scripts from the RaptorXML+XBRL Server command-line (or Web-API). This ensures that scripts still work as expected after RaptorXML+XBRL Server updates—even if a new API MAJOR_VERSION has been released.

•You use the latest version of the API for new projects, even though previous versions will be supported by future RaptorXML+XBRL Server releases.

The Python API versions listed below are currently available. The documentation of the different APIs are available online at the locations given below.

Example files

For examples of scripts that use Raptor's Python APIs, go to https://github.com/altova.

Python API version 1

Introduced with RaptorXML+XBRL Server v2014

This is the original RaptorXML+XBRL Server Python API. It covers support to access the internal model of RaptorXML+XBRL Server for:

•XML 1.0 and XML 1.1 (API module xml)

•XMLSchema 1.0 and XMLSchema 1.1 (API module xsd)

•XBRL 2.1 (API module xbrl)

The API can be used through callback functions which are implemented in a Python script file.

•on_xsi_valid

•on_xsd_valid

•on_dts_valid

•on_xbrl_valid

A script is specified with the --script option on the command line. The callback functions are invoked only if the validation succeeds. Details about the callback functions and the API are described in the RaptorXML+XBRL Server Python API version 1 reference.

Python API version 2

Introduced with RaptorXML+XBRL Server v2015r3. The latest API version is 2.8.6.

This API version introduces over 300 new classes and reorganizes the modules from the RaptorXML+XBRL Server Python API version 1 in such a way that frequently used information (for example, PSVI data) can be accessed more simply and related APIs are grouped logically together (fr example, xbrl.taxonomy, xbrl.formula, xbrl.table). In this version, the callback functions are invoked not only if validation succeeds, but also if validation fails. To reflect this behavior, the name of the callback functions are changed to:

•on_xsi_finished

•on_xsd_finished

•on_dts_finished

•on_xbrl_finished

To enable modularization, RaptorXML+XBRL Server now supports multiple --script options. The callbacks implemented in these Python script files are executed in the order specified on the command line.