Integración con RaptorXML Server
Al integrar RaptorXML Server y FlowForce Server, las funciones de RaptorXML Server pasan a estar disponibles como funciones integradas de FlowForce Server. Esto significa que puede crear trabajos para validar documentos XML y JSON, taxonomías XBRL y archivos de instancia, así como comprobar si su formato es correcto. También es posible transformar y ejecutar documentos XBRL y XQuery. Para más información sobre las funciones de RaptorXML, consulte la documentación de RaptorXML Server.
Información sobre compatibilidad
Se garantiza la compatibilidad entre RaptorXML Server y FlowForce Server de la misma versión. Sin embargo, puede haber problemas de compatibilidad si utiliza versiones diferentes de estos productos. Puede comprobar la compatibilidad ejecutando el script de integración (como se describe en Integración más adelante).
Funciones genéricas de RaptorXML frente a funciones específicas de la versión de RaptorXML
Cuando integre la funcionalidad RaptorXML con FlowForce Server, obtendrá dos conjuntos de funciones: funciones genéricas y funciones específicas de la versión.
Funciones genéricas
Las funciones genéricas del contenedor /RaptorXML admiten un conjunto de características básicas que pueden no proporcionar todas las características del último servidor RaptorXML instalado (por ejemplo, una función genérica puede admitir sólo un parámetro, mientras que la misma función de la última versión puede tener varios parámetros). Estas funciones nunca cambian y se comportan de forma idéntica con cada versión de RaptorXML Server.
Funciones específicas de la versión
Las funciones específicas de la versión del contenedor /RaptorXML/{Release} tienen todas las características más recientes de esa versión de RaptorXML.
Integración
Una vez instalado RaptorXML Server, junto con FlowForce Server (disponible en Windows) o como producto independiente (disponible en cualquier plataforma), deberá integrar la funcionalidad de RaptorXML en FlowForce Server. A continuación se enumeran las posibles opciones de integración:
•Desde la página de configuración de FlowForce Server
•Por medio de varios comandos de la interfaz de la línea de comandos
•Por medio del script de integración
Para más detalles siga leyendo.
Integración desde la página de configuración
Esta es la forma más rápida y cómoda de integrar la funcionalidad RaptorXML en FlowForce Server. Siga estos pasos:
1.Abrir la página de configuración. Las instrucciones pueden variar en función de su plataforma:
2.En la página de configuración, haga clic en el botón Integrar herramientas de la instancia de servidor correspondiente.
3.En el diálogo que se abre, haga clic en Integrar. El registro mostrará los detalles de la integración, como se muestra en la siguiente imagen.
Se recomienda integrar RaptorXML Server antes de instalar los servicios FlowForce Server y FlowForce Web Server. También puede integrar RaptorXML más tarde. Sin embargo, recuerde que debe detener los servicios para poder hacer clic en el botón Integrar herramientas.
Integración desde la interfaz de la línea de comandos
Puede utilizar varios comandos de la ILC con las opciones --integratetools para integrar funciones RaptorXML en una instancia FlowForce nueva (con createdb, initdb o migratedb) o en una instancia ya existente (con initdb o upgradedb).
Integración por medio del script
Otra forma de integrar RaptorXML es ejecutando el script disponible en la siguiente ruta de acceso:
{Directorio de instalación de RaptorXML}\etc\functions\integrate.bat
| Nota: | En los sistemas Unix, el nombre del script es integrate.cs. Para ejecutar este script es necesario tener privilegios de superusuario (sudo). |
Este script toma dos argumentos: la ruta de acceso al directorio de instalación de FlowForce Server y la ruta de acceso al directorio instance-data de FlowForce Server. Al ejecutar el script, ocurre lo siguiente:
•Todas las funciones específicas de la versión RaptorXML Server que está integrada estarán disponibles en FlowForce Server. Las funciones específicas de cada versión tendrán todas las características más recientes de esa versión.
•Las funciones genéricas de RaptorXML se actualizarán de forma que se correspondan con la nueva versión integrada. Esto significa que las funciones genéricas utilizarán la nueva versión de RaptorXML para proporcionar la funcionalidad genérica, pero no admitirán ningún conjunto de características que no sea el genérico.
Para más detalles sobre las funciones RaptorXML genéricas y específicas de la versión, consulte Funciones genéricas de RaptorXML frente a funciones específicas de la versión de RaptorXML más arriba.
Si el script devuelve errores significa que las definiciones de función de la versión integrada de RaptorXML no son compatibles con FlowForce Server. En el caso improbable de que eso ocurra debe contactar nuestro equipo de atención al cliente.
Cómo llamar a las funciones de RaptorXML
Una vez que haya integrado RaptorXML en FlowForce, todas las funciones de RaptorXML Server estarán disponibles en el contenedor /RaptorXML de FlowForce (imagen siguiente). En el caso de RaptorXML+XBRL Server, el nombre del contenedor es /RaptorXMLXBRL.
Puede llamar a las funciones de RaptorXML de varias maneras:
•Navegando hasta el contenedor /RaptorXML (o /RaptorXMLXBRL), abriendo la función que le interese y haciendo clic en Crear trabajo. Puede seleccionar funciones genéricas como /RaptorXML/valjson o funciones específicas de la versión como /RaptorXML/2025/valjson. Más arriba se describen las diferencias entre una y otra.
•Creando un nuevo paso de ejecución en un trabajo y llamando a la función de RaptorXML deseada desde este paso. Por ejemplo, el siguiente paso llama a la función valjson:
Para ver ejemplos de trabajos que llaman a RaptorXML Server, consulte:
•Validar un documento con RaptorXML
•Validar XML con registro de errores
•Pasar pares clave/valor con RaptorXML
Para obtener información sobre las funciones de RaptorXML disponibles, consulte la documentación de RaptorXML Server.
Cómo actualizar las funciones de RaptorXML específicas de la versión a una versión más reciente
Si sus trabajos hacen referencia a funciones específicas de versiones anteriores (por ejemplo, 2022) y ha integrado una versión más reciente de RaptorXML Server (por ejemplo, 2024), las funciones específicas de versiones anteriores no se actualizarán automáticamente en sus trabajos. Para actualizar a una versión más reciente de las funciones de RaptorXML, puede utilizar cualquiera de estos métodos:
•Puede revisar cada trabajo y sustituir manualmente las funciones de RaptorXML de versiones anteriores por las nuevas.
•Alternativamente, puede copiar el archivo RaptorXML_<versión>.tool del directorio {INSTALLDIR}\etc de RaptorXML Server de la última versión instalada en el directorio {INSTANCEDIR}\tools de FlowForce Server. Después, tendrá que cambiar el nombre del archivo para que coincida con la versión a la que se refieren sus trabajos. Por ejemplo, si la versión anterior es RaptorXML 2022, entonces cambie el nombre a RaptorXML_2022.tool. Aparentemente, todos los trabajos existentes seguirán llamando a funciones de RaptorXML 2022, mientras que el nuevo archivo .tool se asignará de hecho al ejecutable de RaptorXML Server 2024.
Si sus trabajos hacen referencia a funciones genéricas de RaptorXML, no tendrá que hacer nada.
Información sobre los archivos .tool
FlowForce Server utiliza archivos .tool para localizar otros productos de servidor Altova que se ejecutan bajo su gestión. Los archivos tool son una parte crucial de la integración de RaptorXML, ya que permiten a FlowForce Server encontrar el ejecutable de RaptorXML Server correspondiente y localizar las diferentes versiones de RaptorXML. Estos archivos también pueden utilizarse para establecer variables de entorno. Existe un archivo .tool distinto por cada versión de RaptorXML Server. Para más información sobre los archivos .tool, consulte Archivos tool.