Erstellen eines Auftrags anhand eines Mapforce Mappings
In diesem Beispiel wird gezeigt, wie Sie anhand eines MapForce Mappings einen FlowForce Server-Auftrag erstellen. Zuerst müssen Sie ein Demo-Mapping aus MapForce auf FlowForce Server bereitstellen. Nachdem die Transformation auf FlowForce Server bereitgestellt wurde, erstellen Sie einen Auftrag anhand dieser Datei. Der Auftrag wird für die tägliche Ausführung zu einer bestimmten Uhrzeit konfiguriert.
Voraussetzungen
•Benötigte Lizenzen: MapForce Enterprise oder Professional Edition, MapForce Server oder MapForce Server Advanced Edition, FlowForce Server
•Der FlowForce Web Server- und der FlowForce Server-Dienst werden an der konfigurierten Netzwerkadresse und am konfigurierten Port ausgeführt und sind dort empfangsbereit.
•Sie haben ein FlowForce Server-Benutzerkonto mit Berechtigungen für einen der Container (standardmäßig hat jeder authentifizierte Benutzer Zugriff auf den in diesem Beispiel verwendeten Container /public).
•Mit dem in diesem Beispiel erstellten Mapping-Auftrag wird bei jeder Ausführung eine XML-Datei erstellt. Sie benötigen daher auf dem Betriebssystem, auf dem FlowForce Server ausgeführt wird, Schreibrechte für ein Verzeichnis (in diesem Beispiel wird das Verzeichnis C:\FlowForceExamples\Mapping verwendet).
Verwendete Demo-Dateien
Der Name der Mapping-Datei in diesem Beispiel ist CompletePO.mfd. Sie steht auf dem Rechner, auf dem MapForce installiert ist, unter dem folgenden Pfad zur Verfügung: <Dokumente>\Altova\MapForce2025\MapForceExamples. Beachten Sie, dass das Verzeichnis "MapForceExamples" erst zu dem Zeitpunkt erstellt wird, zu dem MapForce das erste Mal gestartet wird.
CompletePO.mfd
Das obige Demo-Mapping erhält als Input drei XML-Dateien und erzeugt eine einzige XML-Datei als Output. Die XML-Input-Datei wird in diesem Beispiel automatisch in das auf FlowForce Server bereitgestellte Paket inkludiert. Bei anderen Mappings sind unter Umständen zusätzliche Vorbereitungsschritte erforderlich, bevor Sie das Mapping bereitstellen können, siehe Bereitstellen von Mappings auf FlowForce Server.
Erstellen des Auftrags
Bei der Bereitstellung eines Mappings fasst MapForce alle in diesem Mapping verwendeten Mapping-Ressourcen in einem einzige Paket zusammen und sendet dieses über HTTP (oder, falls konfiguriert, HTTPS) an FlowForce Server.
So stellen Sie das Mapping auf FlowForce Server bereit:
1.Öffnen Sie die Datei CompletePO.mfd in MapForce.
2.Setzen Sie die Transformationssprache des Mappings auf "Built-in", falls das noch nicht geschehen ist.
3.Klicken Sie im Menü Datei auf Auf FlowForce Server bereitstellen.
4.Geben Sie den Servernamen und den Port der Web-Verwaltungsschnittstelle in die Felder Server und Port ein, (z.B. 127.0.0.1 und 8082, wenn der FlowForce Web Server-Dienst auf demselben Rechner unter dem Standard-Port empfangsbereit ist.) Ändern Sie diese Werte, wenn Sie eine andere Adresse und einen anderen Port konfiguriert haben, siehe Definieren der Netzwerkeinstellungen.
5.Geben Sie in die Textfelder Benutzer und Passwort Ihren FlowForce Server Benutzernamen und Ihr Passwort ein.
6.Wählen Sie aus der Login-Dropdown-Liste entweder Direkt aus oder belassen Sie die Option <Standard> unverändert.
Falls die Directory Service Integration aktiviert ist, geben Sie Ihren Domain-Benutzernamen und Ihr Domain-Passwort ein und wählen Sie den Domain-Namen aus der Login-Dropdown-Liste aus. Nähere Informationen dazu finden Sie unter Ändern der Directory Service-Einstellungen. |
7.Aus Gründen der Einheitlichkeit stellen wir das Mapping wie die anderen Beispiele im Container /public/Examples bereit. Klicken Sie auf Durchsuchen und ändern Sie den Container-Pfad in /public/Examples. Der Container /public/Examples muss bereits vorhanden sein, wenn Sie das vorherige Beispiel durchgearbeitet haben; Andernfalls können Sie ihn im unten gezeigten Dialogfeld durch Klick auf Container erstellen erstellen:
8.Aktivieren Sie das Kontrollkästchen Web Browser zur Erstellung eines neuen Auftrags öffnen.
9.Klicken Sie auf OK, um das Mapping bereitzustellen.
Nachdem das Mapping bereitgestellt wurde, wird die FlowForce Server Verwaltungsschnittstelle in Ihrem Webbrowser geöffnet und eine teilweise ausgefüllte Auftragsseite wird angezeigt. Die Mapping-Funktion selbst wird unter dem zuvor definierten Container-Pfad gespeichert. Damit ist die Bereitstellung abgeschlossen.
Erstellen des Auftrags
Nachdem Sie die Mapping-Datei, wie oben beschrieben, auf FlowForce Server bereitgestellt haben, wird im Browser eine bereits teilweise ausgefüllte Auftragsseite angezeigt. Der erste Ausführungsschritt, in dem einige Parameter bereits ausgefüllt sind, wird automatisch erstellt.
Sie können den Auftrag auch durch Öffnen der Funktionsseite (/public/Examples/CompletePO.mapping) und anschließendes Klicken auf Auftrag erstellen erstellen.
So konfigurieren Sie den Auftrag:
1.Ändern Sie den Standardauftragsnamen von "CompletePO.job" in einen aussagekräftigeren Namen wie z.B. "GeneratePurchaseOrder". Dies ist ein optionaler Schritt, der jedoch eventuell notwendig ist, falls der Name bereits für einen anderen Auftrag im selben Container verwendet wird.
2.Füllen Sie den ersten standardmäßig erstellten Ausführungsschritt folgendermaßen aus:
Funktion ausführen | Dieses Feld verweist auf die zuvor bereitgestellte Mapping-Funktion; lassen Sie es unverändert. |
Parameter | Die Felder Customers, Articles und ShortPO enthalten die entsprechenden mit dem Auftrag verpackten XML-Dateien.
Im Feld CompletePO ist der Pfad zur Ausgabedatei definiert. Standardmäßig lautet dieser CompletePO.xml. Der Pfad ist, wie weiter unten beschrieben, relativ zum Arbeitsverzeichnis.
Sie können in diesem Beispiel alle Input- und Output-Optionen unverändert lassen. Informationen zum Ändern von Input- und Output-Instanzen finden Sie unter Ausführen von Mappings und Transformationen als Aufträge.
Geben Sie in das Feld Working-directory den Pfad zum Arbeitsverzeichnis des Auftrags ein. In diesem Beispiel wird als Arbeitsverzeichnis C:\FlowForceExamples\Mapping verwendet.
Ein Arbeitsverzeichnis (oder Working-directory) ist ein Parameter, der von Ausführungsschritten benötigt wird, wenn für den Auftrag ein Ordner benötigt wird, in dem Input-Dateien entpackt oder Output-Dateien gespeichert werden. Anhand des Arbeitsverzeichnisses werden in FlowForce Server auch alle relativen Pfade, die während der Ausführung von Schritten vorkommen, aufgelöst. Wenn Sie nach einem Arbeitsverzeichnis gefragt werden, sollten Sie einen gültigen Pfad auf dem Betriebssystem, auf dem FlowForce ausgeführt wird, angeben. Falls bei Erstellung des Schritts kein Arbeitsverzeichnis angegeben wird, verwendet FlowForce Server ein temporäres Verzeichnis. |
Das Ergebnis dieses Schritts zuweisen an | In diesem Feld wird dem Ergebnis des Mappings ein Name gegeben. Sie können das Feld in diesem Beispiel leer lassen. |
3.Klicken Sie unter "Trigger" auf die Schaltfläche Neuer Timer.
4.Setzen Sie den Timer neben "Ausführen" auf täglich alle 1 Tage. Wählen Sie neben "Start" ein Datum und eine Uhrzeit für den Start des Auftrags aus, z.B:
5.Wählen Sie unter "Anmeldeinformationen" einen vorhandenen Eintrag aus oder definieren Sie lokale Anmeldeinformationen. Nähere Informationen dazu finden Sie unter Anmeldeinformationen.
6.Klicken Sie auf Speichern.
Ausführung des Auftrags
Sobald der Trigger-Zeitpunkt erreicht wird, wird der Mapping-Auftrag ausgeführt. Bei erfolgreicher Ausführung des Auftrags steht die als Ergebnis generierte Datei (CompletePO.xml) im Verzeichnis C:\FlowForceExamples\Mapping zur Verfügung. Im Auftrags-Log können Sie kontrollieren, ob der Auftrag erfolgreich ausgeführt wurde.