Altova MapForce 2025 Professional Edition

Die allgemeine Syntax eines MapForce-Befehls in der Befehlszeile lautet:

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

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

Notation

Die Befehlszeilensyntax wird folgendermaßen notiert:

Parameter

<dateiname>

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. Es werden die folgenden Codegenerierungsziele unterstützt.

•/XSLT

•/XSLT2

•/XSLT3

•Der Befehl /COMPILE[:compileoptionen]kompiliert ein Mapping zu einer MapForce Server-Ausführungsdatei (.mfx). Sie können auch die folgenden durch ein Komma getrennten Optionen definieren:

oDie Option JDBC transformiert alle Datenbankverbindungen unter Verwendung des JDBC-Treibers und der im Dialogfeld Datenbank-Komponenteneinstellungen definierten Datenbank-URL in JDBC.

oDie Option NOXMLSIGNATURES unterdrückt die Generierung digitaler Signaturen in der MapForce Server-Ausführungsdatei. Beachten Sie, dass digitale Signaturen von MapForce Server nicht unterstützt werden.

•Der Befehl /GENERATE generiert für alle Mappings in der Projektdatei anhand der aktuellen Ordnereinstellungen Projektcode (siehe Verwalten von Projektordnern). Wenn Sie dieses Ziel auswählen, muss unbedingt ein MapForce-Projekt (.mfp) als <dateiname> angegeben werden.

•/XQuery

•/JAVA

•Der Befehl /CS generiert C#-Code. Bei diesem Befehl können optional auch die folgenden Optionen für die Codegenerierung definiert werden:

/CS[:{VS2013|VS2015|VS2017|VS2019|VS2022|DOTNETCORE31|DOTNET50|DOTNET60}]

Wenn keine Visual Studio-Version definiert wird, wird der Code mit der in den Codegenerierungsoptionen definierten Visual Studio-Version generiert.

•Der Befehl /CPP generiert C++-Code. Bei diesem Befehl können optional auch die folgenden Optionen für die Codegenerierung definiert werden:

/CPP[:{VS2013|VS2015|VS2017|VS2019|VS2022|DOTNETCORE31|DOTNET50|DOTNET60},{MSXML|XERCES3},{LIB|DLL},{MFC|NoMFC}]

In der ersten Optionsgruppe wird die Visual Studio-Zielversion definiert (z.B. steht VS2022 für Visual Studio 2022).

In der zweiten Optionsgruppe wird die XML-Bibliothek definiert, für die der Code generiert wird. Die folgenden Werte sind gültig:

oMSXML (generiert Code für MSXML 6.0)

oXERCES3 (generiert Code für Xerces 3)

In der dritten Optionsgruppe wird definiert, ob statische oder dynamische Bibliotheken generiert werden sollen. Gültige Werte:

oLIB (generiert statische LIB-Bibliotheken)

oDLL (generiert DLL-Bibliotheken)

In der vierten Optionsgruppe wird definiert, ob Code mit oder ohne MFC-Unterstützung generiert werden soll. Gültige Werte:

oMFC (aktiviert MFC-Unterstützung)

oNoMFC (deaktiviert die MFC-Unterstützung)

Wenn die Optionen oben nicht definiert sind, wird Code mit der in den Codegenerierungsoptionen definierten Visual Studio Version generiert.

<ausgabeverz>

Optionaler Parameter, mit dem das Ausgabeverzeichnis definiert wird. Wenn kein Ausgabepfad angegeben wird, wird das aktuelle Arbeitsverzeichnis verwendet. Beachten Sie, dass relative Dateipfade relativ zum aktuellen Arbeitsverzeichnis sind.

Wenn das Ziel /GENERATE ist und der Parameter <ausgabeverz> nicht definiert ist, werden die Codegenerierungssprache sowie der Ausgabepfad der einzelnen Mappings den für die einzelnen Ordner im Projekt definierten Einstellungen (siehe Verwalten von Projektordnern) entnommen.

Wenn das Ziel /GENERATE ist und der Parameter <ausgabeverz> definiert ist, hat der in der Befehlszeile angegebene Wert <ausgabeverz> Vorrang vor dem auf Root-Ebene des Projekts definierten Ausgabeverzeichnis. Er hat jedoch keinen Vorrang vor den Codegenerierungseinstellungen, die für die einzelnen Ordner im Projekt definiert sind.

/optionen

Die /optionen schließen einander nicht gegenseitig aus. Sie können eine oder mehrere der folgenden Optionen definieren:

•Die Option /GLOBALRESOURCEFILE <Dateiname> kann verwendet werden, wenn im Mapping zum Auflösen von Input- oder Output-Datei- oder -Ordnerpfaden oder -Datenbanken globale Ressourcen verwendet werden. Nähere Informationen dazu finden Sie unter Globale Altova-Ressourcen. Die Option /GLOBALRESOURCEFILE definiert den Pfad zu einer XML-Datei für globale Ressourcen. Wenn /GLOBALRESOURCEFILE definiert ist, muss auch /GLOBALRESOURCECONFIG definiert sein.

•Mit der Option /GLOBALRESOURCECONFIG <Konfig.> wird der Name der XML-Datei für globale Ressourcen definiert (siehe auch vorhergehende Option). Wenn /GLOBALRESOURCEFILE definiert ist, muss auch /GLOBALRESOURCECONFIG definiert sein.

•Die Option /LOG <logdateiname> generiert eine Log-Datei unter dem angegebenen Pfad. <logdateiname> kann ein absoluter Pfad sein. Wenn ein vollständiger Pfad angegeben wird, muss das Verzeichnis für die zu generierende Log-Datei vorhanden sein. Wenn Sie nur den Dateinamen angeben, wird die Datei in das aktuelle Verzeichnis der Windows-Befehlszeile geschrieben.

•Die Option [/MFXVERSION[:<version>] kann angewendet werden, wenn das Ziel /COMPILE ist. Damit wird die MapForce Server-Ausführungsdatei (.mfx) für eine bestimmte Version von MapForce Server kompiliert. Sie können als Wert jede Version von MapForce Server ab Version 2013r2 angeben. Siehe auch Kompilieren von Mappings für eine spezifische MapForce Server-Version.

•Die Option /LIBRARY <libname> (...) wird zusammen mit einer Codegenerierungszielsprache verwendet, um zusätzliche Funktionsbibliotheken zu definieren. Diese Option kann mehrmals definiert werden, um damit mehrere Bibliotheken zu laden. Siehe Verwalten von Funktionsbibliotheken.

Anmerkungen

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

•Verwenden Sie in der Befehlszeile am Ende nicht den umgekehrten Schrägstrich und das schließende Anführungszeichen (z.B., "C:\My directory\"). Diese beiden Zeichen werden vom Befehlszeilenparser als Literalzeichen, d.h. als doppeltes Anführungszeichen interpretiert. Es wird empfohlen keine Leerzeichen und Anführungszeichen zu verwenden. Verwenden Sie den doppelten umgekehrten Schrägstrich \\, wenn in der Befehlszeile Leerzeichen vorkommen und Sie die Anführungszeichen ("c:\Mein Verzeichnis\\") benötigen.

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 2025 zu kompilieren und XML-Signaturen zu unterdrücken, verwenden Sie:

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