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]]]
Para más información sobre cada parámetro del comando, véase la lista a continuación.
Sintaxis de la línea de comandos
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 |
El archivo del diseño de la asignación (.mfd) o del proyecto de la asignación (.mfp) (ediciones Professional y Enterprise) a partir del cual se genera el código.
|
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:
•/XSLT •/XSLT2 •/XSLT3
|
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.
|
Las opciones /options no se excluyen mutuamente. Se pueden indicar una o más de las siguientes opciones:
•La opción /GLOBALRESOURCEFILE <filename> se puede aplicar si la asignación de datos usa los recursos globales para resolver un archivo de entrada o de salida, rutas a directorios 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. Observe si está indicado /GLOBALRESOURCEFILE también ha de estarlo /GLOBALRESOURCECONFIG.
•La opción /GLOBALRESOURCECONFIG <config> especifica el nombre de la configuración de los recursos globales (véase la opción anterior). Si está indicado /GLOBALRESOURCEFILE también ha de estarlo /GLOBALRESOURCECONFIG.
•La opción /LOG <logfilename> genera un archivo de registro en la ruta indicada. La ruta <logfilename> puede ser absoluta. Si indica una ruta completa, el directorio debe existir para que se genere el archivo de registro. Si sólo indica el nombre del archivo, este se guardará en el directorio actual del símbolo del sistema de Windows.
|
Notas
•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 se aplica a la ruta del nombre de archivo .mfd, directorio de salida, nombre de archivo de registro y nombre de archivo de recurso global.
•No use barras diagonales inversas y comillas de cierre en la línea de comandos (p.ej., "C:\Mi directorio\"). El analizador sintáctico interpreta estos dos caracteres como comillas dobles literales. Se recomienda evitar el uso de espacios y comillas. Si hay espacios en la línea de comando y necesita las comillas, use la doble barra inversa (p.ej., "C:\Mi Directorio\\").
Ejemplos
1) Para iniciar MapForce y abrir la asignación <filename>.mfd, use este comando:
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 este comando:
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 este comando:
Mapforce.exe <filename>.mfd /XSLT2 <outputdir> /GLOBALRESOURCEFILE <grfilename> /GLOBALRESOURCECONFIG <grconfigname>
Ejemplos para las ediciones Professional y Enterprise
1) Para generar una aplicación en código C# para Visual Studio 2022 y generar un archivo de registro, use este comando:
MapForce.exe <filename>.mfd /CS:VS2022 <outputdir> /LOG <logfilename>
2) 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 este comando:
MapForce.exe <filename>.mfd /CPP <outputdir> /LOG <logfilename>
3) Para generar una aplicación en C++ para Visual Studio 2022, MSXML, con bibliotecas estáticas, compatible con MFC y sin archivo de registro, use este comando:
MapForce.exe <filename>.mfd /CPP:VS2022,MSXML,LIB,MFC
4) 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 este comando:
MapForce.exe <filename>.mfd /CPP:VS2022,XERCES,DLL,NoMFC <outputdir> /LOG <logfilename>
5) Para generar una aplicación en código Java y generar un archivo de registro, use este comando:
MapForce.exe <filename>.mfd /JAVA <outputdir> /LOG <logfilename>
6) 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 este comando:
MapForce.exe <filename>.mfp /GENERATE /LOG <logfilename>
7) Para generar código Java para todas las asignaciones del archivo del proyecto, use este comando:
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.
8) 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 este comando:
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).
9) Para compilar una asignación en un archivo de ejecución de MapForce Server para la versión de MapForce 2024 y eliminar las firmas XML, use este comando:
MapForce.exe <filename>.mfd /COMPILE:NOXMLSIGNATURES <outputdir> /MFXVERSION:2024 /LOG <logfilename>