Altova MapForce 2027 Professional Edition

Über die MapForce-Befehlszeilenschnittstelle können Sie Aufgaben automatisieren. Dazu gehören:

•Öffnen von Mappings

•Generieren von Mapping-Code

•Kompilieren von Mappings für MapForce Server (Professional und Enterprise Edition)

•Generieren von Code für Projekte (Professional und Enterprise Edition)

•Erstellen von Log-Dateien

•Vergleichen zweier Mappings

Syntax

Die Syntax für die Befehlszeile lautet folgendermaßen:

MapForce.exe <dateiname> [/{ziel} [[<ausgabeverz>] [/optionen]]]

So führen Sie Befehle aus

Um über die Befehlszeile Befehle auszuführen, wechseln Sie in das Installationsverzeichnis von MapForce. Beispiel:

C:\Programme\Altova\ MapForce2027

Nähere Informationen zu den einzelnen Parametern des Befehls finden Sie weiter unten unter Parameter.

Notation

Die Befehlszeilensyntax wird folgendermaßen notiert:

Parameter

<dateiname>

Bezieht sich auf das Mapping-Design (.mfd) oder Mapping-Projekt (.mfp) (Professional und Enterprise Edition), anhand dessen Code generiert werden soll. Um Code für das gesamte Projekt zu generieren, definieren Sie das Ziel für /GENERATE (siehe /{Ziel} unten) und geben Sie den Projektpfad als <dateiname> ein, z.B. MapForceExamples.mfp.

/{ziel}

Definiert die Zielsprache oder Zielumgebung, für die Code generiert werden soll. In der nachstehenden Tabelle finden Sie eine Übersicht über die unterstützten Ziele der Codegenerierung.

<ausgabeverz>

Optionaler Parameter, mit dem das Ausgabeverzeichnis definiert wird. Wenn dieser Parameter nicht angegeben wird, wird das aktuelle Arbeitsverzeichnis verwendet. Relative Pfade sind relativ zum aktuellen Arbeitsverzeichnis.

Wenn als Ziel /GENERATE definiert ist, gilt Folgendes:

•Wenn <ausgabeverz> nicht definiert ist, werden die für die einzelnen Projektordner definierten Codegenerierungssprachen und Ausgabepfade verwendet (siehe Projektordner).

•Wenn <ausgabeverz> definiert ist, setzt dies das auf Root-Projekebene definierte Ausgabeverzeichnis außer Kraft, nicht aber die für einzelne Projektordner definierten Codegenerierungseinstellungen.

/optionen

Sie können eine oder mehrere der folgenden Optionen definieren.

Anmerkungen

•Relative Pfade sind relativ zum aktuellen Verzeichnis der Applikation, die MapForce aufruft. Dies gilt für den Pfad der .mfd-Datei, der .mfp-Datei, das Ausgabeverzeichnis, die Log-Datei und die globale Ressourcendatei.

•Verwenden Sie in der Befehlszeile keinen abschließenden Backslash vor dem schließenden Anführungszeichen (z. B. "C:\Mein Verzeichnis\“). Der Befehlszeilenparser interpretiert den Backslash und das schließende Anführungszeichen als literales doppeltes Anführungszeichen. Wenn ein Pfad Leerzeichen enthält und in doppelte Anführungszeichen gesetzt werden muss, verwenden Sie einen doppelten Backslash vor dem schließenden Anführungszeichen (z.B. "c:\MeinVerzeichnis\\").

Beispiele

1) Um MapForce zu starten, und das Mapping <dateiname>.mfd zu öffnen, verwenden Sie:

MapForce.exe <dateiname>.mfd

2) Um XSLT 2.0-Code zu generieren und auch eine Log-Datei mit dem Namen <logdateiname> zu erstellen, verwenden Sie:

MapForce.exe <dateiname>.mfd /XSLT2 <ausgabeverz> /LOG <logdateiname>

3) Um unter Verwendung der globalen Ressourcenkonfiguration <grkonfigname> aus der globalen Ressourcendatei <grdateiname> XSLT 2.0-Code zu generieren, verwenden Sie:

Mapforce.exe <dateiname>.mfd /XSLT2 <ausgabeverz> /GLOBALRESOURCEFILE <grdateiname> /GLOBALRESOURCECONFIG <grkonfigname>

Beispiele für die Professional und die Enterprise Edition

1) Um eine C#-Applikation für Visual Studio 2022 zu generieren und eine Log-Datei zu erstellen, verwenden Sie:

MapForce.exe <dateiname>.mfd /CS:VS2022 <ausgabeverz> /LOG <logdateiname>

2) Um unter Verwendung der in Extras | Optionen definierten Codegenerierungseinstellungen eine C++-Applikation zu generieren und eine Log-Datei zu erstellen, verwenden Sie:

MapForce.exe <dateiname>.mfd /CPP <ausgabeverz> /LOG <logdateiname>

3) Um eine C++-Applikation für Visual Studio 2022, MSXML, mit statischen Bibliotheken, MFC-Unterstützung und ohne Log-Datei zu generieren, verwenden Sie:

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

4) Um eine C++-Applikation für Visual Studio 2022, Xerces, mit statischen Bibliotheken, keine MFC-Unterstützung und ohne Log-Datei zu generieren, verwenden Sie:

MapForce.exe <dateiname>.mfd /CPP:VS2022,XERCES,DLL,NoMFC <ausgabeverz> /LOG <logdateiname>

5) Um eine Java-Applikation zu generieren und eine Log-Datei zu erstellen, verwenden Sie:

MapForce.exe <dateiname>.mfd /JAVA <ausgabeverz> /LOG <logdateiname>

6) Um unter Verwendung der Sprache und des Ausgabeverzeichnisses, die/das in den Ordnereinstellungen (für die einzelnen Ordner im Projekt) definiert ist, für alle Mappings im Projekt Code zu generieren, verwenden Sie:

MapForce.exe <dateiname>.mfp /GENERATE /LOG <logdateiname>

7) Um für alle Mappings in der Projektdatei Java-Code zu generieren, verwenden Sie:

MapForce.exe <dateiname>.mfp /JAVA /LOG <logdateiname>

Beachten Sie, dass die in den Ordnereinstellungen definierte Codegenerierungssprache ignoriert wird und für alle Mappings Java verwendet wird.

8) Um in der Befehlszeile für ein zuvor kompiliertes Java-Mapping Input- und Output-Dateien anzugeben, verwenden Sie:

java -jar <mappingdatei>.jar /InputFileName <inputdateiname> /OutputFileName <outputdateiname>

Die /InputFileName und /OutputFileName Parameter sind die Namen spezieller Input-Komponenten im MapForce Mapping, die Ihnen gestatten, Parameter in der Befehlszeilenausführung zu verwenden (siehe Bereitstellen von Parametern für das Mapping).

9) Um ein Mapping zu einer MapForce Server-Ausführungsdatei für die MapForce Server Version 2027 zu kompilieren und XML-Signaturen zu unterdrücken, verwenden Sie:

MapForce.exe <dateiname>.mfd /COMPILE:NOXMLSIGNATURES <ausgabeverz> /MFXVERSION:2027 /LOG <logdateiname>