Verwenden Sie den RegistryLookup-Knoten, um beliebige Entitäten aus dem WebSphere Service Registry and Repository (WSRR) abzurufen. Die Entitäten, die den angegebenen Suchbedingungen entsprechen, werden in der lokalen Umgebung gespeichert. Die Eingabenachricht wird nicht geändert.
Der RegistryLookup-Knoten ruft alle Arten von Entitäten aus dem WSRR ab.
Daten werden abhängig von Suchbedingungen abgerufen, die durch Knoteneigenschaften definiert werden und zur Ausführungszeit durch Definitionen in der lokalen Umgebung ergänzt oder überschrieben werden können (weitere Informationen siehe Überschreibungen der lokalen Umgebung).
Die abgerufenen Daten werden in der Baumstruktur der lokalen Umgebung abgelegt, so dass sie nachfolgenden Knoten zur Verfügung stehen. Die vom Knoten empfangene Eingabenachricht wird unverändert an das Ausgabeterminal weitergegeben.
Der RegistryLookup-Knoten ist im Ablagefach Web-Services der Nachrichtenflussknotenpalette enthalten und wird in der WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:
Die Eingabenachricht wird unverändert an das Ausgangsterminal weitergegeben. Die Baumstruktur der lokalen Umgebung wird an das Ausgangsterminal weitergegeben, wo es zur weiteren Verarbeitung durch Transformationsknoten zur Verfügung stehe. Die genaue Darstellung einer Entität in der Baumstruktur der lokalen Umgebung ist von der Eigenschaft Richtlinie für Tiefe abhängig. Im Abschnitt Ausgabe des RegistryLookup-Knotens finden Sie ausführliche Informationen zur Ausgabebaumstruktur der lokalen Umgebung.
Fügen Sie einen Rechenknoten zu Ihrem Nachrichtenfluss, der die zurückgegebenen Daten interpretiert und auswertet. Wenn die Baumstruktur der lokalen Umgebung beispielsweise mehrere Endpunktadressen zur Nutzung durch nachfolgende Anforderungsknoten enthält, sollte der Rechenknoten die erforderlichen Adressen auswählen und alle Transport-Header oder Einstellungen für die lokale Umgebung, die für die betreffenden Anforderungsknoten erforderlich sind, einrichten.
Sie können die Eigenschaften des RegistryLookup-Knotens über Einstellungen der lokalen Umgebung überschreiben. Weitere Informationen hierzu finden Sie unter Suchkriterien dynamisch definieren.
Nachdem Sie eine Instanz des RegistryLookup-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.
In der folgenden Tabelle werden die RegistryLookup-Knotenterminals beschrieben .
Terminal | Beschreibung |
---|---|
Eingabeterminal (In) | Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Fehlerterminal (Failure) | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn in der Verarbeitung des Knotens ein Fehler auftritt. |
Ausgang | Das Ausgabeterminal, an das die unveränderte Eingabenachricht und die aktualisierte lokale Umgebung mit den übereinstimmenden Registry-Daten gesendet werden. |
NoMatch | Das Terminal, an das die Eingabenachricht gesendet wird, wenn auf Grundlage der angegebenen Suchbedingungen keine übereinstimmende Entität gefunden wird. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K 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 RegistryLookup-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Knotenname | Nein | Nein | Der Knotentyp (RegistryLookup) | Der Name des Knotens. |
Kurzbeschreibung | Nein | Nein | Ohne | Eine Kurzbeschreibung des Knotens. |
Langbeschreibung | Nein | Nein | Ohne | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
In der folgenden Tabelle werden die grundlegenden Eigenschaften des RegistryLookup-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Name | Nein | Ja | Ohne | Geben Sie für die Entitäten oder Artefakte, die Sie aus dem WSSR
abrufen möchten, die Zeichenfolgewerte für einen oder mehrere der folgenden Parameter an:
Name, Namespace
und Version. Einer der drei Parameter muss angegeben werden. Wenn Sie alle drei Eigenschaften leer lassen, erhalten Sie beim Speichern eine Fehlernachricht. |
name |
Namespace | Nein | Ja | Ohne | namespace | |
Version | Nein | Ja | Ohne | serviceVersion | |
Benutzereigenschaften | Nein | Nein | Ohne | Ermöglicht in einer Abfrage die Definition benutzerdefinierter Eigenschaften.
Fügen Sie Benutzereigenschaften hinzu, indem Sie auf
Hinzufügen klicken. Die Benutzereigenschaften beziehen sich auf die zusätzlichen Eigenschaften, mit denen die Entitäten in WSRR katalogisiert werden. Geben Sie Werte für
Eigenschaftsname (stimmt mit der zusätzlichen Eigenschaft
im WSSR überein, einschließlich der Groß-/Kleinschreibung),
Eigenschaftstyp und
Eigenschaftswert ein. Als
Eigenschaftstyp kann Folgendes angegeben werden:
|
|
Klassifizierung | Nein | Nein | Ohne | Das Web Ontology Language (OWL)-Klassifizierungssystemmerkmal. Jedes Klassifizierungsmerkmal entspricht einer OWL-Klasse und verfügt über einen Uniform Resource Identifier (URI). Durch die Verwendung von Klassifizierungen in der Registry lassen sich Objekte leichter finden. Außerdem erhalten speziell für ein bestimmtes System angepasste Objekte durch Klassifizierungen unter Umständen mehr Bedeutung. Fügen Sie eine Klassifizierung hinzu. Klicken Sie dazu auf Hinzufügen und geben Sie die vollständig qualifizierte OWL-URI für die OWL-Klassifizierung ein. Sie kann beispielsweise den Lebenszyklusstatus eines bestimmten Serviceendpunkts definieren. |
|
Übereinstimmungsrichtlinie | Ja | Nein | Eine | WSRR kann mehrere Entitäten enthalten, die den Suchbedingungen entsprechen, die in den oben genannten Eigenschaften angegeben sind. Wenn Übereinstimmungsrichtlinie auf Eine gesetzt ist, wird höchstens eine übereinstimmende Entität zurückgegeben. Wenn Übereinstimmungsrichtlinie auf Alle gesetzt ist, werden alle übereinstimmenden Entitäten zurückgegeben. Unter Ausgabe des RegistryLookup-Knotens |
In der folgenden Tabelle werden die erweiterten Eigenschaften des RegistryLookup-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Richtlinie für Tiefe | Ja | Nein | Nur Übereinstimmungen liefern (Tiefe = 0) | Geben Sie die Tiefe der WSRR-Abfrage und den Inhalt der Daten an, die zurückgegeben werden sollen. Die zurückgegebenen Entitäten werden in der Nachrichtenbaumstruktur 'ServiceRegistry' in der lokalen Umgebung gespeichert. Wählen Sie Nur Übereinstimmungen liefern (Tiefe = 0) aus, um für die WSRR-Abfrage eine Tiefe von 0 zu verwenden, sodass nur die übereinstimmenden Entitäten zurückgegeben werden. Wählen Sie Nur Übereinstimmungen liefern, unmittelbare Abhängigkeiten anzeigen (nur aus Gründen der Kompatibilität) aus, um für die WSRR-Abfrage eine Tiefe von 1 zu verwenden, sodass nur die übereinstimmenden Entitäten zurückgegeben werden. Zu den zurückgegebenen Elementen gehören Entitäten, in denen die bsrURIs von zugehörigen untergeordneten Entitäten aufgelistet sind. Diese Option stellt Kompatibilität mit Versionen von WebSphere Message Broker vor Version 6.1.0.4 her, da es das Ausgabeformat verwendet, das in diesen früheren Versionen verwendet wurde. Diese Option ist veraltet; verwenden Sie eine der anderen Optionen. Wählen Sie Übereinstimmungen liefern plus unmittelbar voneinander abhängige Entitäten (Tiefe = 1) aus, um für die WSRR-Abfrage eine Tiefe von 1 zu verwenden, sodass die übereinstimmenden Entitäten und die unmittelbar voneinander abhängigen Entitäten zurückgegeben werden. Wählen Sie Übereinstimmungen liefern plus alle voneinander abhängige Entitäten (Tiefe = -1) aus, um für die WSRR-Abfrage eine Tiefe von -1 zu verwenden, sodass die übereinstimmenden Entitäten und alle voneinander abhängigen Entitäten zurückgegeben werden. |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Ereignisse | Nein | Nein | Ohne | Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten
definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss
Überwachungsereignisse definiert. Über Hinzufügen,
Bearbeiten und Löschen können Sie
Überwachungsereignisse für den Knoten erstellen, ändern oder löschen (Details siehe
Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren). Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren. |