run
El comando run ejecuta un archivo MFX proporcionado como argumento. Un archivo MFX es una asignación creada con MapForce y compilada para su ejecución en el servidor.
Archivos de entrada
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, los archivos de entrada necesarios para la asignación deben copiarse en el equipo de destino junto con el archivo MFX y se debe hacer referencia a ellos mediante una ruta relativa.
Es posible que existan otros requisitos previos dependiendo de cómo diseñe la asignación. Para más información, consulte Preparar asignaciones para ejecución en servidor.
Salida estándar y error estándar
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 desea que la secuencia de salida estándar se muestre en pantalla junto con los mensajes de éxito o de error, redirija la secuencia de salida estándar o la secuencia de error estándar (o ambos) a archivos. Si no las redirige, las secuencias stdout y stderr se mostrarán juntas en pantalla.
Por ejemplo, para redirigir la secuencia de salida estándar a un archivo, use:
mapforceserver run MiAsignación.mfx > MiResultado.txt |
Para redirigir la secuencia de error estándar a un archivo, use:
mapforceserver run MiAsignación.mfx 2> Diagnóstico.log |
Para redirigir las dos secuencias al mismo tiempo, use:
mapforceserver run MiAsignación.mfx > MiResultado.txt 2> Diagnóstico.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] ArchivoMfx |
Linux | mapforceserver run [opciones] ArchivoMfx |
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 está compuesto por uno o más pares nombre-valor, por ejemplo:
nombre1=valor1&nombre2=valor2
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 idioma utilizado para mostrar los 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=NombreParám:ValorParám. 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).
|
--py | --python-homepath=ARCHIVO | Si ejecuta una asignación que contenga funciones personales Python con MapForce Server, puede configurar el directorio principal de Python con ayuda de la opción --py. Esto anula el directorio de inicio de Python detectado automáticamente.
Para obtener más información sobre el uso de bibliotecas personales Python, 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
En este ejemplo se muestra cómo ejecutar un archivo de ejecución de asignaciones de datos (.mfx) con MapForce Server 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): 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\MapForceServer2027\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. Cada vez 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.