Altova MapForce Server 2020 Advanced Edition · 2020-03-17 · 4 Altova MapForce Server 2020 Advanced Edition 4.3 help ..... 42 4.4 lic en s.....r.v..... 43

Altova MapForce Server 2020 Advanced Edition

Benutzer- und Referenzhandbuch

All rights reserved. No parts of this work may be reproduced in any form or by anymeans - graphic, electronic, or mechanical, including photocopying, recording, taping, orinformation storage and retrieval systems - without the written permission of thepublisher.

Products that are referred to in this document may be either trademarks and/orregistered trademarks of the respective owners. The publisher and the author make noclaim to these trademarks.

While every precaution has been taken in the preparation of this document, thepublisher and the author assume no responsibility for errors or omissions, or fordamages resulting from the use of information contained in this document or from theuse of programs and source code that may accompany it. In no event shall the publisherand the author be liable for any loss of profit or any other commercial damage caused oralleged to have been caused directly or indirectly by this document.

Published: 2020

© 2020 Altova GmbH

Altova MapForce Server 2020 Advanced EditionBenutzer- und Referenzhandbuch

3Altova MapForce Server 2020 Advanced Edition

Inhaltsverzeichnis

1 Einführung 6

2 Installation 7

.......................................................................................................................................................... 72.1 Systemanforderungen

.......................................................................................................................................................... 82.2 Prozessorkerne und Lizenzen

.......................................................................................................................................................... 92.3 Wichtige Pfade

.......................................................................................................................................................... 102.4 Linux

...................................................................................................................................... 102.4.1 Installation von MapForce Server

...................................................................................................................................... 112.4.2 Anzeige der derzeit installierten Produkte

...................................................................................................................................... 112.4.3 Deinstallation von MapForce Server

.......................................................................................................................................................... 132.5 macOS



.......................................................................................................................................................... 152.6 Windows



3 Ausführen von Mappings 17

.......................................................................................................................................................... 203.1 Vorbereiten von Mappings für die Server-Ausführung

.......................................................................................................................................................... 263.2 Globale Ressourcen

.......................................................................................................................................................... 283.3 Join-Optimierung

.......................................................................................................................................................... 313.4 Anmeldeinformationen

.......................................................................................................................................................... 343.5 Dynamische Authentifizierung

4 MapForce Server-Befehlszeile 35

.......................................................................................................................................................... 384.1 assignlicense (nur Windows)

.......................................................................................................................................................... 404.2 exportresourcestrings

Altova MapForce Server 2020 Advanced Edition4

.......................................................................................................................................................... 424.3 help

.......................................................................................................................................................... 434.4 licenseserver

.......................................................................................................................................................... 454.5 run

.......................................................................................................................................................... 494.6 setdeflang

.......................................................................................................................................................... 504.7 verifylicense (nur Windows)

.......................................................................................................................................................... 524.8 version

5 MapForce Server API 53

.......................................................................................................................................................... 545.1 .NET-Schnittstelle

...................................................................................................................................... 555.1.1 C#-Beispiel

...................................................................................................................................... 585.1.2 Visual Basic .NET-Beispiel

.......................................................................................................................................................... 615.2 COM-Schnittstelle

...................................................................................................................................... 615.2.1 C++-Beispiel

...................................................................................................................................... 645.2.2 VBScript-Beispiel

...................................................................................................................................... 675.2.3 VBA-Beispiel

.......................................................................................................................................................... 705.3 Java-Schnittstelle

...................................................................................................................................... 725.3.1 Java-Beispiel

.......................................................................................................................................................... 755.4 Beispiel: Ausführen eines Mappings mit Parametern

.......................................................................................................................................................... 815.5 API Reference (COM, .NET)

...................................................................................................................................... 815.5.1 Schnittstellen

.......................................................................................................................................................... 905.6 API Reference (Java)

...................................................................................................................................... 905.6.1 Klassen

6 Verwaltung digitaler Zertifikate 100

.......................................................................................................................................................... 1036.1 Definieren vertrauenswürdiger Zertifikate unter Linux

.......................................................................................................................................................... 1056.2 Definieren vertrauenswürdiger Zertifkate auf macOS-Systemen

.......................................................................................................................................................... 1066.3 Definieren vertrauenswürdiger Zertifikate unter Windows

.......................................................................................................................................................... 1076.4 Aufrufen der Zertifikatspeicher unter Windows

.......................................................................................................................................................... 1106.5 Exportieren von Zertifikaten aus Windows

.......................................................................................................................................................... 1166.6 Client-Zertifikate unter Linux

.......................................................................................................................................................... 1186.7 Client-Zertifikate auf macOS

.......................................................................................................................................................... 1206.8 Client-Zertifikate unter Windows

5Altova MapForce Server 2020 Advanced Edition

Index 122

6 Einführung

© 2020 Altova GmbHAltova MapForce Server 2020 Advanced Edition

1 Einführung

MapForce Server ist eine Software-Lösung für Unternehmen zur Ausführung von Datenmappingtransformationenauf Windows-, Linux- und macOS-Betriebssystemen. Die Datenmappings (oder Mapping-Design-Dateien,*.mfd) selbst werden auf grafischem Weg mit Altova MapForce (https://www.altova.com/de/mapforce.html)erstellt. Mit Altova MapForce werden die Inputs, Outputs sowie etwaige Zwischenverarbeitungsschritte für IhreDaten definiert. Mit MapForce Server werden mit MapForce kompilierte MapForce Server-Ausführungsdateien(.mfx-Dateien) ausgeführt und je nach zugrunde liegendem Mapping Ausgabedateien oder Daten erzeugt odersogar Datenbankaktualisierungen durchgeführt oder Webservices aufgerufen.

MapForce Server kann als eigenständiges Programm oder unter Verwaltung von Altova FlowForce Server(https://www.altova.com/de/flowforce.html) ausgeführt werden. Wenn FlowForce Server auf demselben Rechnerwie MapForce Server installiert ist, automatisiert FlowForce Server die Ausführung von Mappings über geplanteoder Trigger-basierte Aufträge, die auch als Webservices bereitgestellt werden können. Zusätzlich dazu enthältFlowForce Server eine Bibliothek von vordefinierten Funktionen, mit denen vor oder nach der Mapping-Ausführung weitere automatisierte Aktionen wie z.B. das Senden von E-Mails, das Kopieren von Dateien undVerzeichnissen, das Hochladen von Dateien auf FTP, die Ausführung von Shell-Befehlen und andere Aktionendurchgeführt werden können.

Funktionalitäten· Ausführung von Datenmappings auf Hochleistungsservern· Plattformübergreifender Einsatz: MapForce Server kann auf Windows-, Linux- oder macOS-

Betriebssystemen ausgeführt werden· Befehlszeilenschnittstelle· eine API, die von C++-, C#-, Java-, VB.NET-, VBScript- oder VBA-Code aus aufgerufen werden kann· Native Integration mit FlowForce Server.· Unterstützung für globale Altova Ressourcen. Dadurch können Datei-, Ordner- und

Datenbankreferenzen konfigurierbar und für mehrere Umgebungen und Altova-Applikationen portierbargemacht werden, siehe globale Altova Ressourcen

· Beschleunigte Ausführung von Mappings, wobei eine Join-Optimierung unterstützt wird (siehe Join-Optimierung ).

· Ausführung von Mappings, in denen Funktionen und Standardwerte auf mehrere Datenelementegleichzeitig angewendet werden. Mit solchen Mappings können z.B. alle gefundenen Nullwerte einfachdurch leere Strings oder benutzerdefinierten Text ersetzt werden.

· Ausführung von Mappings, bei denen Daten aus Protocol Buffers-Binärdateien ausgelesen und in diesegeschrieben werden.

· Ausführung von Mappings, die Datenbank-Bulk-Einfügungen durchführen.

Einschränkungen· digitale XML-Signaturen werden nicht unterstützt· ADO-, ADO.NET- und ODBC-Datenbankverbindungen werden nur von Windows unterstützt. Unter

Linux und macOS stehen native Datenbankverbindungen für SQLite und PostgreSQL zur Verfügung.Für andere unter Linux oder macOS ausgeführte Datenbanken sollte JDBC verwendet werden.

Letzte Aktualisierung: 11.03.2020

26

28

https://www.altova.com/de/mapforce.html

https://www.altova.com/de/flowforce.html

© 2020 Altova GmbH

Systemanforderungen 7Installation


2 Installation

2.1 Systemanforderungen

Windows

Windows 7 SP1 mit Plattformupdate, Windows 8, Windows 10

Windows Server

Windows Server 2008 R2 SP1 mit Plattformupdate oder höher

MapForce Server steht unter Windows sowohl als 32-Bit- als auch als 64-Bit-Paket zur Verfügung.

Linux

· CentOS 6 oder neuer· RedHat 6 oder neuer· Debian 8 oder neuer· Ubuntu 16.04 LTS oder neuer

Um die Applikation installieren und ausführen zu können, werden die folgenden Bibliotheken benötigt.Falls die unten angeführten Pakete auf Ihrem Linux-Rechner noch nicht zur Verfügung stehen, führen Siedie Befehl yum (oder ggf. apt-get) aus, um sie zu installieren.

Erforderlich für CentOS, RedHat Debian Ubuntu

LicenseServer krb5-libs libgssapi-krb5-2 libgssapi-krb5-2

MapForce ServerAdvanced Edition

libidn, krb5-libs libidn11, libgssapi-krb5-2 libidn11, libgssapi-krb5-2

macOS

macOS 10.13 oder neuer

Anmerkung: Auf Windows und macOS können mehrere Versionen von MapForce Server auf demselbenRechner installiert werden. Wir machen Sie darauf aufmerksam, dass in solchen Fällen immer nur eineVersion auf demselben Altova LicenseServer registriert werden kann. Daher können nicht gleichzeitigzwei verschiedene Versionen von MapForce Server auf demselben Rechner ausgeführt werden. Eskönnen jedoch mehrere Instanzen derselben Produktversion parallel ausgeführt werden. NähereInformationen dazu finden Sie in der Dokumentation zu Altova LicenseServer(https://www.altova.com/de/documentation#licenseserver).

https://www.altova.com/de/documentation#licenseserver

8 Installation Prozessorkerne und Lizenzen


2.2 Prozessorkerne und Lizenzen

Die Lizenzierung von Altova Server-Produkten basiert auf der Anzahl der auf dem Produktrechner verfügbarenphysischen Prozessorkerne. So hat z.B. ein Dual-Core-Prozessor zwei Prozessorkerne, ein Quad-Core-Prozessor hat vier Kerne, ein Hexa-Core-Prozessor hat sechs Kerne, usw. Die Anzahl der für ein Produktlizenzierten Kerne muss größer oder gleich der Anzahl der auf diesem Serverrechner verfügbaren Kerne sein,unabhängig davon, ob es sich um einen physischen Rechner oder eine Virtual Machine handelt. Wenn einServer z.B. acht Kerne hat, müssen Sie eine Lizenz für acht Kerne erwerben. Sie können Lizenzen auchkombinieren, um das Produkt für die entsprechende Anzahl von Kernen zu lizenzieren. So können z.B. anstelleeiner Lizenz für 8 Kerne auch zwei Lizenzen für 4 Kerne für einen 8-Kern-Prozessor verwendet werden.

Wenn Sie einen Rechnerserver mit einer großen Anzahl von CPU-Kernen verwenden, aber nur geringeDatenmengen verarbeiten müssen, können Sie auch eine Virtual Machine erstellen, der eine geringere Anzahlan Kernen zugewiesen ist und eine Lizenz für diese Anzahl an Kernen erwerben. In diesem Fall ist dieVerarbeitungsgeschwindigkeit natürlich geringer als bei Verwendung aller Kerne des Rechners.

Anmerkung: Jede Altova Server-Produktlizenz kann immer nur für einen Client-Rechner gleichzeitigverwendet werden, selbst wenn die Lizenzkapazität dieser Lizenz noch nicht ausgeschöpft ist. Wennz.B. eine 10-Kern-Lizenz für einen Client-Rechner mit 6 CPU-Kernen verwendet wird, so können dieverbleibenden Lizenzen für die restlichen 4 Kerne nicht gleichzeitig für einen anderen Client-Rechnerverwendet werden.

Single-Thread-AusführungWenn bei einem Altova-Server-Produkt eine Single-Thread-Ausführung möglich ist, so steht eine Option für dieSingle-Thread-Ausführung zur Verfügung. Wenn in solchen Fällen im Lizenzpool eine AltovaServerproduktlizenz für nur einen Prozessorkern verfügbar ist, können Sie einem Rechner mit mehreren Kernendiese Lizenz für einen Kern zuweisen. In diesem Fall führt der Rechner das Produkt an einem einzigen Kernaus. Dadurch verlangsamt sich die Verarbeitungsgeschwindigkeit, da kein Multi-Threading (welches beimehreren Prozessorkernen möglich wäre) zur Verfügung steht. Das Produkt wird auf diesem Rechner im SingleThread-Modus ausgeführt.

Um einem Mehrkernrechner eine Lizenz für nur einen Kern zuzuweisen, aktivieren Sie in LicenseServer für dasentsprechende Produkt das Kontrollkästchen Limit to single thread execution.

Schätzung der benötigten ProzessorkerneEs gibt eine Reihe von externen Faktoren, die das Verarbeitungsvolumen und die Verarbeitungszeiten IhresServers beeinflussen (z.B. Hardware, CPU-Auslastung, Arbeitsspeicher für andere auf dem Server laufendeApplikationen). Um die Leistung möglichst genau messen zu können, empfiehlt es sich, die Applikationen inIhrer Umgebung mit möglichst realistischen Datenvolumina und unter möglichst realistischen Bedingungen zutesten.

© 2020 Altova GmbH

Wichtige Pfade 9Installation


2.3 Wichtige Pfade

InstallationsverzeichnisDie Applikation wird im folgenden Verzeichnis installiert:

Linux /opt/Altova/MapForceServer2020/bin

Mac /usr/local/Altova/MapForceServer2020/bin

Windows <ProgramFilesFolder>\Altova\MapForceServer2020\bin

Ausführbare DateiDie ausführbare MapForce Server-Datei befindet sich nach der Installation unter dem folgenden Pfad:

Linux /opt/Altova/MapForceServer2020/bin/mapforceserver

Mac /usr/local/Altova/MapForceServer2020/bin/mapforceserver

Windows <ProgramFilesFolder>\Altova\MapForceServer2020\bin\MapForceServer.exe

Konfigurationsdaten zur ApplikationDie Konfigurationsdaten der Applikation sind im folgenden Verzeichnis gespeichert:

Linux /var/opt/Altova/MapForceServer

Mac /var/Altova/MapForceServer

Windows C:\ProgramData\Altova\MapForceServer

10 Installation Linux


2.4 Linux

2.4.1 Installation von MapForce Server

SystemanforderungenLinux

· CentOS 6 oder neuer· RedHat 6 oder neuer· Debian 8 oder neuer· Ubuntu 16.04 LTS oder neuer

Um die Applikation installieren und ausführen zu können, werden die folgenden Bibliotheken benötigt.Falls die unten angeführten Pakete auf Ihrem Linux-Rechner noch nicht zur Verfügung stehen, führen Siedie Befehl yum (oder ggf. apt-get) aus, um sie zu installieren.

Erforderlich für CentOS, RedHat Debian Ubuntu

LicenseServer krb5-libs libgssapi-krb5-2 libgssapi-krb5-2

MapForce ServerAdvanced Edition

libidn, krb5-libs libidn11, libgssapi-krb5-2 libidn11, libgssapi-krb5-2

Voraussetzungen1. Führen Sie die Installation entweder als root-Benutzer durch oder als Benutzer mit sudo-Rechten.2. Die vorherige Version von MapForce Server muss deinstalliert werden, bevor Sie eine neue Version

installieren.

Installation von MapForce Server1. Laden Sie das Installationspaket von https://www.altova.com/de/download#server in ein lokales

Verzeichnis herunter.2. Wechseln Sie in das Verzeichnis, in das Sie das Installationspaket heruntergeladen haben, z.B.:

cd /home/User/Downloads

3. Installieren Sie das MapForce Server-Paket.

[Debian, Ubuntu] sudo dpkg --install mapforceserver-2020-debian.deb[CentOS, RedHat] sudo rpm -ivh mapforceserver-2020-1.x86_64.rpm

Anmerkung: Sie müssen den Namen des obigen Pakets eventuell anpassen, damit er der aktuellenRelease- oder Service Pack-Version entspricht.

https://www.altova.com/download#server

© 2020 Altova GmbH

Linux 11Installation


Lizenzierung von MapForce Server1. Stellen Sie sicher, dass die neueste Version von Altova LicenseServer

(https://www.altova.com/de/licenseserver) installiert ist und entweder auf dem lokalen Rechner oder imNetzwerk ausgeführt wird.

2. Registrieren Sie MapForce Server auf Altova LicenseServer. Dazu benötigen Sie entweder den Host-Namen oder die IP-Adresse des Rechners, auf dem LicenseServer ausgeführt wird. WennLicenseServer z.B auf 127.0.0.1 läuft, können Sie Ihr Produkt folgendermaßen registrieren:

sudo ./mapforceserver licenseserver 127.0.0.1

Anmerkung: Beim obigen Befehl wird davon ausgegangen, dass Sie die ausführbare Datei vomProgramminstallationsverzeichnis aus aufrufen, siehe auch Wichtige Pfade .

3. Melden Sie sich auf der Verwaltungsoberfläche von LicenseServer an und weisen Sie die Lizenz demRechner zu, auf dem MapForce Server ausgeführt wird.

Nähere Informationen dazu finden Sie in der Dokumentation zu Altova LicenseServer(https://www.altova.com/de/documentation).

2.4.2 Anzeige der derzeit installierten Produkte

So überprüfen Sie, ob ein Altova Server-Produkt aktuell installiert ist

· Führen Sie den folgenden Befehl aus:

[Debian, Ubuntu] dpkg --list | grep Altova[CentOS, RedHat] rpm -qa | grep server

2.4.3 Deinstallation von MapForce Server

So deinstallieren Sie MapForce Server:

· Führen Sie den folgenden Befehl aus:

[Debian, Ubuntu] sudo dpkg --remove mapforceserver[CentOS, RedHat] sudo rpm -e mapforceserver

Um andere Pakete zu deinstallieren, verwenden Sie denselben Befehl wie oben und stellen Sie das zuentfernende Paket als Argument bereit. z.B.:

[Debian, Ubuntu] sudo dpkg --remove licenseserver

9

https://www.altova.com/de/licenseserver

https://www.altova.com/de/documentation

12 Installation Linux


[CentOS, RedHat] sudo rpm -e licenseserver

© 2020 Altova GmbH

macOS 13Installation


2.5 macOS


SystemanforderungenmacOS

macOS 10.13 oder neuer

Voraussetzungen· Führen Sie die Installation als Benutzer mit Admin-Rechten (Root)-Berechtigung durch.

FlowForce Server-IntegrationSie können MapForce Server entweder als Standalone-Produkt oder im Rahmen einer FlowForce Server-Installation installieren. Um MapForce Server unter Verwaltung von FlowForce Server zu installieren, aktivierenSie die entsprechende Option im FlowForce-Installationsassistenten. Das FlowForce Server-Installationsprogramm enthält das MapForce Server-Installationsprogramm und das FlowForce Server AdvancedEdition-Installationsprogramm enthält das MapForce Server Advanced Edition-Installationsprogramm. Sowohldas FlowForce Server- als auch das MapForce Server-Installationsprogramm kann vom Altova Download Center(https://www.altova.com/de/download) heruntergeladen werden.

Wenn Sie MapForce Server zusammen mit FlowForce Server installieren, sollten Sie zuerst FlowForceServer installieren. Beachten Sie andernfalls die "Aufgaben nach der Installation" weiter unten.

Installation von MapForce Server1. Laden Sie die .dmg (Disk Image)-Datei von der Altova Website

(https://www.altova.com/de/download.html) in ein lokales Verzeichnis herunter und klicken Sie darauf,um sie zu öffnen. Dadurch wird der Installer als neues Laufwerk auf Ihrem Computer angezeigt.

2. Doppelklicken Sie auf die Paketdatei (.pkg) und befolgen Sie die Anweisungen desInstallationsassistenten, in dem Sie auch die Lizenzvereinbarung akzeptieren müssen, bevor Sie mitder Installation fortfahren können. Nach Fertigstellung des Assistenten steht das MapForce Server-Symbol in den Applikationen zur Verfügung. Das Paket wird im folgenden Ordnerinstalliert: /usr/local/Altova/MapForceServer2020/ .

3. Wenn Sie Altova License Server noch nicht installiert haben, oder ihn auf die neueste Versionaktualisieren möchten, doppelklicken Sie auf die entsprechende Paketdatei (.pkg) und befolgen Sie dieAnweisungen auf dem Bildschirm.



2. Registrieren Sie MapForce Server auf Altova LicenseServer. Dazu benötigen Sie entweder den Host-Namen oder die IP-Adresse des Rechners, auf dem LicenseServer ausgeführt wird. Wenn

https://www.altova.com/de/download

https://www.altova.com/de/download.html)


14 Installation macOS


LicenseServer z.B auf 127.0.0.1 läuft, können Sie Ihr Produkt folgendermaßen registrieren:

sudo mapforceserver licenseserver 127.0.0.1



Aufgaben nach der InstallationWenn Sie MapForce Server vor FlowForce Server installiert haben, führen Sie im Anschluss an die Installationvon MapForce Server und FlowForce Server den folgenden Befehl aus:

cp /usr/local/Altova/MapForceServer2019/etc/*.tool /usr/local/Altova/FlowForceServer2019/tools

Dieser Befehl kopiert die .tool-Datei aus dem Verzeichnis /etc von MapForce Server in das FlowForceServer /tools-Verzeichnis. Die Datei .tool wird von FlowForce Server benötigt; sie enthält den Pfad zurausführbaren MapForce Server-Datei. Sie müssen diesen Befehl nicht ausführen, wenn Sie FlowForce Servervor MapForce Server installieren.


So deinstallieren Sie MapForce Server:

1. Klicken Sie unter Applikationen mit der rechten Maustaste auf das MapForce Server-Symbol wählenSie den Befehl Move to Trash. Beachten Sie, dass Ihr MapForce Server-Installationsverzeichnis unddie Konfigurationsdaten dadurch nicht entfernt werden.

2. Wenn Sie auch das MapForce Server-Installationsverzeichnis entfernen möchten, führen Sie denfolgenden Befehl aus:

sudo rm -rf /usr/local/Altova/MapForceServer2020/

Anmerkung: Mit den obigen Schritten werden die Konfigurationsdaten nichtaus /var/Altova/MapForceServer2020 entfernt. Einmal entfernte Konfigurationsdaten können späternicht mehr wiederhergestellt werden.


© 2020 Altova GmbH

Windows 15Installation


2.6 Windows


Systemanforderungen· Windows 7 SP1 mit Plattformupdate, Windows 8, Windows 10· Windows Server 2008 R2 SP1 mit Plattformupdate oder höher

Voraussetzungen· Führen Sie die Installation als Benutzer mit Admin-Rechten durch.

Installation von MapForce ServerSie können MapForce Server entweder als Standalone-Produkt oder im Rahmen einer FlowForce Server-Installation installieren. Um MapForce Server unter Verwaltung von FlowForce Server zu installieren, aktivierenSie die entsprechende Option im FlowForce-Installationsassistenten. Das FlowForce Server-Installationsprogramm enthält das MapForce Server-Installationsprogramm und das FlowForce Server AdvancedEdition-Installationsprogramm enthält das MapForce Server Advanced Edition-Installationsprogramm. Sowohldas FlowForce Server- als auch das MapForce Server-Installationsprogramm kann vom Altova Download Center(https://www.altova.com/de/download) heruntergeladen werden.

So installieren Sie MapForce Server als Standalone-Produkt:

1. Laden Sie die Installationsdatei vom Altova Download Center (https://www.altova.com/de/download)herunter und führen Sie sie aus.

2. Wählen Sie optional die Installationssprache aus dem Feld links unten im Assistenten aus und klickenSie auf Weiter. Sie können die Sprache später über die Befehlszeile ändern.

3. Wählen Sie eine der folgenden Methoden:

a. Wenn Sie Altova LicenseServer noch nicht installiert haben, belassen Sie dieStandardeinstellungen unverändert. Der Assistent installiert daraufhin auf dem Rechner, auf demSie den Assistenten gestartet haben, die neueste Version von Altova LicenseServer.

b. Wenn Sie Altova LicenseServer noch nicht installiert haben und Altova LicenseServer auf einemanderen Rechner installieren möchten, deaktivieren Sie die Option Altova LicenseServer aufdiesem Rechner installieren und wählen Sie anschließend Später registrieren. In diesem Fallmüssen Sie Altova LicenseServer separat installieren und MapForce Server später registrieren.

c. Wenn Altova LicenseServer auf Ihrem Rechner bereits installiert wurde, aber eine niedrigereVersionsnummer als die im Installationsassistenten angegebene hat, belassen Sie dieStandardeinstellungen unverändert. In diesem Fall aktualisiert der Installationsassistent IhreLicenseServer Version automatisch auf die im Dialogfeld angegebene. Beachten Sie, dass dievorhandene Registrierung und die vorhandenen Lizenzierungsdaten nach dem Upgrade erhaltenbleiben.

d. Wenn Altova LicenseServer bereits auf Ihrem Rechner oder in Ihrem Netzwerk installiert wurde unddieselbe Versionsnummer wie diejenige im Assistenten hat, gehen Sie folgendermaßen vor:i. Deaktivieren Sie das Kontrollkästchen Altova LicenseServer auf diesem Rechner

installieren.ii. Wählen Sie unter Dieses Produkt registrieren auf die Altova LicenseServer-Instanz, auf der

Sie MapForce Server registrieren möchten oder wählen Sie Später registrieren. BeachtenSie, dass Sie immer die Möglichkeit haben, Später registrieren auszuwählen, wenn Sie die



16 Installation Windows


LicenseServer-Verknüpfungen ignorieren möchten und mit der Installation von MapForce Serverfortfahren möchten.

4. Klicken Sie auf Weiter.5. Befolgen Sie die Anweisungen des Assistenten, um die Installation abzuschließen.



2. Registrieren Sie MapForce Server auf Altova LicenseServer, falls Sie das noch nicht bei der Installationgetan haben. Dazu benötigen Sie entweder den Host-Namen oder die IP-Adresse des Rechners, aufdem LicenseServer ausgeführt wird. Wenn LicenseServer z.B auf 127.0.0.1 läuft, können Sie IhrProdukt folgendermaßen registrieren:

MapForceServer.exe licenseserver 127.0.0.1




Deinstallieren von MapForce Server

1. Klicken Sie mit der rechten Maustaste auf die Windows-Schaltfläche "Start" und wählen SieEinstellungen.

2. Öffnen Sie die Systemsteuerung (Geben Sie die ersten Buchstaben davon ein und klicken Sie auf denVorschlag).

3. Klicken Sie unter Programme auf Programm deinstallieren.4. Wählen Sie in der Systemsteuerung "Altova MapForce Server" aus und klicken Sie auf

Deinstallieren.



© 2020 Altova GmbH

17Ausführen von Mappings


3 Ausführen von Mappings

Die Aufgabe von MapForce Server ist es, mit Altova MapForce (https://www.altova.com/de/mapforce.html)erstellte Datenmappings auszuführen.

Zuerst müssen die Datenmappings (oder Mapping-Design-Dateien, *.mfd) mit grafischen Mitteln in MapForceerstellt werden. In MapForce werden die Inputs, Outputs und Zwischenverarbeitungsschritte für Ihre Daten (wieSortieren, Filtern, benutzerdefinierte Funktionen und andere) erstellt. Sobald Ihr Mapping fertig ist, können Siees auf eine der folgenden Arten mit MapForce Server ausführen:

· Kompilieren Sie das Mapping auf dem Windows-Rechner, auf dem MapForce ausgeführt wird, zu einerMapForce Server-Ausführungsdatei (.mfx). Bei den .mfx-Dateien handelt es sich um Datenmappings,die in ein Paket für die Ausführung in einer Serverumgebung verpackt wurden. Sie können solcheDateien auf jedes der unterstützen Betriebssysteme, auf denen MapForce Server ausgeführt wird (auchauf andere Plattformen, siehe Systemanforderungen ) kopieren. Auf dem Server können Sie die.mfx-Datei über die Befehlszeile von MapForce Server oder über die MapForce Server API ausführen.

· Stellen Sie das Mapping von dem Windows-Rechner, auf dem MapForce ausgeführt wird, auf einemServer-Rechner, auf dem sowohl MapForce Server als auch FlowForce Server installiert sind, bereit.Beim Server-Rechner kann es sich auch um ein anderes Betriebssystem handeln (sieheSystemanforderungen ). Mappings, die auf diese Art bereitgestellt wurden, werden zu FlowForce-Funktionen, für die Sie geplante oder Trigger-basierte Aufträge erstellen können. Wenn Mappings alsFlowForce Server-Aufträge ausgeführt werden, können Sie auch als Webservices, als anderenAufträgen untergeordnete Schritte, als Teile von Workflows, die auch das Senden von E-Mails, dasÜberprüfen von Exit-Codes, das Ausführen von Shell-Befehlen usw. umfassen, definiert werden.

7

7

https://www.altova.com/de/mapforce.html

18 Ausführen von Mappings


Nähere Informationen zu diesem Szenario finden Sie in der FlowForce Server-Dokumentation(https://www.altova.com/de/documentation).

So führen Sie als MapForce Server-Ausführungsdatei kompilierte Mappings aus1. Starten Sie die MapForce Enterprise oder Professional Edition.2. Öffnen Sie das zu kompilierende Mapping.3. Klicken Sie im Menü Datei auf den Befehl Zu MapForce Server-Ausführungsdatei kompilieren und

wählen Sie ein Zielverzeichnis aus.4. Kopieren Sie die .mfx-Datei zusammen mit allen Input-Dateien oder Abhängigkeiten in das

Zielverzeichnis bzw. auf den gewünschten Server. Nähere Informationen dazu finden Sie unterVorbereiten von Mappings für die Server-Ausführung .

5. Rufen Sie den Befehl "run" der Befehlszeilenschnittstelle oder die entsprechende Methode derMapForce Server API (siehe MapForce Server API ) auf.

So führen Sie auf FlowForce Server bereitgestellte Mappings aus1. Öffnen Sie das gewünschte Mapping in MapForce Enterprise oder Professional.2. Stellen Sie sicher, dass als Transformationssprache (Ausführungsprozessor) des Mappings Built-in

ausgewählt ist. Um den Ausführungsprozessor in Built-in zu ändern, wählen Sie den MenübefehlAusgabe | Built-In Ausführungsprozessor oder klicken Sie auf die Symbolleisten-Schaltfläche Built-

In Ausführungsprozessor auswählen ( ).3. Klicken Sie im Menü Datei auf Auf FlowForce Server bereitstellen.4. Geben Sie die Serververbindungsinformationen (Host, Port), die FlowForce-Anmeldeinformationen und

den FlowForce-Ziel-Container ein. Damit der FlowForce-Auftrag sofort im Browser erstellt wird,aktivieren Sie die Option Web Browser zur Erstellung eines neuen Auftrags öffnen. Sie könnenden FlowForce-Auftrag auch zu einem späteren Zeitpunkt erstellen (siehe nächster Schritt).

5. Öffnen Sie einen Browser, melden Sie sich auf der FlowForce Server Web-Verwaltungsschnittstelle anund navigieren Sie zu dem Container, in dem Sie das Mapping bereitgestellt haben (siehe vorherigerSchritt). Dieser Schritt fällt weg, wenn Sie die Option Web Browser zur Erstellung eines neuenAuftrags öffnen im vorigen Schritt aktiviert haben.

6. Definieren Sie den FlowForce Server-Auftrag mit seinen Triggern, Parametern oder zusätzlichenAusführungsschritten (als Beispiel siehehttps://www.altova.com/manual/de/FlowForceServer/fs_example_mapforce_mapping.htm). Wenn derAuftrag laut Konfiguration gestartet wird, wird das zugrunde liegende Mapping ausgeführt und dieMapping-Ausgabe erzeugt.

20

35

53


https://www.altova.com/manual/de/FlowForceServer/fs_example_mapforce_mapping.htm

© 2020 Altova GmbH

19Ausführen von Mappings


Anmerkung: Wenn MapForce Server auf einem anderen Rechner als dem, auf dem das Mapping erstelltwurde, ausgeführt wird, müssen Sie die Pfade zu den Input-Dateien oder dieDatenbankverbindungsinformationen so definieren, dass sie in der neuen Ausführungsumgebungfunktionieren. Wenn z.B. eine Datenbank in einem Mapping aufgerufen wird und dafür einDatenbanktreiber benötigt wird, so muss der Treiber auch in der Zielumgebung installiert sein, damitdas Mapping erfolgreich ausgeführt werden kann. Klicken Sie in MapForce mit der rechten Maustasteauf die Datenbankkomponente und wählen Sie Eigenschaften, um dieDatenbankverbindungsinformationen anzupassen. Nachdem Sie in MapForce Änderungen amMapping-Design vorgenommen haben, muss es erneut zu einer MapForce Server-Ausführungsdatei(.mfx) kompiliert oder, je nach Situation, erneut auf FlowForce Server bereitgestellt werden. NähereInformationen finden Sie unter Preparing Mappings for Server Execution .20

20 Ausführen von Mappings Vorbereiten von Mappings für die Server-Ausführung


3.1 Vorbereiten von Mappings für die Server-Ausführung

Ein Mit MapForce erstelltes Mapping, das auch in der MapForce-Vorschau angezeigt wird, kann Ressourcen(z.B. Datenbanken) referenzieren, die sich nicht auf dem aktuellen Rechner und Betriebssystem befinden.Außerdem entsprechen in MapForce alle Mapping-Pfade standardmäßig den Windows-Konventionen. Zudemunterstützt der Rechner, auf dem MapForce Server läuft, nicht notwendigerweise dieselbenDatenbankverbindungen wie der Rechner, auf dem das Mapping erstellt wurde. Aus diesem Grund, müssen Sieein Mapping entsprechend vorbereiten, bevor Sie es in einer Server-Umgebung ausführen, vor allem dann, wennder Zielrechner nicht derselbe wie der Quellrechner ist.

Anmerkung: Mit "Quellrechner" wird der Computer bezeichnet, auf dem MapForce installiert ist und mit"Zielrechner" wird der Computer bezeichnet, auf dem MapForce Server oder FlowForce Server installiertist. Im einfachsten Szenario handelt es sich hierbei um denselben Computer. In einem komplexerenSzenario läuft MapForce auf einem Windows-Rechner, während MapForce Server auf einem Linux-oder macOS-Rechner ausgeführt wird.

Stellen Sie am besten immer sicher, dass sich das Mapping in MapForce erfolgreich validieren lässt, bevor Siees auf FlowForce Server bereitstellen oder zu einer MapForce Server-Ausführungsdatei kompilieren.

Wenn MapForce Server alleine (ohne FlowForce Server) ausgeführt wird, werden die folgenden Lizenzenbenötigt:

· Auf dem Quellrechner benötigen Sie zur Erstellung des Mappings und zum Kompilieren zu einerServer-Ausführungsdatei (.mfx) die MapForce Enterprise oder Professional Edition.

· Auf dem Zielrechner benötigen Sie zur Ausführung des Mappings MapForce Server oder MapForceServer Advanced Edition.

Wenn MapForce Server unter Verwaltung von FlowForce Server ausgeführt wird, gelten die folgendenVoraussetzungen:

· Auf dem Quellrechner benötigen Sie zur Erstellung des Mappings und für die Bereitstellung desMappings auf einem Zielrechner die MapForce Enterprise oder Professional Edition.

· Sowohl MapForce Server als auch FlowForce Server müssen auf dem Zielrechner lizenziert sein. DieAufgabe von MapForce Server ist die Ausführung des Mappings; die Aufgabe von FlowForce ist es, dasMapping in Form eines Auftrags bereitzustellen, wodurch Funktionen wie Ausführung nach einemZeitplan oder auf Wunsch, die Ausführung als Webservice, Fehlerbehandlung, Ausführung auf Basisvon Bedingungen, E-Mail-Benachrichtigungen usw. zur Verfügung stehen.

· FlowForce Server muss an der konfigurierten Netzwerkadresse und am konfigurierten Port gestartetsein. Dabei muss der "FlowForce Web Server"-Dienst gestartet sein und so konfiguriert sein, dass erVerbindungen von HTTP-Clients (oder bei Bedarf von HTTPS-Clients) zulässt und er darf nicht durch dieFirewall blockiert werden. Auch der "FlowForce Server"-Dienst muss unter der vorgesehenen Adresseund am angegebenen Port gestartet und verfügbar sein.

· Sie haben ein FlowForce Server-Benutzerkonto und Zugriff auf einen der Container (standardmäßigsteht der Container /public jedem authentifizierten Benutzer zur Verfügung).

Allgemeine Überlegungen

· Wenn Sie beabsichtigen, das Mapping mit MapForce Server alleine auf einem Zielrechner auszuführen,müssen alle vom Mapping referenzierten Input-Dateien ebenfalls auf den Zielrechner kopiert werden.Wenn MapForce Server unter Verwaltung von FlowForce Server ausgeführt wird, müssen die Dateien

© 2020 Altova GmbH

Vorbereiten von Mappings für die Server-Ausführung 21Ausführen von Mappings


nicht manuell kopiert werden. In diesem Fall sind die Instanz- und Schema-Dateien in dem auf demZielrechner bereitgestellten Paket inkludiert.

· Wenn das Mapping Datenbankkomponenten enthält, für die spezielle Datenbanktreiber benötigtwerden, müssen diese Treiber auch auf dem Zielrechner installiert werden. Wenn in Ihrem Mappingz.B. Daten aus einer Microsoft Access-Datenbank ausgelesen werden, so muss Microsoft Accessoder Microsoft Access Runtime (https://www.microsoft.com/en-us/download/details.aspx?id=50040)auch auf dem Zielrechner installiert sein.

· Wenn Sie ein Mapping auf Nicht-Windows-Plattformen bereitstellen, werden ADO-, ADO.NET- undODBC-Datenbankverbindungen automatisch in JDBC konvertiert. Native SQLite- und PostgreSQL-Verbindungen werden als solche beibehalten und müssen nicht zusätzlich konfiguriert werden. Sieheauch "Datenbankverbindungen" weiter unten.

· Wenn das Mapping benutzerdefinierte Funktionsaufrufe enthält (z.B. Aufrufe von .dll- oder .class-Dateien), werden diese Abhängigkeiten nicht zusammen mit dem Mapping bereitgestellt, da sie vor derLaufzeit nicht bekannt sind. Kopieren Sie diese in diesem Fall manuell auf den Zielrechner. Der Pfadder .dll- oder .class-Datei auf dem Server muss derselbe sein, der in MapForce im Dialogfeld"Bibliotheken verwalten" definiert wurde, z.B.:

· In einigen Mappings werden mehrere Input-Dateien über einen Platzhalter-Pfad ausgelesen . In diesemFall sind die Namen der Input-Dateien vor der Laufzeit noch nicht bekannt und können daher nichtbereitgestellt werden. Damit das Mapping erfolgreich ausgeführt werden kann, muss die Input-Datei aufdem Zielrechner vorhanden sein.

· Wenn der Mapping-Ausgabepfad Verzeichnisse enthält, müssen diese auf dem Zielrechner vorhandensein, da sonst bei Ausführung des Mappings ein Fehler generiert wird. Im Gegensatz dazu werden inMapForce nicht vorhandene Verzeichnisse automatisch generiert, wenn die Option Output-Datei alstemporäre Datei generieren aktiviert ist.

· Wenn im Mapping ein Webservice aufgerufen wird, für den eine HTTPS-Authentifizierung mit einemClient-Zertifikat erforderlich ist, muss das Zertifikat ebenfalls an den Zielrechner übertragen werden(siehe Verwaltung digitaler Zertifikate .

· Wenn im Mapping eine Verbindung zu dateibasierten Datenbanken wie Microsoft Access und SQLitehergestellt wird, muss die Datenbank manuell auf den Zielrechner transferiert werden oder in einemfreigegebenen, sowohl Quell- als auch Zielrechner zugänglichen Verzeichnis gespeichert werden undvon dort aus referenziert werden, siehe "Dateibasierte Datenbanken", weiter unten.

Übertragbarmachen von PfadenWenn Sie beabsichtigen, das Mapping auf einem Server auszuführen, müssen Sie sicherstellen, dass es den

100

https://www.microsoft.com/en-us/download/details.aspx?id=50040



jeweils geltenden Pfadkonventionen entspricht und dass eine unterstützte Datenbankverbindung verwendet wird.

Um Pfade auf Nicht-Windows-Betriebssysteme übertragen zu können, verwenden Sie beim Erstellen desMappings in MapForce relative anstelle von absoluten Pfaden:

1. Öffnen Sie die gewünschte Mapping-Design-Datei (.mfd) mit MapForce unter Windows.2. Wählen Sie im Menü Datei den Befehl Mapping-Einstellungen und deaktivieren Sie das

Kontrollkästchen Pfade im generierten Code absolut machen, falls es aktiviert ist.3. Öffnen Sie für jede Mapping-Komponente das Dialogfeld Eigenschaften (z.B. durch Doppelklick auf

die Titelleiste) und ändern Sie alle Dateipfade von absoluten in relative um. Aktivieren Sie außerdemdas Kontrollkästchen Alle Dateipfade relativ zur MFD-Datei speichern. Sie können alle Input-Dateien und Schemas aus praktischen Gründen in denselben Ordner wie das Mapping kopieren unddiese einfach über den Dateinamen referenzieren.

Nähere Informationen zum Arbeiten mit relativen und absoluten Pfaden bei der Erstellung eines Mappingsfinden Sie in der Dokumentation zu MapForce,.

Beachten Sie, dass sowohl MapForce Server als auch FlowForce Server ein so genanntes Arbeitsverzeichnis("working directory") unterstützen, anhand dessen alle relativen Pfade aufgelöst werden. Das Arbeitsverzeichniswird zur Mapping-Laufzeit folgendermaßen definiert:

· in FlowForce Server durch Bearbeitung des Auftragsparameters "Working-directory".· in der MapForce Server API über die Eigenschaft WorkingDirectory der COM und der .NET API oder

über die Methode setWorkingDirectory der Java API.· in der MapForce Server-Befehlszeile ist das Arbeitsverzeichnis das aktuelle Verzeichnis der

Befehlszeile.

DatenbankverbindungenBeachten Sie, dass ADO-, ADO.NET- und ODBC-Verbindungen auf Linux- und macOS-Rechnern nichtunterstützt werden. Wenn es sich beim Zielrechner daher um einen Linux- oder macOS-Rechner handelt,werden diese Verbindungen in JDBC konvertiert, wenn Sie das Mapping auf FlowForce Server bereitstellen oderdas Mapping zu einer MapForce Server-Ausführungsdatei kompilieren. In diesem Fall haben Sie die folgendenMöglichkeiten, bevor Sie das Mapping bereitstellen oder es zu einer Server-Ausführungsdatei kompilieren:

· Erstellen Sie in MapForce eine JDBC-Verbindung zur Datenbank, bevor Sie das Mapping bereitstellen · Füllen Sie in MapForce die JDBC-Datenbankverbindungsinformationen im Abschnitt "JDBC-spezifische

Einstellungen" der Datenbankkomponente aus .

Wenn im Mapping eine native Verbindung zu einer PostgreSQL- oder SQLite-Datenbank verwendet wird, wirddie native Verbindung beibehalten und es wird keine JDBC-Konvertierung durchgeführt. Wenn im Mapping eineVerbindung zu einer dateibasierten Datenbank wie Microsoft Access und SQLite hergestellt wird, müssenzusätzliche Konfigurationsschritte durchgeführt werden, siehe "Dateibasierte Datenbanken" weiter unten.

Für die Ausführung von Mappings mit JDBC-Verbindungen muss Java Runtime Environment oder JavaDevelopment Kit auf dem Server-Rechner installiert sein. Dabei kann es sich entweder um Oracle JDK odereinen Open Source Build wie z.B. Oracle OpenJDK handeln.

· Die JAVA_HOME-Umgebungsvariable muss auf das JDK-Installationsverzeichnis verweisen. · Unter Windows hat ein Java Virtual Machine-Pfad aus der Windows Registry Vorrang vor der

JAVA_HOME-Variablen.

© 2020 Altova GmbH



· Die JDK-Plattform (64-Bit, 32-Bit) muss mit der von MapForce Server identisch sein, da Sie sonsteventuell einen Fehler erhalten, weil "kein Zugriff auf JVM besteht".

So richten Sie unter Linux oder macOS eine JDBC-Verbindung ein:

1. Laden Sie den vom Datenbankanbieter bereitgestellten JDBC-Treiber herunter und installieren Sie ihnauf dem Betriebssystem. Wählen Sie die 32-Bit-Version aus, wenn Ihr Betriebssystem mit 32 Bitausgeführt wird, und die 64-Bit-Version, wenn Ihr Betriebssystem mit 64 Bit ausgeführt wird.

2. Definieren Sie für die Umgebungsvariablen den Pfad, unter dem der JDBC-Treiber installiert ist.Normalerweise müssen Sie die CLASSPATH-Variable und eventuell noch einige weitere Variablendefinieren. Nähere Informationen dazu, welche Umgebungsvariablen konfiguriert werden müssen, findenSie in der mit dem JDBC-Treiber mitgelieferten Dokumentation.

Anmerkung: Unter macOS werden die installierten JDBC-Bibliotheken imVerzeichnis /Library/Java/Extensions gesucht. Es wird daher empfohlen, den JDBC-Treiber unterdiesem Pfad zu entpacken; andernfalls müssen Sie das System so konfigurieren, dass es die JDBC-Bibliothek unter dem Pfad sucht, unter dem Sie den JDBC-Treiber installiert haben.

Oracle Instant Client-Verbindungen auf macOSWenn Sie über den Oracle Database Instant Client eine Verbindung zu einer Oracle-Datenbank herstellen,gelten auf macOS die folgenden Voraussetzungen:

· Es muss Java 8.0 oder höher installiert sein. Sie können auch über die JDBC Thin for All Platforms-Bibliothek eine Verbindung herstellen, wenn auf dem Mac-Rechner eine Java-Version älter als Version8 läuft. In diesem Fall können Sie die unten stehende Anleitung ignorieren.

· Oracle Instant Client muss installiert sein. Sie können den Oracle Instant Client von der offiziellenOracle Download-Seite herunterladen. Beachten Sie, dass auf dieser Seite mehrere Instant Client-Pakete zum Download zur Verfügung stehen. Stellen Sie sicher, dass Sie ein Paket mit Oracle CallInterface (OCI)-Unterstützung (z.B. Instant Client Basic) auswählen. Stellen Sie außerdem sicher,dass Sie die 32-Bit-Version auswählen, falls Ihr Betriebssystem auf 32 Bit läuft, und die 64-Bit-Version,falls Ihr Betriebssystem auf 64 Bit läuft.

Nachdem Sie den Oracle Instant Client heruntergeladen und entpackt haben, bearbeiten Sie die mit demInstaller mitgelieferte Eigenschaftsliste (plist-Datei), sodass die folgenden Umgebungsvariablen auf denentsprechenden Treiberpfad verweisen, z.B.:

Variable Beispielwert

CLASSPATH /opt/oracle/instantclient_11_2/ojdbc6.jar:/opt/oracle/instantclient_11_2/ojdbc5.jar

TNS_ADMIN /opt/oracle/NETWORK_ADMIN

ORACLE_HOME /opt/oracle/instantclient_11_2

DYLD_LIBRARY_PATH /opt/oracle/instantclient_11_2

PATH $PATH:/opt/oracle/instantclient_11_2



Anmerkung: Bearbeiten Sie die obigen Beispielwerte, sodass sie auf die Pfade verweisen, unter denen dieOracle Instant Client-Dateien auf Ihrem Betriebssystem installiert sind.

Dateibasierte DatenbankenDateibasierte Datenbanken wie Microsoft Access und SQLite sind in dem auf FlowForce Server bereitgestelltenPaket oder in der kompilierten MapForce Server-Ausführungsdatei nicht enthalten. Wenn der Quellrechnerdaher nicht derselbe wie der Zielrechner ist, gehen Sie folgendermaßen vor:

1. Klicken Sie in MapForce mit der rechten Maustaste auf das Mapping und deaktivieren Sie dasKontrollkästchen Pfade im generierten Code absolut machen .

2. Klicken Sie mit der rechten Maustaste im Mapping auf die Datenbankkomponente und fügen Sie eineVerbindung zu einer Datenbankdatei über einen relativen Pfad hinzu. Eine einfache Methode, umPfadprobleme zu vermeiden, ist, das Mapping-Design (die .mfd-Datei) im selben Verzeichnis wie dieDatenbankdatei zu speichern und letztere vom Mapping aus nur über den Dateinamen (d.h. über einenrelativen Pfad) zu referenzieren.

3. Kopieren Sie die Datenbankdatei in ein Verzeichnis auf dem Zielrechner (nennen wir es das"Arbeitsverzeichnis"). Dieses Verzeichnis benötigen Sie später, um das Mapping auf dem Serverauszuführen (siehe unten).

Um ein solches Mapping auf dem Server auszuführen, wählen Sie eine der folgenden Methoden:

· Wenn das Mapping unter Verwaltung von FlowForce Server mit MapForce Server ausgeführt wird,konfigurieren Sie den FlowForce Server-Auftrag so, dass das zuvor erstellte Arbeitsverzeichnisverwendet wird. Die Datenbankdatei muss sich in diesem Arbeitsverzeichnis befinden. Ein Beispieldazu finden Sie in der FlowForce Server-Dokumentation im Kapitel "Bereitstellen eines Auftrags ausWeb-Dienst" (https://www.altova.com/manual/de/FlowForceServer/FlowForceServerAdvanced/index.html?fs_example_web_service.htm)

· Wenn das Mapping von MapForce Server alleine über die Befehlszeile ausgeführt wird, ändern Sie dasaktuelle Verzeichnis in das Arbeitsverzeichnis (z.B. cd pfad\zum\arbeitsverzeichnis), bevor Sieden MapForce Server-Befehl run aufrufen.

· Wenn das Mapping über die MapForce Server API ausgeführt wird, definieren Sie dasArbeitsverzeichnis programmatisch, bevor Sie das Mapping ausführen. Zu diesem Zweck steht für dasMapForce Server-Objekt in der COM und .NET API die Eigenschaft WorkingDirectory zur Verfügung.In der Java API steht dafür die Methode setWorkingDirectory zur Verfügung.

Wenn es sich sowohl beim Quell- als auch beim Zielrechner um Windows-Rechner im lokalen Netzwerkhandelt, wäre eine alternative Methode, das Mapping so zu konfigurieren, dass die Datenbankdateifolgendermaßen aus einem gemeinsamen, freigegebenen Verzeichnis gelesen wird:

1. Speichern Sie die Datenbankdatei in einem gemeinsamen freigegebenen Verzeichnis, auf das sowohlder Quell- als auch der Zielrechner Zugriff hat.

2. Klicken Sie mit der rechten Maustaste im Mapping auf die Datenbankkomponente und fügen Sie übereinen absoluten Pfad eine Verbindung zur Datenbankdatei hinzu.

Globale RessoucenWenn ein Mapping anstelle von direkten Pfaden oder Datenbankverbindungen Referenzen auf globaleRessourcen enthält, können Sie auch serverseitig globale Ressourcen verwenden. Wenn Sie ein Mapping zueiner MapForce Server-Ausführungsdatei (.mfx) kompilieren, bleiben die Referenzen auf globale Ressourcenintakt, so dass Sie diese zur Mapping-Laufzeit auf Seite des Servers bereitstellen können. Wenn Sie einMapping auf FlowForce Server bereitstellen, können Sie optional auswählen, ob darin die Ressourcen auf dem

https://www.altova.com/manual/de/FlowForceServer/FlowForceServerAdvanced/index.html?fs_example_web_service.htm

https://www.altova.com/manual/de/FlowForceServer/FlowForceServerAdvanced/index.html?fs_example_web_service.htm

© 2020 Altova GmbH



Server verwendet werden sollen.

Damit Mappings (oder, im Fall von FlowForce Server, Mapping-Funktionen) erfolgreich ausgeführt werdenkönnen, muss die eigentliche Datei, der eigentliche Ordner bzw. die Datenbankverbindungsinformationen, dieSie als globale Ressourcen bereitstellen mit der Server-Umgebung kompatibel sein. So muss z.B. beiAusführung des Mappings auf einem Linux-Server bei Datei- und Ordnerpfaden die Linux-Pfadkonventionverwendet werden. Ebenso müssen als Datenbankverbindungen definierte globale Ressourcen auf dem Server-Rechner möglich sein.

Nähere Informationen dazu finden Sie unter Globale Ressourcen .

XBRL-TaxonomiepaketeWenn Sie ein Mapping bereitstellen, in dem XBRL-Taxonomiepakete referenziert werden, sammelt MapForcealle externen Referenzen aus dem Mapping und löst diese dann unter Verwendung der aktuellen Konfigurationund der aktuell installierten Taxonomiepakete auf. Falls es aufgelöste externe Referenzen gibt, die auf einTaxonomiepaket verweisen, so wird das Taxonomiepaket zusammen mit dem Mapping bereitgestellt.FlowForce Server verwendet dieses Paket in dem Zustand, in dem es sich bei der Bereitstellung befand, umdas Mapping auszuführen. Um das von FlowForce Server verwendete Taxonomiepaket zu aktualisieren,müssen Sie es in MapForce ändern und das Mapping erneut bereitstellen.

Beachten Sie, dass der Root-Katalog von MapForce Server einen Einfluss darauf hat, wie Taxonomien auf demZielrechner aufgelöst werden. Der Root-Katalog befindet sich unter dem folgenden Pfad relativ zum MapForceServer-Installationsverzeichnis: etc/RootCatalog.xml.

Mit einem Mapping bereitgestellte Taxonomiepakete werden verwendet, wenn der Root-Katalog von MapForceServer nicht bereits ein solches Paket enthält oder kein Paket enthält, das für dasselbe URL-Präfix definiert ist.Der Root-Katalog von MapForce Server hat Vorrang vor einer bereitgestellten Taxonomie.

Wenn MapForce Server alleine (ohne FlowForce Server) ausgeführt wird, kann der für das Mapping zuverwendende Root-Katalog folgendermaßen definiert werden:

· in der Befehlszeile durch Hinzufügen der Option -catalog zum Befehl run.· in der MapForce Server API durch Aufruf der Methode SetOption und Bereitstellen des String

"catalog" als erstes Argument und des Pfads zum Root-Katalog als zweites Argument.

Wenn in einem Mapping XBRL-Komponenten mit Tabellen-Linkbases verwendet werden, muss dasTaxonomiepaket oder die Taxonomiepaketkonfigurationsdatei dem Mapping folgendermaßen zur Laufzeit zurVerfügung gestellt werden:

· Fügen Sie in der MapForce Server-Befehlszeile die Option --taxonomy-package oder --taxonomy-packages-config-file zum Befehl run hinzu.

· Rufen Sie über die MapForce Server API die Methode SetOption auf. Das erste Argument mussentweder "taxonomy-package" oder "taxonomy-packages-config-file" sein. Das zweite Argumentmuss der eigentliche Pfad zum Taxonomiepaket (oder zur Taxonomiepaketkonfigurationsdatei) sein.

26

26 Ausführen von Mappings Globale Ressourcen


3.2 Globale Ressourcen

Globale Altova-Ressourcen sind übertragbare Referenzen auf Dateien, Ordner oder Datenbanken. Wenn Pfadeund Datenbankverbindungsinformationen als globale Ressourcen gespeichert werden, lassen sich diese inmehreren Altova-Applikationen wiederverwenden. Wenn Sie ein und dieselbe Datei z.B. häufig in verschiedenenAltova Desktop-Applikationen öffnen müssen, empfiehlt es sich, diese als globale Ressource zu definieren. Aufdiese Art müssen Sie sich den Dateipfad nicht merken, da Sie die entsprechende globale Ressourcestattdessen über das Dialogfeld "Datei öffnen" auswählen können. Dies hat auch den Vorteil, dass Sie denPfad nur an einer Stelle ändern müssen, falls sich der Dateipfad ändern sollte.

Ein typisches Beispiel für die Verwendung globaler Ressourcen ist die einmalige Definition einerDatenbankverbindung, die dann in allen Altova-Applikationen, die globale Ressourcen unterstützen,wiederverwendet wird. So können Sie etwa auf dem Rechner, auf dem das MapForce Mapping erstellt wurde,eine Datenbankverbindung erstellen und dieselbe Verbindung dann auf dem Rechner, auf dem MapForce Serverdas Mapping ausführt, wiederverwenden (Eventuell muss dafür in einigen Fällen auf beiden Rechnern dieselbeDatenbank-Client-Software installiert sein).

Sie können optional mehrere Varianten derselben globalen Ressource (sogenannte "Konfigurationen") erstellen.Auf diese Art können Sie Datei- oder Ordnerpfade (oder sogar Datenbanken) ganz nach Bedarf einfachwechseln. So könnten Sie etwa eine "Datenbank"-Ressource mit zwei Konfigurationen erstellen: "Entwicklung"und "Produktion". In MapForce Server könnten Sie Daten dann z.B. ganz einfach entweder aus derEntwicklungs- oder der Produktionsdatenbank abrufen, indem Sie die gewünschte Konfiguration zur Mapping-Laufzeit als Befehlszeilenparameter angeben.

Globale Ressourcen können über die folgenden Altova Desktop-Applikationen erstellt werden: Altova Authentic,DatabaseSpy, MobileTogether Designer, MapForce, StyleVision und XMLSpy. Serverseitig können globaleRessourcen von den folgenden Altova-Server-Applikationen verwendet werden: FlowForce Server, MapForceServer, RaptorXML Server, RaptorXML+XBRL Server

Nähere Informationen zur Erstellung von globalen Ressourcen finden Sie in der MapForce-Dokumentation imKapitel "Globale Altova-Ressourcen".

Ressourcen in MapForce ServerWenn Sie ein Mapping zu einer MapForce Server-Ausführungsdatei (.mfx) kompilieren, werden im Mappingverwendete globale Ressource-Referenzen beibehalten und nicht aufgelöst. Das bedeutet, Sie müssen dieseReferenzen auf dem Server zur Verfügung stellen, damit das Mapping erfolgreich ausgeführt werden kann. InMapForce Server werden folgende Informationen benötigt, damit eine .mfx-Datei, in der globale Ressourcenverwendet werden, ausgeführt werden kann:

1. Die XML-Datei für die globalen Ressourcen. Auf dem Rechner, auf dem MapForce installiert ist, hat dieDatei den Namen GlobalResources.xml und befindet sich im Ordner Dokumente\Altova. Siekönnen diese Datei auf den Rechner, auf dem MapForce Server ausgeführt wird, kopieren undgegebenenfalls auch mehrere dieser Dateien erstellen.

2. Der Name der globalen Ressourcenkonfiguration. Jede globale Ressource hat eineStandardkonfiguration namens "Default". Sie können aber bei Bedarf zusätzliche Konfigurationendefinieren. Falls Sie dies tun, so müssen Sie anstelle von "Default" den Namen der gewünschtenKonfiguration definieren.

Der Pfad der globalen Ressourcendatei und der Name der globalen Ressourcenkonfiguration werden inMapForce über die grafische Benutzeroberfläche definiert bzw. geändert. Diese werden in MapForce Server zur

© 2020 Altova GmbH

Globale Ressourcen 27Ausführen von Mappings


Mapping-Laufzeit definiert.

· Wenn Sie das Mapping über die Befehlszeilenschnittstelle ausführen, definieren Sie nach dem Befehlrun die Optionen --globalresourceconfig and --globalresourcefile, z.B:

C:\Program Files (x86)\Altova\MapForceServer2020\bin\MapForceServer.exe runSomeMapping.mfx --globalresourcefile="C:\Users\me\Documents\Altova\GlobalResources.xml" --globalresourceconfig="Default"

· Wenn Sie das Mapping über die MapForce Server API ausführen, rufen Sie die Methode SetOptions

zwei Mal auf, bevor Sie die Run-Methode aufrufen. Mit dem ersten Aufruf wird der Dateipfad zur XML-

Datei für globale Ressourcen als Option bereitgestellt, mit dem zweiten wird der Name der globalenRessourcenkonfiguration bereitgestellt Nähere Informationen dazu finden Sie unter MapForce ServerAPI .53

28 Ausführen von Mappings Join-Optimierung


3.3 Join-Optimierung

Mit Hilfe der Join-Optimierung lässt sich die Ausführung von Datenmappings, in denen große Datenmengengefiltert oder verknüpft werden, beschleunigen.

Bei der Join-Optimierung werden verschachtelte, bei der Ausführung des Mappings auftretende interneSchleifen eliminiert. Verschachtelte Schleifen entstehen, wenn bei einem Mapping jedes Datenelement einerDatengruppe so oft iteriert wird, wie es in einer zweiten Datengruppe vorkommt. Beachten Sie, dass esaufgrund des Mapping-Designs normal für den Mapping-Ausführungsprozessor* ist, dass an verschiedenenDatenelementsequenzen eine Schleifenverarbeitung (Iteration) durchgeführt wird. Wenn es zu unabhängigenverschachtelten Schleifen kommt (d.h. bei Schleifenverarbeitungen, die über andere Schleifen iterieren), kanneine Join-Optimierung, die die Ausführungsdauer des Mappings erheblich verringern würde, sinnvoll sein.Verschachtelte Schleifen fallen bei der Ausführung von Mappings mit wenigen Input-Daten kaum ins Gewicht.Im Fall von Mappings, in denen Dateien oder Datenbanken mit sehr vielen Datensätzen verarbeitet werden,kann dies jedoch zu Problemen führen.

* Der Ausführungsprozessor eines Mappings kann MapForce, MapForce Server oder ein mit MapForcegeneriertes C#-, C++- oder Java-Programm sein. Die Join-Optimierung steht ausschließlich in derMapForce Server Advanced Edition zur Verfügung.

Um MapForce Server als Ausführungszielprozessor zu definieren, klicken Sie in MapForce auf die

Symbolleisten-Schaltfläche BUILT-IN ( ). Damit gewährleisten Sie außerdem, dass in Ihrem Mappingder größte verfügbare Funktionsumfang genutzt werden kann. Wenn Sie eine andereTransformationssprache auswählen, werden bestimmte MapForce-Funktionalitäten eventuell in dieserSprache nicht unterstützt.

Wie oben erwähnt, geht es bei Join-Optimierungen in erster Linie darum, verschachtelte Schleifen effizient zuverarbeiten. Wir wollen nun genauer analysieren, wir verschachtelte Schleifen überhaupt entstehen.

Typischerweise kommt es dann zu verschachtelten Schleifen, wenn das Mapping mindestens eine Join-Komponente enthält und der SQL JOIN-Modus** nicht möglich ist.

** Unter bestimmten Bedingungen kann ein spezieller Ausführungsmodus in MapForce, nämlich der "SQLJoin-Modus", verwendet werden. Dies gilt nur für Mappings, in denen Daten aus einer Datenbankausgelesen werden. Wenn Daten auf diese Art mittels Join verknüpft werden, wird die Join-Operation vonder Datenbank durchgeführt (d.h. es wird ein SQL JOIN durchgeführt). Dadurch muss der Mapping-Ausführungsprozessor keine verschachtelten Schleifen mehr durchführen. Nähere Informationen zum SQLJoin-Modus finden Sie in der MapForce-Dokumentation (https://www.altova.com/de/documentation.html).

In der Abbildung unten sehen Sie ein (mit Altova MapForce erstelltes) Beispiel-Mapping, in dem Daten auszwei XML-Dateien mit Hilfe einer Join-Komponente miteinander kombiniert werden. Sie finden dieses Mappingauf dem Rechner, auf dem MapForce installiert ist, unter dem folgenden Pfad: ..\Dokumente\Altova\MapForce2020\MapForceExamples\Tutorial\JoinPeopleInfo.mfd. EinigePersonendaten (People) stehen nur in der ersten XML-Datei (Email, Phone) zur Verfügung, während andereDaten nur in der zweiten XML-Datei (City, Street, Number) verfügbar sind. Ziel des Mappings ist es, diezusammengeführten Daten aller Personen, bei denen FirstName und LastName in beiden Quellstrukturenmiteinander übereinstimmen, in die XML-Zieldatei zu schreiben.

https://www.altova.com/de/documentation.html

© 2020 Altova GmbH

Join-Optimierung 29Ausführen von Mappings


JoinPeopleInfo.mfd

Eine Join-Komponente in MapForce verbindet Datenelemente in zwei Datengruppen gemäß einerbenutzerdefinierten Bedingung. Zu diesem Zweck wird jedes Datenelement in der Datengruppe 1 mit jedemDatenelement in der Datengruppe 2 verglichen. Die Gesamtanzahl der Vergleiche bildet das Kreuzprodukt (daskartesische Produkt) beider Datengruppen. Wenn etwa die erste Datengruppe 50 Datenelemente und diezweite 100 enthält, so werden insgesamt 5000 Vergleiche (50 x 100) durchgeführt. Im obigen Mappingentsprechen die verglichenen Gruppen allen Instanzdatenelementen der zwei mit der Join-Komponenteverbundenen XML-Strukturen.

Anmerkung: Eine Join-Optimierung (eine Funktionalität der MapForce Server Advanced Edition) ist nicht mitJoin-Komponenten (einer Funktionalität von MapForce) zu verwechseln. Nähere Informationen zu Join-Komponenten finden Sie in der MapForce-Dokumentation(https://www.altova.com/de/documentation.html).

Von der Verarbeitungsleistung her gesehen, würden Mappings, die verschachtelte Schleifen enthalten, mehrVerarbeitungszeit in Anspruch nehmen. Stellen Sie sich vor, Sie haben einen Fall, in dem beide miteinanderverknüpften Datengruppen Millionen von Datensätzen enthalten. Dies wirkt sich natürlich auf dieVerarbeitungsgeschwindigkeit aus. Hier wäre eine Join-Optimierung sinnvoll. Eine Join-Optimierung verhält sichgrob gesprochen wie ein Datenbankprozessor, der so optimiert ist, dass er extrem große Datengruppenindiziert, bloß dass eine Join-Optimierung, wie im Mapping oben gezeigt, nicht nur mit Daten aus Datenbankenoperiert. Mit einer Join-Optimierung werden verschachtelte Schleifen unabhängig von der Datenart eliminiert,indem, wo dies möglich ist, interne Lookup-Tabellen erstellt werden, die zur Mapping-Laufzeit abgefragt werden.Dadurch wird die Mapping-Verarbeitungsgeschwindigkeit erheblich verbessert und weniger Zeit für dieAusführung des Mappings benötigt.

Anmerkung: Bei Join-Optimierungen dauert die Mapping-Verarbeitung weniger lang, doch wirdnormalerweise auch mehr Arbeitsspeicher in Anspruch genommen. Denken Sie daran, dass dieArbeitsspeicherbeanspruchung von verschiedenen komplexen Faktoren abhängig ist; aus diesemGrund kann das beobachtete Verhalten je nach Fall unterschiedlich sein.

https://www.altova.com/de/documentation.html

30 Ausführen von Mappings Join-Optimierung


Mit Hilfe von Join-Optimierungen können nicht nur Mappings mit Joins, sondern auch Mappings, dieFilterkomponenten enthalten, beschleunigt werden. Ein Filter verarbeitet in MapForce eine Sequenz vonDatenelementen (d.h. er überprüft für jede Instanz des mit dem node/row-Input verbundenen Datenelementseine angegebene Boolesche Bedingung). Wenn die Boolesche Bedingung mit einer Funktion verbunden ist, dieselbst wiederum über eine weitere Sequenz von Datenelementen iterieren muss und es der Mapping-Kontextverlangt, so kann es zu einer ähnlichen Situation wie bei einem Join kommen. Wenn mit dem Filter einKreuzvergleich jedes Datenelements in zwei Datengruppen durchgeführt werden muss, so ist eine Join-Optimierung hier sinnvoll.

Damit die Join-Optimierung in einem Mapping genutzt werden kann, muss es mit der MapForce ServerAdvanced Edition ausgeführt werden. Um ein Mapping mit der MapForce Server Advanced Edition auszuführen,öffnen Sie es in MapForce und kompilieren Sie es mit dem Menübefehl Datei | Zu MapForce Server-Ausführungsdatei kompilieren zu einer Mapping-Ausführungsdatei (.mfx). Führen Sie die .mfx-Dateianschließend entweder mit einer API-Methode in der Programmiersprache Ihrer Wahl aus oder verwenden Sieden Befehl run der Befehlszeilenschnittstelle (siehe auch Funktionalität ).17

© 2020 Altova GmbH

Anmeldeinformationen 31Ausführen von Mappings


3.4 Anmeldeinformationen

Mit Hilfe von Anmeldeinformationsobjekten können Authentifizierungsdaten (wie Benutzernamen, Passwörterund OAuth-Authentifzierungsinformationen) zwischen verschiedenen Mapping-Ausführungsumgebungen aufsichere Art portabel gemacht werden. Anmeldeinformationen eignen sich für die Verwendung in Mappings, fürdie eine einfache HTTP-Authentifizierung oder eine OAuth 2.0-Authentifizierung erforderlich ist.Anmeldeinformationen können sowohl in MapForce als auch FlowForce Server definiert werden. Wenn dieAnmeldeinformationen in MapForce definiert wurden, können diese, ähnlich wie Mappings, optional auch aufFlowForce Server bereitgestellt werden.

Nachdem Sie das Mapping zu einer MapForce Server-Ausführungsdatei (.mfx) kompiliert haben, führtMapForce Server die .mfx-Datei gemäß der von Ihnen zum Zeitpunkt des Designs des Mapping getroffenenAuswahl aus.

Wenn Sie bei der Erstellung der Anmeldeinformationen in MapForce das Kontrollkästchen Verschlüsselt inMapForce Server-Ausführungsdatei und Mapping-Bereitstellung inkludieren aktiviert haben, verwendetMapForce Server zur Mapping-Laufzeit die in der .mfx-Datei gespeicherten Anmeldeinformationen. Dasbedeutet, Sie können das Mapping mit einem Befehl wie dem folgenden ausführen:

<exec> run mapping.mfx

Hierbei steht <exec> für den Pfad zur ausführbaren MapForce Server-Datei. Dieser Pfad kann entweder ein

absoluter sein oder Sie können nur den Namen der ausführbaren Datei eingeben, wenn das aktuelleVerzeichnis dasselbe wie das der ausführbaren Datei ist.

Wenn Sie in MapForce nur den Namen der Anmeldeinformationen (ohne Benutzernamen und Passwort)eingegeben haben, müssen Sie diese Informationen mit Hilfe der Befehlszeilenoption --credential des

Befehls run zur Mapping-Laufzeit explizit bereitstellen. Auf diese Art können Sie z.B. in der Produktion andereAnmeldeinformationen als zum Zeitpunkt des Mapping-Designs verwenden. Die Option --credential hat dieForm --credential=KEY:VALUE., wobei

· KEY der Name der in MapForce definierten Anmeldeinformationen ist.

· VALUE eine Anmeldeinformationseigenschaft oder eine durch das Zeichen (&) getrennte Liste von

Eigenschaften ist. Bei Anmeldeinformationen vom Typ "Passwort" sind die möglichen Eigenschaftenusername und password. Bei Anmeldeinformationen vom Typ OAuth 2.0 ist die einzige unterstützte

Eigenschaft die Eigenschaft oauth:token.

· Die eigentlichen Eigenschaftswerte werden genau wie Abfrageparameter in einer URL mit Hilfe desZeichens "=" bereitgestellt.

Beispiel:

<exec> run mapping.mfx --credential="mycredential:username=admin&password=4xJ38dnx7"

Der Wert der Option --credential im Codefragment oben wurde in Anführungszeichen gesetzt, damit derWert als Literal behandelt wird, da der Benutzername und das Passwort durch ein Kaufmännisches Und-Zeichen voneinander getrennt sind.

Wenn mehrere benannte Anmeldeinformationsobjekte erforderlich sind, damit Ihr Mapping ausgeführt werdenkann, können Sie die Option --credential mehrmals definieren.

32 Ausführen von Mappings Anmeldeinformationen


Anmeldeinformationen, die als Befehlszeilenoptionen bereitgestellt werden, haben Vorrang vorgespeicherten Anmeldeinformationen.

Wenn Sie die Option Verschlüsselt in MapForce Server-Ausführungsdatei und Mapping-Bereitstellunginkludieren nicht aktiviert haben, fehlen die Felder mit den sensiblen Daten, d.h. Sie müssen in derBefehlszeile das Passwort angeben, während Sie das Anmeldeinformationsobjekt anhand seines Namensreferenzieren, z.B:

<exec> run mapping.mfx --credential=mycredential:password=4xJ38dnx7

Die folgenden Felder gelten als Felder, die sensible Daten enthalten:

· Passwort (bei Anmeldeinformationen vom Typ "Passwort")· Client Secret, Access Token und Refresh Token (bei Anmeldeinformationen vom Typ "OAuth

2.0")

Bei Mappings, für die eine OAuth 2.0-Autorisierung erforderlich ist, wird in der MapForce Server-Befehlszeilezur Mapping-Laufzeit ein OAuth 2.0 Access Token als Input akzeptiert. Beachten Sie, dass es in derMapForce Server-Befehlszeile keine interaktive Benutzeroberfläche gibt. Daher müssen Sie das OAuth 2.0Access Token in diesem Fall auf externem Weg (z.B. durch Anforderung von MapForce aus) abrufen. Dies istjedoch nicht notwendig, wenn MapForce Server unter FlowForce Server-Verwaltung ausgeführt wird, daFlowForce Server zur Laufzeit selbst ein neues OAuth 2.0 Access Token anfordern kann.

Ein Mapping kann solange mit gespeicherten Anmeldeinformationen über die Befehlszeile ausgeführt werden,als das gespeicherte OAuth 2.0 Token noch nicht abgelaufen ist oder vom Webservice-Anbieter widerrufenwurde. Andernfalls müssen Sie über die Option --credential ein neues (auf externem Weg abgerufenes)

OAuth 2.0 Access Token angeben, z.B:

<exec> run mapping.mfx --credential=my_oauth_credential:oauth:token=jdsaflkajlkewsaiurthczv904215-jhd

wobei:

· my_oauth_credential der Name der mit MapForce erstellten OAuth 2.0-Anmeldeinformationen ist.

· oauth:token die Methode ist, um MapForce Server mitzuteilen, dass zur Laufzeit ein neues OAuth

2.0 Access Token bereitgestellt wird.

MapForce Server APIDie MapForce Server API bietet Methoden, um Anmeldeinformationen zu erstellen, Eigenschaften zuAnmeldeinformationen hinzuzufügen und Anmeldeinformationen zu schließen, nachdem Sie diese fertigdeklariert haben. Der folgende Code ist ein Beispiel dafür, wie Passwort-Anmeldeinformationen in einem C#-Programm, das ein Mapping ausführt, normalerweise deklariert werden:

//Create a MapForce Server object

Altova.MapForceServer.Server objMFS = new Altova.MapForceServer.Server();

© 2020 Altova GmbH

Anmeldeinformationen 33Ausführen von Mappings


// Set the credential name as it was defined in MapForce

objMFS.BeginCredential("mycredential"); // Add the credential properties

objMFS.AddCredentialProperty("username", "altova");objMFS.AddCredentialProperty("password", "b45ax78!");// Close the credential

objMFS.EndCredential();

Um eine OAuth 2.0-Autorisierung von einem Programm, das ein Mapping ausführt, durchzuführen, muss derEigenschaftsname der Anmeldeinformationen, wie unten gezeigt, als oauth:token definiert werden:

//Create a MapForce Server object

Altova.MapForceServer.Server objMFS = new Altova.MapForceServer.Server();

// Set the credential name as it was defined in MapForce

objMFS.BeginCredential("my_oauth_credential");// Add the credential properties

objMFS.AddCredentialProperty("oauth:token", "jdsaflkajlkewsaiurthczv904215-jhd");// Close the credential

objMFS.EndCredential();

Wenn mehrere Anmeldeinformationen im Mapping benötigt werden, gehen Sie vor, wie oben gezeigt, um ganznach Bedarf mehrere Anmeldeinformationsgruppen hinzuzufügen. Sobald Sie alle erforderlichenAnmeldeinformationen deklariert haben, können Sie die Mapping-Ausführungsdatei standardmäßig durch Aufrufder Run() Methode ausführen. Nähere Informationen dazu finden Sie in der API-Referenz .53

34 Ausführen von Mappings Dynamische Authentifizierung


3.5 Dynamische Authentifizierung

Sie können in MapForce Mappings definieren, die Webservices für eine einfache HTTP-Authentifizierungaufrufen. Eine dynamische Authentifizierung kann als eine der Alternativen zur Verwendung vonAnmeldeinformationen verwendet werden. Dynamische Authentifizierung bedeutet, ein Mapping so zuentwerfen, dass Benutzername und Passwort darin als Input-Parameter akzeptiert werden NähereInformationen zum Konfigurieren einer dynamischen Authentifizierung finden Sie in der MapForce-Dokumentation (https://www.altova.com/de/documentation).

Wenn Sie das Mapping für eine dynamische Authentifizierung konfiguriert haben, müssen der entsprechendeBenutzername und das entsprechende Passwort zur Mapping-Laufzeit genau wie bei der Bereitstellung andererParameterarten als Parameter bereitgestellt werden. Wenn Sie z.B. MapForce Server über die Befehlszeileaufrufen, lautet die Syntax für ein Mapping wie das oben beschriebene folgendermaßen:

<exec> run mapping.mfx --p=username:admin --p=password:dj9JaVax

Wobei:

· <exec> der Pfad zur ausführbaren MapForce Server-Datei ist. Dabei kann es sich entweder um einen

absoluten Pfad handeln oder Sie können einfach nur den Namen der ausführbaren Datei angeben,wenn das aktuelle Verzeichnis dasselbe wie das der ausführbaren Datei ist.

· username und password die Namen der entsprechenden Input-Parameter im MapForce Mapping sind.

Bei Aufruf der MapForce Server API können Sie das Mapping durch Aufruf der Methode AddParameter

authentifizieren, bevor Sie die Methode Run aufrufen. Der Code dafür in C#, könnte folgendermaßen aussehen:

try

{ Altova.MapForceServer.Server mfs = new Altova.MapForceServer.Server();

mfs.AddParameter("username", "admin"); mfs.AddParameter("password", "dj9JaVax"); mfs.WorkingDirectory = "C:\\Work"; if(mfs.Run("C:\\Work\\mapping.mfx"))

{ Console.WriteLine("Success"); } else

{ Console.WriteLine(mfs.LastExecutionMessage); } Console.ReadLine();}catch(Exception ex)

{ Console.WriteLine(ex);}

Auch hier müssen username und password (das erste Argument für die Methode AddParameter) mit den

Namen der entsprechenden Input-Parameter im MapForce-Mapping identisch sein.


© 2020 Altova GmbH

35MapForce Server-Befehlszeile


4 MapForce Server-Befehlszeile

MapForce Server bietet eine Befehlszeilenschnittstelle, über die Sie Verwaltungsaufgaben wie die Lizenzierungdurchführen und auch Mapping-Ausführungsdateien (.mfx) ausführen können. Es stehen die folgenden Befehlezur Verfügung:

· assignlicense : (nur Windows) Lädt eine Lizenz in LicenseServer hoch und weist sie MapForceServer zu.

· exportresourcestrings : Exportiert alle Applikationsressourcenstrings in eine XML-Datei.· help : Zeigt Informationen zu dem im Argument angegebenen Befehl - oder wenn kein Befehl

angegeben ist, zu allen Befehlen - an.· licenseserver : Registriert MapForce Server auf einem LicenseServer im lokalen Netzwerk.· run : Führt eine mit MapForce kompilierte Mapping-Ausführungsdatei (.mfx) aus.· setdeflang : Definiert die Standardsprache von MapForce Server.· verifylicense : (Nur Windows) Überprüft, ob der aktuelle MapForce Server lizenziert ist; optional dazu

können Sie überprüfen, ob ein bestimmter Lizenzschlüssel zugewiesen ist.· version : Zeigt die Versionsnummer von MapForce Server an.

Um MapForce Server über die Befehlszeile aufzurufen, müssen Sie den jeweils für Ihr Betriebssystemgeltenden Pfad zur ausführbaren Datei kennen. Standardmäßig befindet sich die ausführbare MapForce Server-Datei unter dem folgenden Pfad:

Linux /opt/Altova/MapForceServer2020/bin/mapforceserver

macOS /usr/local/Altova/MapForceServer2020/bin/mapforceserver

Windows C:\Programme\Altova\MapForceServer2020\bin\MapForceServer.exe

Anmerkung: Wenn MapForce Server 32-Bit unter Windows 64-Bit installiert ist, ändern Sie C:\Programme

in C:\Programme (x86).

Bei der Beschreibung eines Befehls wird in dieser Dokumentation konventionsgemäß anstelle des vollständigenPfads der ausführbaren Datei mapforceserver verwendet, z.B:

mapforceserver help

Hierbei ist mapforceserver der Pfad oder Name der ausführbaren Datei. Beachten Sie Folgendes: Wenn Sie

einen absoluten Pfad verwenden, können Sie Befehle unabhängig vom aktuellen Verzeichnis, in dem sich IhrEingabeaufforderungsfenster (Terminal) befindet, ausführen. Wenn Sie die ausführbare Datei jedoch nur durchEingabe ihres Namens aufrufen möchten, dann wählen Sie eine der nachstehenden Methoden:

· Das aktuelle Verzeichnis im Terminal muss das MapForce Server-Installationsverzeichnis sein.· Fügen Sie das Verzeichnis, in dem sich die ausführbare Datei befindet, zur Umgebungsvariablen PATH

hinzu.

Beide Methoden werden weiter unten näher beschrieben.

Tipps und TricksWenn Sie mit der Befehlszeile nicht vertraut sind, hier einige Tipps und Tricks:

38

40

42

43

45

49

50

52

36 MapForce Server-Befehlszeile


· Um das aktuelle Verzeichnis, in dem sich das Befehlszeilenfenster gerade befindet, zu ermitteln,geben Sie auf Linux- und macOS-Systemen pwd ein. Geben Sie auf Windows-Systemen echo %CD%

ein.· Durch Drücken der Tabulatortaste können Sie schnell verschiedene Datei- oder Verzeichnispfade

eingeben, ohne diese vollständig eintippen zu müssen. Wenn Sie z.B. cd c:\prog in die Befehlszeile

eingeben und anschließend die Tabulatortaste drücken, wird automatisch C:\Program Files (oder

eventuell ein anderes Verzeichnis unter C:\, dessen Name mit "Prog" beginnt) ergänzt.· Setzen Sie bei Eingabe von Pfaden, die Leerzeichen enthalten, wie z.B. unter Windows C:\Program

Files, diese Leerzeichen in Anführungszeichen.

· Wenn eine Meldung angezeigt wird, dass "dieser Befehl nicht als interner oder externer Befehl,ausführbares Programm oder Batch-Datei erkannt wurde", so haben Sie sich bei der Eingabe einesPfads oder Befehls wahrscheinlich vertippt.

· Unter Linux muss bei Eingabe von Datei- oder Verzeichnisnamen die Groß- und Kleinschreibungbeachtet werden. Wenn Sie z.B. einen Pfad wie /home/nikita/downloads eingeben, wird ein Fehler

angezeigt, wenn der Verzeichnisname in Wirklichkeit /home/nikita/Downloads lautet.

· Verwenden Sie unter Linux oder macOS in Pfadnamen anstelle des umgekehrten Schrägstrichs denSchrägstrich vorwärts.

Ausführen eines Befehls1. Öffnen Sie ein Eingabeaufforderungsfenster.

a. Drücken Sie dazu unter Windows die Windows-Taste und beginnen Sie mit der Eingabe von cmd.Klicken Sie auf den angezeigten Vorschlag Command Prompt.

b. Um auf Mac einen Terminal zu öffnen, klicken Sie auf das Such-Symbol und wählen Sie im Menüanschließend den Befehl Go > Utilities. Doppelklicken Sie im Fenster "Utilities" auf dasTerminal-Symbol.

c. Wenn Sie Linux über eine grafische Benutzeroberfläche ausführen, navigieren Sie zum jeweiligenTerminal-Befehl Ihrer Linux-Distribution und führen Sie ihn aus. Ignorieren Sie diesen Schritt,wenn Sie Linux über eine Befehlszeilenschnittstelle ausführen.

2. Geben Sie den vollständigen Pfad zur ausführbaren Datei, gefolgt vom gewünschten Befehl ein. Mit dennachstehenden Befehl können Sie z.B. die Hilfe in der Befehlszeile aufrufen.

Linux /opt/Altova/MapForceServer2020/bin/mapforceserver help

macOS /usr/local/Altova/MapForceServer2020/bin/mapforceserver help

Windows C:\Programme (x86)\Altova\MapForceServer2020\bin\MapForceServer.exe help

Im obigen Beispiel wurde der Befehl help ohne Optionen oder Argumente ausgeführt. Andere Befehle haben

manchmal Argumente und Optionen, die obligatorisch oder optional sein können. So hat z.B. der Befehl run

ein obligatorisches Argument, mit dem Sie den Pfad oder Namen der auszuführenden .mfx-Datei angebenkönnen. Nähere Informationen zu den einzelnen Befehlen finden Sie im Abschnitt "Referenz".

Aufruf von MapForce Server im InstallationsverzeichnisUm die ausführbare Datei aufzurufen, ohne den vollständigen Pfad eingeben zu müssen, wechseln Sie in dasVerzeichnis, in dem die ausführbare MapForce Server-Datei installiert wurde, z.B:

© 2020 Altova GmbH

37MapForce Server-Befehlszeile


Linux cd /opt/Altova/MapForceServer2020/bin

macOS cd /usr/local/Altova/MapForceServer2020/bin

Windows cd "C:\Programme (x86)\Altova\MapForceServer2020\bin\MapForceServer.exe"

Sie können jeden beliebigen Befehl nun einfach durch Eingabe des Namens der ausführbaren Datei ausführen,z.B:

Linux ./mapforceserver help

macOS ./mapforceserver help

Windows MapForceServer.exe help

Anmerkung: Auf Linux- und macOS-Systemen gibt das Präfix ./ an, dass sich die ausführbare Datei im

aktuellen Verzeichnis befindet.

Aufruf von MapForce Server von jedem beliebigen Verzeichnis ausUm die ausführbare Datei von jedem beliebigen Verzeichnis aus aufzurufen, geben Sie den absoluten Pfad ein.Wenn Sie das Programm alternativ dazu nur durch Eingabe des Namens der ausführbaren Datei aufrufenmöchten, können Sie die Umgebungsvariable PATH Ihres Betriebssystems bearbeiten, sodass diese denvollständigen Pfad zum MapForce Server-Installationsverzeichnis enthält. PATH kann auf verschiedene Artengeändert werden. Hier einige Beispiele:

Linux export PATH=$PATH:/opt/Altova/MapForceServer2020/bin

macOS Bearbeiten Sie die Datei etc/paths und fügen Sie den folgenden Pfad hinzu:

/usr/local/Altova/MapForceServer2020/bin

Windows SETX PATH "C:\Programme (x86)\Altova\MapForceServer2020\bin;%PATH%"

Anmerkung: Damit die Änderungen wirksam werden, müssen Sie eventuell das Terminal-Fenster schließenund ein neues öffnen.

38 MapForce Server-Befehlszeile assignlicense (nur Windows)


4.1 assignlicense (nur Windows)

Syntax und BeschreibungDer Befehl assignlicense steht nur unter Windows (nicht aber auf Linux- oder Mac-Systemen) zur Verfügung.

Mit diesem Befehl wird eine Lizenzdatei auf den Altova LicenseServer, auf dem MapForce Server registriert ist(siehe Befehl licenseserver) hochgeladen und die Lizenz wird MapForce Server zugewiesen. Der Befehlerhält den Pfad einer Lizenzdatei als Argument. Außerdem können Sie mit dem Befehl die Gültigkeit einerLizenz überprüfen.

mapforceserver assignlicense [options] FILE

· Das Argument FILE erhält den Pfad der Lizenzdatei.

· Mit der Option --test-only wird die Lizenzdatei auf LicenseServer hochgeladen und auf ihre Gültigkeitüberprüft. Sie wird jedoch MapForce Server nicht zugewiesen.

Nähere Informationen zur Lizenzierung finden Sie in der Dokumentation zu LicenseServer(https://www.altova.com/manual/de/AltovaLicenseServer/).

Groß- und Kleinschreibung und Schrägstriche in der Befehlszeile

MapForceServer unter Windows

mapforceserver unter Windows und Unix (Linux, Mac)

* Beachten Sie, dass klein geschriebene Befehle (mapforceserver) auf allen Plattformen (Windows, Linuxund Mac) funktionieren, während großgeschriebene Befehle (MapForceServer) nur unter Windows undMac ausgeführt werden.*Verwenden Sie auf Linux und Mac-Systemen Schrägstriche und auf Windows-Systemen umgekehrteSchrägstriche.

Umgekehrte Schrägstriche und Leerzeichen auf Windows-Systemen

Auf Windows-Systemen: Verwenden Sie bei Vorhandensein von Leerzeichen (z.B. in Datei- oderOrdnernamen oder Firmen-, Personen- oder Produktnamen) Anführungszeichen: z.B., "Meine Datei".

Beachten Sie jedoch, dass ein von einem doppelten Anführungszeichen gefolgter umgekehrterSchrägstrich (z.B: "C:\Mein Verzeichnis\") eventuell nicht korrekt gelesen wird, da der umgekehrte

Schrägstrich auch den Beginn einer Escape-Sequenz markiert und die Escape-Sequenz \" für ein

doppeltes Anführungszeichen steht. Wenn Sie diese Zeichensequenz mit einem Escape versehen wollen,verwenden Sie einen vorangestellten umgekehrten Schrägstrich, wie den folgenden: \\". Einfacher

ausgedrückt: Wenn Sie einen Dateipfad, der Leerzeichen und einen umgekehrten Schrägstrich am Endeenthält, schreiben müssen, so schreiben Sie diesen folgendermaßen: "C:\Mein Verzeichnis\\".

BeispieleBeispiele für den Befehl assignlicense:

mapforceserver assignlicense C:\licensepool\mylicensekey.lic

mapforceserver assignlicense --test-only=true C:\licensepool\mylicensekey.lic

· Mit dem ersten Befehl oben wird die angegebene Lizenzdatei auf LicenseServer hochgeladen undMapForce Server zugewiesen.

https://www.altova.com/manual/de/AltovaLicenseServer/

© 2020 Altova GmbH

assignlicense (nur Windows) 39MapForce Server-Befehlszeile


· Mit dem letzten Befehl wird die angegebene Lizenz auf LicenseServer hochgeladen und auf ihreGültigkeit überprüft, ohne sie MapForce Server zuzuweisen.

OptionenOptionen werden in ihrer kurzen Form (falls verfügbar) und in ihrer langen Form aufgelistet. Für die kurze unddie lange Form können ein oder zwei Bindestriche verwendet werden. Eine Option kann, muss aber keinenWert erhalten. Eine Option, die einen Wert erhält, wird folgendermaßen geschrieben: --option=wert. Werte

können außer in zwei Fällen ohne Anführungszeichen definiert werden: (i) wenn der Wertestring Leerzeichenenthält oder (ii) wenn in der Beschreibung der Option explizit erwähnt ist, dass Anführungszeichen zwingenderforderlich sind. Wenn eine Option einen Booleschen Wert erhält und kein Wert definiert ist, so ist derStandardwert der Option TRUE. Mit Hilfe der Option --h, --help können Sie Informationen über den Befehl

anzeigen.

test-only [t]

--t, --test-only = true|false

Die Werte sind true|false. Bei true wird die Lizenzdatei auf LicenseServer hochgeladen und auf ihreGültigkeit überprüft, aber nicht zugewiesen.

40 MapForce Server-Befehlszeile exportresourcestrings


4.2 exportresourcestrings

Syntax und BeschreibungDer Befehl exportresourcestrings gibt eine XML-Datei aus, die die Ressourcenstrings der MapForce Server-

Applikation in der definierten Sprache enthält. Als Exportsprachen stehen Englisch (en), Deutsch (de),Spanisch (es), Französisch (fr) und Japanisch (ja) zur Verfügung.

mapforceserver exportresourcestrings [options] LanguageCode XMLOutputFile

· Das Argument LanguageCode gibt die Sprache der Ressourcenstrings in der XML-Ausgabedatei an;

dies ist die Exportsprache. Derzeit unterstützte Exportsprachen sind (mit den Sprachcodes inKlammern): Englisch (en), Deutsch, (de), Spanisch (es), Französisch (fr) und Japanisch (ja).

· Das Argument XMLOutputFile definiert den Namen und Pfad der XML-Ausgabedatei.

Eine Anleitung zum Erstellen von Lokalisierungen finden Sie weiter unten.











BeispieleBeispiele für den Befehl exportresourcestrings:

mapforceserver exportresourcestrings en c:\Strings.xml

· Mit dem Befehl oben wird unter c:\ eine Datei namens Strings.xml erstellt, die alleRessourcenstrings der MapForce Server Applikation in englischer Sprache enthält.

© 2020 Altova GmbH

exportresourcestrings 41MapForce Server-Befehlszeile


Erstellen lokalisierter Versionen von MapForce ServerSie können für jede Sprache Ihrer Wahl eine lokalisierte Version von MapForce Server erstellen. Im Ordner C:\Programme (x86)\Altova\MapForceServer2020\bin stehen fünf lokalisierte Versionen (Englisch, Deutsch,Spanisch, Französisch und Japanisch) bereits zur Verfügung. Eine Lokalisierung für diese Sprache ist dahernicht mehr notwendig.

Folgendermaßen können Sie eine lokalisierte Version erstellen:

1. Generieren Sie mit Hilfe des Befehls exportresourcestrings (siehe Befehlssyntax oben) eine XML-Datei, die die Ressourcenstrings enthält. Die Ressourcenstrings in dieser XML-Datei sind in einer derfünf unterstützten Sprachen: je nachdem, welches LanguageCode-Argument mit dem Befehl verwendet

wird, in Englisch (en), Deutsch (de), Spanisch (es), Französisch (fr) oder Japanisch (ja).2. Übersetzen Sie die Ressourcenstrings aus einer der fünf unterstützten Sprachen in die Zielsprache.

Die Ressourcenstrings bilden den Inhalt der <string> Elemente in der XML-Datei. Übersetzen Siekeine Variablen in geschweiften Klammern wie z.B. {option} oder {product}.

3. Wenden Sie sich an den Altova Support, um anhand Ihrer übersetzten XML-Datei eine lokalisierteMapForce Server DLL-Datei zu generieren.

4. Nachdem Sie Ihre lokalisierte DLL-Datei vom Altova Support erhalten haben, speichern Sie diese unterC:\Programme (x86)\Altova\MapForceServer2020\bin. Ihre DLL-Datei wird einen Namen in derForm MapForceServer2020_lc.dll haben. Der lc Teil des Namens enthält den Sprachencode. Sosteht z.B. in MapForceServer2020_de.dll der Teil de für Deutsch.

5. Führen Sie den Befehl setdeflang aus, um Ihre lokalisierte DLL als die zu verwendende MapForceServer Applikation zu definieren. Verwenden Sie den Sprachencode, der Teil des DLL-Namens ist, alsArgument des Befehls setdeflang.

Anmerkung: Altova MapForce Server ist mit Unterstützung für fünf Sprachen erhältlich: Englisch, Deutsch,Spanisch, Französisch und Japanisch. Sie müssen daher keine lokalisierte Version dieser Sprachenerstellen. Um eine dieser Sprachen als Standardsprache festzulegen, verwenden Sie den MapForceServer Befehl setdeflang.

http://www.altova.com/support

http://www.altova.com/support

42 MapForce Server-Befehlszeile help


4.3 help

Syntax und BeschreibungDer Befehl help hat ein einziges Argument (Command): den Namen des Befehls, zu dem die Hilfe benötigt wird.

Er zeigt die korrekte Syntax des Befehls, seine Optionen sowie andere relevante Informationen an. Wenn dasArgument Command nicht angegeben wird, werden alle Befehle der ausführbaren Datei aufgelistet, wobei zujedem eine kurze Textbeschreibung angezeigt wird.

mapforceserver help Command





BeispielBeispiel für den Befehl help, um Informationen über den Befehl licenserver anzuzeigen:

mapforceserver help licenserver

Die Option --helpDie Hilfe zu einem Befehl kann auch über die Option --help im Anschluss an diesen Befehl aufgerufen werden. Mit den beiden unten stehenden Befehlen erhalten Sie dasselbe Ergebnis:

mapforceserver licenseserver --help

Im obigen Befehl wird die Option --help des Befehls licenserver verwendet.

mapforceserver help licenseserver

Der Befehl help erhält licenseserver als Argument.

In beiden Fällen wird die Hilfe zum Befehl licenseserver angezeigt.

© 2020 Altova GmbH

licenseserver 43MapForce Server-Befehlszeile


4.4 licenseserver

Syntax und BeschreibungBei Ausführung des Befehls licenseserver wird MapForce Server auf dem durch das Argument Server-Or-

IP-Address definierten LicenseServer registriert. Damit der Befehl licenseserver erfolgreich ausgeführt

werden kann, müssen sich die beiden Server (MapForce Server und LicenseServer) im selben Netzwerkbefinden und LicenseServer muss ausgeführt werden. Außerdem benötigen Sie zum Registrieren von MapForceServer auf dem LicenseServer Administratorrechte.

mapforceserver licenseserver [options] Server-Or-IP-Address

· Das Argument Server-Or-IP-Address erhält den Namen oder die IP-Adresse des LicenseServer-

Rechners.· Um eine Evaluierungslizenz für MapForce Server anzufordern, geben Sie die entsprechenden Werte für

die Optionen --company, --email und --name an. Um eine Evaluierungslizenz für ein zusätzlichesAltova-Produkt (d.h. zusätzlich zu MapForce Server) anzufordern, fügen Sie die Option --request-eval-license mit einem Wert, der dem Name dieses Produkts entspricht, hinzu. NähereInformationen dazu finden Sie in der Liste weiter unten.

Sobald MapForce Server erfolgreich auf dem LicenseServer registriert wurde, erhalten Sie eine entsprechendeMeldung. Darin wird auch die URL des LicenseServer angezeigt. Sie können nun zu LicenseServer wechselnund MapForce Server eine Lizenz zuweisen. Nähere Informationen dazu finden Sie in der Dokumentation zuLicenseServer (https://www.altova.com/manual/de/AltovaLicenseServer/).











BeispieleBeispiele für den Befehl licenseserver:


44 MapForce Server-Befehlszeile licenseserver


mapforceserver licenseserver DOC.altova.com

mapforceserver licenseserver localhost

mapforceserver licenseserver 127.0.0.1

Die Befehle oben definieren den Rechner namens DOC.altova.com und den Rechner des Benutzers(localhost bzw. 127.0.0.1) als den Rechner, auf dem Altova LicenseServer ausgeführt wird. In jedem dieserFälle wird MapForce Server auf dem LicenseServer auf dem angegebenen Rechner registriert. Mit dem letztenBefehl wird zum Ausführen des Befehls die ausführbare Server-Datei aufgerufen.



anzeigen.

json [j]

--j, --json = true|false

Die Werte sind true|false. Bei true wird das Ergebnis des Registrierungsversuchs als JSON-Objektausgegeben, das von Rechnern geparst werden kann.

© 2020 Altova GmbH

run 45MapForce Server-Befehlszeile


4.5 run

Der Befehl run führt eine als Argument bereitgestellte MapForce Server-Ausführungsdatei (.mfx-Datei) aus. DieMapForce Server-Ausführungsdatei wird mit MapForce erstellt. Es handelt sich dabei im Grunde um ein für dieServer-Ausführung kompiliertes Mapping.

Für das Mapping erforderliche Input-Dateien müssen sich unter dem Pfad befinden, der zum Zeitpunkt desMapping-Designs in MapForce definiert wurde. Wenn MapForce Server nicht auf demselben Betriebssystemwie MapForce ausgeführt wird, müssen die für das Mapping erforderlichen Input-Dateien zusammen mit der.mfx.-Datei auf den Zielrechner kopiert und über einen relativen Pfad referenziert werden. Informationen zumKonfigurieren eines Mappings im Hinblick auf relative oder absolute Pfade finden Sie in der MapForce-Dokumentation (https://www.altova.com/de/documentation#mapforce). Je nach Mapping-Design müssen auchandere Voraussetzungen erfüllt werden, siehe Vorbereiten von Mappings für die Server-Ausführung .

Wenn das Ergebnis des Mappings ein einfacher Wert wie z.B. ein String ist, wird diese Ausgabe in den stdout(Standard Output) Stream geschrieben. Die Erfolgs- und Fehlermeldungen wiederum stehen im stderr(Standard Error) Stream zur Verfügung. Wenn Sie nicht möchten, dass der Standardausgabe-Streamzusammen mit den Erfolgs- oder Fehlermeldungen auf dem Bildschirm angezeigt wird, leiten Sie entweder denStandardausgabe- oder den Standard Error Stream (oder beide) in Dateien um. Wenn weder der stdout nochder stderr Stream umgeleitet wird, werden beide kombiniert auf dem Bildschirm angezeigt.

Um z.B. den Standardausgabe-Stream in eine Datei umzuleiten, verwenden Sie den folgenden Befehl:

mapforceserver run MyMapping.mfx > MyOutput.txt

Um den Standard Error-Stream in eine Datei umzuleiten, verwenden Sie den Befehl:

mapforceserver run MyMapping.mfx 2> Diagnostics.log

Um beide Streams gleichzeitig umzuleiten, verwenden Sie den Befehl:

mapforceserver run MyMapping.mfx > MyOutput.txt 2> Diagnostics.log

Nähere Informationen zum Umleiten von Streams finden Sie in der Dokumentation zur Befehls-Shell IhresBetriebssystems.

Syntax

Windows MapForceServer run [options] MfxFile

Linux mapforceserver run [options] MfxFile

Mac mapforceserver run [options] MfxFile




20

https://www.altova.com/de/documentation#mapforce

46 MapForce Server-Befehlszeile run



Vermeiden Sie auf Windows-Systemen in der Befehlszeile die Verwendung eines umgekehrten Schrägstrichsund eines schließenden Anführungszeichens \" z.B. "C:\My directory\". Diese beiden Zeichen werdenvom Befehlszeilenparser als Literal für ein doppeltes Anführungszeichen interpretiert. Verwenden Sie dendoppelten umgekehrten Schrägstrich \\, falls in der Befehlszeile Leerzeichen vorkommen und Sie dieAnführungszeichen benötigen ( "C:\My Directory\\").

Befehlsoptionen

--catalog Definiert den absoluten Pfad zu einer Root-Katalog-Datei, die nichtdie installierte Root-Katalog-Datei ist. Der Standardwert ist derabsolute Pfad zur installierten Root-Katalog-Datei.Form: --catalog=FILE

--cert -certificatespath Dieser Befehl gilt für MapForce Server, wenn er auf Linuxausgeführt wird. Damit wird der Pfad zu dem Verzeichnis definiert,in dem für das Mapping benötigte Zertifikatdateien gespeichert sindForm: --certificatespath=DIRECTORY

Siehe auch Verwaltung digitaler Zertifikate

--cred --credential=KEY:VALUE Diese Option ist anwendbar, wenn das MappingAnmeldeinformationen enthält, die Sie zum Zeitpunkt des Designsdes Mappings in MapForce definiert haben. KEY ist der Namen derAnmeldeinformationen, wie er in MapForce definiert wurde. VALUEbestehte aus einem oder mehreren Name-Wert-Paaren, z.B:

name1=value1&name2=value2

Hierbei ist name einer der folgenden:

· username· password· oauth:token

Wenn Sie mehrere durch das Kaufmännische Und-Zeichengetrennte Name-Wert-Paare verwenden, setzen Sie das KEY:VALUE-Paar in Anführungszeichen, siehe Anmeldeinformationen .

--gc --globalresourceconfig Diese Option ist anwendbar, wenn im Mapping globaleRessourcen verwendet werden. Sie definiert den Namen derKonfiguration für globale Ressourcen (Alias). Diese Option musszusammen mit der Option --globalresourcefile verwendetwerden.Form: --gc=VALUE

31

26

© 2020 Altova GmbH

run 47MapForce Server-Befehlszeile


--gr --globalresourcefile Diese Option ist anwendbar, wenn im Mapping globaleRessourcen verwendet werden. Sie definiert den Pfad zurDefinitionsdatei für globale Ressourcen. Diese Option musszusammen mit der Option --globalresourceconfig verwendetwerden.Form: --gr=FILE.

--l --lang Die Sprache, in der Meldungen angezeigt werden.Form: --lang=VALUE (en,de,ja,es)

--p --param Diese Option ist anwendbar, wenn für das Mapping Input-Parameterverwendet werden. Damit wird einem im Mapping definiertenParameter ein Wert zugewiesen. Form: --param=ParamName:ParamValue. Vor jedem Parameter muss die

Option --param verwendet werden. Verwenden SieAnführungszeichen, wenn ParamName oder ParamValue ein

Leerzeichen enthält. Beispiel: --p=company:"Nanonull Inc".

Nähere Informationen zu Mappings, die Input-Parameter erhalten,finden Sie in der MapForce-Dokumentation(https://www.altova.com/de/documentation#mapforce).

--taxonomy-package Definiert den absoluten Pfad zu einem zusätzlichen in derTaxonomy Packages 1.0 Recommendation beschriebenen XBRL-Taxonomiepaket. Der Wert FILE gibt den Pfad desTaxonomiepakets an. Fügen Sie die Option mehrmals hinzu, ummehr als ein Taxonomiepaket zu definieren.Form: --taxonomy-package=FILE

--taxonomy-packages-config-file

Definiert den Pfad zu einer Konfigurationsdatei namensTaxonomyPackagesConfig.json, anhand welcher XBRL-Taxonomiepakete geladen werden. Diese Konfigurationsdatei wirdjedes Mal, wenn Sie XBRL-Taxonomiepakete über die grafischeBenutzeroberfläche von XMLSpy, MapForce oder StyleVisionhinzufügen, entfernen, aktivieren oder deaktivieren, aktualisiert.Wenn Sie über eines der oben erwähnten Produktebenutzerdefinierte XBRL-Taxonomiepakete hinzugefügt haben, sobefindet sich die Datei unter C:\Benutzer\<Benutzername>\Documents\Altova.Form: --taxonomy-packages-config-file=FILE

BeispieleIn diesem Beispiel wird gezeigt, wie Sie eine Mapping-Ausführungsdatei (.mfx) mit MapForce Server unterWindows ausführen. In dem in diesem Beispiel beschriebenen Mapping wird die Input-Datei Employees.xmlausgelesen und es werden zwei Ausgabedateien erzeugt (PersonList.xml und Contacts.xml).

Zuerst wird die MapForce Server-Ausführungsdatei (.mfx) folgendermaßen generiert:

1. Starten Sie Altova MapForce und öffnen Sie die folgende MapForce Design-Datei (.mfd-Datei): C:\Benutzer\<Benutzer>\Dokumente\Altova\MapForce2020\MapForceExamples\ChainedPersonList.mfd.

26

https://www.altova.com/de/documentation#mapforce

https://www.xbrl.org/Specification/taxonomy-package/REC-2016-04-19/taxonomy-package-REC-2016-04-19.html

48 MapForce Server-Befehlszeile run


2. Klicken Sie im Menü Datei auf den Befehl Zu MapForce Server-Ausführungsdatei kompilieren.3. Wenn Sie dazu aufgefordert werden, speichern Sie die .mfx-Datei im Verzeichnis C:\temp. Dieses

Verzeichnis wird bei der Ausführung durch MapForce Server als Arbeitsverzeichnis verwendet.

Öffnen Sie als nächstes eine Eingabeaufforderung und ändern Sie das Arbeitsverzeichnis in C:\temp\.

cd C:\temp

Führen Sie schließlich den folgenden Befehl aus, um ChainedPersonList.mfx auszuführen. In diesemBeispiel wird MapForce Server über einen absoluten Pfad aufgerufen. (Um das Programm über einen relativenPfad aufzurufen, fügen Sie den Pfad zur ausführbaren Datei zu PATH-Umgebungsvariablen Ihres Systemshinzu).

"C:\Programme (x86)\Altova\MapForceServer2020\bin\MapForceServer.exe" runChainedPersonList.mfx

Die beiden Ausgabedateien (PersonList.xml und Contacts.xml) werden im Arbeitsverzeichnis generiert.Beachten Sie, dass in diesem Mapping die Verwendung von absoluten Pfaden konfiguriert wurde. Aus diesemGrund konnte das Mapping erfolgreich ausgeführt werden und die Input-Datei Employees.xml musste sichnicht im Arbeitsverzeichnis befinden. Die Datei Employees.xml befindet sich im oben erwähnten OrdnerMapForce Examples und wird über einen absoluten Pfad referenziert. Um anzugeben, ob Pfade als absoluteoder relative Pfad behandelt werden sollen, klicken Sie in MapForce mit der rechten Maustaste in das Mapping,wählen Sie Mapping-Einstellungen und aktivieren bzw. deaktivieren Sie anschließend das KontrollkästchenPfade im generierten Code absolut machen. Immer, wenn Sie die Mapping-Einstellungen ändern, müssenSie das Mapping erneut zu einer .mfx-Datei kompilieren. Nähere Informationen dazu finden Sie unterVorbereiten von Mappings für die Server-Ausführung .20

© 2020 Altova GmbH

setdeflang 49MapForce Server-Befehlszeile


4.6 setdeflang

Syntax und BeschreibungDer Befehl setdeflang (Kurzform ist sdl) definiert die Standardsprache von MapForce Server. Verfügbare

Sprachen sind Englisch (en), Deutsch (de), Spanisch (es), Französisch (fr) und Japanisch (ja). Er akzeptiertein obligatorisches Argument LanguageCode.

mapforceserver setdeflang [options] LanguageCode

· Das Argument LanguageCode definiert die Standardsprache von MapForce Server. Die entsprechenden

Werte sind: en, de, es, fr, ja.· Mit Hilfe der Option --h, --help können Sie Informationen über den Befehl anzeigen.





BeispieleBeispiele für den Befehl setdeflang (sdl):

mapforceserver sdl en

mapforceserver setdeflang es

· Mit dem ersten Befehl wird als Standardsprache von MapForce Server Englisch definiert.· Mit dem zweiten Befehl wird als Standardsprache von MapForce Server Spanisch definiert.

OptionenMit Hilfe der Option --h, --help können Sie Informationen über den Befehl anzeigen.

50 MapForce Server-Befehlszeile verifylicense (nur Windows)


4.7 verifylicense (nur Windows)

Syntax und BeschreibungMit dem Befehl verifylicense wird überprüft, ob das aktuelle Produkt lizenziert ist. Zusätzlich können Sie mit

der Option --license-key überprüfen, ob dem Produkt bereits ein bestimmter Lizenzschlüssel zugewiesenwurde. Dieser Befehl wird nur auf Windows-Systemen, nicht aber unter Linux oder Max unterstützt.

mapforceserver verifylicense [options]

· Um zu überprüfen, ob MapForce Server eine bestimmte Lizenz zugewiesen ist, geben Sie denLizenzschlüssel als Wert der Option --license-key an.

Nähere Informationen zur Lizenzierung finden Sie in der LicenseServer-Dokumentation(https://www.altova.com/manual/de/AltovaLicenseServer/)..





BeispieleBeispiele für den Befehl verifylicense:

mapforceserver verifylicense mapforceserver verifylicense --license-key=ABCD123-ABCD123-ABCD123-ABCD123-ABCD123-

ABCD123

· Mit dem ersten Befehl wird überprüft, ob MapForce Server lizenziert ist.· Mit dem zweiten Befehl wird überprüft, ob MapForce Server mit dem in der Option --license-key

definierten Lizenzschlüssel lizenziert ist.



anzeigen.

license-key [l]


© 2020 Altova GmbH

verifylicense (nur Windows) 51MapForce Server-Befehlszeile


--l, --license-key = Value

Überprüft, ob MapForce Server mit dem als Wert dieser Option definierten Lizenzschlüssel lizenziert ist.

52 MapForce Server-Befehlszeile version


4.8 version

Syntax und BeschreibungMit dem Befehl version wird die Versionsnummer von MapForce Server angezeigt.

mapforceserver version





BeispielBeispiel für den Befehl version:

mapforceserver version

© 2020 Altova GmbH

53MapForce Server API


5 MapForce Server API

MapForce Server bietet eine API (Application Programming Interface), die Sie programmatisch über Ihren .NET-, Java- oder COM-basierten Code aufrufen können.

In den folgenden Kapiteln finden Sie eine Einführung in die einzelnen Plattformen:

· .NET-Schnittstelle· COM-Schnittstelle· Java-Schnittstelle

In den folgenden Kapiteln finden Sie eine technische Beschreibung der API:

· API-Referenz (COM, .NET)· API-Referenz (Java)

54

61

70

81

90

54 MapForce Server API .NET-Schnittstelle


5.1 .NET-Schnittstelle

Die .NET-Schnittstelle ist als Wrapper rund um die COM-Schnittstelle gebaut. Sie dient als primäre von Altovasignierte Interop-Assembly und verwendet den Namespace Altova.MapForceServer. MapForce Server wirdbei der Installation automatisch als COM-Serverobjekt registriert und muss daher nicht manuell registriertwerden.

Um MapForce Server in Ihrem .NET-Projekt verwenden zu können, fügen Sie, wie unten gezeigt, eine Referenzzur Datei Altova.MapForceServer.dll hinzu. Die Datei Altova.MapForceServer.dll befindet sich imOrdner bin des MapForce Server-Installationsordners. Diese .dll-Datei wird bei der Installation von MapForceServer automatisch zum Global Assembly Cache (GAC) hinzugefügt.

Anmerkung: Vor der .NET Framework 4.0-Version befand sich der GAC im Verzeichnis %windir%\assembly. Ab der .NET Framework 4.0-Version befindet sich der GAC im Verzeichnis %windir%\Microsoft.NET\assembly. Der Teil %windir% steht für das Windows-Betriebssystemverzeichnis,normalerweise C:\Windows.

So fügen Sie in einem Visual Studio .NET-Projekt eine Referenz zur MapForce Server DLL hinzu

1. Klicken Sie bei geöffnetem .NET-Projekt auf Project | Add Reference.

© 2020 Altova GmbH

.NET-Schnittstelle 55MapForce Server API


2. Navigieren Sie auf dem Register "Browse" zum Ordner: <MapForceServer application

folder>/bin, wählen Sie die Datei Altova.MapForceServer.dll aus und klicken Sie auf OK.

Mit dem Visual Studio Object Browser sehen Sie die Struktur der Altova.MapForceServer Assembly (klickenSie dazu im Menü View auf den Befehl Object Browser).

5.1.1 C#-Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie eine Mapping-Ausführungsdatei (.mfx) über C#-Code ausführen.Unter Windows stehen die Beispieldateien unter dem folgenden Pfad zur Verfügung: C:\Programme\Altova\MapForceServer2020\etc\Examples.

Voraussetzungen· MapForce Server ist installiert und lizenziert.· Wenn Sie ein neues Visual Studio-Projekt erstellen, fügen Sie eine Referenz zur MapForce Server

Assembly hinzu (siehe Informationen zur .NET-Schnittstelle ). Sie können diesen Schrittüberspringen, wenn Sie das vorhandene MapForce Server API-Beispiel ausführen, da die MapForceServer Assembly darin bereits referenziert wird.

· Klicken Sie im Menü Build von Visual Studio auf Configuration Manager und definieren Sie einekorrekte Build-Plattform, z.B. Debug | x86 (oder gegebenenfalls Debug | x64). Verwenden Sie nicht"Any CPU" als Plattform.

· Wenn Sie eine MapForce Server 64-Bit-Version installiert haben, so muss auch die Applikation, die dieAPI aufruft (wie z.B. die unten gezeigte Beispielapplikation) für die 64-Bit-Plattform in Visual Studioerstellt sein. Außerdem muss der Pfad zur ausführbaren MapForce Server-Datei im Code entsprechendangepasst werden.

Die Beispiellösung befindet sich im Verzeichnis "Programme", für das Sie Administratorrechte benötigen.Starten Sie Visual Studio entweder als Administrator oder kopieren Sie die Lösung in einen anderenOrdner, für den Sie keine Administratorrechte benötigen.

Ausführen des Mapping-CodesMit dem nachstehenden Code werden drei Server-Ausführungsdateien (.mfx) ausgeführt. Die Tabelle untenenthält eine Liste der von den einzelnen .mfx.-Dateien erwarteten Input-Dateien sowie der nach der Ausführungerstellten Ausgabedateien.

Ausführungsdatei (.mfx) Input Augabe

TokenizeString.mfx AltovaTools.xml AltovaToolsFeatures.csv

SimpleTotal.mfx ipo.xml String

ClassifyTemperatures.mfx Temperatures.xml Temperatures_out.xml

Wenn Sie Altova MapForce installiert haben, haben Sie die Möglichkeit, sich zum besseren Verständnis dieOriginal-Mappings, anhand derer die .mfx-Dateien kompiliert wurden, anzusehen. Diese haben die NamenTokenizeString1.mfd, SimpleTotal.mfd bzw. ClassifyTemperatures.mfd. Sie finden die Mapping imfolgenden Verzeichnis: C:\Benutzer\<Benutzer>\Altova\MapForce2020\MapForceExamples.

54



In diesem Beispiel geschieht Folgendes:

· Es wird eine neue Instanz von Altova.MapForceServer.Server erstellt. Dies ist das Objekt, mit demSie später arbeiten werden.

· Darin wird ein Arbeitsverzeichnis konfiguriert, in dem die Dateien ausgeführt werden. Die Input-Dateiensollten in diesem Verzeichnis vorhanden sein, falls Sie diese über einen relativen Pfad referenzierthaben. Auch die Ausgabedateien werden in diesem Verzeichnis erstellt (siehe Tabelle oben).

· TokenizeString.mfx wird ausgeführt. Der Dateipfad wird als Argument für die Methode Runbereitgestellt (Beachten Sie, dass der Pfad relativ zum zuvor definierten Arbeitsverzeichnis ist). Nacherfolgreicher Ausführung wird im Arbeitsverzeichnis eine .csv-Datei, die die Mapping-Ausgabe darstellt,erstellt.

· SimpleTotal.mfx wird ausgeführt. Auch hier ist der Dateipfad wieder relativ zum Arbeitsverzeichnis.Mit diesem Mapping wird eine String-Ausgabe erzeugt, daher wird die Methode GetOutputParameter

aufgerufen, um die String-Ausgabe zu erhalten.· ClassifyTemperatures.mfx wird ausgeführt. In diesem Mapping wird ein Parameter als Input erwartet,

der mit Hilfe der Methode AddParameter bereitgestellt wurde.

namespace MapForceServerAPI_sample

{ class Program

{ static void Main(string[] args)

{ try

{ // Create a MapForce Server object Altova.MapForceServer.Server objMFS = new Altova.MapForceServer.Server();

// Set a working directory - used as a base for relative paths (you mayneed to adapt the path to the installation folder) objMFS.WorkingDirectory = "..\\..\\..";

// Default path to the MapForce Server executable is the installationpath (same dir with the MapForceServer.dll) // In case you moved the binaries on the disk, you need to explicitly setthe path to the .exe file // objMFS.ServerPath = "C:\\Program Files (x86)\\Altova\\MapForceServer2020\\bin\\MapForceServer.exe"; // objMFS.ServerPath = "C:\\Program Files\\Altova\\MapForceServer2020\\bin\\MapForceServer.exe";

System.Console.WriteLine("Running " + objMFS.ProductNameAndVersion + ".\n");

// Set global resource file and configuration, if your mapping usesglobal resources // objMFS.SetOption( "globalresourcefile", "GlobalResource.xml" ); //"gr" can be used as short name for "globalresourcefile" // objMFS.SetOption( "globalresourceconfig", "Default" ); // "gc" can beused as short name for "globalresourceconfig"

//----------------------------------------------------------------------------------

© 2020 Altova GmbH



// An example with input and output paths stored inside the MFX file System.Console.WriteLine("\nExecuting TokenizeString.mfx..."); if (objMFS.Run("TokenizeString.mfx"))

System.Console.WriteLine("Successfully generated file'AltovaToolFeatures.csv'."); else

{ // execution failed. maybe no write permissions in working directory?Run this program as administrator. System.Console.WriteLine(objMFS.LastExecutionMessage); }

//---------------------------------------------------------------------------------- // An example creating a simple output so that we can retrieve the resultexplicitly System.Console.WriteLine("\nExecuting SimpleTotal.mfx..."); if (objMFS.Run("SimpleTotal.mfx"))

System.Console.WriteLine("Mapping result is: " +objMFS.GetOutputParameter("total")); else

{ // execution failed (e.g. somebody deleted file ipo.xml) System.Console.WriteLine(objMFS.LastExecutionMessage); }

//---------------------------------------------------------------------------------- // an example with parameterized input // the default of 'lower = 5' gets changed to the value '10' // mfx reads file Temperatures.xml and writes its output toTemperatures_out.xml. System.Console.WriteLine("\nExecuting ClassifyTemperatures.mfx withparameter 'lower' set to '10' ..."); objMFS.AddParameter("lower", "10"); if (objMFS.Run("ClassifyTemperatures.mfx"))

System.Console.WriteLine("File Temperatures_out.xml has been writtensuccessfully."); else

{ // execution failed. maybe no write permissions in working directory?Run this program as administrator. System.Console.WriteLine(objMFS.LastExecutionMessage); } } catch (System.Runtime.InteropServices.COMException ex)

{ System.Console.WriteLine("Internal Error - " + ex.Message); } } }}



5.1.2 Visual Basic .NET-Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie eine Mapping-Ausführungsdatei (.mfx) über VB .NET-Codeausführen. Unter Windows stehen die Beispieldateien unter dem folgenden Pfad zur Verfügung: C:\Programme\Altova\MapForceServer2020\etc\Examples.

Voraussetzungen· MapForce Server ist installiert und lizenziert.· Wenn Sie ein neues Visual Studio-Projekt erstellen, fügen Sie eine Referenz zur MapForce Server

Assembly hinzu (siehe Informationen zur .NET-Schnittstelle ). Sie können diesen Schrittüberspringen, wenn Sie das vorhandene MapForce Server API-Beispiel ausführen, da die MapForceServer Assembly darin bereits referenziert wird.

· Klicken Sie im Menü Build von Visual Studio auf Configuration Manager und definieren Sie einekorrekte Build-Plattform, z.B. Debug | x86 (oder gegebenenfalls Debug | x64). Verwenden Sie nicht"Any CPU" als Plattform.

· Wenn Sie eine MapForce Server 64-Bit-Version installiert haben, so muss auch die Applikation, die dieAPI aufruft (wie z.B. die unten gezeigte Beispielapplikation) für die 64-Bit-Plattform in Visual Studioerstellt sein. Außerdem muss der Pfad zur ausführbaren MapForce Server-Datei im Code entsprechendangepasst werden.

Die Beispiellösung befindet sich im Verzeichnis "Programme", für das Sie Administratorrechte benötigen.Starten Sie Visual Studio entweder als Administrator oder kopieren Sie die Lösung in einen anderenOrdner, für den Sie keine Administratorrechte benötigen.









· Darin wird ein Arbeitsverzeichnis konfiguriert, in dem die Dateien ausgeführt werden. Die Input-Dateiensollten in diesem Verzeichnis vorhanden sein, falls Sie diese über einen relativen Pfad referenziert

54

© 2020 Altova GmbH



haben. Auch die Ausgabedateien werden in diesem Verzeichnis erstellt (siehe Tabelle oben). · TokenizeString.mfx wird ausgeführt. Der Dateipfad wird als Argument für die Methode Run

bereitgestellt (Beachten Sie, dass der Pfad relativ zum zuvor definierten Arbeitsverzeichnis ist). Nacherfolgreicher Ausführung wird im Arbeitsverzeichnis eine .csv-Datei, die die Mapping-Ausgabe darstellt,erstellt.




Option Explicit On

Module Program

Sub Main()

Try 'Create a MapForce Server object;

Dim objMFS As Altova.MapForceServer.Server = New Altova.MapForceServer.Server

'Set a working directory - used as a base for relative paths for the MapForce

server execution (.mfx) file.

'objMFS.WorkingDirectory = "C:\Program Files (x86)

\Altova\MapForceServer2020\etc\Examples"

objMFS.WorkingDirectory = "..\..\.."

'Default path to the MapForce Server executable is the installation path

(same dir with the MapForceServer.dll)

'In case you moved the binaries on the disk, you need to explicitly set the

path to the .exe file

'objMFS.ServerPath = "C:\Program Files (x86)

\Altova\MapForceServer2020\bin\MapForceServer.exe"

'objMFS.ServerPath = "C:\Program

Files\Altova\MapForceServer2020\bin\MapForceServer.exe"

'Set global resource file and configuration, if your mapping uses global

resources

'objMFS.SetOption("globalresourcefile", "GlobalResource.xml") '"gr" can be

used as short name for "globalresourcefile"

'objMFS.SetOption("globalresourceconfig", "Config2") '"gc" can be used as

short name for "globalresourceconfig"

'----------------------------------------------------------------------------

------

'An example with input and output paths stored inside the MFX file

System.Console.WriteLine(vbCrLf & "Executing TokenizeString.mfx...")

If (objMFS.Run("TokenizeString.mfx")) Then

System.Console.WriteLine("Successfully generated file

'AltovaToolFeatures.csv'.") Else

'execution failed. maybe no write permissions in working directory? Run



this program as administrator.

System.Console.WriteLine(objMFS.LastExecutionMessage)

End If

'----------------------------------------------------------------------------

------

'An example creating a simple output so that we can retrieve the result

explicitly

System.Console.WriteLine(vbCrLf & "Executing SimpleTotal.mfx...")

If (objMFS.Run("SimpleTotal.mfx")) Then

System.Console.WriteLine("Mapping result is: " &

objMFS.GetOutputParameter("total")) Else

'execution failed (e.g. somebody deleted file ipo.xml)


End If

'----------------------------------------------------------------------------

------

'an example with parameterized input

' the default of 'lower=5' gets changed to the value '10'

' mfx reads file Temperatures.xml and writes its output to

Temperatures_out.xml.

System.Console.WriteLine(vbCrLf & "Executing ClassifyTemperatures.mfx with

parameter 'lower' set to '10' ...") objMFS.AddParameter("lower", "10") If (objMFS.Run("ClassifyTemperatures.mfx")) Then

System.Console.WriteLine("File Temperatures_out.xml has been written

successfully.") Else

'execution failed. maybe no write permissions in working directory? Run

this program as administrator.


End If

Catch ex As Exception

System.Console.WriteLine("Internal Error - " & ex.Message())

End Try

End Sub

End Module

© 2020 Altova GmbH

COM-Schnittstelle 61MapForce Server API


5.2 COM-Schnittstelle

MapForce Server wird bei der Installation automatisch als COM-Serverobjekt registriert. Um zu überprüfen, obdie Registrierung erfolgreich war, öffnen Sie den Registrierungseditor (z.B. durch Eingabe von regedit.exe indie Befehlszeile). Wenn die Registrierung erfolgreich war, enthält die Registrierungsdatei die KlassenMapForce.Server. Diese beiden Klassen befinden sich normalerweise unterHKEY_LOCAL_MACHINE\SOFTWARE\Classes.

Nach Registrierung des COM-Serverobjekts können Sie es von Applikationen und Skriptsprachen aus mitUnterstützung für COM-Aufrufe aufrufen. Wenn Sie den Pfad des MapForce Server Installationspakets ändernmöchten, sollten Sie MapForce Server am besten zuerst deinstallieren und anschließend im gewünschtenOrdner installieren. Auf diese Art wird die Aufhebung der Registrierung und die erneute Registrierungautomatisch während der Installation vorgenommen.

5.2.1 C++-Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie eine Mapping-Ausführungsdatei (.mfx) über C++-Code ausführen.Unter Windows stehen die Beispieldateien unter dem folgenden Pfad zur Verfügung: C:\Programme\Altova\MapForceServer2020\etc\Examples.

VoraussetzungenBevor Sie den nachstehenden Code ausführen, stellen Sie sicher, dass die folgenden Voraussetzungen erfülltwerden:

· MapForce Server ist installiert und lizenziert.· MapForce Server steht als COM-Serverobjekt zur Verfügung (normalerweise geschieht dies

automatisch bei der Installation von MapForce Server; Informationen, wie Sie überprüfen, ob dieRegistrierung erfolgreich war, finden Sie unter Informationen zur COM-Schnittstelle ).








61

62 MapForce Server API COM-Schnittstelle



· Darin wird ein Arbeitsverzeichnis konfiguriert, in dem die Dateien ausgeführt werden. Die Input-Dateiensollten in diesem Verzeichnis vorhanden sein, falls Sie diese über einen relativen Pfad referenzierthaben. Auch die Ausgabedateien werden in diesem Verzeichnis erstellt (siehe Tabelle oben).

· TokenizeString.mfx wird ausgeführt. Der Dateipfad wird als Argument für die Methode Runbereitgestellt (Beachten Sie, dass der Pfad relativ zum zuvor definierten Arbeitsverzeichnis ist). Nacherfolgreicher Ausführung wird im Arbeitsverzeichnis eine .csv-Datei, die die Mapping-Ausgabe darstellt,erstellt.




// MapForceServerAPI_sample.cpp : Defines the entry point for the console application.

//

#include <iostream>#include "atlbase.h"

#ifndef _WIN64// 32-bit MapForce Server

#import "progid:MapForce.Server"#else// 64-bit MapForce Server

#import "progid:MapForce_x64.Server"#endif

int _tmain(int argc, _TCHAR* argv[])

{ CoInitialize( NULL );

try

{ // Create a MapForce Server object

MapForceServerLib::IServerPtr pMFS; CoCreateInstance( __uuidof( MapForceServerLib::Server ), NULL, CLSCTX_ALL,__uuidof( MapForceServerLib::IServer ), reinterpret_cast< void** >( &pMFS ) );

//Set a working directory - used as a base for relative paths (you may need to

adapt the path to the installation folder)

pMFS->WorkingDirectory = ".."; // this is relative to this applications' working

directory (the project folder)

// Default path to the MapForce Server executable is the installation path (same

dir with the MapForceServer.dll)

// In case you moved the binaries on the disk, you need to explicitly set the path

to the .exe file

// pMFS.ServerPath = "C:\\Program Files (x86)\\Altova\\MapForceServer2020\\bin\

\MapForceServer.exe";

// pMFS.ServerPath = "C:\\Program Files\\Altova\\MapForceServer2020\\bin\

© 2020 Altova GmbH



\MapForceServer.exe";

//Set global resource file and configuration, if your mapping uses global resources

//pMFS->SetOption( "globalresourcefile", "GlobalResource.xml" ); // "gr" can be

used as short name for "globalresourcefile"

//pMFS->SetOption( "globalresourceconfig", "Default" ); // "gc" can be used as

short name for "globalresourceconfig"

//

----------------------------------------------------------------------------------

// An example with input and output paths stored inside the MFX file

std::cout << "\nExecuting TokenizeString.mfx..." << std::endl; if ( pMFS->Run( "TokenizeString.mfx" ) == VARIANT_TRUE )

std::cout << "Successfully generated file 'AltovaToolFeatures.csv'." <<std::endl; else

{ // execution failed. maybe no write permissions in working directory? Run this

program as administrator.

std::cout << pMFS->LastExecutionMessage << std::endl; }

//

----------------------------------------------------------------------------------

// An example creating a simple output so that we can retrieve the result

explicitly

std::cout << "\nExecuting SimpleTotal.mfx..." << std::endl; if ( pMFS->Run( "SimpleTotal.mfx" ) )

std::cout << "Mapping result is: " + pMFS->GetOutputParameter( "total" ) <<std::endl; else

{ // execution failed (e.g. somebody deleted file ipo.xml)


//

----------------------------------------------------------------------------------

// an example with parameterized input

// the default of 'lower = 5' gets changed to the value '10'

// mfx reads file Temperatures.xml and writes its output to Temperatures_out.xml.

std::cout << "\nExecuting ClassifyTemperatures.mfx with parameter 'lower' set to'10' ..." << std::endl; pMFS->AddParameter("lower", "10"); if ( pMFS->Run( "ClassifyTemperatures.mfx" ) )

std::cout << "File Temperatures_out.xml has been written successfully." <<std::endl; else

{ // execution failed. maybe no write permissions in working directory? Run this

program as administrator.




} catch (_com_error& err )

{ BSTR bstrMessage; (err).ErrorInfo()->GetDescription( &bstrMessage ); std::cout << "Exception occurred: " <<_com_util::ConvertBSTRToString( bstrMessage ) << std::endl; }

CoUninitialize();

return 0;

}

5.2.2 VBScript-Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie eine Mapping-Ausführungsdatei (.mfx) über VBScript-Codeausführen. Unter Windows stehen die Beispieldateien unter dem folgenden Pfad zur Verfügung: C:\Programme\Altova\MapForceServer2020\etc\Examples.

Bevor Sie den nachstehenden Code ausführen, stellen Sie sicher, dass die folgenden Voraussetzungen erfülltwerden:

· MapForce Server ist installiert und lizenziert· MapForce Server steht als COM-Serverobjekt zur Verfügung (normalerweise geschieht dies

automatisch bei der Installation von MapForce Server; Informationen, wie Sie überprüfen, ob dieRegistrierung erfolgreich war, finden Sie unter Informationen zur COM-Schnittstelle ).

Option Explicit

REM This script produces extensive output.

REM It is best called from a cmd.exe console with "cscript MapForceServerAPI_sample.vbs"

'Create the MapForce Server object

Dim objMFS

' Since we load a COM-DLL we need care about the process architecture

On Error Resume Next ' ignore any COM errors avoiding uncontrolled script termination

Dim WshShell

Dim WshProcEnv

Set WshShell = CreateObject("WScript.Shell")

Set WshProcEnv = WshShell.Environment("Process")

Dim process_architecture

process_architecture= WshProcEnv("PROCESSOR_ARCHITECTURE")If process_architecture = "x86" Then

Set objMFS = WScript.GetObject( "", "MapForce.Server" )

If Err.Number <> 0 then

WScript.Echo("You are running in a 32-bit process but MapForce Server COM-API 32-bit seems not to be installed on your system.") WScript.Quit -1 End If

61

© 2020 Altova GmbH



Else

Set objMFS = WScript.GetObject( "", "MapForce_x64.Server" )

If Err.Number <> 0 then

WScript.Echo("You are running in a 64-bit process but MapForce Server COM-API 64-bit seems not to be installed on your system.") WScript.Echo("If you have installed 32-bit MapForce Server consider calling yourscript from the 32-bit console 'C:\Windows\SysWOW64\cmd.exe.'") WScript.Quit -1 End If

End If

On Error Goto 0 ' re-enble default error promotion

'Set a working directory - used as a base for relative paths (you may need to adapt the

path to the installation folder)

REM objMFS.WorkingDirectory = "C:\Program Files (x86)

\Altova\MapForceServer2020\etc\Examples"

Dim currDir

Dim fso

Set fso = CreateObject("Scripting.FileSystemObject")

currDir = fso.GetParentFolderName(Wscript.ScriptFullName)'set working folder to parent of this script

objMFS.WorkingDirectory = fso.GetParentFolderName( currDir )

'Default path to the MapForce Server executable is the installation path (same dir with

the MapForceServer.dll)

'In case you moved the binaries on the disk, you need to explicitly set the path to the

.exe file

'objMFS.ServerPath = "C:\Program Files (x86)

\Altova\MapForceServer2020\bin\MapForceServer.exe"

'Set global resource file and configuration, if your mapping uses global resources

'Call objMFS.SetOption("globalresourcefile", "GlobalResource.xml") '"gr" can be used as

short name for "globalresourcefile"

'Call objMFS.SetOption("globalresourceconfig", "Config2") '"gc" can be used as short name

for "globalresourceconfig"

WScript.Echo( "Running " & objMFS.ProductNameAndVersion & vbCrlf )

' The Run method will return 'True' if the execution of the mfx file was successful

otherwise 'False'.

' In the case of fundamental errors like termination of the server process a COM error

will be raised which

' can be handled using the VBScript Err object.

On Error Resume Next ' ignore any COM errors avoiding uncontrolled script termination

Err.Clear

REM ----------------------------------------------------------------------------

REM run an example with input and output paths stored inside the MFX file

' the path to the mfx file can be absolute or relative to the working directory

' depends on existence of file AltovaTools.xml in working direcory

' creates output file AltovaToolFeatures.csv in working directory

WScript.Echo( "Processing TokenizeString.mfx..." )



If ( objMFS.Run( "TokenizeString.mfx" ) ) Then

'WScript.Echo( objMFS.LastExecutionMessage ) ' execution log

WScript.Echo( "Successfully generated file AltovaToolFeatures.csv." )Else

'execution failed (e.g. somebody deleted file AltovaTools.xml)

WScript.Echo( objMFS.LastExecutionMessage )End If

WScript.Echo("")' handle COM errors

If Err.Number <> 0 Then

WScript.Echo("Internal error - " & Err.Description )

WScript.Quit -1End If

REM

-----------------------------------------------------------------------------------------

REM this is an example creating a simple output so that we can retrieve the result

explicitly

' depends on inpuz XML file ipo.xml

WScript.Echo( "Processing SimpleTotal.mfx..." )If ( objMFS.Run( "SimpleTotal.mfx" ) ) Then

'WScript.Echo( objMFS.LastExecutionMessage )

WScript.Echo( "Mapping result is: " & objMFS.GetOutputParameter("total") )Else

'execution failed (e.g. somebody deleted file ipo.xml)


WScript.Echo("")' handle COM errors




REM ----------------------------------------------------------------------------

REM This is an example with parameterized input

' the default of 'lower=5' gets changed to the value '10'

' mfx reads file Temperatures.xml and writes its output to Temperatures_out.xml.

WScript.Echo( "Processing ClassifyTemperatures.mfx with parameter 'lower' set to '10'..." )call objMFS.AddParameter("lower", "10")

If ( objMFS.Run( "ClassifyTemperatures.mfx" ) ) Then

'WScript.Echo( objMFS.LastExecutionMessage )

WScript.Echo( "File Temperatures_out.xml has been written successfully." )Else

'execution failed (e.g. somebody locks file Temperatures_out.xml)


call objMFS.ClearParameterList()

WScript.Echo("")

' handle COM errors


© 2020 Altova GmbH





On Error Goto 0 ' re-enble default error promotion

5.2.3 VBA-Beispiel

Microsoft Visual Basic for Applications (VBA) dient in erster Linie zum Automatisieren von Aufgaben inMicrosoft Office. Sie können aber auch die MapForce Server API von VBA aus aufrufen und Mappingsausführen. Die folgende Anleitung wurde auf MapForce Server und VBA für Microsoft Office 2013 getestet. BeiVerwendung einer anderen VBA-Umgebung sind die einzelnen Schritte eventuell anders.

VoraussetzungenBevor Sie die MapForce Server API-Funktionen von Ihrem VBA-Projekt aus aufrufen können, benötigen Sie diefolgenden Voraussetzungen:

1. Microsoft Office und MapForce Server müssen auf demselben Rechner installiert sein.2. Die Architektur von MapForce Server (32-Bit oder 64-Bit) muss mit der von Microsoft Office

übereinstimmen. Wenn Sie z.B. VBA auf Microsoft Office 32-Bit ausführen, stellen Sie sicher, dassSie die MapForce Server 32-Bit-Version verwenden. Um herauszufinden, ob Ihr Office-Produkt auf 64-Bit läuft, klicken Sie auf das Register Datei, dann auf Konto und anschließend auf "Über Excel" (oder"Über Word")

3. Die MapForce Server-Bibliothek muss von Ihrem VBA-Projekt aus referenziert werden (siehe Anleitungunten).

So fügen Sie in Ihrem VBA-Projekt eine Referenz zur MapForce Server-Bibliothek hinzu1. Klicken Sie in einem Microsoft Office-Dokument (.docm, .xlsm), in dem Makros aktiviert sind, auf dem

Register Entwicklertools auf Visual Basic.

Standardmäßig ist das Register Entwicklertools in Microsoft Office nicht aktiviert. Um dasRegister Entwicklertools in einem Office 2013-Programm zu aktivieren, klicken Sie mit derrechten Maustaste auf das Menüband und wählen Sie im Kontextmenü den Befehl Menübandanpassen. Aktivieren Sie anschließend im Dialogfeld "Optionen" unter "Hauptregisterkarten" dasKontrollkästchen Entwicklertools.

2. Klicken Sie in der VBA-Entwicklungsumgebung im Menü Extras auf Verweise.



3. Klicken Sie, um die MapForce Server-Typbibliothek auszuwählen.

So rufen Sie die MapForce Server API aufNachdem Sie in Ihrem VBA-Projekt eine Referenz zur MapForce Server-Bibliothek hinzugefügt haben, könnenSie den VBA-Code im Code-Editor-Fenster eingeben. Mit dem folgenden Beispielcode wird z.B.MapForceServer aufgerufen und eine ausführbare Mapping-Datei (mapping.mfx), die einen Input-Parameter namens"outfile" mit dem Wert "output.csv" erhält, ausgeführt.

Sub RunMapping()

' Create a new instance of the MapForce Server Dim objMFS As New MapForceServerLib.Server

With objMFS

' Set the working directory ' (used as base if the mapping has relative paths) .WorkingDirectory = "C:\temp\" ' If the mapping has parameters, supply them Call .AddParameter("outfile", "output.csv")

' Run the mapping .Run ("C:\temp\mapping.mfx") End With

End Sub

Drücken Sie F5, um den VBA-Code zu debuggen und das Mapping auszuführen.

© 2020 Altova GmbH



70 MapForce Server API Java-Schnittstelle


5.3 Java-Schnittstelle

Um die MapForce Server API von Java-Code aus aufrufen zu können, muss die folgende Referenz zurMapForceServer.jar-Bibliothek zur Java-Classpath-Datei hinzugefügt werden. Die MapForceServer.jar-Dateibefindet sich im Ordner bin des MapForce Server Installationsordners. Sie können die Datei entweder überihren Originalpfad referenzieren oder sie in einen anderen Ordner kopieren, falls Sie Ihr Projekt anderseinrichten möchten.

Wenn Sie Eclipse als Java-Entwicklungsumgebung verwenden, können Sie die erforderlicheBilbliotheksreferenz zum CLASSPATH hinzufügen, indem Sie die Eigenschaft des Java-Projekts wie untengezeigt bearbeiten. Sie können optional auch Dokumentation im JavaDoc-Format zur .jar-Bibliothek hinzufügen.Die JavaDoc befindet sich im Ordner bin des MapForce-Installationsordners. In der Anleitung unten wirdbeschrieben, wie Sie die JavaDoc-Dokumentation von Eclipse aus sichtbar machen.

So fügen Sie eine Referenzen zur MapForce Server-Bibliothek hinzu:

1. Klicken Sie bei geöffnetem Projekt in Eclipse im Menü Project auf Properties.2. Klicken Sie auf Java Build Path.3. Klicken Sie auf dem Register Libraries auf Add External JARs und navigieren Sie zur Datei

MapForceServer.jar im MapForce Server Installationsordner.

4. Erweitern Sie optional den Eintrag MapForceServer.jar und doppelklicken Sie auf den EintragJavadoc location: (None).

© 2020 Altova GmbH

Java-Schnittstelle 71MapForce Server API


5. Vergewissern Sie sich, dass die Optionen Javadoc in archive und External file ausgewählt sind undnavigieren Sie anschließend zur Datei MapForceServer_JavaDoc.zip im MapForce ServerInstallationsordner.

6. Klicken Sie auf OK.

Unten sehen Sie ein Beispiel dafür, wie die Eclipse .classpath-Datei aussehen könnte, wenn Sie die Dateienauf einer 64-Bit MapForce Server-Version auf einem 64-Bit-Windows-Betriebssystem vomOriginalinstallationsordner aus referenzieren (die entsprechenden Zeilen sind gelb markiert):



<?xml version="1.0" encoding="UTF-8"?><classpath>

<classpathentry kind="src" path=""/>

<classpathentry kind="lib" path="C:/Program

Files/Altova/MapForceServer2020/bin/MapForceServer.jar">

<attributes>

<attribute name="javadoc_location" value="jar:file:/C:/Program%

20Files/Altova/MapForceServer2020/bin/MapForceServer_JavaDoc.zip!/"/>

</attributes>

</classpathentry>

<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER">

<attributes>

<attribute name="module" value="true"/>

</attributes>

</classpathentry>

<classpathentry kind="output" path=""/>

</classpath>

5.3.1 Java-Beispiel

Im folgenden Beispiel sehen Sie, wie Sie eine Mapping-Ausführungsdatei (.mfx) von Java-Code aus ausführen.Unter Windows stehen die Beispieldateien unter dem folgenden Pfad zur Verfügung: C:\Programme\Altova\MapForceServer2020\etc\Examples. Folgende Beispieldateien stehen zur Verfügung:

· TokenizeString.mfx - eine MapForce Server-Ausführungsdatei, die vom Java-Programm ausgeführtwird.

· AltovaTools.xml - eine XML-Datei, die die Input-Daten für das Mapping-Programm bereitstellt.

Auf Linux- und Mac-Plattformen werden keine Beispiele vorinstalliert, Sie können jedoch eine ausführbare .mfx-Datei wie die in diesem Beispiel gezeigte folgendermaßen vorbereiten:

1. Öffnen Sie die gewünschte Mapping-Design-Datei (.mfd) mit MapForce unter Windows.2. Wählen Sie im Menü Datei den Befehl Mapping-Einstellungen und deaktivieren Sie das

Kontrollkästchen Pfade im generierten Code absolut machen, falls es aktiviert ist.3. Öffnen Sie für jede Mapping-Komponente das Dialogfeld Eigenschaften (z.B. durch Doppelklick auf

die Titelleiste) und ändern Sie alle Dateipfade von absoluten in relative um. Aktivieren Sie außerdemdas Kontrollkästchen Alle Dateipfade relativ zur MFD-Datei speichern. Sie können alle Input-Dateien und Schemas aus praktischen Gründen in denselben Ordner wie das Mapping kopieren unddiese einfach über den Dateinamen referenzieren. Nähere Informationen zum Arbeiten mit relativen undabsoluten Pfaden bei der Erstellung eines Mappings finden Sie in der Dokumentation zu MapForce.

4. Wählen Sie im Menü Datei den Befehl Zu MapForce Server-Ausführungsdatei kompilieren.Dadurch wird die .mfx.Datei generiert, die Sie in der Folge mit MapForce Server ausführen werden, wieim Codefragment unten gezeigt.

VoraussetzungenBevor Sie den nachstehenden Code ausführen, stellen Sie sicher, dass die folgenden Voraussetzungen erfülltwerden:

· MapForce Server ist installiert und lizenziert.

© 2020 Altova GmbH

Java-Schnittstelle 73MapForce Server API


· Die java-CLASSPATH-Datei enthält eine Referenz zur MapForceServer.jar-Bibliothek (Beispiel sieheInformationen zur Java-Schnittstelle ).

Wenn Sie, wie unten gezeigt, eine benutzerdefinierte .mfx-Datei verwenden, variieren die Voraussetzungeneventuell je nach Art der vom Mapping verarbeiteten Daten. Nähere Informationen dazu finden Sie unterVorbereiten von Mappings für die Server-Ausführung .

Das Java-Beispielprojekt befindet sich unter Windows im Verzeichnis "Programme", für das SieAdministratorrechte benötigen. Starten Sie Ihre Java-Entwicklungsumgebung (z.B. Eclipse) entweder alsAdministrator oder kopieren Sie das Beispiel in einen anderen Ordner, für den Sie keineAdministratorrechte benötigen.

Ausführen des Java-ProgrammsMit dem nachstehenden Codefragment wird zuerst ein MapForce Server-Objekt erstellt. Als nächstes wird dasArbeitsverzeichnis, in dem die Applikation nach Input-Dateien für das Mapping suchen soll und in dem dieMapping-Ausgabedateien erzeugt werden sollen, definiert. Wie oben erwähnt, werden in der Beispiel-Mapping-Datei Daten aus einer XML-Quelldatei ausgelesen. Stellen Sie also sicher, dass sich sowohl die XML-Datei ausauch das dazugehörige Schema im Arbeitsverzeichnis befindet.

Die Methode setServerPath definiert den Pfad zur ausführbaren MapForce Server-Datei. Auf Ubuntu wäre derPfad /opt/Altova/MapForceServer2020/bin/mapforceserver. Sie können setServerPath weglassen, wennSie die MapForceServer.jar -Datei nicht aus ihrem Standardordner verschoben haben.

Mit der Methode run wird schließlich ein Mapping (.mfx-Datei) ausgeführt, das mit MapForce kompiliert wurde(in diesem Beispiel TokenizeString.mfx). Bei Erfolg generiert das unten stehende Programm eine CSV-Dateiim Arbeitsverzeichnis. Bei einem Fehler versucht das Programm die letzte von MapForce Server generierteAusführungsmeldung zu drucken.

public class Program

{ public static void main(String[] args)

{ try

{ //Create a MapForce Server object

com.altova.mapforceserver.MapForceServer objMFS = new

com.altova.mapforceserver.MapForceServer(); //Set a working directory - used as a base for relative paths (you may need to

adapt the path to the installation folder)

objMFS.setWorkingDirectory( "C:\\Program Files (x86)\\Altova\\MapForceServer2020\\etc\\Examples" ); //Default path to the MapForce Server executable is the installation path (same

dir with the MapForceServer.jar)

//In case you copied the JAR file to a new location, you need to explicitly set

the path to the .exe file

objMFS.setServerPath( "C:\\Program Files (x86)\\Altova\\MapForceServer2020\\bin\\MapForceServer.exe" );

70

20



//Set global resource file and configuration, if your mapping uses global

resources

//objMFS.setOption( "globalresourcefile", "GlobalResource.xml" ); // "gr" can

be used as short name for "globalresourcefile"

//objMFS.setOption( "globalresourceconfig", "Default" ); // "gc" can be used

as short name for "globalresourceconfig"

//Prepare the parameters, if your design uses parameters

//objMFS.addParameter( "testparam1", "value 1" );

//Run the mapping; input and output paths are stored inside the MFX file

// NOTE Please adapt the path to the input file in order to run the sample

if ( objMFS.run( "C:\\Program Files (x86)\\Altova\\MapForceServer2020\\etc\

\Examples\\TokenizeString.mfx" ) ) System.out.println( "Success - finished execution" ); else

System.out.println( objMFS.getLastExecutionMessage() ); } catch ( Exception e)

{ e.printStackTrace(); } System.out.println( "Finished - exiting" ); }}

© 2020 Altova GmbH

Beispiel: Ausführen eines Mappings mit Parametern 75MapForce Server API


5.4 Beispiel: Ausführen eines Mappings mit Parametern

In diesem Beispiel wird gezeigt, wie Sie ein MapForce-Mapping zu einer MapForce Server-Ausführungsdatei(.mfx) kompilieren und diese über die MapForce API ausführen. Im Beispiel wird ein Szenario beschrieben, indem der Name der Input-Datei im Mapping als Parameter verwendet wird. Siehe dazu auch die vorherigenBeispiele zu C# , C++ , VB.NET , VBScript oder Java .

In diesem Beispiel wird zur Anzeige und zum Verständnis des ursprünglichen Mapping-Designs MapForceverwendet. Das Mapping wird mit MapForce zu einer MapForce Server Ausführungsdatei (.mfx) kompiliert.Auch Einstellungen wie relative anstelle von absoluten Pfaden werden in MapForce vorgenommen.

Die in diesem Beispiel verwendete Server-Plattform ist Windows. Es könnte sich hierbei entweder umdenselben Rechner handeln, auf dem auch MapForce installiert ist, oder um einen anderen. Sie können diesesBeispiel auch auf einem Linux- oder Mac-Rechner (in Java) ausführen, vorausgesetzt, Sie passen die Windows-Pfade an Ihre jeweilige Plattform an.

VoraussetzungenFür die Ausführung dieses Mappings gelten dieselben Voraussetzungen wie für die zuvor beschriebenenBeispiele für C# , C++ , VB.NET , VBScript oder Java .

Vorbereiten von Mappings für die Server-AusführungNachdem Sie MapForce installiert und zum ersten Mal gestartet haben, steht eine Reihe von Demo-Mapping-Design-Dateien unter dem folgenden Pfad zur Verfügung:

C:\Benutzer\<Benutzername>\Dokumente\Altova\MapForce2020\MapForce Examples

Der obige Pfad muss entsprechend geändert werden, wenn Sie eine andere Version vom MapForce haben.

Das in diesem Beispiel verwendete Mapping-Design hat den Namen FileNamesAsParameters.mfd. Wie Siein der Abbildung unten sehen, handelt es sich hierbei um ein einfaches Mapping, in dem Daten beinaheunverändert aus einer XML-Quelldatei in eine XML-Zieldatei kopiert werden. Nur die Felder PrimaryKey undName der XML-Zieldatei werden mit Konstanten aus dem Mapping befüllt.

55 61 58 64 72

55 61 58 64 72

76 MapForce Server API Beispiel: Ausführen eines Mappings mit Parametern


FileNamesAsParameters.mfd

Das Mapping hat zwei Input-Parameter: InputFileName und OutputFileName. Damit in MapForce eineVorschau auf das Mapping angezeigt werden kann, werden die Parameterwerte durch zwei Konstantenbereitgestellt. Wie weiter unten beschrieben, haben Sie die Möglichkeit, die Parameterwerte bei Ausführungdes Mappings mit MapForce Server durch Ihre eigenen zu ersetzen.

Beachten Sie, dass der Dateiname laut Konfiguration sowohl für die Quell- als auch für die Zielkomponente desMappings dynamisch aus dem Mapping abgerufen wird. In der obersten Zeile der Komponente steht dazu einDatei <dynamisch> Input-Konnektor zur Verfügung, über den Daten aus dem entsprechenden Mapping-Parameter (InputFileName oder OutputFileName) ausgelesen werden. Sie können diese Option in MapForcedurch Klicken auf die Schaltfläche Datei/String in der rechten oberen Ecke der Komponente definieren oderändern. Beachten Sie, dass der als Parameter bereitgestellte Input-Dateiname eine physische XML-Datei, diedie Input-Daten für das Mapping enthält (in diesem Beispiel Altova_Hierarhical.xml, aus demselben Ordnerwie die Mapping-Design-Datei) referenzieren muss. Der Ausgabedateiname kann jeder gültige Name sein, z.B.Output.xml.

Bevor Sie das Mapping zu einer MapForce Server Ausführungsdatei (.mfx) kompilieren, sollten Sienormalerweise die Mapping-Einstellungen überprüfen. Klicken Sie mit der rechten Maustaste in einen leerenBereich des Mappings und wählen Sie im Kontextmenü den Befehl Mapping-Einstellungen.

© 2020 Altova GmbH



Ändern Sie die Einstellungen für dieses Beispiel wie oben gezeigt. Beachten Sie vor allem, dass alle absolutenPfade zu im Mapping verwendeten Input- oder Output-Dateien relativ zur Mapping-Design-Datei (.mfd) aufgelöstwerden, wenn Sie das Kontrollkästchen Pfade im generierten Code absolut machen deaktivieren.MapForce Server sucht zur Laufzeit im Arbeitsverzeichnis des Programms nach diesen Pfaden. WelchesStandard-Arbeitsverzeichnis verwendet wird, hängt von der Plattform ab, über die Sie die MapForce Server APIaufrufen. Im Fall einer C#-Applikation ist es dasselbe Verzeichnis wie das der ausführbaren Datei. Außerdemkönnen Sie, wie weiter unten gezeigt, das Arbeitsverzeichnis mit Hilfe einer API-Eigenschaft namensWorkingDirectory (oder gegebenenfalls der Java-Methode setWorkingDirectory ) ändern.

Anmerkungen:

· Im Dialogfeld "Mapping-Einstellungen" sind die einzigen Einstellungen, die sich direkt auf dieKompilierung der .mfx-Datei auswirken Pfade im generierten Code absolut machen undZeilenenden.

· In diesem Mapping war es nicht notwendig, die einzelnen Mapping-Komponenten in MapForce zubearbeiten, um absolute Pfade in relative zu ändern, da alle Pfade bereits relativ waren. Falls dies nichtder Fall ist, müssten Sie diesen zusätzlichen Schritt ebenfalls durchführen, siehe Vorbereiten vonMappings für die Server-Ausführung .

In diesem Beispiel wird das Verzeichnis C:\MappingExample als Arbeitsverzeichnis verwendet. Kopieren Siedaher die vom Mapping referenzierte Input-Datei Altova_Hierarchical.xml von C:\Benutzer\<Benutzername>\Dokumente\Altova\MapForce2020\MapForceExamples in dasArbeitsverzeichnis.

Sowohl bei der Quell- als auch bei der Zieldatei in diesem Beispiel handelt es sich um XML-Dateien. Die XML-Schema-Datei ist auf dem Server nicht vonnöten, da die Informationen daraus bei der Kompilierung in die .mfx-Datei eingebettet wurden. Wenn in Ihrem Mapping andere Komponententypen (z.B. Datenbanken) verwendetwerden, gelten allenfalls zusätzliche Voraussetzungen, wie unter Vorbereiten von Mappings für die Server-Ausführung beschrieben.

Um das Mapping schließlich zu einer Server-Ausführungsdatei zu kompilieren, gehen Sie folgendermaßen vor:

85 98

20

20



· Klicken Sie im Menü Datei auf den Befehl Zu MapForce Server-Ausführungsdatei kompilieren undwählen Sie ein Zielverzeichnis aus. Das Zielverzeichnis ist in diesem Beispiel dasselbe wir dasArbeitsverzeichnis, nämlich C:\MappingExample.

In den folgenden Codefragmenten wird gezeigt, wie Sie das Mapping über die MapForce Server API vonverschiedenen Umgebungen aus ausführen. Beachten Sie, dass beide Parameter in den unten stehendenCodefragmenten durch denselben Namen, den sie auch im Mapping-Design haben, referenziert werden.Außerdem hat der Parameterwert denselben Datentyp, der auch im Mapping definiert ist (in diesem FallString).

Ausführen des Mappings über C++Sie können die .mfx-Datei nun mit C++-Code, wie dem unten gezeigten, ausführen. Um diesen Code erfolgreichausführen zu können, stellen Sie sicher, dass MapForce Server eine gültige Lizenz hat, siehe auch CLI-Befehlverifylicense .

C++

#include <iostream>#include "atlbase.h"

// 32-bit MapForce Server

#import "progid:MapForce.Server"

int _tmain(int argc, _TCHAR* argv[])

{ CoInitialize( NULL );

try

{ //Create a MapForce Server object

MapForceServerLib::IServerPtr pMFS; CoCreateInstance( __uuidof( MapForceServerLib::Server ), NULL, CLSCTX_ALL,__uuidof( MapForceServerLib::IServer ), reinterpret_cast< void** >( &pMFS ) );

//Set a working directory - used as a base for relative paths

pMFS->WorkingDirectory = "C:\\MappingExample";

//Prepare the parameters

pMFS->AddParameter("InputFileName", "Altova_Hierarchical.xml"); pMFS->AddParameter("OutputFileName", "Output.xml");

//Run the mapping

if (pMFS->Run("FileNamesAsParameters.mfx"))

std::cout << "Success - finished execution" << std::endl; else

std::cout << pMFS->LastExecutionMessage << std::endl;

} catch (_com_error& err )

{ BSTR bstrMessage; (err).ErrorInfo()->GetDescription( &bstrMessage ); std::cout << "Exception occurred: " <<

50

© 2020 Altova GmbH



_com_util::ConvertBSTRToString( bstrMessage ) << std::endl;

}

CoUninitialize(); return 0;

}

Ausführen des Mappings über C#Sie können die .mfx-Datei nun mit C#-Code, wie dem unten gezeigten, ausführen. Um diesen Code erfolgreichausführen zu können, fügen Sie zuerst in Visual Studio eine Referenz zur MapForce Server DLL hinzu, wieunter .NET-Schnittstelle beschrieben, und vergewissern Sie sich, dass MapForce Server eine gültige Lizenzhat, siehe auch CLI-Befehl verifylicense .

C#

static void Main(string[] args)

{ try

{ // Create a MapForce Server object Altova.MapForceServer.Server objMFS = new Altova.MapForceServer.Server();

// Set the working directory - all relative paths will be resolved against it objMFS.WorkingDirectory = "C:\\MappingExample";

//Prepare the parameters objMFS.AddParameter("InputFileName", "Altova_Hierarchical.xml"); objMFS.AddParameter("OutputFileName", "Output.xml");

//Run the mapping if (objMFS.Run("FileNamesAsParameters.mfx"))

System.Console.WriteLine("Success - finished execution"); else

System.Console.WriteLine(objMFS.LastExecutionMessage); } catch(System.Runtime.InteropServices.COMException ex)

{ System.Console.WriteLine("Internal Error: " + ex.Message); }}

Ausführen des Mappings über JavaSie können die .mfx-Datei nun mit Java-Code, wie dem unten gezeigten, ausführen. Um dieses Codefragmenterfolgreich ausführen zu können, stellen Sie sicher, dass:

· die Java-CLASSPATH-Umgebungsvariable eine Referenz zur MapForceServer.jar-Bibliothek enthält,wie unter Informationen zur Java-Schnittstelle beschrieben.

· MapForce Server eine gültie Lizenz hat, siehe auch CLI-Befehl verifylicense .

54

50

70

50



Java

public static void main(String[] args) {

try {

// Create a MapForce Server object

com.altova.mapforceserver.MapForceServer objMFS = new

com.altova.mapforceserver.MapForceServer(); // Set the working directory - all relative paths will be resolved against it

// objMFS.setWorkingDirectory("/home/ubuntu/Downloads/MappingExample");

objMFS.setWorkingDirectory("C:\\MappingExample"); // Add the mapping parameters

objMFS.addParameter("InputFileName", "Altova_Hierarchical.xml"); objMFS.addParameter("OutputFileName", "Output.xml"); // Run the mapping

if ( objMFS.run( "FileNamesAsParameters.mfx" ) )

System.out.println( "Success - finished execution" ); else

System.out.println( objMFS.getLastExecutionMessage() ); } catch (Exception e) {

e.printStackTrace(); } System.out.println("Finished execution"); }

© 2020 Altova GmbH

API Reference (COM, .NET) 81MapForce Server API


5.5 API Reference (COM, .NET)

Dieser Abschnitt enthält allgemeine Informationen über die Elemente der MapForce Server API (wie z.B.Schnittstellen und Methoden), die für Code, der für die COM- oder .NET-Plattform geschrieben wurde,verwendet werden können.

5.5.1 Schnittstellen

5.5.1.1 IServer

Die IServer-Schnittstelle erstellt eine neue MapForce Server-Objektinstanz und bietet Zugriff auf denMapForce Server-Prozessor.

Wenn Sie C++ unter der COM-Plattform verwenden, lautet der Name der Hauptschnittstelle IServer. WennSie eine .NET-Sprache wie z.B. C# oder VB.NET verwenden, lautet der Name der Hauptschnittstelle Server.

Eigenschaften

Name Beschreibung

APIMajorVersion Schreibgeschützt.Ruft die Hauptversion der MapForce Server API ab. Diesestimmt unter Umständen nicht mit der Produktversion überein,wenn die API mit einem anderen Server verbunden ist.

APIMinorVersion Schreibgeschützt.Ruft die Nebenversion der MapForce Server API ab. Diesestimmt unter Umständen nicht mit der Produktversion überein,wenn die API mit einem anderen Server verbunden ist.

APIServicePackVersion Schreibgeschützt.Ruft die Service Pack-Version der MapForce Server API ab.Diese stimmt unter Umständen nicht mit der Produktversionüberein, wenn die API mit einem anderen Server verbunden ist.

Is64Bit Schreibgeschützt.Gibt true zurück, wenn der MapForce Server-Prozessor eineausführbare 64-Bit-Datei ist.

LastExecutionMessage Schreibgeschützt.Ruft die beim letzten Run-Befehl erhaltene Meldung ab.

MajorVersion Schreibgeschützt.Ruft die Hauptversion des Produkts als Anzahl von Jahren seit1998 ab (z.B. "20" für Altova MapForce Server 2018).

MinorVersion Schreibgeschützt.Ruft die Nebenversion des Produkts ab (z.B. "2" für AltovaMapForce Server 2018 r2).

84

84

84

84

84

85

85

82 MapForce Server API API Reference (COM, .NET)


Name Beschreibung

ProductName Schreibgeschützt.Ruft den Namen des Produkts ab (z.B. "Altova MapForceServer").

ProductNameAndVersion Schreibgeschützt.Ruft den vollständigen Namen und die Version des Produkts ab(z.B. "Altova MapForce Server 2018 r2 sp1 (x64)").

ServerPath Ruft den Pfad der ausführbaren MapForce Server-Datei ab bzw.definiert ihn.

ServicePackVersion Schreibgeschützt.Ruft die Service Pack-Version des Produkts ab (z.B. "1" fürAltova MapForce Server 2018 r2 sp1).

WorkingDirectory Ruft das aktuelle Verzeichnis für ausgeführte Aufträge ab bzw.definiert es (relative Pfade werden anhand desArbeitsverzeichnisses aufgelöst).

Methoden

Name Beschreibung

AddCredentialProperty Fügt eine Eigenschaft zu den aktuellen Anmeldeinformationenhinzu (z.B. den Benutzernamen, das Passwort oder beides).Das erste Argument definiert den Namen der Eigenschaft, daszweite Argument den Wert der Eigenschaft GültieEigenschaftsnamen: username, password. In der MapForceServer Advanced Edition wird zusätzlich dazu derEigenschaftsname oauth:token unterstützt.

Diese Methode muss nach BeginCredential() und vorEndCredential() aufgerufen werden.

AddParameter Weist einem im Mapping definierten Parameter einen Wert zu.Das erste Argument definiert den Namen des Parameters, wieer im Mapping definiert wurde; das zweite Argument definiertden Parameterwert.

BeginCredential Erstellt neue Anmeldeinformationen, wobei der Name alsArgument bereitgestellt wird. Wenn Sie diese Methode aufrufen,müssen Sie mittels AddCredentialProperty() auchEigenschaften zu dieser hinzufügen und dieAnmeldeinformationen schließlich durch Aufruf vonEndCredential() schließen.

ClearCredentialList Löscht die zuvor definierte Liste von Anmeldeinformationen. AlleAnmeldeinformationen sind während der Lebensdauer desObjekts gültig. Rufen Sie diese Methode auf, wenn Sie allezuvor gesetzten Anmeldeinformationen explizit löschenmöchten.

85

85

85

85

85

85

86

86

87

© 2020 Altova GmbH



Name Beschreibung

ClearOptions Löscht die Liste der zuvor mit der Methode SetOptiondefinierten Optionen. Alle mit der SetOption-Methodedefinierten Optionen sind während der Lebensdauer des Objektsgültig. Rufen Sie diese Methode auf, wenn Sie alle zuvorgesetzten Optionen explizit löschen möchten.

ClearParameterList Löscht die Liste der zuvor mit der Methode AddParameterdefinierten Parameter.

EndCredential Schließt ein zuvor mit der Methode BeginCredential erstelltesAnmeldeinformationsobjekt.

GetOutputParameter Ruft den mit dem letzten run-Befehl generierten String Outputab. Gibt Null zurück, wenn kein Output generiert wurde. Fürdiese Funktion ist ein String-Parameter, der den Namen derOutput-Komponente in MapForce definiert, erforderlich.

Run Führt eine MapForce Server-Ausführungsdatei (.mfx-Datei) aus.Gibt bei Erfolg true zurück, andernfalls false.

SetOption Definiert vor Ausführung des Mappings eine Option. Das ersteArgument definiert den Namen der Option, das zweite Argumentdefiniert den Optionswert. Diese Methode ist besonders dannnützlich, wenn in einem Mapping globale Ressourcen verwendetwerden (siehe Globale Altova-Ressourcen ). Derzeit werdendie folgenden Optionen unterstützt:

· globalresourcefile (oder gr) - Der Pfad zu einerglobalen Ressourcendatei. (Wenn diese Option definiertist, muss auch ein Name für die Konfiguration derglobalen Ressource definiert werden, siehe nächsterEintrag).

· globalresourcefile (oder gr) - Name einer globalenRessourcenkonfiguration. (Wenn diese Option definiertist, muss ein Dateipfad zu einer globale Ressourcen-Datei definiert werden, siehe vorheriger Eintrag).

· catalog - Pfad zu eienr benutzerdefiniertenRootCatalog.xml-Datei. Mit Hilfe dieser Option könnenSie eine benutzerdefinierte Katalogdatei für dieAuflösung von im Mapping verwendeten URLsdefinieren. Der Standardkatalog befindet sich imUnterverzeichnis "etc" desProgramminstallationsverzeichnisses.

· taxonomy-package - Der Pfad zu einembenutzerdefinierten XBRL-Taxonomiepaket, falls einesfür das Mapping erforderlich ist.

· taxonomy-packages-config-file - Der Pfad zu einerbenutzerdefinierten XBRL-Taxonomiepaketkonfiguration,falls eine für das Mapping erforderlich ist.

87

87

87

87

88

88

26



Name Beschreibung

Alle definierten Optionen sind während der Lebensdauer desObjekts gültig. Wenn Sie eine Option mit demselben Namenzwei Mal definieren, wird die vorherige Option außer Kraftgesetzt. Um alle Optionen explizit zu löschen, rufen Sie dieMethode ClearOptions() auf.

BeispieleIn den folgenden Beispielen wird gezeigt, wie Sie MapForce Server in verschiedenen Sprachen initialisieren undausführen:

· C++ -Beispiel· C#-Beispiel· VBScript-Beispiel· VB.NET-Beispiel .

5.5.1.1.1 Eigenschaften

5.5.1.1.1.1 APIMajorVersion

Ruft die Hauptversion der MapForce Server API ab. Diese stimmt unter Umständen nicht mit der Produktversionüberein, wenn die API mit einem anderen Server verbunden ist.

5.5.1.1.1.2 APIMinorVersion

Ruft die Nebenversion der MapForce Server API ab. Diese stimmt unter Umständen nicht mit derProduktversion überein, wenn die API mit einem anderen Server verbunden ist.

5.5.1.1.1.3 APIServicePackVersion

Ruft die Service Pack-Version der MapForce Server API ab. Diese stimmt unter Umständen nicht mit derProduktversion überein, wenn die API mit einem anderen Server verbunden ist.

5.5.1.1.1.4 Is64Bit

Gibt true zurück, wenn der MapForce Server-Prozessor eine ausführbare 64-Bit-Datei ist.

5.5.1.1.1.5 LastExecutionMessage

Ruft die beim letzten Run-Befehl erhaltene Meldung ab.

61

55

64

58

© 2020 Altova GmbH



5.5.1.1.1.6 MajorVersion

Ruft die Hauptversion des Produkts als Anzahl von Jahren seit 1998 ab (z.B. "20" für Altova MapForce Server2018).

5.5.1.1.1.7 MinorVersion

Ruft die Nebenversion des Produkts ab (z.B. "2" für Altova MapForce Server 2018 r2).

5.5.1.1.1.8 ProductName

Ruft den Namen des Produkts ab (z.B. "Altova MapForce Server").

5.5.1.1.1.9 ProductNameAndVersion

Ruft den vollständigen Namen und die Version des Produkts ab (z.B. "Altova MapForce Server 2018 r2 sp1(x64)").

5.5.1.1.1.10 ServerPath

Ruft den Pfad der ausführbaren MapForce Server-Datei ab bzw. definiert ihn.

5.5.1.1.1.11 ServicePackVersion

Ruft die Service Pack-Version des Produkts ab (z.B. "1" für Altova MapForce Server 2018 r2 sp1).

5.5.1.1.1.12 WorkingDirectory

Ruft das aktuelle Verzeichnis für ausgeführte Aufträge ab bzw. definiert es (relative Pfade werden anhand desArbeitsverzeichnisses aufgelöst).

5.5.1.1.2 Methoden

5.5.1.1.2.1 AddCredentialProperty

Fügt eine Eigenschaft zu den aktuellen Anmeldeinformationen hinzu (z.B. den Benutzernamen, das Passwortoder beides). Das erste Argument definiert den Namen der Eigenschaft, das zweite Argument den Wert derEigenschaft Gültie Eigenschaftsnamen: username, password. In der MapForce Server Advanced Edition wirdzusätzlich dazu der Eigenschaftsname oauth:token unterstützt.



Diese Methode muss nach BeginCredential() und vor EndCredential() aufgerufen werden.

Parameter

Name Typ Beschreibung

bstrName System.String Definiert den Namen derAnmeldeinformationen-Eigenschaft.

bstrValue System.String Definiert den Wert derAnmeldeinformationen-Eigenschaft.

BeispieleIm folgenden Code wird gezeigt, wie Sie Anmeldeinformationen mit dem Namen "mycredential" in C#deklarieren. Der Name der Anmeldeinformationen muss mit dem, den Sie den Anmeldeinformation zumZeitpunkt des Designs in MapForce gegeben haben, übereinstimmen.

//Create a MapForce Server objectAltova.MapForceServer.Server objMFS = new Altova.MapForceServer.Server();

objMFS.BeginCredential("mycredential");objMFS.AddCredentialProperty("username", "altova");objMFS.AddCredentialProperty("password", "b45ax78!");objMFS.EndCredential();

5.5.1.1.2.2 AddParameter

Weist einem im Mapping definierten Parameter einen Wert zu. Das erste Argument definiert den Namen desParameters, wie er im Mapping definiert wurde; das zweite Argument definiert den Parameterwert.

Parameter


bstrName String Definiert den Parameternamen.

bstrValue String Definiert den Parameterwert.

5.5.1.1.2.3 BeginCredential

Erstellt neue Anmeldeinformationen, wobei der Name als Argument bereitgestellt wird. Wenn Sie dieseMethode aufrufen, müssen Sie mittels AddCredentialProperty() auch Eigenschaften zu dieser hinzufügenund die Anmeldeinformationen schließlich durch Aufruf von EndCredential() schließen.

© 2020 Altova GmbH



Parameter


bstrCredentialName String Definiert den Namen derAnmeldeinformationen, wie er inMapForce definiert wurde.

5.5.1.1.2.4 ClearCredentialList

Löscht die zuvor definierte Liste von Anmeldeinformationen. Alle Anmeldeinformationen sind während derLebensdauer des Objekts gültig. Rufen Sie diese Methode auf, wenn Sie alle zuvor gesetztenAnmeldeinformationen explizit löschen möchten.

5.5.1.1.2.5 ClearOptions

Löscht die Liste der zuvor mit der Methode SetOption definierten Optionen. Alle mit der SetOption-Methodedefinierten Optionen sind während der Lebensdauer des Objekts gültig. Rufen Sie diese Methode auf, wenn Siealle zuvor gesetzten Optionen explizit löschen möchten.

5.5.1.1.2.6 ClearParameterList

Löscht die Liste der zuvor mit der Methode AddParameter definierten Parameter.

5.5.1.1.2.7 EndCredential

Schließt ein zuvor mit der Methode BeginCredential erstelltes Anmeldeinformationsobjekt.

5.5.1.1.2.8 GetOutputParameter

Ruft den mit dem letzten run-Befehl generierten String Output ab. Gibt Null zurück, wenn kein Output generiertwurde. Für diese Funktion ist ein String-Parameter, der den Namen der Output-Komponente in MapForcedefiniert, erforderlich.

Parameter


bstrName String Definiert den Namen der Output-Komponente, wie er in MapForceangezeigt wird. Dieser Name wirdin der Titelleiste jeder Komponentedes Mappings angezeigt (oder




wenn Sie mit der rechtenMaustaste auf dieKomponentenüberschrift klickenund den Befehl Eigenschaftenwählen.)

5.5.1.1.2.9 Run

Führt eine MapForce Server-Ausführungsdatei (.mfx-Datei) aus. Gibt bei Erfolg true zurück, andernfalls false.

Parameter


bstrMappingPath String Definiert den Pfad zur MapForceServer-Ausführungsdatei (.mfx)-Datei. Wenn Sie einen relativenPfad definieren, wird dieser anhanddes Arbeitsverzeichnissesaufgelöst. Sie können dasArbeitsverzeichnis über dieEigenschaft WorkingDirectorydefinieren.

5.5.1.1.2.10 SetOption

Definiert vor Ausführung des Mappings eine Option. Das erste Argument definiert den Namen der Option, daszweite Argument definiert den Optionswert. Diese Methode ist besonders dann nützlich, wenn in einemMapping globale Ressourcen verwendet werden (siehe Globale Altova-Ressourcen ). Derzeit werden diefolgenden Optionen unterstützt:

· globalresourcefile (oder gr) - Der Pfad zu einer globalen Ressourcendatei. (Wenn diese Optiondefiniert ist, muss auch ein Name für die Konfiguration der globalen Ressource definiert werden, siehenächster Eintrag).

· globalresourcefile (oder gr) - Name einer globalen Ressourcenkonfiguration. (Wenn diese Optiondefiniert ist, muss ein Dateipfad zu einer globale Ressourcen-Datei definiert werden, siehe vorherigerEintrag).

· catalog - Pfad zu eienr benutzerdefinierten RootCatalog.xml-Datei. Mit Hilfe dieser Option könnenSie eine benutzerdefinierte Katalogdatei für die Auflösung von im Mapping verwendeten URLsdefinieren. Der Standardkatalog befindet sich im Unterverzeichnis "etc" desProgramminstallationsverzeichnisses.

· taxonomy-package - Der Pfad zu einem benutzerdefinierten XBRL-Taxonomiepaket, falls eines fürdas Mapping erforderlich ist.

· taxonomy-packages-config-file - Der Pfad zu einer benutzerdefinierten XBRL-Taxonomiepaketkonfiguration, falls eine für das Mapping erforderlich ist.

26

© 2020 Altova GmbH



Alle definierten Optionen sind während der Lebensdauer des Objekts gültig. Wenn Sie eine Option mitdemselben Namen zwei Mal definieren, wird die vorherige Option außer Kraft gesetzt. Um alle Optionen explizitzu löschen, rufen Sie die Methode ClearOptions() auf.

Parameter


bstrName String Definiert den Namen der zusetzenden Option.

bstrValue String Definiert den Wert der zusetzenden Option.

90 MapForce Server API API Reference (Java)


5.6 API Reference (Java)

Dieser Abschnitt enthält allgemeine Informationen über die Elemente der MapForce Server API (wie z.B.Klassen und Methoden), die in Code, der für die Java-Plattform geschrieben wurde, verwendet werden können.

5.6.1 Klassen

5.6.1.1 MapForceServer

Die MapForceServer-Klasse erstellt eine MapForce Server-Objektinstanz und ermöglicht den Zugriff auf denMapForce Server-Prozessor.

Methoden

Name Beschreibung

addCredentialPropertiesFromMap Fügt zu den aktuellen Anmeldeinformationen Eigenschaften auseiner Anmeldeinformationen-Eigenschaftszuordnung hinzu.Diese Methode erhält als Argument eine Anmeldeinformationen-Eigenschaftszuordnung (property_name, property_value). DieseMethode muss nach beginCredential() und vorendCredential() aufgerufen werden. Alternativ dazu könnenSie auch AddCredentialProperty() aufrufen.

addCredentialProperty Fügt eine Eigenschaft zu den aktuellen Anmeldeinformationenhinzu (z.B. den Benutzernamen, das Passwort oder beides).Das erste Argument definiert den Namen der Eigenschaft, daszweite den Wert der Eigenschaft. Gültige Eigenschaftsnamen:username, password. In der MapForce Server Advanced Editionwird zusätzlich dazu der Eigenschaftsname oauth:tokenunterstützt.

Diese Methode muss nach beginCredential() und vorendCredential() aufgerufen werden. Alternativ dazu könnenSie auch addCredentialProperty() aufrufen.

addParameter Weist einem im Mapping definierten Parameter einen Wert zu.

beginCredential Erstellt neue Anmeldeinformationen mit dem als Argumentbereitgestellten Namen. Wenn Sie diese Methode aufrufen,müssen Sie mit Hilfe von addCredentialProperty() oderaddCredentialPropertiesFromMap() auch Eigenschaftendazu hinzufügen und die Anmeldeinformationen schließlichdurch Aufruf von endCredential() schließen.

clearCredentialList Löscht die Liste der zuvor definierten Anmeldeinformationen.Alle Anmeldeinformationen sind während der Lebensdauer desObjekts gültig. Rufen Sie diese Methode auf, wenn Sie alle

93

93

94

94

95

© 2020 Altova GmbH

API Reference (Java) 91MapForce Server API


Name Beschreibung

zuvor definierten Anmeldeinformationen explizit löschenmöchten.

clearOptions Löscht die Liste der zuvor mit der Methode setOptiondefinierten Optionen. Alle mit der setOption-Methodedefinierten Methoden sind während der Lebensdauer desObjekts gültig. Rufen Sie diese Methode auf, wenn Sie allezuvor gesetzten Optionen explizit löschen möchten.

clearParameterList Löscht die Liste der zuvor mit der Methode addParameterdefinierten Parameter.

endCredential Schließt ein zuvor mit der Methode beginCredential erstelltesAnmeldeinformationsobjekt.

getAPIMajorVersion Ruft die Hauptversion der MapForce Server API ab. Diesestimmt unter Umständen nicht mit der Produktversion überein,wenn die API mit einem anderen Server verbunden ist.

getAPIMinorVersion Ruft die Nebenversion der MapForce Server API ab. Diesestimmt unter Umständen nicht mit der Produktversion überein,wenn die API mit einem anderen Server verbunden ist.

getAPIServicePackVersion Ruft die Service Pack-Version der MapForce Server API ab.Diese stimmt unter Umständen nicht mit der Produktversionüberein, wenn die API mit einem anderen Server verbunden ist.

getLastExecutionMessage Ruft die beim letzten run-Befehl erhaltene Meldung ab.

getMajorVersion Ruft die Hauptversion des Produkts als Anzahl von Jahren seit1998 ab (z.B. "20" für Altova MapForce Server 2018).

getMinorVersion Ruft die Nebenversion des Produkts ab (z.B. "2" für AltovaMapForce Server 2018 r2).

getOutputParameter Ruft den mit dem letzten run-Befehl generierten String Outputab. Gibt Null zurück, wenn kein Output generiert wurde. Fürdiese Funktion ist ein String-Parameter, der den Namen derOutput-Komponente in MapForce definiert, erforderlich.

getProductName Ruft den Namen des Produkts ab (z.B. "Altova MapForceServer").

getProductNameAndVersion Ruft den vollständigen Namen und die Version des Produkts ab(z.B. "Altova MapForce Server 2018 r2 sp1 (x64)").

getServicePackVersion Ruft die Service Pack-Version des Produkts ab bzw. definiert sie(z.B. "1" für Altova MapForce Server 2018 r2 sp1 (x64)).

is64bit Gibt true zurück, wenn der MapForce Server-Prozessor eineausführbare 64-Bit-Datei ist.

95

95

95

95

95

96

96

96

96

96

96

97

97

97



Name Beschreibung

run Führt eine MapForce Server-Ausführungsdatei (.mfx-Datei) aus.Gibt bei Erfolg true zurück, andernfalls false.

setOption Definiert vor Ausführung des Mappings eine Option. Das ersteArgument definiert den Namen der Option, das zweite Argumentdefiniert den Optionswert. Diese Methode ist besonders dannnützlich, wenn in einem Mapping globale Ressourcen verwendetwerden (siehe Globale Altova-Ressourcen ). Derzeit werdendie folgenden Optionen unterstützt:

· globalresourcefile (oder gr) - Der Pfad zu einerglobalen Ressourcendatei. (Wenn diese Option definiertist, muss auch ein Name für die Konfiguration derglobalen Ressource definiert werden, siehe nächsterEintrag).

· globalresourcefile (oder gr) - Name einer globalenRessourcenkonfiguration. (Wenn diese Option definiertist, muss ein Dateipfad zu einer globale Ressourcen-Datei definiert werden, siehe vorheriger Eintrag).

· catalog - Pfad zu eienr benutzerdefiniertenRootCatalog.xml-Datei. Mit Hilfe dieser Option könnenSie eine benutzerdefinierte Katalogdatei für dieAuflösung von im Mapping verwendeten URLsdefinieren. Der Standardkatalog befindet sich imUnterverzeichnis "etc" desProgramminstallationsverzeichnisses.

· taxonomy-package - Der Pfad zu einembenutzerdefinierten XBRL-Taxonomiepaket, falls einesfür das Mapping erforderlich ist.

· taxonomy-packages-config-file - Der Pfad zu einerbenutzerdefinierten XBRL-Taxonomiepaketkonfiguration,falls eine für das Mapping erforderlich ist.

Alle definierten Optionen sind während der Lebensdauer desObjekts gültig. Wenn Sie eine Option mit demselben Namenzwei Mal definieren, wird die vorherige Option außer Kraftgesetzt. Um alle Optionen explizit zu löschen, rufen Sie dieMethode clearOptions() auf.

setServerPath Definiert den Pfad der ausführbaren MapForce Server-Datei.

setWorkingDirectory Definiert das aktuelle Verzeichnis für ausgeführte Aufträge(relative Pfade werden anhand des Arbeitsverzeichnissesaufgelöst).

BeispieleEin Beispiel zur Erstellung einer neuen Instanz von MapForceServer in Java finden Sie im Java-Beispiel .

97

97

26

98

98

72

© 2020 Altova GmbH



5.6.1.1.1 Methoden

5.6.1.1.1.1 addCredentialPropertiesFromMap

Fügt zu den aktuellen Anmeldeinformationen Eigenschaften aus einer Anmeldeinformationen-Eigenschaftszuordnung hinzu. Diese Methode erhält als Argument eine Anmeldeinformationen-Eigenschaftszuordnung (property_name, property_value). Diese Methode muss nach beginCredential() undvor endCredential() aufgerufen werden. Alternativ dazu können Sie auch AddCredentialProperty()aufrufen.

Parameter


arg0 Map Eine Zuordnung, die den Namender Anmeldeinformationen-Eigenschaft und ihren Wertbereitstellt.

BeispieleIm folgenden Codefragment wird gezeigt, wie Sie Anmeldeinformationen namens "mycredential" mit Hilfe derMethode addCredentialPropertiesFromMap zum aktuellen Kontext hinzufügen.

//Create a MapForce Server objectcom.altova.mapforceserver.MapForceServer objMFS = new com.altova.mapforceserver.MapForceServer();

objMFS.beginCredential("mycredential");java.util.Map<String, String> credentialMap = new java.util.HashMap<String,String>();credentialMap.put("username", "altova");credentialMap.put("password", "b45ax78!");objMFS.addCredentialPropertiesFromMap(credentialMap);objMFS.endCredential();

5.6.1.1.1.2 addCredentialProperty

Fügt eine Eigenschaft zu den aktuellen Anmeldeinformationen hinzu (z.B. den Benutzernamen, das Passwortoder beides). Das erste Argument definiert den Namen der Eigenschaft, das zweite den Wert der Eigenschaft.Gültige Eigenschaftsnamen: username, password. In der MapForce Server Advanced Edition wird zusätzlichdazu der Eigenschaftsname oauth:token unterstützt.

Diese Methode muss nach beginCredential() und vor endCredential() aufgerufen werden. Alternativ dazukönnen Sie auch addCredentialProperty() aufrufen.



Parameter


arg0 String Der Name derAnmeldeinformationen-Eigenschaft(z.B. "username" oder"password").

arg1 String Der Wert derAnmeldeinformationen-Eigenschaft.

BeispieleIm folgenden Codefragment wird gezeigt, wie Sie Anmeldeinformationen namens "mycredential" deklarieren.Der Name der Anmeldeinformationen muss derjenige sein, der den Anmeldeinformationen in MapForce zumZeitpunkt des Designs gegeben wurde.

//Create a MapForce Server objectcom.altova.mapforceserver.MapForceServer objMFS = new com.altova.mapforceserver.MapForceServer(); objMFS.beginCredential("mycredential");objMFS.addCredentialProperty("username", "altova");objMFS.addCredentialProperty("password", "b45ax78!");objMFS.endCredential();

5.6.1.1.1.3 addParameter

Weist einem im Mapping definierten Parameter einen Wert zu.

Parameter


arg0 String Definiert den Parameternamen.

arg1 String Definiert den Parameterwert.

5.6.1.1.1.4 beginCredential

Erstellt neue Anmeldeinformationen mit dem als Argument bereitgestellten Namen. Wenn Sie diese Methodeaufrufen, müssen Sie mit Hilfe von addCredentialProperty() oder addCredentialPropertiesFromMap()auch Eigenschaften dazu hinzufügen und die Anmeldeinformationen schließlich durch Aufruf vonendCredential() schließen.

© 2020 Altova GmbH



Parameter


arg0 String Der Name derAnmeldeinformationen lautDefinition in MapForce.

5.6.1.1.1.5 clearCredentialList

Löscht die Liste der zuvor definierten Anmeldeinformationen. Alle Anmeldeinformationen sind während derLebensdauer des Objekts gültig. Rufen Sie diese Methode auf, wenn Sie alle zuvor definiertenAnmeldeinformationen explizit löschen möchten.

5.6.1.1.1.6 clearOptions

Löscht die Liste der zuvor mit der Methode setOption definierten Optionen. Alle mit der setOption-Methodedefinierten Methoden sind während der Lebensdauer des Objekts gültig. Rufen Sie diese Methode auf, wennSie alle zuvor gesetzten Optionen explizit löschen möchten.

5.6.1.1.1.7 clearParameterList

Löscht die Liste der zuvor mit der Methode addParameter definierten Parameter.

5.6.1.1.1.8 endCredential

Schließt ein zuvor mit der Methode beginCredential erstelltes Anmeldeinformationsobjekt.

5.6.1.1.1.9 getAPIMajorVersion

Ruft die Hauptversion der MapForce Server API ab. Diese stimmt unter Umständen nicht mit der Produktversionüberein, wenn die API mit einem anderen Server verbunden ist.

5.6.1.1.1.10 getAPIMinorVersion

Ruft die Nebenversion der MapForce Server API ab. Diese stimmt unter Umständen nicht mit derProduktversion überein, wenn die API mit einem anderen Server verbunden ist.



5.6.1.1.1.11 getAPIServicePackVersion

Ruft die Service Pack-Version der MapForce Server API ab. Diese stimmt unter Umständen nicht mit derProduktversion überein, wenn die API mit einem anderen Server verbunden ist.

5.6.1.1.1.12 getLastExecutionMessage

Ruft die beim letzten run-Befehl erhaltene Meldung ab.

5.6.1.1.1.13 getMajorVersion

Ruft die Hauptversion des Produkts als Anzahl von Jahren seit 1998 ab (z.B. "20" für Altova MapForce Server2018).

5.6.1.1.1.14 getMinorVersion

Ruft die Nebenversion des Produkts ab (z.B. "2" für Altova MapForce Server 2018 r2).

5.6.1.1.1.15 getOutputParameter

Ruft den mit dem letzten run-Befehl generierten String Output ab. Gibt Null zurück, wenn kein Output generiertwurde. Für diese Funktion ist ein String-Parameter, der den Namen der Output-Komponente in MapForcedefiniert, erforderlich.

Parameter


arg0 String Definiert den Namen der Output-Komponente, wie er in MapForceangezeigt wird. Dieser Name wirdin der Titelleiste jeder Komponentedes Mappings angezeigt (oderwenn Sie mit der rechtenMaustaste auf dieKomponentenüberschrift klickenund den Befehl Eigenschaftenwählen.)

5.6.1.1.1.16 getProductName

Ruft den Namen des Produkts ab (z.B. "Altova MapForce Server").

© 2020 Altova GmbH



5.6.1.1.1.17 getProductNameAndVersion

Ruft den vollständigen Namen und die Version des Produkts ab (z.B. "Altova MapForce Server 2018 r2 sp1(x64)").

5.6.1.1.1.18 getServicePackVersion

Ruft die Service Pack-Version des Produkts ab bzw. definiert sie (z.B. "1" für Altova MapForce Server 2018 r2sp1 (x64)).

5.6.1.1.1.19 is64bit

Gibt true zurück, wenn der MapForce Server-Prozessor eine ausführbare 64-Bit-Datei ist.

5.6.1.1.1.20 run

Führt eine MapForce Server-Ausführungsdatei (.mfx-Datei) aus. Gibt bei Erfolg true zurück, andernfalls false.

Parameter


arg0 String Definiert den Pfad zur MapForceServer-Ausführungsdatei (.mfx)-Datei. Wenn Sie einen relativenPfad definiert haben, wird dieseranhand des Arbeitsverzeichnissesaufgelöst. Sie können dasArbeitsverzeichnis durch Aufruf derMethode setWorkingDirectorydefinieren.

5.6.1.1.1.21 setOption

Definiert vor Ausführung des Mappings eine Option. Das erste Argument definiert den Namen der Option, daszweite Argument definiert den Optionswert. Diese Methode ist besonders dann nützlich, wenn in einemMapping globale Ressourcen verwendet werden (siehe Globale Altova-Ressourcen ). Derzeit werden diefolgenden Optionen unterstützt:

· globalresourcefile (oder gr) - Der Pfad zu einer globalen Ressourcendatei. (Wenn diese Optiondefiniert ist, muss auch ein Name für die Konfiguration der globalen Ressource definiert werden, siehenächster Eintrag).

· globalresourcefile (oder gr) - Name einer globalen Ressourcenkonfiguration. (Wenn diese Optiondefiniert ist, muss ein Dateipfad zu einer globale Ressourcen-Datei definiert werden, siehe vorherigerEintrag).

26



· catalog - Pfad zu eienr benutzerdefinierten RootCatalog.xml-Datei. Mit Hilfe dieser Option könnenSie eine benutzerdefinierte Katalogdatei für die Auflösung von im Mapping verwendeten URLsdefinieren. Der Standardkatalog befindet sich im Unterverzeichnis "etc" desProgramminstallationsverzeichnisses.

· taxonomy-package - Der Pfad zu einem benutzerdefinierten XBRL-Taxonomiepaket, falls eines fürdas Mapping erforderlich ist.

· taxonomy-packages-config-file - Der Pfad zu einer benutzerdefinierten XBRL-Taxonomiepaketkonfiguration, falls eine für das Mapping erforderlich ist.

Alle definierten Optionen sind während der Lebensdauer des Objekts gültig. Wenn Sie eine Option mitdemselben Namen zwei Mal definieren, wird die vorherige Option außer Kraft gesetzt. Um alle Optionen explizitzu löschen, rufen Sie die Methode clearOptions() auf.

Parameter


arg0 String Definiert den Namen der zusetzenden Option.

arg1 String Definiert den Wert der zusetzenden Option.

5.6.1.1.1.22 setServerPath

Definiert den Pfad der ausführbaren MapForce Server-Datei.

Parameter


arg0 String Definiert den Pfad derausführbaren MapForce Server-Datei.

5.6.1.1.1.23 setWorkingDirectory

Definiert das aktuelle Verzeichnis für ausgeführte Aufträge (relative Pfade werden anhand desArbeitsverzeichnisses aufgelöst).

Parameter


arg0 String Definiert den Pfad zumArbeitsverzeichnis.

© 2020 Altova GmbH



5.6.1.2 MapForceServerException

Die Klasse MapForceServerException bietet programmatischen Zugriff auf von der Klasse MapForceServerausgelöste Ausnahmen.

public class MapForceServerException extends Exception

100 Verwaltung digitaler Zertifikate



Die Verwaltung digitaler Zertifikate spielt eine wichtige Rolle beim sicheren Austausch von Daten zwischeneinem Client-Rechner und einem Webserver. Da Mappings nicht nur durch MapForce unter Windowsausgeführt werden können, sondern auch durch MapForce Server (entweder als Standalone-Version oder ineiner FlowForce Server-Ausführung) auf einem Windows-, Linux- oder macOS-Server, wird in diesem Abschnittdie Verwaltung von HTTPS-Zertifikaten auf verschiedenen Plattformen behandelt.

Im Zusammenhang mit dem sicheren HyperText Transport Protocol (HTTPS) muss zwischen Server- undClient-Zertifikaten unterschieden werden.

Server-ZertifikateEin Server-Zertifikat dient dazu, einen Server für eine Client-Applikation wie z.B. MapForce als vertrauenswürdigzu erkennen. Das Server-Zertifikat kann von einer kommerziellen Zertifizierungsstelle oder von IhremUnternehmen selbst digital signiert sein. In beiden Fällen können Sie beim Erstellen eines Mappings inMapforce die folgenden Einstellungen definieren:

· ob das Server-Zertifikat überprüft werden muss,· ob mit dem Request fortgefahren werden soll, wenn das Namenszertifikat nicht mit dem Namen des

Host übereinstimmt.

Diese Einstellungen werden über das MapForce-Dialogfeld "HTTP-Sicherheitseinstellungen" vorgenommen .Wenn Sie die Überprüfung der Server-Zertifikate aktivieren, beachten Sie die folgenden Punkte:

· Wenn Sie einen Webserver aufrufen, dessen Zertifikat von einer vertrauenswürdigen Zertifizierungsstellesigniert ist, erkennt Ihr Betriebssystem das Server-Zertifikat von seiner Konfiguration her meist bereitsals vertrauenswürdig, sodass keine zusätzliche Konfiguration erforderlich ist.

· Wenn Sie einen Webserver aufrufen, der ein selbst signiertes Zertifikat bereitstellt (z.B. einen lokalenNetzwerkserver in Ihrem Unternehmen), so müssen Sie auch Ihr Betriebssystem so konfigurieren, dasses dieses Zertifikat als vertrauenswürdig erkennt.

In den meisten Fällen können Sie die Konfiguration der Vertrauenswürdigkeit überprüfen, indem Sie die URLdes Webservice in die Adressleiste Ihres Browsers eingeben. Wenn dem Server nicht vertraut wird oder wennIhr Betriebssystem den Server laut Konfiguration nicht als vertrauenswürdig einstuft, so wird in Ihrem Browsereine Meldung ungefähr folgenden Inhalts angezeigt "Diese Verbindung ist nicht vertrauenswürdig" oder "Es gibtein Problem mit dem Zertifikat der Website". Beachten Sie, dass Sie die Einstellung für dieVertrauenswürdigkeit eines Webservers nicht überprüfen können, wenn der Browser eine andere Zertifikat-Datenbank als die des Betriebssystems verwendet (z.B. Firefox auf Ubuntu).

Unter Windows können Sie die Vertrauenswürdigkeit einer Verbindung durch Befolgen der Anweisungen imBrowser und Importieren oder Installieren des benötigten Zertifikats im Speicher der vertrauenswürdigenStammzertifikate bestätigen (siehe Vertrauenswürdige Server-Zertifikate unter Windows ). Auf macOS-Systemen können Sie die entsprechende Operation in Keychain Access durchführen (siehe VertrauenswürdigeServer-Zertifikate auf macOS ). Eine Anleitung zu Linux-Systemen finden Sie unter VertrauenswürdigeServer-Zertifikate unter Linux .

Client-ZertifikateWährend Server-Zertifikate dazu dienen, einen Server als vertrauenswürdig zu erkennen, werden Client-Zertifikate in erste Linie dazu verwendet, den aufrufenden Client auf dem Webserver zu identifizieren. Wenn Sie

106

105

103

© 2020 Altova GmbH

101Verwaltung digitaler Zertifikate


vorhaben, auf einen Webserver zuzugreifen, für den Client-Zertifikate erforderlich sind, müssen Siemöglicherweise den Administrator des Webservers bezüglich einer Client-Konfigurationsanweisungkontaktieren. So kann ein Webserver z.B. bei IIS (Internet Information Services) so konfiguriert werden, dass erHTTPS- und Client-Zertifikate auf eine der folgenden Arten behandelt:

· HTTPS ist erforderlich und Client-Zertifikat wird ignoriert· HTTPS ist erforderlich und Client-Zertifikat wird akzeptiert· HTTPS und Client-Zertifikat sind erforderlich

Der Erfolg eines Webservice-Request hängt von der Konfiguration des Webservers und der Client-Applikationab. Wenn der Webserver z.B. so konfiguriert ist, dass er ein Client-Zertifikat verlangt, so muss die aufrufendeApplikation ein gültiges Client-Zertifikat zur Verfügung stellen, damit der Aufruf erfolgreich ist.

Aus der MapForce-Perspektive gesehen, gilt dasselbe für Mappings, die Webservice-Aufrufe über HTTPSenthalten. Damit solche Mappings erfolgreich ausgeführt werden können, geht MapForce davon aus, dass derWebserver so konfiguriert ist, dass er das Client-Zertifikat akzeptiert oder zwingend verlangt und dass dasBetriebssystem, auf dem das Mapping ausgeführt wird, das richtige Client-Zertifikat für den Webserver zurVerfügung stellt.

Im unten gezeigten Diagramm sehen Sie ein Szenario, in dem ein in MapForce verwendetes Client-Zertifikat aufeinen Linux-Server transferiert wird, auf dem MapForce Server ausgeführt wird. Sobald das Zertifikat auf dasZielbetriebssystem transferiert wurde, kann MapForce Server sich mit Hilfe dieses Zertifikats beim Webserverauthentifizieren und das Mapping erfolgreich ausführen.

Bereitstellen von Mappings mit Client-Zertifikaten auf einem anderen Rechner

Bei einer HTTPS-Authentifizierung in Webservice-Aufrufen kann MapForce zusätzlich zu HTTP die TransportLayer Security (TLS) verwendenon. TLS ist der Nachfolger des SSL (Secure Sockets Layer)-Protokolls.Beachten Sie dass der Client bzw. Server auf SSL zurückgreift, falls die Client- bzw. Server-Implementierung



TLS nicht unterstützt.

Die jeweilige Implementierung der Zertifikatverwaltung auf den einzelnen Plattformen ist dafür verantwortlich,dass Webservice-Aufrufe mit Client-Authentifizierung durch MapForce unterstützt werden. Daher muss dieZertifikatverwaltung immer im Rahmen des zugrunde liegenden Betriebssystems erfolgen. JedesBetriebssystem bietet unterschiedliche Unterstützung für Zertifikatverwaltung - siehe Tabelle unten.

Plattform Zertifikatverwaltung und -implementierung

Windows Unter Windows können Sie Zertifikate mit Hilfe des Zertifikat-Snap-in verwalten(siehe Aufrufen der Zertifikatspeicher unter Windows ).

TLS-Unterstützung steht über den Sicheren Kanal (auch als SKanalbezeichnet) zur Verfügung.

Linux Unter Linux können Sie Zertifikate mit Hilfe des OpenSSL (openssl)Befehlszeilentools und der dazugehörigen Bibliothek verwalten. Falls auf demLinux-Recher, auf dem MapForce Server installiert ist, noch keine OpenSSL-Unterstützung zur Verfügung steht, müssen Sie diese Funktion herunterladenund sie installieren, bevor Sie Zertifikate verwalten können.

TLS-Unterstützung steht über die OpenSSL-Bibliothek zur Verfügung(https://www.openssl.org/).

macOS Auf macOS-Rechnern können Sie Zertifikate mit dem Keychain AccessManager unter Finder > Applications > Utilities verwalten.

TLS-Unterstützung steht über die native Secure Transport-Bibliothek zurVerfügung

Wenn Sie das Mapping auf einem Windows-Betriebssystem ausführen, auf dem Sie den Webservice, den Sieaufrufen möchten, bereits erfolgreich verwendet haben, ist normalerweise keine zusätzlicheZertifikatkonfiguration erforderlich (Welche Bedingungen erfüllt werden müssen, damit das Mapping erfolgreichunter Windows ausgeführt werden kann, finden Sie unter Client-Zertifikate unter Windows ). Wenn Sieallerdings auf einem Windows-Rechner Mappings mit MapForce erstellen und diese dann auf einem anderenComputer bereitstellen (der möglicherweise unter einem anderen Betriebssystem läuft), so wird das Client-Zertifikat nicht zusammen mit dem bereitgestellten Paket gespeichert bzw. kopiert. Damit der Webservice-Aufrufe (und das Mapping) erfolgreich ausgeführt werden können, muss das Client-Zertifikat auch auf demZielbetriebssystem vorhanden sein.

Um ein Zertifikat von einem Windows-System auf einen anderen Windows-basierten Rechner zu transferieren,exportieren Sie das erforderliche Zertifikat (mit dem privaten Schlüssel) aus dem Ausgangssystem (sieheExportieren von Zertifikaten aus Windows ). Importieren Sie anschließend dasselbe Zertifikat in den SpeicherAktueller Benutzer\Persönlich auf dem Zielbetriebssystem (siehe Client-Zertifikate unter Windows ).

Eine Anleitung zum Transferieren von Client-Zertifikaten auf die Linux- und macOS-Plattform finden Sie unterClient-Zertifikate unter Linux bzw. Client-Zertifikate unter macOS .

107

120

110

120

116 118

https://www.openssl.org/

© 2020 Altova GmbH

Definieren vertrauenswürdiger Zertifikate unter Linux 103Verwaltung digitaler Zertifikate


6.1 Definieren vertrauenswürdiger Zertifikate unter Linux

Auf Linux-Systemen gehen Sie vor, wie unten gezeigt, um ein vertrauenswürdiges Zertifikat in denZertifikatspeicher des Systems zu importieren:

Führen Sie die folgenden Schritte nur durch, wenn Sie sicher sind, dass das betreffende Zertifikatauthentisch ist.

Befolgen Sie auf Debian und Ubuntu die folgende Anleitung:

1. Kopieren Sie die Zertifikatdatei des Webservers in das folgende Verzeichnis.

sudo cp /home/downloads/server_cert.crt /usr/local/share/ca-certificates/

2. Aktualisieren Sie den Zertifikatspeicher folgendermaßen:

sudo update-ca-certificates

Befolgen Sie auf CentOS die folgende Anleitung:

1. Installieren Sie das Paket ca-certificates:

yum install ca-certificates

2. Aktivieren Sie die Funktion zur dynamischen Konfiguration der Zertifizierungsstelle:

update-ca-trust enable

3. Kopieren Sie das Server-Zertifikat in das folgenden Verzeichnis:

cp server_cert.crt /etc/pki/ca-trust/source/anchors/

4. Verwenden Sie den folgenden Befehl:

update-ca-trust extract

In Fällen, in denen Sie nur über den Browser auf den Server zugreifen, genügt es, das Zertifikat in denZertifikatspeicher des Browsers zu importieren. Die genaue Vorgehensweise variiert je nach Browser. In Firefox59.0.2 können Sie z.B. folgendermaßen vorgehen:

1. Klicken Sie unter Options | Privacy & Security auf View Certificates.2. Klicken Sie auf dem Register Authorities auf Import und navigieren Sie zur zuvor erstellen Root-

Zertifikatdatei.3. Aktivieren Sie die Option Trust this CA to identify websites, wenn Sie gefragt werden.

104 Verwaltung digitaler Zertifikate Definieren vertrauenswürdiger Zertifikate unter Linux


© 2020 Altova GmbH

Definieren vertrauenswürdiger Zertifkate auf macOS-Systemen 105Verwaltung digitaler Zertifikate


6.2 Definieren vertrauenswürdiger Zertifkate aufmacOS-Systemen

Auf macOS-Systemen importieren Sie ein vertrauenswürdiges Zertifikat auf folgende Weise in den KeychainAccess.

1. Starten Sie Keychain Access.2. Klicken Sie auf System und anschließend auf Certificates.3. Klicken Sie im Menü File auf Import Items.4. Navigieren Sie zum gewünschten vertrauenswürdigen Zertifikat und klicken Sie auf Open.5. Geben Sie das Keychain Access-Passwort ein, wenn Sie dazu aufgefordert werden und klicken Sie

anschließend auf Modify Keychain.6. Doppelklicken Sie auf das Zertifikat, erweitern Sie den Abschnitt Trust und aktivieren Sie die Option

Always Trust.

106 Verwaltung digitaler Zertifikate Definieren vertrauenswürdiger Zertifikate unter Windows


6.3 Definieren vertrauenswürdiger Zertifikate unterWindows

Auf Windows-Systemen importieren Sie ein vertrauenswürdiges Zertifikat auf folgende Weise in denZertifikatspeicher des Systems:

1. Öffnen Sie den Windows-Zertifikatspeicher für das Computer-Konto, siehe Aufrufen des Windows-Zertifikatspeichers .

Führen Sie die folgenden Schritte nur durch, wenn Sie sicher sind, dass das Webserver-Zertifikatauthentisch ist.

1. Klicken Sie unter "Vertrauenswürdige Stammzertifizierungsstellen" mit der rechten Maustaste aufZertifikate wählen Sie Alle Aufgaben | Importieren und befolgen Sie die Anweisungen desZertifikatimportassistenten.

Nähere Informationen dazu finden Sie unter https://technet.microsoft.com/en-us/library/cc754489(v=ws.11).aspx.

107

https://technet.microsoft.com/en-us/library/cc754489(v=ws.11).aspx

https://technet.microsoft.com/en-us/library/cc754489(v=ws.11).aspx

© 2020 Altova GmbH

Aufrufen der Zertifikatspeicher unter Windows 107Verwaltung digitaler Zertifikate


6.4 Aufrufen der Zertifikatspeicher unter Windows

Auf Windows-Systemen können Sie Zertifikate entweder über das Microsoft Management Console (MMC)Snap-in entweder für Ihr Benutzerkonto oder für das Computerkonto verwalten.

So öffnen Sie das Snap-in "Zertifikate" (für den aktuellen Windows-Benutzer):

· Führen Sie certmgr.msc in der Befehlszeile aus.

So öffnen Sie das Snap-in "Zertifikate" (für das Computerkonto):

1. Führen Sie in der Befehlszeile den Befehl mmc aus.2. Klicken Sie im Menü Datei auf Snap-in hinzufügen/entfernen.3. Klicken Sie auf Zertifikate und anschließend auf Hinzufügen.

4. Klicken Sie auf Computerkonto und anschließend auf Weiter.

108 Verwaltung digitaler Zertifikate Aufrufen der Zertifikatspeicher unter Windows


5. Klicken Sie auf Lokalen Computer und anschließend auf Fertig stellen.

© 2020 Altova GmbH

Aufrufen der Zertifikatspeicher unter Windows 109Verwaltung digitaler Zertifikate


110 Verwaltung digitaler Zertifikate Exportieren von Zertifikaten aus Windows


6.5 Exportieren von Zertifikaten aus Windows

Bei Mappings, in denen Webservices über HTTPS aufgerufen werden und die auf einem macOS- oder Linux-Server, auf dem MapForce Server oder FlowForce Server ausgeführt wird, bereitgestellt werden, muss auf demNicht-Windows-Betriebssystem dasselbe Client-Zertifikat zur Verfügung stehen, das auch beim Design undTesten des Mappings unter Windows verwendet wurde. Um solche Mappings auf einem anderenBetriebssystem als Windows mit MapForce Server ausführen zu können, exportieren Sie das erforderlicheZertifikat mit dem privaten Schlüssel aus Windows und importieren Sie es anschließend in dasZielbetriebssystem.

So exportieren Sie ein Zertifikat mit einem privaten Schlüssel aus Windows:

1. Öffen Sie in Windows das Zertifikate-Snap-in (siehe Aufrufen der Zertifikatspeicher unter Windows ).2. Klicken Sie mit der rechten Maustaste auf das gewünschte Zertifikat, platzieren Sie den Mauszeiger

über Alle Aufgaben und klicken Sie auf Exportieren.3. Klicken Sie auf Weiter.

4. Wählen Sie die Option, dass das Zertifikat zusammen mit seinem privaten Schlüssel aus Windowsexportiert werden soll und klicken Sie anschließend auf Weiter.

107

© 2020 Altova GmbH

Exportieren von Zertifikaten aus Windows 111Verwaltung digitaler Zertifikate


5. Wählen Sie das Dateiformat Privater Informationsaustausch - PKCS #12 (.pfx) aus und klicken Sie aufWeiter.



Anmerkung: Stellen Sie sicher, dass Sie nicht die Option Privaten Schlüssel nach erfolgreichemExport löschen aktiviert haben, da Sie das Zertifikat nach dem Export sonst nicht mehr verwenden können.

6. Geben Sie ein Passwort ein und klicken Sie auf Weiter. Sie benötigen dieses Passwort nachdem Siedas Zertifikat in das Zielbetriebssystem kopiert haben.

© 2020 Altova GmbH



7. Navigieren Sie zur Datei, die Sie exportieren möchten und klicken Sie auf Weiter.



8. Klicken Sie auf fertig stellen.

© 2020 Altova GmbH



116 Verwaltung digitaler Zertifikate Client-Zertifikate unter Linux


6.6 Client-Zertifikate unter Linux

Wenn Ihre Mappings eine Webservice-Authentifizierung mittels Client-Zertifikaten über HTTPS enthalten,befolgen Sie die folgende Anleitung, um solche Mappings auf einem Linux-Rechner, auf dem MapForce Serverläuft, bereitzustellen:

1. Öffnen Sie das Mapping, das den Webservice aufruft, in MapForce.2. Doppelklicken Sie auf die Überschrift der Webservice-Komponente. Daraufhin wird das Dialogfeld

"Komponenteneinsetllungen" aufgerufen.3. Klicken Sie neben "HTTP-Sicherheitseinstellungen" auf Bearbeiten.4. Klicken Sie im Dialogfeld "HTTP-Sicherheitseinstellungen" auf Client-Zertifikat und wählen Sie

anschließend in Windows das gewünschte Zertifikat aus dem Speicher AktuellerBenutzer\Persönlich aus .

5. Speichern Sie das Mapping und kompilieren Sie es zu einerm Mapping-Ausführungsdatei oder stellenSie es auf FlowForce bereit.

6. Übertragen Sie die für den Webservice-Aufruf erforderlichen Client-Zertifikate auf dasZielbetriebssystem. Stellen Sie sicher, dass das Zertifikat einen privaten Schlüssel hat und dass dieEigenschaft Erweiterte Schlüsselverwendung des Zertifikats "Clientauthentifizierung" als Zweckenthält.

So transferieren Sie das Client-Zertifikat auf Linux:

1. Exportieren Sie das Client-Zertifikat mit dem privaten Schlüssel im Dateiformat PrivaterInformationsaustausch - PKCS #12 (.pfx) (siehe Exportieren von Zertifikaten aus Windows ).

2. Kopieren Sie die Zertifikatdatei auf den Linux-Rechner.3. Konvertieren Sie die .pfx-Datei mit dem folgenden Befehl in das .pem-Format.

openssl pkcs12 -in cert.pfx -out "John Doe.pem" -nodes

Dieser Befehl parst die .pfx-Datei und erzeugt eine .pem-Datei, ohne dabei den privaten Schlüssel zuverschlüsseln. Bei Zertifikaten mit einem verschlüsselten privaten Schlüssel wird nach einem Passwortgefragt, was bei der Server-Ausführung nicht unterstützt wird.

Ausführen des MappingsDamit MapForce Server die .pem-Datei als Client-Zertifikat verwendet, definieren Sie beim Ausführen desMappings den Parameter --certificatespath. Der Parameter --certificatespath definiert den Pfad zudem Verzeichnis, in dem alle vom aktuellen Mapping benötigten Zertifikate gespeichert sind. Wenn der Pfadzur Zertifikatdatei z.B. /home/John/John Doe.pem lautet, so muss --certificatespath auf /home/Johngesetzt werden.

Wenn der Parameter --certificatespath nicht angegeben wird, sucht MapForce Server standardmäßig imVerzeichnis $HOME/.config/altova/certificates des aktuellen Benutzers nach Zertifikaten.

Damit das Mapping erfolgreich ausgeführt werden kann, muss die Zertifikatdatei die Erweiterung .pemhaben und der Name der Datei muss mit dem Common Name (CN) des Zertifikats einschließlich derLeerzeichen übereinstimmen (z.B. John Doe.pem).

Wenn Sie vorhaben, das Mapping als FlowForce Server-Auftrag auszuführen, kopieren Sie das Zertifikat in das

110

© 2020 Altova GmbH

Client-Zertifikate unter Linux 117Verwaltung digitaler Zertifikate


Verzeichnis $HOME/.config/altova/certificates. FlowForce Server sucht bei Ausführung des Auftrags indiesem Verzeichnis nach allen für das Mapping erforderlichen Zertifikatdateien.

Stellen Sie aus Sicherheitsgründen sicher, dass Zertifikatdateien nicht von anderen Benutzern gelesenwerden können, da sie sensible Informationen enthalten.

118 Verwaltung digitaler Zertifikate Client-Zertifikate auf macOS


6.7 Client-Zertifikate auf macOS

Wenn Ihre Mappings eine Webservice-Authentifizierung mittels Client-Zertifikaten über HTTPS enthalten,befolgen Sie die folgende Anleitung, um solche Mappings auf einem macOS-System, auf dem MapForceServer läuft, bereitzustellen:

1. Öffnen Sie das Mapping, das den Webservice aufruft, in MapForce.2. Doppelklicken Sie auf die Überschrift der Webservice-Komponente. Daraufhin wird das Dialogfeld

"Komponenteneinsetllungen" aufgerufen.3. Klicken Sie neben "HTTP-Sicherheitseinstellungen" auf Bearbeiten.4. Klicken Sie im Dialogfeld "HTTP-Sicherheitseinstellungen" auf Client-Zertifikat und wählen Sie

anschließend das gewünschte Zertifikat aus .5. Wenn der Zertifikatname nicht genau mit dem Host-Namen des Servers übereinstimmt, aktivieren Sie

die Option Diskrepanz zwischen Host-Namen im Zertifikat und Request zulassen.6. Speichern Sie das Mapping und stellen Sie es auf dem Zielbetriebssystem bereit. 7. Übertragen Sie die für den Webservice-Aufruf erforderlichen Client-Zertifikate auf das

Zielbetriebssystem. Stellen Sie sicher, dass das Zertifikat einen privaten Schlüssel hat und dass dieEigenschaft Erweiterte Schlüsselverwendung des Zertifikats "Clientauthentifizierung" als Zweckenthält.

So übertragen Sie das Client-Zertifikat auf das macOS-System:

1. Exportieren Sie das Client-Zertifikat mit dem privaten Schlüssel im Dateiformat PrivaterInformationsaustausch - PKCS #12 (.pfx) (sieheExportieren von Zertifikaten aus Windows ) ausWindows und kopieren Sie die .pfx-Datei auf den macOS.

2. Stellen Sie sicher, dass das Betriebssystem das Server-Zertifikat als vertrauenswürdig einstuft (sieheDefinieren vertrauenswürdiger Zertifkate auf Mac-Systemen .

3. Führen Sie über Finder > Applications > Utilities Keychain Access aus.4. Klicken Sie im Menü File auf Import Items.5. Navigieren Sie zu dem in Schritt 1 exportierten Client-Zertifikat und wählen Sie eine Ziel-Keychain aus.6. Klicken Sie auf Open und geben Sie das Passwort ein, mit dem das Zertifikat verschlüsselt wurde.

Ausführen des MappingsSie können jetzt das Mapping mit dem MapForce Server-Befehl run ausführen. Beachten Sie dazu Folgendes:

· Wenn Sie das Mapping über einen entfernten Rechner mittels SSH ausführen, entsperren Sie zuerstdie Keychain mit dem Befehl security unlock-keychain.

· Wenn Sie das Mapping über die grafische Benutzeroberfläche von macOS ausführen, klicken Sie aufAllow, wenn Sie gefragt werden, ob MapForce Server Zugriff auf die Keychain erhalten soll.

110

105

© 2020 Altova GmbH

Client-Zertifikate auf macOS 119Verwaltung digitaler Zertifikate


120 Verwaltung digitaler Zertifikate Client-Zertifikate unter Windows


6.8 Client-Zertifikate unter Windows

Wenn Sie unter Windows ein Mapping ausführen, für das Client-Zertifikate erforderlich sind, müssen diefolgenden Voraussetzungen erfüllt werden, damit das Mapping erfolgreich ausgeführt werden kann:

· Das Client-Zertifikat muss im Zertifikatspeicher Aktueller Benutzer\Persönlich (auch als MeinSpeicher bezeichnet) vorhanden sein. Dazu muss es mit dem Zertifikatimport-Assistenten importiertwerden. Eine Anleitung dazu finden Sie unter https://technet.microsoft.com/de-de/library/cc754489(v=ws.11).aspx.

· Das Zertifikat muss einen privaten Schlüssel haben.· Die Eigenschaft Erweiterte Schlüsselverwendung des Zertifikats muss als Zweck

"Clientauthentifizierung" enthalten.

In der aktuellen Version von MapForce wählt Windows das erforderliche Zertifikat aufgrund einer Einschränkungder von MapForce verwendeten Bibliothek automatisch aus dem Zertifikatspeicher aus, wenn Sie das Mappingausführen. Das Mapping wird erfolgreich ausgeführt, wenn der Server nach dem Filtern des ZertifikatspeichersAktueller Benutzer\Persönlich ein passendes Zertifikat findet. Beachten Sie, dass die HTTPS-Authentifizierung (und die Auswahl des Zertifikats) von Windows und nicht von MapForce oder MapForce Server

https://technet.microsoft.com/de-de/library/cc754489(v=ws.11).aspx

https://technet.microsoft.com/de-de/library/cc754489(v=ws.11).aspx

© 2020 Altova GmbH

Client-Zertifikate unter Windows 121Verwaltung digitaler Zertifikate


gesteuert wird. Es kann vorkommen, dass im Zertifikatspeicher Aktueller Benutzer\Persönlich mehrereZertifikate vorhanden sind und dass das Betriebssystem automatisch ein unpassendes Zertifikat auswählt,wodurch das Mapping fehlschlägt. Diese Situation lässt sich vermeiden, indem Sie die Anzahl der im SpeicherAktueller Benutzer\Persönlich verfügbaren Zertifikate einschränken.

Index

© 2020 Altova GmbH

122

Index

AADO, 6, 20

ADO.NET, 6, 20

assignlicense,

als CLI-Befehl, 38

BBefehlszeilenschnittstelle,

Verwendung, 35

CC#,

Beispiel, 55

Mappings ausführen mit, 55

C++,

Beispiel, 61


CLI-Befehle,

assignlicense, 38

exportresourcestrings, 40

help, 42

licenseserver, 43

run, 45

setdeflang, 49

verifylicense, 50, 52

DDigitale Zertifikate,

auf Linux übertragen, 116

auf Mac übertragen, 118

aus Windows exportieren, 110

in MapForce Mappings, 100

unter Windows verwalten, 107

vertrauenswürdige auf Mac-Systemen einrichten, 105

vertrauenswürdige unter Linux einrichten, 103

vertrauenswürdige unter Windows einrichten, 106

Eexportresourcestrings,

als CLI-Befehl, 40

FFlowForce Server, 6, 17, 20

GGlobale Ressourcen,

Definition, 26

in Mappings verwenden, 26

Hhelp,

als CLI-Befehl, 42

HTTPS,

Webservices aufrufen über, 100

JJava, 20

Beispiel, 72

MapForce Server aufrufen über, 72

MapForce Server zum CLASSPATH hinzufügen, 70

JDBC, 6

Join-Optimierung,

Funktionsweise, 28

© 2020 Altova GmbH

Index 123

Llicenseserver,

als CLI-Befehl, 43

Linux,

Anzeige der installierten Altova-Produkte, 11

Client-Zertifikate übertragen auf, 116

Deinstallation von MapForce Server von, 11

Info zur Unterstützung, 7

Installation von MapForce Server unter, 10

Mappings mit Webservice-Aufrufen über HTTPSausführen, 116

vertrauenswürdige Server-Zertifikate einrichten, 103

MMac,

Client-Zertifikate übertragen auf, 118



macOS,




MapForce Server API,

C#-Beispiel, 55

C++-Beispiel, 61

Einführung, 53

für .NET, 54

für COM, 61

für Java, 70

Java-Beispiel, 72

VBA-Beispiel, 67

Mappings,

auf FlowForce Server bereitstellen, 17

mit C# ausführen, 55

mit C++ ausführen, 61

mit Java ausführen, 72

mit VBA ausführen, 67

über die Befehlszeile ausführen, 45

vorbereiten für die Ausführung, 20

zu Ausführungsdateien kompilieren, 17

OODBC, 6, 20

Rrun,

CLI-Befehle, 45

Ssetdeflang,

als CLI-Befehl, 49

VVBA,

Beispiel, 67


verifylicense,

als CLI-Befehl, 50

version,

als CLI-Befehl, 52

WWebservices,

über HTTPS aufrufen, 100

Windows,




