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 obtener más información sobre la funcionalidad 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 diferentes versiones de estos productos. Puede comprobar la compatibilidad ejecutando el script de integración (tal y como se describe más abajo en Integración).
Funciones genéricas de RaptorXML frente a funciones de una versión específica
Al integrar las funciones de RaptorXML en 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 básico de características que puede no incluir todas las características de la última versión instalada de RaptorXML Server (por ejemplo, una función genérica puede admitir solo 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 manera idéntica en todas las versiones de RaptorXML Server.
Funciones específicas de la versión
Las funciones específicas de la versión disponibles en el contenedor /RaptorXML/{Release} tienen todas las características más recientes de esa versión de RaptorXML.
Integración
Después de instalar 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. Estas son las opciones de integración:
•A través de la página de configuración de FlowForce Server
•Con ayuda de varios comandos de la interfaz de la línea de comandos
•Con ayuda del script de integración
Siga leyendo para saber más.
Integración a través de 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. Puede integrar RaptorXML Server:
•Antes de instalar los servicios: puede configurar una instancia de FlowForce, integrar RaptorXML Server y, luego, instalar los servicios FlowForce Server y FlowForce Web Server.
•Más tarde: puede configurar una instancia de FlowForce, instalar los servicios y, más adelante, volver a la página de configuración para integrar RaptorXML Server. No olvide que debe detener los servicios antes de poder hacer clic en el botón Integrar herramientas.
Para integrar RaptorXML Server, siga estos pasos:
1.Abra la página de configuración. Las instrucciones pueden variar dependiendo de la plataforma:
2.En la página de configuración, haga clic en el botón Integrar herramientas para la instancia de servidor correspondiente.
3.En el cuadro de diálogo que se abre, haga clic en Integrar. El registro mostrará los detalles de la integración (imagen siguiente).
Integración desde la interfaz de la línea de comandos
Para integrar las funciones de RaptorXML, puede utilizar varios comandos de la interfaz de la línea de comandos que incorporan la opción --integratetools. Para integrarlas en una instancia nueva tiene los comandos createdb, initdb o migratedb. Para integrarlas en una instancia ya existente tiene initdb o upgradedb.
Integración con ayuda del script de integración
Otra forma de integrar RaptorXML es ejecutar el script disponible en la siguiente ruta:
{RaptorXML installation directory}\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 al directorio de instalación de FlowForce Server y la ruta al directorio de datos de instancia de FlowForce Server. Cuando ejecute el script, ocurrirá lo siguiente:
•Todas las funciones específicas de la versión integrada de RaptorXML Server estarán disponibles en FlowForce Server. Las funciones específicas de cada versión incluirán todas las características más recientes de dicha versión.
•Las funciones genéricas de RaptorXML se actualizarán de tal manera que se asignarán a la versión que acaba de ser 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 un conjunto de características más allá de la genérica.
Para saber más sobre las funciones genéricas y específicas de cada versión, consulte Funciones genéricas de RaptorXML frente a funciones de una versión específica 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:
•Navegue hasta el contenedor /RaptorXML (o /RaptorXMLXBRL), abra la función en cuestión y después haga clic en Crear trabajo. Puede seleccionar funciones genéricas como /RaptorXML/valjson o funciones específicas de una versión concreta, como /RaptorXML/2026/valjson. Más abajo se describen las diferencias entre unas y otras.
•Cree un nuevo paso de ejecución en un trabajo y llame a la función de RaptorXML en cuestión 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
•Usar RaptorXML para pasar pares de parámetros clave/valor
Si desea saber más sobre las funciones disponibles de RaptorXML, consulte la documentación de RaptorXML Server.
Cómo actualizar funciones específicas de la versión de RaptorXML con 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 la versión anterior no se actualizarán automáticamente en sus trabajos. Para cambiar a una versión más reciente de las funciones de RaptorXML, puede utilizar cualquiera de los siguientes métodos:
•Puede ir revisando cada trabajo y sustituir manualmente las funciones RaptorXML de las versiones anteriores por las más recientes.
•También puede copiar el archivo RaptorXML_<release>.tool del directorio {INSTALLDIR}\etc de RaptorXML Server de la última versión instalada al directorio {INSTANCEDIR}\tools de FlowForce Server. Después, deberá cambiar el nombre del archivo para que coincida con la versión a la que hacen referencia sus trabajos. Por ejemplo, si la versión anterior es RaptorXML Server 2022, cambie el nombre del archivo a RaptorXML_2022.tool. Los trabajos existentes seguirán como si llamaran a las funciones de RaptorXML 2022, mientras que el nuevo archivo .tool se asignará en realidad al ejecutable RaptorXML Server 2024.
Si sus trabajos hacen referencia a las funciones genéricas de RaptorXML, no tiene que cambiar nada.
Información sobre los archivos .tool
FlowForce Server utiliza archivos .tool para localizar otros productos servidor de Altova que se ejecutan bajo su gestión. Los archivos tool son una parte fundamental de la integración de RaptorXML, ya que permiten a FlowForce Server encontrar el ejecutable pertinente de RaptorXML Server y localizar diferentes versiones de RaptorXML. Estos archivos también se pueden utilizar para configurar variables de entorno. Existe un archivo .tool distinto por cada versión de RaptorXML Server. Si quiere saber más sobre los archivos .tool, consulte Archivos tool.