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; este archivo representa una asignación compilada para su ejecución en 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 MapFroce, 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 información sobre cómo configurar una asignación con respecto a rutas relativas o absolutas, consulte la documentación de MapForce (https://www.altova.com/es/documentation#mapforce). Puede que existan otros requisitos en función de cómo haya diseñado la asignación (véase Preparar asignaciones para ejecución en servidor).
Si la asignación devuelve un valor simple, como una cadena, este resultado se escribe en la secuencia stdout (resultado estándar). Los mensajes de éxito y error, por su parte, se encuentran 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 |
Mac | mapforceserver run [opciones] MfxFile |
Opciones
| --catalog | 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 por defecto es la ruta absoluta al archivo de catálogo raíz instalado. Formulario: --catalog=FILE |
--cert | --certificatespath | Esta opción se puede aplicar si MapForce se está ejecutando en Linux. Indica la ruta de acceso al directorio donde se almacenan los archivos de certificado requeridos por la asignación. Formulario: --certificatespath=DIRECTORY
Véase también el apartado Gestión de certificados digitales. |
--cred | --credential=KEY:VALUE | Esta opción se puede usar si la asignación contiene credenciales que definió al diseñar la asignación en MapForce. KEY es el nombre de la credencial como se definió en MapForce. VALUE consiste en uno o más pares nombre-valor, por ejemplo: name1=value1&name2=value2
Donde name es cualquiera de estas opciones:
•username •password •oauth:token
Si usa varios pares nombre-valor separados por el símbolo & debe usar KEY:VALUE entre comillas. Para más información consulte Credenciales. |
--gc | --globalresourceconfig | Esta opción se puede usar si la aplicación consume recursos globales. Indica el nombre de la configuración de los recursos globales (alias) y se debe usar junto con la opción --globalresourcefile. |
--gr | --globalresourcefile | Esta opción se puede usar si la aplicación consume recursos globales. Indica la ruta de acceso al archivo de definición de los recursos globales y se debe usar junto con la opción --globalresourceconfig. |
--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. Formulario --param=ParamName:ParamValue. Antes de cada parámetro se debe usar el conmutador --param. Use comillas si ParamName o ParamValue contienen algún espacio. Por ejemplo: --p=company:"Nanonull Inc".
Para más información sobre asignaciones que aceptan parámetros de entrada consulte la documentación de MapForce (https://www.altova.com/es/documentation#mapforce). |
| --taxonomy-package | 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 FILE suministra la ubicación del paquete de taxonomía. Añada la opción varias veces para indicar más de un paquete de taxonomía. Formulario: --taxonomy-package=FILE |
| --taxonomy-packages-config-file | 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\<username>\Documents\Altova. Formulario: --taxonomy-packages-config-file=FILE |
Ejemplos
Este ejemplo muestra cómo ejecutar el archivo de ejecución de una asignación (.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\<user>\Documents\Altova\MapForce2025\MapForceExamples\ChainedPersonList.mfd.
2.En el menú Archivo haga clic en Compilar en archivo de ejecución de MapForce Server.
3.Cuando el programa lo 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:\Program Files (x86)\Altova\MapForceServer2025\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ó exitosamente y no necesitó que el archivo Employees.xml de entrada existiera en el directorio de trabajo. El archivo Employees.xml existe en la carpeta MapForce Examples que hemos mencionado antes. Para hacer referencia a él se usa 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 el apartado Preparar asignaciones para ejecución en servidor.