run
El comando run ejecuta un archivo de ejecución de MapForce Server (archivo .mfx) suministrado como argumento. El archivo de ejecución de MapForce Server se crea con MapForce y representa una asignación compilada para su ejecución en un servidor.
Los archivos de entrada que necesita la asignación se espera que estén en la ruta indicada al diseñar la asignación en MapForce. Si MapForce Server no se ejecuta en el mismo sistema operativo que MapForce, entonces los archivos de entrada para la asignación se deben copiar en el equipo de destino junto con el archivo .mfx y después se debe hacer referencia a ellos con una ruta relativa. Para obtener información sobre las rutas relativas o absolutas en las asignaciones de datos, consulte la documentación de MapForce (https://www.altova.com/es/documentation#mapforce). Es posible que existan otros requisitos previos dependiendo de cómo haya diseñado la asignación. Para más información, consulte Preparar asignaciones para ejecución en servidor.
Si la asignación devuelve un valor simple, como una cadena, esta salida se escribe en la secuencia stdout (salida estándar). Los mensajes de éxito y error están disponibles en la secuencia stderr (error estándar). Si no quiere que la secuencia de resultado estándar se muestre en pantalla junto con el mensaje de éxito o error puede redirigir la secuencia de resultado estándar o la secuencia de error estándar (o ambas) a archivos. Si no las redirige, las secuencias stdout y stderr se mostrarán juntas en pantalla.
Por ejemplo, para redirigir la secuencia de resultado estándar a un archivo, use:
mapforceserver run MyMapping.mfx > MyOutput.txt |
Para redirigir la secuencia de error estándar a un archivo, use:
mapforceserver run MyMapping.mfx 2> Diagnostics.log |
Para redirigir las dos secuencias al mismo tiempo, use:
mapforceserver run MyMapping.mfx > MyOutput.txt 2> Diagnostics.log |
Para más información sobre cómo redirigir secuencias consulte la documentación de la shell de comandos de su sistema operativo.
Sintaxis
Windows | MapForceServer run [opciones] MfxFile |
Linux | mapforceserver run [opciones] MfxFile |
Opciones del comando
| --catalog=ARCHIVO | Especifica la ruta absoluta a un archivo de catálogo raíz que no es el archivo de catálogo raíz instalado. El valor predeterminado es la ruta absoluta al archivo de catálogo raíz instalado; consulte Archivos de catálogo.
|
--cert | --certificatespath=ARCHIVO | Aplicable a MapForce Server cuando se ejecuta en Linux. Indica la ruta de acceso al directorio donde se almacenan los archivos de certificado requeridos por la asignación.
Consulte la sección Gestión de certificados digitales para obtener más información.
|
--cp | --java-classpath=CLASSPATH | Especifica la variable classpath de Java que se va a utilizar (equivalente a la opción -cp al iniciar Java). MapForce Server pasa este valor al Java Runtime.
|
--cred | --credential=CLAVE:VALOR | Esta opción se puede usar si la asignación contiene credenciales que definió al diseñar la asignación en MapForce. CLAVE es el nombre de la credencial como se definió en MapForce. VALOR consiste en uno o más pares nombre-valor, por ejemplo:
name1=value1&name2=value2
Donde name es cualquiera de estas opciones:
•nombre de usuario •contraseña •oauth:token
Si usa varios pares nombre-valor separados por el símbolo & debe usar CLAVE:VALOR entre comillas. Para más información consulte Credenciales.
|
--gc | --globalresourceconfig=VALOR | Esta opción se puede usar si la aplicación consume recursos globales. Especifica el nombre de la configuración de recursos globales. Esta opción debe utilizarse junto con la opción --globalresourcefile, |
--gr | --globalresourcefile=ARCHIVO | Esta opción se puede usar si la aplicación consume recursos globales. Especifica la ruta del archivo de definición de recursos globales. Esta opción debe utilizarse junto con la opción --globalresourceconfig. |
| --java-ignore-codebase=true|false | Ignora la ruta del código base incrustada en la asignación, que de otro modo se utilizaría para localizar los archivos de clase Java. Cuando se configura como true, solo se utiliza la ruta de clases Java para resolver clases. El valor predeterminado es false.
Utilice --java-ignore-codebase=true junto con --java-classpath para asegurarse de que solo se utilice la ruta de clases especificada para resolver las clases Java.
|
--l | --lang | El lenguaje usado para mostrar mensajes.
|
--p | --param | Esta opción se puede aplicar si la asignación se diseñó para aceptar parámetros de entrada. Asigna un valor a un parámetro definido en la asignación. Formato: --param=ParamName:ParamValue. El conmutador --param se debe usar antes de cada parámetro. Si NombreParám o ValorParám contiene un espacio, utilice comillas. Por ejemplo: --p=company:"Nanonull Inc".
Para obtener más información sobre las asignaciones que admiten parámetros de entrada, consulte la documentación de MapForce (https://www.altova.com/es/documentation#mapforce).
|
| --taxonomy-package=ARCHIVO | Indica la ruta de acceso absoluta a un paquete de taxonomías XBRL según se describe en la recomendación Taxonomy Packages 1.0. El valor de ARCHIVO suministra la ubicación del paquete de taxonomía. Agregue esta opción varias veces para indicar más de un paquete de taxonomía.
|
| --taxonomy-packages-config-file=ARCHIVO | Indica la ruta de acceso a un archivo de configuración llamado TaxonomyPackagesConfig.json que se usa para cargar paquetes de taxonomía XBRL. Este archivo de configuración se actualiza cada vez que añade, elimina, activa o desactiva paquetes de taxonomías XBRL desde la interfaz gráfica de los productos de Altova XMLSpy, MapForce o StyleVision. Si añadió paquetes de taxonomías XBRL personales con uno de esos productos el archivo está en C:\Users\<usuario>\Documentos\Altova.
|
Ejemplos
Este ejemplo muestra cómo ejecutar el archivo de ejecución de asignaciones (.mfx) con MapForce en Windows. La asignación usada en este ejemplo lee un archivo de entrada, Employees.xml, y produce dos archivos de salida (PersonList.xml y Contacts.xml).
Primero, genere el archivo de ejecución de MapForce Server (.mfx):
1.Ejecute MapForce y abra el siguiente archivo de diseño de MapForce (archivo .mfd): C:\Users\<usuario>\Documentos\Altova\MapForce2026\MapForceExamples\ChainedPersonList.mfd.
2.En el menú Archivo haga clic en Compilar en archivo de ejecución de MapForce Server.
3.Cuando se le solicite, guarde el archivo .mfx en el directorio C:\temp. Este es el directorio de trabajo donde MapForce Server ejecuta la asignación.
A continuación abra la línea de comandos y cambie el directorio de trabajo a C:\temp\.
cd C:\temp |
Por último, ejecute este comando para ejecutar ChainedPersonList.mfx. En este ejemplo se llama a MapForce Server con una ruta absoluta. (Para llamarlo con una ruta relativa debe añadir la ruta de acceso del ejecutable a la variable de entorno PATH de su sistema).
"C:\Archivos de programa (x86)\Altova\MapForceServer2026\bin\MapForceServer.exe" run ChainedPersonList.mfx |
Los dos archivos de salida (PersonList.xml y Contacts.xml) se generan en el directorio de trabajo. Es importante destacar que esta asignación está configurada para usar rutas absolutas, razón por la cual esta asignación se ejecutó correctamente y no necesitó que el archivo Employees.xml de entrada existiera en el directorio de trabajo. El archivo Employees.xml existe realmente en la carpeta MapForce Examples mencionada anteriormente y se hace referencia a él mediante una ruta absoluta. Para indicar si las rutas deben tratarse como absolutas o relativas haga clic con el botón derecho en la asignación en MapForce, seleccione Configurar asignación y después active o desactive la casilla Convertir las rutas de acceso en absolutas en el código generado. Siempre que cambie la configuración de la asignación debe asegurarse de que vuelve a compilar la asignación a .mfx. Para más información, consulte Preparar asignaciones para ejecución en servidor.