Altova FlowForce Server 2024 Advanced Edition

In diesem Kapitel wird erläutert, wie Sie das Ergebnis eines Schritts in einem anderen Schritt verwenden, wie Sie den Datentyp des Schrittergebnisses ändern und den Rückgabetyp des gesamten Auftrags deklarieren.

 

Schrittergebnis

Manchmal muss das Ergebnis eines Schritts in einem anderen Schritt verwendet werden. Meist muss in einem solchen Fall der Datentyp des Schrittergebnisses geändert werden. Unser Beispielauftrag hat einen Ausführungsschritt, in dem Dateien und Verzeichnisse des Laufwerks C aufgelistet werden (Schritt 1 in der Abbildung unten). Wenn dieser Schritt ein Ergebnis zurückgibt, weist FlowForce Server diesem automatisch den allgemeinen Typ result zu. Die Verzeichnisliste soll per E-Mail gesendet werden.

 

Da der Parameter Nachrichtentext in der Funktion /system/mail/send den Typ String hat (siehe Schritt 4 in "Als Mail senden"), müssen wir result in String konvertieren. Zu diesem Zweck verwenden wir die Funktionen stdout und content in einem einzigen Ausdruck, wodurch result in Stream und anschließend in String konvertiert wird (siehe Ausdruck in Schritt 2 unten). Gehen Sie folgendermaßen vor:

 

1.Füllen Sie die Funktion und die Parameter, wie in Schritt 1 gezeigt, aus (siehe Abbildung unten).

2.Deklarieren Sie das Ergebnis von Schritt 1 als ErgebnisSchritt1. Geben Sie in das Feld Ergebnis dieses Schritts zuweisen an ErgebnisSchritt1 ein (unten rot umrandet). Sie müssen diesen Wert später referenzieren, um das Ergebnis des Schritts aufrufen zu können.

3.Fügen Sie einen neuen Ausführungsschritt hinzu, der die vordefinierte Funktion /system/compute aufruft.

4.Geben Sie in Parameter den folgenden Ausdruck ein: content(stdout(ErgebnisSchritt1)), wobei ErgebnisSchritt1 das Ergebnis von Schritt 1 ist.

5.Deklarieren Sie das Ergebnis von Schritt 2 als ErgebnisSchritt2.

fs_clip0001

Der Auftragsausgabedatentyp ist nun ein String. Im nächsten Schritt wird nun ein neuer Ausführungsschritt erstellt, der das Ergebnis von Schritt 2 per E-Mail sendet.

 

Als Mail senden

Um die Verzeichnisliste an eine E-Mail-Adresse zu senden, gehen Sie folgendermaßen vor:

 

1.Fügen Sie einen neuen Ausführungsschritt hinzu, wie in der Abbildung unten gezeigt. Vor Verwendung der Funktion /system/mail/send müssen die Mail-Sever-Einstellungen konfiguriert werden.

fs_clip0002

2.Als letzter Schritt wird ein Trigger erstellt, mit dem der Auftrag gestartet wird. In unserem Beispiel haben wir einen Timer Trigger hinzugefügt, der den Auftrag alle 60 Minuten ausführt (siehe unten). Klicken Sie abschließend auf Speichern.

fs_clip0003

 

Auftragsergebnis

Wenn Sie das Ergebnis eines Auftrags im Cache speichern möchten, müssen Sie den Rückgabetyp des Auftrags deklarieren. Eine Deklaration des Rückgabetyps eines Auftrags ist eventuell auch dann sinnvoll, wenn Sie den Auftrag als Ausführungsschritt in anderen Aufträgen verwenden möchten. Beachten Sie beim Deklarieren des Rückgabetyps bitte Folgendes:

 

Es ist nur bei Aufträgen, die tatsächlich ein Ergebnis erzeugen, sinnvoll einen Rückgabetyp zu deklarieren.  

Wenn Sie das Ergebnis eines Auftrags im Cache speichern möchten, müssen Sie den Rückgabetyp deklarieren.

Der Rückgabetyp des Auftrags muss mit dem Datentyp des letzten Schritts im Auftrag übereinstimmen. Andernfalls retourniert FlowForce Server einen Fehler. Wenn Typdiskrepanzfehler auftreten, ändern Sie den Datentyp des letzten Auftragsschritts mit Hilfe von Ausdrucksfunktionen, in den als Auftragsrückgabetyp deklarierten Rückgabetyp. Nähere Informationen dazu finden Sie im obigen Beispiel.

 

Um die Rückgabetyp eines Auftrags zu definieren, gehen Sie folgendermaßen vor:

 

1.Erstellen Sie einen neuen Auftrag oder öffnen Sie einen vorhandenen, um ihn zu bearbeiten.

2.Wählen Sie auf der Konfigurationsseite im Abschnitt Ausführungsergebnis einen Rückgabetyp aus.

 

Rückgabetypen

Es stehen die folgenden Rückgabetypen zur Auswahl zur Verfügung.

 

ignorieren/verwerfen

String

Stream

Zahl

Boolean

Anmeldeinformationen

Zertifikat

Ergebnis

AS2-Partner (Advanced Edition)

AS2 MDN (Advanced Edition)

SFTP-Verbindung (Advanced Edition)

 

Die Standardoption ist ignorieren/verwerfen. Dadurch ignoriert oder verwirft FlowForce Server das Ergebnis des Auftrags. Wählen Sie diese Option, wenn mit dem Auftrag kein Ergebnis erzeugt wird oder wenn das Ergebnis nicht weiter verarbeitet werden muss.

 

© 2017-2023 Altova GmbH