Altova MapForce 2027 Professional Edition

La interfaz de la línea de comandos de MapForce permite automatizar tareas como:

•Abrir asignaciones de datos

•Generar código de asignación de datos

•Compilar asignaciones para MapForce Server (ediciones Professional y Enterprise)

•Generar código para proyectos (ediciones Professional y Enterprise)

•Crear archivos de registro

•Comparar dos asignaciones de datos

Sintaxis

La sintaxis para la línea de comandos es la siguiente:

MapForce.exe <nombreArchivo> [/{destino} [[<directorioSalida>] [/opciones]]]

Cómo ejecutar comandos

Para ejecutar comandos en la línea de comandos, acceda al directorio de instalación de MapForce. Por ejemplo:

C:\Archivos de programa\Altova\MapForce2027

Para más información sobre cada parámetro del comando, consulte la lista Parámetros más abajo.

Notación

Para indicar la sintaxis de la línea de comandos se usa la siguiente notación:

Parámetros

<nombreArchivo>

Se refiere al 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 /{destino} a continuación) e introduzca la ruta del proyecto en el campo <nombreArchivo> (p.ej., MapForceExamples.mfp).

/{destino}

Indica el lenguaje o entorno de destino para el que se genera el código. En la tabla siguiente se resumen los destinos de generación de código compatibles.

<directorioSalida>

Parámetro opcional que indica el directorio de salida. Si no se indica, se usa el directorio de trabajo actual. Las rutas de acceso relativas son relativas al directorio de trabajo actual.

Cuando el objetivo está establecido en /GENERATE, se aplica lo siguiente:

•Si no se especifica <directorioSalida>, se utilizan el lenguaje de generación de código y la ruta de salida definidos para cada carpeta de proyecto (véase Carpetas de proyecto).

•Si se especifica <directorioSalida>, este anula el directorio de salida definido en el nivel raíz del proyecto, pero no la configuración de generación de código definida para las carpetas de cada proyecto.

/opciones

Se pueden indicar una o más de las siguientes opciones.

Notas

•Las rutas relativas son relativas al directorio actual de la aplicación que invoca a MapForce. Esto se aplica a las rutas de acceso de los archivos .mfd y .mfp, al directorio de salida, al archivo de registro y al archivo de recursos globales.

•No utilice una barra diagonal inversa al final antes de la comilla de cierre en la línea de comandos (por ejemplo, "C:\Mi directorio\"). El analizador de la línea de comandos interpreta la barra diagonal inversa y la comilla de cierre como una comilla doble literal. Si una ruta contiene espacios y debe ir entre comillas, utilice una barra diagonal inversa doble antes de la comilla de cierre (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 2027 y eliminar las firmas XML, use este comando:

MapForce.exe <filename>.mfd /COMPILE:NOXMLSIGNATURES <outputdir> /MFXVERSION:2027 /LOG <logfilename>