Altova FlowForce Server 2024 

Diese Kapitel enthält Informationen über Grundkonzepte der Auftragsausführung.

 

Auftrag

Ein Auftrag ist eine Aufgabe oder eine Reihe von Aufgaben, die vom Server ausgeführt werden. Ein Auftrag besteht aus den folgenden Teilen (einige davon sind optional): Input-Parametern, Ausführungsschritten, Triggern, Anmeldeinformationen und verschiedenen Einstellungen. Jeder Auftrag hat ein Ausführungsergebnis, das als Erfolg, Fehler oder unterbrochener Auftrag/unbekanntes Ergebnis ausgegeben wird. Nähere Informationen dazu finden Sie unter Statistik.

 

Je nach Anforderungen kann ein Auftrag unterschiedliche Komplexitätsgrade haben. Ein Auftrag kann aus einem einzigen Schritt (z.B dem Senden einer E-Mail) bestehen oder mehrere Aktionen ausführen und das Ergebnis (z.B. eine Datei) als Parameter an einen anderen Auftrag übergeben. Nähere Informationen zur Auftragskonfiguration finden Sie unter Auftragskonfiguration.

 

Parameter

Parameter in FlowForce Server ähneln Funktionsargumenten in einer Programmiersprache. Es gibt verschiedene Arten von Parametern, z.B. Datei- und Verzeichnisreferenzen, Text, Zahlen, Boolesche Werte und andere. Es gibt in Aufträgen zwei Arten von Parametern: (i) Auftrags-Input-Parameter und (ii) Funktionsparameter.

 

Unter bestimmten Bedingungen stehen Auftrags-Input-Parameter automatisch auf der Konfigurationsseite des Auftrags zur Verfügung. Wenn Sie z.B. einen Dateisystem- oder HTTP-Trigger zu Ihrem Auftrag hinzufügen, wird automatisch der Input-Parameter triggerfile hinzugefügt. Die Trigger-Datei kann in Schritt-Funktionen z.B. verwendet werden, um diese Datei auf einen FTP-Server hochzuladen. Ein Beispiel dazu finden Sie unter der system/ftp/store.

 

Funktionsparameter können verschiedene Werte, darunter Ausdrücke und Ausdrucksfunktionen erhalten. Ein Beispiel dazu finden Sie unter der Funktion system/compute.

 

Nähere Informationen zu Parametern finden Sie unter Input-Parameter.

 

Trigger

Bei der Erstellung eines Auftrags müssen Sie Bedingungen definieren, durch die ein Auftrag gestartet wird. Diese Bedingungen werden als Trigger bezeichnet. FlowForce Server führt den Auftrag aus, sobald die Trigger-Bedingung erfüllt wird.

 

Schritte

Mit Schritten wird in FlowForce Server definiert, was ein Auftrag tun soll (z.B. eine Datei löschen, ein MapForce Mapping ausführen, eine E-Mail senden). In seiner einfachsten Form ist ein Schritt eine Operation, deren Ergebnis entweder erfolgreich oder nicht erfolgreich ist. Mit jedem Schritt muss eine Funktion ausgeführt werden. Sie können für Ihren Auftrag beliebig viele Schritte erstellen und festlegen, in welcher Reihenfolge diese ausgeführt werden sollen. Das Ergebnis eines Schritts kann in anderen Schritten verwendet werden.

 

Nähere Informationen zu Schritten finden Sie unter Auftragsausführungsschritte.

 

Funktionen

Es gibt in FlowForce Server zwei Arten von Funktionen: (i) Schrittfunktionen und (ii) Ausdrucksfunktionen. Bei Schrittfunktionen handelt es sich um Anweisungen, die verschiedene Operationen am Zieldateisystem ausführen. Für jeden Ausführungsschritt wird eine Schrittfunktion benötigt. So weist die Funktion system/mail/send FlowForce Server etwa an, eine E-Mail an den angegebenen Empfänger zu senden. Es gibt die folgenden Arten von Schrittfunktionen:

 

Systemfunktionen

StyleVision-Transformationen

MapForce Mappings

Ein Auftrag als Ausführungsschritt eines anderen Auftrags

 

Die meisten Schrittfunktionen haben Parameter. Parameter können verschiedene Werte, darunter Ausdrücke und Ausdrucksfunktionen erhalten. Ausdrucksfunktionen verarbeiten als Argumente bereitgestellte Werte, z.B. um Strings zu verbinden (siehe die concat-Funktion). Ein Beispiel für einen Auftrag, in dem Ausdrucksfunktionen verwendet werden, finden Sie in der send-mime-Funktion unter Beispiel 2.

 

Ausführungsergebnis

Sie können in FlowForce Server auf zwei Ebenen mit dem Ausführungsergebnis arbeiten: (i) auf Ebene des Schritts und (ii) auf Auftragsebene. Im Ergebnis eines Schritts ist definiert, was nach Ausführung des Schritts zurückgegeben wird (z.B. eine Datei). Das Schrittergebnis kann in anderen Ausführungsschritten verwendet werden. Sehen Sie dazu Beispiel 1 in der send-mime-Funktion, in dem das Ergebnis des zweiten Schritts im Parameter Nachrichtentext des letzten Schritts verwendet wird. Auf Auftragsebene muss der Rückgabetyp des Ausführungsergebnisses definiert werden, wenn das Ergebnis des Auftrags im Cache gespeichert werden soll. Eine Deklaration des Rückgabetyps des Auftragsergebnisses ist eventuell auch dann sinnvoll, wenn Sie das Ergebnis in anderen Auftragen verwenden möchten.

 

Nähere Informationen dazu finden Sie unter Ergebnis eines Schritts/Auftrags.

 

Anmeldeinformationen

Ein Anmeldeinformationsobjekt ist ein Datensatz, in dem Authentifizierungsinformationen wie Benutzernamen, Passwörter, Zertifikate, API-Schlüssel, Token, usw., gespeichert sind, die zur sicheren Verwaltung und Übertragung von Authentifizierungsdaten und für den Zugriff auf verschiedene Dienste und Ressourcen dienen.

 

Nähere Informationen zu Anmeldeinformationen finden Sie unter Anmeldeinformationen.

 

Einstellungen

Bei der Erstellung eines Auftrags können Sie die folgenden optionalen Einstellungen konfigurieren:

 

Bereitstellung des Auftrags als Web-Dienst.

Definition der Warteschlangeneinstellungen, die die Anzahl der parallel laufenden Instanzen für denselben Auftrag angeben.

Speichern des Auftragsergebnisses im Cache.

 

© 2017-2023 Altova GmbH