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. Para generar código para todo el proyecto, indique el destino /GENERATE (véase /{target} a continuación) e introduzca la ruta del proyecto en el campo <filename> (p.ej., MapForceExamples.mfp).
|
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 •El comando /COMPILE[:compileoptions] Compila una asignación en un archivo de ejecución de MapForce Server (.mfx). También puede elegir las siguientes opciones separadas por una coma:
oLa opción JDBC transforma todas las conexiones DB en JDBC usando el driver JDBC y la URL definidos en el cuadro de diálogo Configuración de componentes de BD. oLa opción NOXMLSIGNATURES elimina la generación de firmas digitales en el archivo de ejecución de MapForce Server. Tenga en cuenta que no se admiten las firmas digitales en MapForce Server.
•El comando /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 (.mfp) en el campo <filename>. •/XQuery •Java •El comando /CS genera código C#. Este comando permite configurar las siguientes opciones de generación de código:
/CS[:{VS2013|VS2015|VS2017|VS2019|VS2022|DOTNETCORE31|DOTNET50|DOTNET60}]
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.
•El comando /CPP genera código C++. Este comando permite configurar las siguientes opciones de generación de código:
/CPP[:{VS2013|VS2015|VS2017|VS2019|VS2022|DOTNETCORE31|DOTNET50|DOTNET60},{MSXML|XERCES3},{LIB|DLL},{MFC|NoMFC}]
El primer grupo de opciones indica el entorno de desarollo (p.ej., VS2022 significa Visual Studio 2022).
El segundo grupo de opciones indica la biblioteca XML de destino para el código generado. Los siguientes valores son válidos:
oMSXML (genera código para MSXML 6.0) oXERCES3 (genera código para Xerces 3)
El tercer grupo de opciones indica si deben generarse bibliotecas estáticas o dinámicas. Los valores válidos son los siguientes:
oLIB (genera bibliotecas LIB estáticas) oDLL (genera bibliotecas DLL)
El cuarto grupo de opciones indica si el código generado debe ser compatible o no con MFC. Los valores válidos son los siguientes:
oMFC (habilita la compatibilidad con MFC) oNoMFC (deshabilita la compatibilidad con MFC)
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.
|
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 y 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> indicado en la línea de comandos tiene prioridad sobre el directorio de salida definido en el nivel raíz del proyecto. Sin embargo, no tiene prioridad sobre las opciones de generación de código definidas en cada carpeta del proyecto.
|
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 solo indica el nombre del archivo, este se guardará en el directorio actual del símbolo del sistema de Windows.
•La opción [/MFXVERSION[:<version>] se puede aplicar si el destino es /COMPILE. Con esta opción se compila un archivo de ejecución de MapForce Server (.mfx) para una versión específica de MapForce Server. Puede introducir cualquiera de las versiones de MapForce Server a partir de la versión 2013r2. Consulte también Compilar asignaciones en archivos de ejecución de MapForce Server.
•La opción /LIBRARY <libname> (...) 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. Consulte también Gestionar bibliotecas de funciones.
|
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, .mfp, 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>