Erstellen eines Auftrags anhand einer StyleVision-Transformation

www.altova.com Dieses Kapitel drucken Vorherige Seite Eine Ebene nach oben Nächste Seite

Startseite >  Beispiele zur Konfiguration von Aufträgen >

Erstellen eines Auftrags anhand einer StyleVision-Transformation

In diesem Beispiel wird gezeigt, wie Sie anhand einer StyleVision-Transformation einen FlowForce Server-Auftrag erstellen. Zuerst wird eine Demo-Transformationsdatei aus  StyleVision in FlowForce Server bereitgestellt. Dabei sammelt StyleVision die für die Transformation verwendeten Ressourcen in einem Objekt und übergibt dieses an FlowForce Server. Nachdem die Transformation in FlowForce Server bereitgestellt wurde, erstellen Sie einen Auftrag anhand dieser Datei. Der Auftrag besteht aus den folgenden drei Schritten:

 

1.Im ersten Schritt wird die StyleVision-Transformation ausgeführt.
2.Da von der Transformation ein Array aus mehreren Streams zurückgegeben wird, wird im zweiten Schritt mit Hilfe eines FlowForce Server-Ausdrucks eine der durch die Transformation erstellten Dateien aufgerufen.
3.Im dritten Schritt wird die Datei in einen Archivordner kopiert.

 

Voraussetzungen

Benötigte Lizenzen: StyleVision Enterprise oder Professional Edition, StyleVision Server, FlowForce Server
FlowForce Server wird an der konfigurierten Netzwerkadresse und am konfigurierten Port ausgeführt (siehe Einstellen der Netzwerkadresse und des Ports)
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).
Die folgenden Verzeichnisse müssen in dem Betriebssystem, in dem FlowForce Server ausgeführt wird, vorhanden sein und Sie benötigen Schreibrechte dafür:
oc:\archive
oc:\temp

 

Verwendete Demo-Dateien

AutoCalc.sps steht relativ zum StyleVision Beispielprojekt im folgenden Ordner zur Verfügung: Examples > Basics AutoCalc.sps. (Um das StyleVision-Beispielprojekt in StyleVision zu öffnen, klicken Sie im Menü Projekt auf Examples).

 

Erstellen des Auftrags

1.Öffnen Sie die Datei AutoCalc.sps in StyleVision.
2.Klicken Sie im Menü Datei auf den Befehl In FlowForce bereitstellen. Wenn diese Option deaktiviert ist, vergewissern Sie sich, dass das Register "Design" ausgewählt ist.
3.Wenn Sie aufgefordert werden, die Transformation als PXF-Datei zu speichern, behalten Sie die Standardeinstellungen unverändert bei und klicken Sie auf OK.
4.Geben Sie den Servernamen und Port der Web-Verwaltungsschnittstelle in die entsprechenden Felder ein (z.B. localhost und 8082, wenn FlowForce Server unter dem Standard-Port auf demselben Rechner ausgeführt wird).
5.Geben Sie Ihren FlowForce Server-Benutzernamen und Ihr Passwort ein und belassen Sie die Standardoption neben Login unverändert.

 

 

Wenn die Directory Service-Integration aktiviert ist, geben Sie Ihren Domain-Benutzernamen und Ihr Domain-Passwort ein und wählen Sie anschließend in der Dropdown-Liste unter Login Ihren Domain-Namen aus. Nähere Informationen dazu finden Sie unter Ändern der Directory Service-Einstellungen.

 

 

DeployStyleVisionDlg

 

6.Vergewissern Sie sich, dass die Option Web Browser zur Erstellung eines neuen Auftrags öffnen aktiviert ist. Sie können zwar den Pfad, unter dem die Transformation bereitgestellt wird, ändern, belassen Sie ihn aber in diesem Beispiel unverändert.
7.Klicken Sie auf OK. Wenn die Transformation bereitgestellt ist, wird die FlowForce Server Verwaltungsschnittstelle in Ihrem Webbrowser geöffnet und eine teilweise ausgefüllte Auftragsseite wird angezeigt. Wie unten gezeigt, wird automatisch ein Ausführungsschritt erstellt, in dem einige Parameter bereits ausgefüllt sind. Belassen Sie die Parameterwerte in diesem Beispiel unverändert.

fs_stylevision_example2

Anmerkung:Die Option GenerateHtmlOutputAsMime ist in diesem Beispiel nicht ausgewählt. Normalerweise wird diese Option benötigt, um den HTML-Nachrichtentext einer mit FlowForce Server gesendeten E-Mail vorzubereiten. Nähere Informationen dazu, siehe send-mime-Funktion.
8.Klicken Sie neben "Parameter" / OutHtml auf die add Schaltfläche. Dadurch wird die Datei AutoCalc.html als Ausgabedatei deklariert.
9.Geben Sie im Ergebnisfeld Das Ergebnis dieses Schritts zuweisen an den Text Schritt1 ein.

Dadurch weisen Sie FlowForce Server an, dass das vom ersten Ausführungsschritt des Auftrags zurückgegebene Ergebnis den Namen Schritt1 hat. Dieses Ergebnis muss später referenziert werden.

10.Geben Sie im Feld Arbeitsverzeichnis den Pfad zu einem Verzeichnis ein, in dem die Auftragsausgabe gespeichert werden soll. In diesem Beispiel wird als Arbeitsverzeichnis c:\temp 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.

 

11.Klicken Sie unter dem bereits erstellten Ausführungsschritt auf Neuer Ausführungsschritt und konfigurieren Sie den Schritt folgendermaßen:

 

Funktion ausführen

Navigieren Sie zur Funktion builtin_function/system/compute.

Ausdruck

Geben Sie den folgenden FlowForce Server-Ausdruck ein:

as-file(nth(results(step1), 0))

Mit diesem Ausdruck werden folgende Schritte in FlowForce Server definiert:

1.Aufrufen der Funktion results um den im vorigen Schritt1 deklarierten Array aufzurufen.
2.Übergeben dieses Array an die Funktion nth, um den ersten Eintrag im Array aufzurufen. Da der Array-Index nullbasiert ist, verwenden wir 0 als zweites Argument der Funktion nth.
3.Übergeben des Werts an die Funktion as-file, um ihn als Datei zu deklarieren.

Das Ergebnis dieses Schritts zuweisen an

Geben Sie Schritt2 ein. Dadurch weisen Sie FlowForce Server an, dass das vom Ausführungsschritt zurückgegebene Ergebnis den Namen Schritt2 hat. Dieses Ergebnis muss später referenziert werden.

 

12.Klicken Sie auf Neuer Ausführungsschritt und konfigurieren Sie den Schritt folgendermaßen:

 

Funktion ausführen

Navigieren Sie zur Funktion builtin_function/system/filesystem/copy.

Quelle

Klicken Sie auf ff-setTo und wählen Sie Schritt2.

Ziel

c:\archive\AutoCalc.html

Überschreiben

Aktivieren Sie das Kontrollkästchen Überschreiben.

Arbeitsverzeichnis

c:\temp

 

Zu diesem Zeitpunkt sollte der Abschnitt "Ausführungsschritte" der Auftragsseite folgendermaßen aussehen:

 

ExampleStyleVision3

 

13.Klicken Sie in der Gruppe "Trigger" auf die Schaltfläche "Neuer Timer".
14.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.:

 

ExampleStyleVision4

 

15.Wählen Sie unter "Anmeldeinformationen" einen vorhandenen Anmeldeinformationeneintrag aus oder definieren Sie lokale Anmeldeinformationen (siehe auch Anmeldeinformationen).

 

Bei den Anmeldeinformationen handelt es sich um eine Kombination aus dem Benutzernamen und dem Passwort, die mit einem Benutzerkonto auf dem Betriebssystem, auf dem der FlowForce Server-Auftrag ausgeführt wird, verknüpft sind. Bei Definition eines Auftrags in FlowForce Server müssen Sie die Anmeldeinformationen angeben, mit denen der Auftrag ausgeführt werden soll. Wenn das mit den Anmeldeinformationen verknüpfte Benutzerkonto nicht genügend Rechte auf dem Betriebssystem hat, kann der Auftrag nicht erfolgreich ausgeführt werden.

 

ff-trig1a

 

16.Klicken Sie auf Speichern. Sobald der Trigger-Zeitpunkt erreicht wird, wird die StyleVision-Transformation ausgeführt. Bei erfolgreicher Ausführung des Auftrags steht die Datei AutoCalc.html im Verzeichnis c:\archive Verfügung. Um zu sehen, ob der Auftrag erfolgreich ausgeführt wurde, rufen Sie das Auftrags-Log auf (siehe Anzeige des Auftrags-Logs).

© 2019 Altova GmbH