Verwenden Sie den TimeoutControl-Knoten zur Verarbeitung einer Eingabenachricht, die eine Zeitlimitanforderung enthält.
Dieses Thema enthält folgende Abschnitte:
Der TimeoutControl-Knoten prüft die Nachricht über eine Zeitlimitanforderung, speichert die Nachricht und gibt die (unveränderte) Nachricht an den nächsten Knoten im Nachrichtenfluss weiter. Der Abschnitt Nachricht über eine Zeitlimitüberschreitung bei Anforderung enthält weitere Informationen hierzu.
Der TimeoutControl-Knoten befindet sich im Ablagefach Zeitgeber der Palette und wird in der Workbench durch folgendes Symbol dargestellt:
Der TimeoutControl-Knoten und der TimeoutNotification-Knoten werden gemeinsam in einem Nachrichtenfluss für eine Anwendung verwendet, bei der Ereignisse zu einem bestimmten Zeitpunkt oder in regelmäßigen Abständen auftreten müssen.
Sie können mehrere TimeoutControl-Knoten bei einem TimeoutNotification-Knoten verwenden. Zeitlimitanforderungen, die von diesen TimeoutControl-Knoten initialisiert werden, werden alle von demselben TimeoutNotification-Knoten verarbeitet, wenn für den TimeoutNotification-Knoten und die einzelnen TimeoutControl-Knoten eine identische Eindeutige Kennung verwendet wird.
Nachdem Sie eine Instanz des TimeoutControl-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.
In der folgenden Tabelle werden die TimeoutControl-Knotenterminals beschrieben .
| Terminal | Beschreibung |
|---|---|
| Eingangsterminal | Eingabeterminal, das eine Nachrichtenbaumstruktur für die Verarbeitung akzeptiert (darin enthalten ist die Prüfung der Zeitlimitanforderung, die in der Nachrichtenbaumstruktur unter Position anfordern angegeben ist) und sie der Steuerwarteschlange hinzufügt. |
| Fehlerterminal | Das Ausgabeterminal, an das die Eingabenachricht weitergegeben wird, wenn während der Verarbeitung in diesem Knoten ein Fehler auftritt. Wenn dieses Terminal nicht mit einem anderen Knoten verbunden ist, werden die Fehlerdaten wieder an den vorherigen Knoten im Nachrichtenfluss übergeben. |
| Ausgabeterminal | Das Ausgabeterminal, an das eingehende Nachrichten nach einer erfolgreichen Verarbeitung einer Zeitlimitanforderung unverändert weitergegeben werden. Wenn dieses Terminal nicht mit einem anderen Knoten verbunden ist, erfolgt keine Weitergabe. Wenn die Weitergabe der Nachricht fehlschlägt, wird die Nachricht an das Fehlerterminal weitergegeben. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).
In der folgenden Tabelle werden die Beschreibungseigenschaften des TimeoutControl-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Knotenname | Nein | Nein | Knotentyp TimeoutControl | Der Name des Knotens. |
| Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
| Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
In der folgenden Tabelle werden die Basiseigenschaften des TimeoutControl-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Eindeutige Kennung | Ja | Ja | Keine | Dies ist die einzige obligatorische Eigenschaft für den Knoten. Ihr Wert muss im Broker eindeutig sein. Die entsprechende Eigenschaft des paarweise damit verbundenen TimeoutNotification-Knotens muss den gleichen Wert haben. Die maximale Länge dieser Kennung beträgt 12 Zeichen. |
| Position anfordern | Nein | Nein | Keine | Mit dieser Eigenschaft wird beschrieben, wo die Daten der Zeitlimitanforderung zu finden sind. Dieser Wert muss eine gültige Position in der Nachrichtenbaumstruktur haben. Sie wird zur Laufzeit ausgewertet. Wurde keine Anforderungsposition angegeben, wird der Wert 'LocalEnvironment.TimeoutRequest' vorausgesetzt. Weitere Informationen zur Nachricht über eine Zeitlimitanforderung finden Sie unter Nachricht über eine Zeitlimitüberschreitung bei Anforderung. |
| Permanenz anfordern | Nein | Nein | Automatisch | Über diese Eigenschaft wird gesteuert, ob eine eingehende Zeitlimitanforderung den Neustart eines Brokers oder Nachrichtenflusses überdauert. Gültige Werte sind Automatisch, Ja oder Nein. Wenn für den Wert Automatisch festgelegt wurde, wird im Eigenschaftenordner der eingehenden Nachricht die Einstellung 'Permanenz' verwendet. |
In der folgenden Tabelle werden die Nachrichteneigenschaften des TimeoutControl-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Position für gespeicherte Nachricht | Nein | Nein | Keine | Die Position für den Teil der Anforderungsnachricht, den Sie für die Übergabe durch den paarweise mit diesem Knoten verbundenen TimeoutNotification-Knoten speichern möchten. |
| Nachrichtendomäne | Nein | Nein | BLOB | Die Domäne, die für die Syntaxanalyse der gespeicherten Nachricht zur Zeitlimitanforderung durch den TimeoutNotification-Knoten verwendet wird. Wenn Sie keinen Wert angeben und die Nachrichtenposition gespeichert ist, ist der Standardwert BLOB. |
| Nachrichtengruppe | Nein | Nein | Keine | Der Name oder die ID der Nachrichtengruppe, in der die gespeicherte Nachricht über eine Zeitlimitanforderung definiert ist. |
| Nachrichtentyp | Nein | Nein | Keine | Der Name der gespeicherten Nachricht über eine Zeitlimitanforderung. |
| Nachrichtenformat | Nein | Nein | Keine | Der Name des physischen Formats der gespeicherten Nachricht über eine Zeitlimitanforderung. |