Altova RaptorXML Server 2025

RaptorXML Server ofrece varias versiones de la API de Python. Todas las versiones antiguas de la API de Python son compatibles con la versión actual de RaptorXML Server. La versión de la API de Python se selecciona con la marca de la línea de comandos --script-api-version=MAJOR_VERSION. El valor predeterminado del argumento MAJOR_VERSION siempre es la versión actual. Cada vez que se introduzcan mejoras o cambios incompatibles, estará disponible un MAJOR_VERSION nuevo para la API de Python de RaptorXML Server. El usuario de la API no tiene que actualizar sus scripts cuando se publiquen versiones nuevas.

Sin embargo, recomendamos:

•Utilizar la marca --script-api-version=MAJOR_VERSION para invocar scripts de otras utilidades desde la línea de comandos de RaptorXML Server (o desde la API web). Así se garantiza que los scripts sigan funcionando tras la instalación de actualizaciones de RaptorXML Server (incluso si se publica una versión nueva de MAJOR_VERSION).

•Utilizar la versión más reciente de la API para proyectos nuevos, aunque las versiones nuevas de RaptorXML Server sean compatibles con versiones antiguas de la API.

A continuación se enumeran las versiones de la API de Python que están disponibles actualmente. La documentación de estas API se puede consultar en el sitio web de Altova (ver enlaces más abajo).

Archivos de ejemplo

Puede encontrar ejemplos de scripts para las API de Python de RaptorXML en https://github.com/altova.

API de Python (versión 1)

Se introdujo con RaptorXML Server v2014.

Se trata de la API de Python de RaptorXML Server original. Ofrece funciones para acceder al modelo interno de RaptorXML Server para:

•XML 1.0 y XML 1.1 (módulo API xml)

•XMLSchema 1.0 y XMLSchema 1.1 (módulo API xsd)

•XBRL 2.1 (módulo API xbrl)

La API se puede utilizar a través de varias funciones de devolución de llamada que se implementan en un archivo de script Python.

•on_xsi_valid

•on_xsd_valid

•on_dts_valid

•on_xbrl_valid

El script se especifica con la opción --script en la línea de comandos. Las funciones de devolución de llamada se invocan solamente si la validación finaliza correctamente. Para obtener más información sobre las funciones de devolución de llamada y la API, consulte la Referencia de la API de Python (versión 1) en el sitio web de Altova.

API de Python (versión 2)

Se introdujo con RaptorXML Server v2015r3. La versión más reciente de la API es la versión 2.10.0.

Esta versión de la API introduce más de 300 clases nuevas y reorganiza los módulos de la versión 1 en RaptorXML Server de tal modo que la información que se utiliza con más frecuencia (como los datos PSVI, por ejemplo) sea más accesible. Además las API relacionadas se agrupan de forma lógica (p.ej. xbrl.taxonomy, xbrl.formula, xbrl.table). En esta versión las funciones de devolución de llamada no solamente se invocan cuando la validación finaliza correctamente, sino también cuando se produce un error durante la validación. Por ello se ha modificado el nombre de las funciones de devolución de llamada:

•on_xsi_finished

•on_xsd_finished

•on_dts_finished

•on_xbrl_finished

Además, RaptorXML Server ofrece varias opciones --script. Las devoluciones de llamada implementadas en los scripts Python se ejecutan en el orden indicado en la línea de comandos.