Interfaz de la línea de comandos de MapForce
La sintaxis general para usar un comando de MapForce en la línea de comandos es:
MapForce.exe <filename> [/{target} [[<outputdir>] [/options]]] |
Leyenda
Para indicar la sintaxis de la línea de comando se usa la siguiente notación:
Notación | Descripción |
---|---|
Texto sin corchetes ni llaves | Elementos que puede teclear tal y como aparecen |
<Texto entre cuñas> | Marcador de posición para el que debe indicar un valor |
[Texto entre corchetes] | Elementos opcionales |
{Texto entre llaves} | Conjunto de elementos obligatorios; elija uno |
Barra vertical (|) | Separador para elementos mutuamente excluyentes; elija uno |
Puntos suspensivos (...) | Elementos que pueden repetirse |
<filename>
El archivo del diseño de la asignación (.mfd) o del proyecto de la asignación (.mfp) a partir del cual se genera el código. Para generar código para todo el proyecto, indique el destino /GENERATE (véase la siguiente tabla) e introduzca la ruta del proyecto en el campo <filename>, por ejemplo MapForceExamples.mfp.
/{target}
Indica el lenguaje o entorno de destino para el que se genera el código. Son compatibles los siguientes destinos de generación de código.
Destino | Descripción | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/COMPILE[:compileoptions] | Compila una asignación en un archivo de ejecución de MapForce Server (.mfx). También se pueden indicar las siguientes opciones:
| ||||||||||||||||||||||
/GENERATE | Genera código de proyecto para todas las asignaciones del archivo del proyecto usando la configuración actual de la carpeta (véase Gestionar las carpetas de proyecto). Si selecciona este destino, asegúrese de que indica un proyecto de MapForce (archivo .mfp) en el campo <filename>. | ||||||||||||||||||||||
/XSLT | Genera código XSLT 1.0. | ||||||||||||||||||||||
/XSLT2 | Genera código XSLT 2.0. | ||||||||||||||||||||||
/XSLT3 | Genera código XSLT 3.0. | ||||||||||||||||||||||
/XQuery | Genera código XQuery. | ||||||||||||||||||||||
/JAVA | Genera código Java. | ||||||||||||||||||||||
/CS | Genera código C#. Este comando también permite usar opciones específicas para generar el código, a saber:
/CS[:{VS2010|VS2013|VS2015|VS2017|VS2019}]
Si no se especifica ninguna versión de Visual Studio, el código se generará usando la versión del programa que esté definida en las opciones del generador de código (véase Opciones del generador de código). | ||||||||||||||||||||||
/CPP | Genera código C++. Este comando también permite
/CPP[:{VS2010|VS2013|VS2015|VS2017|VS2019},{MSXML|XERCES3},{LIB|DLL},{MFC|NoMFC}]
El primer grupo de opciones establece la versión de Visual Studio de destino. Valores válidos:
El segundo grupo de opciones indica la biblioteca XML de destino para el código generado. Valores válidos:
El tercer grupo de opciones indica si deben generarse bibliotecas estáticas en vez de dinámicas. Valores válidos:
El cuarto grupo de opciones indica si el código generado debe ser compatible o no con MFC. Valores válidos:
Si no se especifican estas opciones, el código se generará usando la versión del programa que esté definida en las opciones del generador de código (véase Opciones del generador de código). |
<outputdir>
Parámetro opcional que indica el directorio de salida. Si no se indica una ruta de salida, se usará el directorio de trabajo actual. Observe que las rutas relativas lo son al directorio de trabajo actual.
Cuando el destino es /GENERATE y el parámetro <outputdir> no está definido, el lenguaje de generación de código, así como la ruta de salida de cada asignación, los determinan las opciones definidas para cada carpeta del proyecto (véase Gestionar las carpetas de proyecto).
Cuando el destino es /GENERATE y el parámetro <outputdir> está definido, el valor <outputdir> introducido en la línea de comandos tiene prioridad frente al directorio de salida definido a nivel del proyecto raíz, pero no la tiene frente a las opciones de generación de código definidas en cada una de las carpetas dentro del proyecto.
/options
Las opciones /options no se excluyen mutuamente. Se pueden indicar una o más de las siguientes opciones.
Opción | Descripción |
---|---|
[/MFXVERSION[:<version>] | Esta opción se puede aplicar si el destino es /COMPILE. Con ella se compila un archivo de ejecución de MapForce Server (.mfx) para una versión específica de MapForce Server. Como valor puede introducir cualquiera de las versiones de MapForce Server a partir de la versión 2013r2 hasta la más reciente. Consulte también Compilar asignaciones en archivos de ejecución de MapForce Server. |
/GLOBALRESOURCEFILE <filename> | Esta opción se puede aplicar si la asignación de datos usa los recursos globales para resolver los archivos o las rutas a directorios de entrada o de salida, o bases de datos. Para más información, consulte Recursos globales de Altova. La opción /GLOBALRESOURCEFILE indica la ruta al archivo .xml de los recursos globales. Tenga en cuenta que si está indicado /GLOBALRESOURCEFILE también ha de estarlo /GLOBALRESOURCECONFIG. |
/GLOBALRESOURCECONFIG <config> | Esta opción especifica el nombre de la configuración de los recursos globales (véase la opción anterior). Observe si está indicado /GLOBALRESOURCEFILE también ha de estarlo /GLOBALRESOURCECONFIG. |
/LIBRARY <libname> (...) | Esta opción se usa junto con un lenguaje de generación de código de destino para especificar bibliotecas de funciones adicionales. Se puede usar varias veces para cargar varias bibliotecas. Estas bibliotecas se añaden de forma temporal (para esta ejecución) a las que se encuentran en Herramientas | Opciones | Bibliotecas. |
/LOG <logfilename> | Genera un archivo de registro en la ruta indicada. <logfilename> puede ser una ruta completa, es decir, puede incluir tanto un directorio como un nombre de archivo. Sin embargo, si indica una ruta completa, el directorio debe existir para que se genere el archivo de registro. Si solo indica el nombre del archivo, entonces este se guardará en el directorio actual del símbolo del sistema de Windows. |
Observaciones
•Las rutas relativas lo son al directorio de trabajo, que es el directorio de la aplicación que llama a MapForce en ese momento. Esto afecta a la ruta del nombre de archivo .mfd, del nombre de archivo .mfp, del directorio de salida, del nombre del archivo de registro y del nombre de archivo de los recursos globales. .
•No cierre la ruta con barra inversa y comillas en la línea de comandos (por ejemplo: "C:\Mi Directorio\"). El analizador sintáctico interpreta estos dos caracteres como comillas dobles literales. Use la doble barra inversa \\ si hay espacios en la línea de comando y necesita las comillas ("C:\Mi Directorio\\") o intente evitar el uso de espacios y, por ende, de comillas.
Ejemplos
1) Para iniciar MapForce y abrir la asignación <filename>.mfd, use:
MapForce.exe <filename>.mfd |
2) Para generar código XSLT 2.0 y crear también un archivo de registro con el nombre <logfilename>, use:
MapForce.exe <filename>.mfd /XSLT2 <outputdir> /LOG <logfilename> |
3) Para generar código XSLT 2.0 teniendo en cuenta la configuración del recurso global <grconfigname> del archivo de recurso global <grfilename>, use:
Mapforce.exe <filename>.mfd /XSLT2 <outputdir> /GLOBALRESOURCEFILE <grfilename> /GLOBALRESOURCECONFIG <grconfigname> |
4) Para generar una aplicación en código C# para Visual Studio 2015 y generar un archivo de registro, use:
MapForce.exe <filename>.mfd /CS:VS2015 <outputdir> /LOG <logfilename> |
5) Para generar una aplicación en C++ usando las opciones de generación de código definidas en Herramientas | Opciones y generar un archivo de registro, use:
MapForce.exe <filename>.mfd /CPP <outputdir> /LOG <logfilename> |
6) Para generar una aplicación en C++ para Visual Studio 2015, MSXML, con bibliotecas estáticas, compatible con MFC y sin archivo de registro, use:
MapForce.exe <filename>.mfd /CPP:VS2015,MSXML,LIB,MFC |
7) Para generar una aplicación en C++ para Visual Studio, Xerces, con bibliotecas dinámicas, sin compatibilidad con MFC y con archivo de registro, use:
MapForce.exe <filename>.mfd /CPP:VS2015,XERCES,DLL,NoMFC <outputdir> /LOG <logfilename> |
8) Para generar una aplicación en Java y también un archivo de registro, use:
MapForce.exe <filename>.mfd /JAVA <outputdir> /LOG <logfilename> |
9) Para generar código para todas las asignaciones del proyecto usando el lenguaje y el directorio de salida definidos en las opciones de la carpeta (de cada carpeta dentro del proyecto), use:
MapForce.exe <filename>.mfp /GENERATE /LOG <logfilename> |
10) Para generar código Java para todas las asignaciones del archivo del proyecto, use:
MapForce.exe <filename>.mfp /JAVA /LOG <logfilename> |
Con esta opción se ignora el lenguaje de generación de código definido en las opciones de la carpeta y se usa Java para todas las asignaciones.
11) Para indicar los archivos de entrada y de salida en la línea de comandos para una asignación en Java compilada con anterioridad, use:
java -jar <mappingfile>.jar /InputFileName <inputfilename> /OutputFileName <outputfilename> |
Los parámetros /InputFileName y /OutputFileName son nombres de componentes especiales de entrada de la asignación de datos de MapForce que permiten usar parámetros en la ejecución de la línea de comandos (véase Pasar parámetros a la asignación).
12) Para compilar una asignación en un archivo de ejecución de MapForce Server para la versión de MapForce 2023 y eliminar las firmas XML:
MapForce.exe <filename>.mfd /COMPILE:NOXMLSIGNATURES <outputdir> /MFXVERSION:2023 /LOG <logfilename> |