Altova MapForce Server 2024 

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

•assignlicense: (nur Windows) Lädt eine Lizenz in LicenseServer hoch und weist sie MapForce Server 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 Betriebssystem geltenden Pfad zur ausführbaren Datei kennen. Standardmäßig befindet sich die ausführbare MapForce Server-Datei unter dem folgenden Pfad:

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

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 Ihr Eingabeaufforderungsfenster (Terminal) befindet, ausführen. Wenn Sie die ausführbare Datei jedoch nur durch Eingabe 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 Tricks

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

•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 eines Pfads oder Befehls wahrscheinlich vertippt.

•Unter Linux muss bei Eingabe von Datei- oder Verzeichnisnamen die Groß- und Kleinschreibung beachtet 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 den Schrägstrich vorwärts.

Ausführen eines Befehls

1.Ö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 das Terminal-Symbol.

c.Wenn Sie Linux über eine grafische Benutzeroberfläche ausführen, navigieren Sie zum jeweiligen Terminal-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 den nachstehenden Befehl können Sie z.B. die Hilfe in der Befehlszeile aufrufen.

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 angeben können. Nähere Informationen zu den einzelnen Befehlen finden Sie im Abschnitt "Referenz".

Aufruf von MapForce Server im Installationsverzeichnis

Um die ausführbare Datei aufzurufen, ohne den vollständigen Pfad eingeben zu müssen, wechseln Sie in das Verzeichnis, in dem die ausführbare MapForce Server-Datei installiert wurde, z.B:

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

Aufruf von MapForce Server von jedem beliebigen Verzeichnis aus

Um 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 aufrufen möchten, können Sie die Umgebungsvariable PATH Ihres Betriebssystems bearbeiten, sodass diese den vollständigen Pfad zum MapForce Server-Installationsverzeichnis enthält. Wie Sie die PATH-Umgebungsvariable ändern können, finden Sie in der Dokumentation zu Ihrem Betriebssystem.