Altova MapForce 2027 Enterprise Edition

The MapForce command-line interface enables you to automate tasks such as:

•Opening mappings

•Generating mapping code

•Compiling mappings for MapForce Server (Professional and Enterprise editions)

•Generating code for projects (Professional and Enterprise editions)

•Creating log files

•Comparing two mappings

Syntax

The syntax for the command line is as follows:

MapForce.exe <filename> [/{target} [[<outputdir>] [/options]]]

How to run commands

To run commands at the command line, switch to the installation directory of MapForce. For example:

C:\Program Files\Altova\MapForce2027

For more information about each parameter of the command, see Parameters below.

Notation

The following notation is used to indicate command-line syntax:

Parameters

<filename>

Refers to the mapping design (.mfd) or mapping project (.mfp) (Professional and Enterprise editions) from which code is to be generated. To generate code for the whole project, set the target /GENERATE (see /{target} below) and enter the project path as <filename> (e.g., MapForceExamples.mfp).

/{target}

Specifies the target language or environment for which code is to be generated. The table below summarizes the supported code-generation targets.

<outputdir>

Optional parameter that specifies the output directory. If not supplied, the current working directory is used. Relative paths are relative to the current working directory.

With the target set to /GENERATE, the following applies:

•If <outputdir> is not specified, the code generation language and output path defined for each project folder are used (see Project Folders).

•If <outputdir> is specified, it overrides the output directory defined at the root project level, but not the code generation settings defined for individual project folders.

/options

One or more of the following options can be set.

Notes

•Relative paths are relative to the current directory of the application calling MapForce. This applies to the path of the .mfd and .mfp file paths, output directory, log file, and Global Resource file.

•Do not use a trailing backslash before the closing quotation mark at the command line (e.g., "C:\My directory\"). The command line parser interprets the backslash and closing quotation mark as a literal double quotation mark. If a path contains spaces and must be enclosed in quotation marks, use a double backslash before the closing quotation mark (e.g., "c:\My Directory\\").

Examples

1) To start MapForce and open the mapping <filename>.mfd, use the following command:

MapForce.exe <filename>.mfd

2) To generate XSLT 2.0 code and create a log file with the name <logfilename>, use the following command:

MapForce.exe <filename>.mfd /XSLT2 <outputdir> /LOG <logfilename>

3) To generate XSLT 2.0 code taking into account the global resource configuration <grconfigname> from the global resource file <grfilename>, use the following command:

Mapforce.exe <filename>.mfd /XSLT2 <outputdir> /GLOBALRESOURCEFILE <grfilename> /GLOBALRESOURCECONFIG <grconfigname>

Examples for Professional and Enterprise editions

1) To generate a C# application for Visual Studio 2022 and output a log file, use the following command:

MapForce.exe <filename>.mfd /CS:VS2022 <outputdir> /LOG <logfilename>

2) To generate a C++ application using the code generation settings defined in Tools | Options and output a log file, use the following command:

MapForce.exe <filename>.mfd /CPP <outputdir> /LOG <logfilename>

3) To generate a C++ application for Visual Studio 2022, MSXML, with static libraries, MFC support, and no log file, use the following command:

MapForce.exe <filename>.mfd /CPP:VS2022,MSXML,LIB,MFC

4) To generate a C++ application for Visual Studio 2022, Xerces, with dynamic libraries, no MFC support, and a log file, use the following command:

MapForce.exe <filename>.mfd /CPP:VS2022,XERCES,DLL,NoMFC <outputdir> /LOG <logfilename>

5) To generate a Java application and output a log file, use the following command:

MapForce.exe <filename>.mfd /JAVA <outputdir> /LOG <logfilename>

6) To generate code for all mappings in the project, using the language and output directory defined in the folder settings (of each folder inside the project), use the following command:

MapForce.exe <filename>.mfp /GENERATE /LOG <logfilename>

7) To generate Java code for all mappings in the project file, use the following command:

MapForce.exe <filename>.mfp /JAVA /LOG <logfilename>

Note that the code generation language defined in the folder settings are ignored, and Java is used for all mappings.

8) To supply input and output files at the command line for a previously compiled Java mapping, use the following command:

java -jar <mappingfile>.jar /InputFileName <inputfilename> /OutputFileName <outputfilename>

The /InputFileName and /OutputFileName parameters are the names of special input components in the MapForce mapping that allow you to use parameters in command line execution (see Supplying Parameters to the Mapping).

9) To compile a mapping to a MapForce Server execution file for MapForce Server version 2027 and suppress XML signatures, use the following command:

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