Altova MapForce 2023 Enterprise Edition

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:

JDBC

Transforma todas las conexiones DB en JDBC usando el driver JDBC y la URL definidos en el cuadro de diálogo Configuración delde componentes de BD (véase también Configuración de componentes de BD).

NOXMLSIGNATURES

Elimina la generación de firmas digitales en el archivo de de MapForce Server (observe que las firmas digitales no son compatibles con MapForce Server).

 

/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}]

 

VS2010

Visual Studio 2010

VS2013

Visual Studio 2013

VS2015

Visual Studio 2015

VS2017

Visual Studio 2017

VS2018

Visual Studio 2018

 

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
Este comando también permite usar opciones específicas para generar el código, a saber:

 

/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:

 

VS2010

Visual Studio 2010

VS2013

Visual Studio 2013

VS2015

Visual Studio 2015

VS2017

Visual Studio 2017

VS2019

Visual Studio 2019

 

El segundo grupo de opciones indica la biblioteca XML de destino para el código generado. Valores válidos:

 

MSXML

Genera código para MSXML 6.0

XERCES3

Genera código para Xerces 3

 

El tercer grupo de opciones indica si deben generarse bibliotecas estáticas en vez de dinámicas. Valores válidos:

 

LIB

Genera bibliotecas LIB estáticas

DLL

Genera bibliotecas DLL

 

El cuarto grupo de opciones indica si el código generado debe ser compatible o no con MFC. Valores válidos:

 

MFC

Habilita la compatibilidad con MFC

NoMFC

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 (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>

 

© 2017-2023 Altova GmbH