Compilar asignaciones en archivos de ejecución de MapForce Server
Si en la asignación de datos de MapForce eligió el motor de transformación integrado, la asignación se podrá ejecutar con MapForce y con MapForce Server (ver apartado anterior). Hay dos maneras de ejecutar asignaciones de datos con MapForce Server:
•Si MapForce Server se ejecuta en modo independiente (es decir, si no tiene FlowForce Server instalado), la asignación debe compilarse en un archivo de ejecución .mfx (ver más abajo). El archivo .mfx se puede ejecutar en la línea de comandos con el comando run. También puede ejecutar la asignación invocando el método run de la API de MapForce Server. Consulte la documentación de MapForce Server (https://www.altova.com/es/documentation) para obtener más información.
•Si MapForce Server se ejecuta como módulo de FlowForce Server, la asignación se puede implementar en un equipo donde se ejecuten FlowForce Server y MapForce Server. Para más información consulte el apartado Implementar asignaciones en FlowForce Server.
Requisitos
Consulte el apartado anterior (Preparar asignaciones para ejecutarlas en servidores).
Para compilar una asignación en un archivo de ejecución de MapForce Server (.mfx):
1.Abra una asignación de datos en MapForce (por ejemplo, myMapping.mfd).
2.En el menú Archivo, haga clic en Compilar en archivo de ejecución de MapForce Server.
3.Seleccione la carpeta donde desea guardar el archivo .mfx y cambie el nombre del archivo si lo necesita.
4.Por último, haga clic en Guardar. El archivo de ejecución de MapForce Server myMapping.mfx se genera en la carpeta seleccionada.
Para compilar una asignación en un archivo de ejecución de MapForce Server (.mfx) desde la línea de comandos:
•Ejecute MapForce desde la línea de comandos, especifique el archivo de asignación y la opción /COMPILE de la línea de comandos.
Por ejemplo, con el comando que aparece a continuación puede compilar la asignación C:\Usuarios\altova\Documentos\Altova\MapForce2024\MapForceExamples\SimpleTotal.mfd en un archivo de ejecución de MapForce Server que se creará en el directorio de salida C:\Usuarios\altova\Desktop.
"C:\Archivos de programa (x86)\Altova\MapForce2024\MapForce.exe" "C:\Usuarios\altova\Documentos\Altova\MapForce2024\MapForceExamples\SimpleTotal.mfd" /COMPILE "C:\Usuarios\altova\Desktop" |
Consulte la documentación de la interfaz de la línea de comandos de MapForce para obtener más información.
Qué incluye el archivo .mfx
El archivo .mfx incluye esta información:
•El algoritmo de asignación, incluidas todas las funciones definidas por el usuario importadas de otras asignaciones.
•Nombres de archivos de entrada y salida a los que se hace referencia en componentes de la asignación. Las rutas de acceso son absolutas o relativas dependiendo de la configuración de la asignación, véase Rutas de acceso según el entorno de ejecución.
•Si la asignación contiene componentes XML, se incluye la información sobre el esquema XML, que es necesaria para poder ejecutar la asignación, y se codifica en el algoritmo de asignación.
•Si la asignación incluye conexiones a la base de datos, se describen también los detalles de esta conexión. Las contraseñas están cifradas.
•Información1 derivada de, según la asignación:
oconfiguraciones EDI y FlexText
oesquemas JSON
oarchivos .proto
•Si la asignación incluye credenciales también se incluyen los campos de información sensible, cifrados, si marca la casilla Incluir credencial cifrada en el archivo .mfx y en la implementación de la asignación. De lo contrario esos campos se omiten. Para más detalles, consulte Credenciales.
Notas al pie:
1.Información derivada de configuraciones EDI o FlexText, esquemas JSON, taxonomías XBRL o archivos .proto se incrusta en el archivo .mfx en forma compilada y procesada. Los archivos de origen originales no se pueden obtener desde un archivo .mfx compilado. La información se compila en el estado en que esté en el momento de la compilación; si la modifica más adelante deberá volver a compilar también el archivo mfx.
Los archivos de instancia de entrada (XML, CSV, texto, EDI, Excel, JSON, XBRL) que use la asignación no se incluyen en el archivo .mfx compilado. Lo mismo ocurre con las bases de datos basadas en archivos, como son Access o SQLite. Si la asignación hace referencia a taxonomías XBRL relacionadas con la compatibilidad con tablas XBRL, la información relativa a la taxonomía no se compila en el archivo .mfx. Para más información consulte el apartado Preparar asignaciones para ejecución en servidor.
Compilar asignaciones para una versión concreta de MapForce Server
Si su versión de MapForce Server es anterior a su versión de MapForce, puede que MapForce Server no pueda ejecutar correctamente los archivos creados con la versión más reciente de MapForce. Si este es su caso, puede compilar el archivo .mfx para una versión concreta de MapForce Server:
1.Haga clic en el comando de menú Herramientas | Opciones y después elija Generación de código.
2.En el grupo de opciones Archivo de ejecución para servidor, junto al campo Generar para versión de MapForce Server, seleccione la versión de MapForce Server que necesita en la lista desplegable.
Cuando instale una versión más reciente de MapForce Server, recuerde que deberá cambiar esta opción según corresponda. Si no quiere compilar para una versión específica de MapForce Server, también puede seleccionar la versión más reciente en la lista desplegable (es la opción predeterminada). En este caso se compilará el archivo .mfx para la versión más reciente de MapForce Server, lo cual le permitirá beneficiarse de las mejoras y características más recientes del producto.
Para especificar una versión concreta de MapForce Server desde la línea de comandos debe ejecutar el comando /COMPILE con el conmutador /MFXVERSION. Por ejemplo:
"C:\Archivos de programa (x86)\Altova\MapForce2024\MapForce.exe" /COMPILE /MFXVERSION:2024 |
Consulte la documentación de la interfaz de la línea de comandos de MapForce para obtener más información.
Otras opciones
La compilación de archivos de ejecución de MapForce Server también puede verse afectada por estas opciones de la aplicación:
Convertir todas las conexiones a BD ADO y ODBC en JDBC | Si esta opción está habilitada, las conexiones de base de datos ADO, ADO.NET y ODBC se transforman en JDBC, usando el controlador JDBC y la URL de la base de datos definida en el cuadro de diálogo "Configuración del componente" (véase Configuración de componentes de base de datos).
La conexión JDBC se usará de forma implícita si el equipo de destino es un servidor Linux o macOS. |
Ignorar las firmas digitales (incompatibles con MapForce Server) | Esta opción solamente es relevante en MapForce Enterprise Edition y está habilitada por defecto. Si utiliza firmas XML digitales, la asignación omitirá la información sobre firmas digitales porque MapForce Server no es compatible con esta característica |
Para ver o cambiar estas opciones:
•Haga clic en el comando de menú Herramientas | Opciones y después elija Generación de código.
También puede acceder a estas opciones desde la interfaz de la línea de comandos. Consulte la documentación de la interfaz de la línea de comandos de MapForce para obtener más información.