Schablone für Get-Knoten

Mit einem Get-Knoten werden Daten aus einer externen Ressource abgerufen, und zwar auf Basis einer Anforderungsnachricht, die an das zugehörige In-Terminal gesendet wird. Ein Get-Knoten sendet keine Geschäftsdaten an das externe System; er fordert lediglich Geschäftsdaten auf Basis einiger Metadaten an.

Ein MQGet-Knoten kann beispielsweise eine Korrelations-ID senden, um eine Nachricht, die Geschäftsdaten enthält, aus einer Warteschlange abzurufen. Ein weiteres Beispiel ist der Abruf einer E-Mail von einem Server durch einen E-Mail-Knoten. Die Anzeige Anforderung dient zum Abruf von Details aus der eingehenden Nachricht. Dadurch wird entschieden, welche Ressourcen abgefragt und welche Metadaten verwendet werden sollen. Die Ergebnisse werden mit Details in der Anzeige Ergebnis gespeichert. Da der Get-Knoten die empfangenen Daten mit Hilfe der gleichen Verfahren wie der Input-Knoten syntaktisch analysiert, kann der Code für diesen Prozess gemeinsam genutzt werden. Der Get-Knoten steuert weder Transaktionen noch die Zuordnung von Threads.

Anzeigen

In der folgenden Tabelle werden die Anzeigen beschrieben, die in der Schablone für Get-Knoten verfügbar sind.
Anzeigenname Ist die Anzeige optional? Beschreibung
Benutzerdefinierte Anzeigen Ja Diese Gruppe von Anzeigen enthält Eigenschaften speziell für diesen Knoten.
Transaktionalität Ja Diese Anzeige stellt die Handhabung der Transaktionalität durch den Knoten dar. Wenn Sie die Transaktionalitätsanzeige nicht auf dem Knoten definieren, ist er immer nicht transaktionsgesteuert.
Datensatzerkennung Ja Diese Anzeige ist erforderlich, wenn Sie einen Streaming-Transport nutzen und die Anzeige Parser inbound (Nach innen gerichteter Parser) vorhanden sein muss.
Parser inbound (Nach innen gerichteter Parser) Ja In dieser Anzeige wird der Parser angegeben, der aus dem bereitgestellten Bitstrom eine Nachricht generiert. Sie können diese Anzeige entfernen, wenn es sich bei den Daten des externen Systems nicht um einen Bitstrom handelt.
Anforderung Nein Diese Anzeige stellt dar, wie eine Anforderung gestellt werden soll.
Ergebnis Nein Diese Anzeige stellt dar, wo die Antwort gespeichert werden soll.
Report Nein Diese Anzeige stellt dar, wo der Bericht gespeichert werden soll.
Auswertung Ja Diese Anzeige stellt dar, wie ein Parser eine Gültigkeitsprüfung für eine Nachricht durchführt. Diese Anzeige ist nur relevant, wenn Sie die Anzeige Parser inbound (Nach innen gerichteter Parser) nutzen. Sie können diese Anzeige entfernen, wenn es sich bei den Daten des externen Systems nicht um einen Bitstrom handelt.

Terminals

In der folgenden Tabelle werden die Terminals beschrieben, die in der Schablone für Get-Knoten verfügbar sind.
Terminalname Typ Beschreibung
In Eingabedaten Der Knoten wird über eine Nachricht gesteuert, die beim zugehörigen In-Terminal eingeht.
Out Ausgabedaten Wenn eine Nachricht von einer externen Ressource empfangen wurde, wird sie an das Out-Terminal gesendet.
NoMessage Ausgabedaten Wenn keine Nachricht abgerufen wird, wird eine Nachricht an das NoMessage-Terminal gesendet.
Failure Ausgabedaten Eine Störung im Knoten wird an das Failure-Terminal gesendet.

Ablaufsteuerung

Die grundlegende Ablaufsteuerung für einen Get-Knoten umfasst folgende Schritte:
  1. Der Knoten ruft die Anforderungsdetails auf Basis der Anzeige Anforderung ab.
  2. Der Knoten ruft eine Nachricht aus dem externen Transport ab, und zwar entweder unter Verwendung einer Anwendungsprogrammierschnittstelle oder eines Datenstroms. Dies hängt vom verwendeten Transporttyp ab. Wenn keine Nachricht zur Verfügung steht, wird eine Nachricht an das NoMessage-Terminal gesendet.
  3. Das Ergebnis wird in eine Nachrichtenbaumstruktur umgewandelt. Es stehen zwei Methoden zur Auswahl:
    • Erstellung eines Parsers mit Hilfe der Anzeige Parser inbound (Nach innen gerichteter Parser) und dessen Verwendung für die Syntaxanalyse des Bitstroms.
    • Erstellung einer Nachrichtenbaumstruktur unter Verwendung der Ergebnisse aus den API-Aufrufen; kein Parser wird verwendet.
  4. Die erstellte Nachrichtenbaumstruktur wird an der in der Anzeige Ergebnis festgelegten Position hinzugefügt, und eine Statusbaumstruktur wird erstellt und an der in der Anzeige Bericht angegebenen Position hinzugefügt. Der Status basiert auf dem Ergebnis des Aufrufs an das externe System.
Der Großteil der erforderlichen Funktionen wird zwar von der Schablone bereitgestellt, Sie müssen jedoch die folgenden Schritte selbst ausführen:
  • Definieren Sie, welche Optionsanzeigen verwendet werden sollen.
  • Fordern Sie Details für diesen Get-Knoten an.
  • Rufen Sie Daten aus dem externen System ab.
  • Erstellen Sie die Nachrichtenbaumstruktur, wenn kein Parser verwendet wird.
  • Erstellen Sie eine Baumstruktur für den Status.
Zugehörige Konzepte
Überblick zu benutzerdefinierten Erweiterungen
Benutzerdefinierter Knoten
Zugehörige Tasks
Benutzerdefinierte Erweiterungen implementieren
Zugehörige Verweise
Knotenschablonen
Definitionen der Anzeigen
Terminaldefinitionen
Benutzerdefinierte Erweiterungen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
as37453_