WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

RegistryLookup-Knoten

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.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

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.

Verarbeitung des RegistryLookup-Knotens

Der RegistryLookup-Knoten ist im Ablagefach Web-Services der Nachrichtenflussknotenpalette enthalten und wird in der WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für RegistryLookup-Knoten
Wenn der RegistryLookup-Knoten eine Nachricht empfängt, werden die folgenden Schritte nacheinander ausgeführt.
  1. Der RegistryLookup-Knoten ruft die Daten unter Verwendung der angegebenen Suchbedingungen aus dem WSRR ab.
  2. Wird mehr als eine Übereinstimmung gefunden, fügt der RegistryLookup-Knoten eine Darstellung der betreffenden Entitäten zur Baumstruktur der lokalen Umgebung hinzu.
    • Wenn Übereinstimmungsrichtlinie auf Eine gesetzt ist, wird nur eine Entität vom WSRR zurückgegeben und zur Baumstruktur der lokalen Umgebung hinzugefügt. Wenn die Registry mehrere Entitäten enthält, die den angegebenen Suchbedingungen entsprechen, kann nicht bestimmt werden, welche vom WSRR zurückgegeben wird. Bei jeder Ausgabe der Abfrage kann eine andere Entität zurückgegeben werden.
    • Wenn Übereinstimmungsrichtlinie auf Alle gesetzt ist, werden alle übereinstimmenden Entitäten zur Baumstruktur der lokalen Umgebung hinzugefügt. Die Reihenfolge der Entitäten wird vom WSRR festgelegt und kann von Abfrage zu Abfrage variieren.

    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.

  3. Wenn keine Übereinstimmungen gefunden werden, gibt der RegistryLookup-Knoten die Eingabenachricht an das NoMatch-Terminal weiter.
  4. Bei einem Verarbeitungsfehler, wenn beispielsweise keine Verbindung mit dem WSRR-Server, der im Objekt DefaultWSRR des konfigurierbaren Service konfiguriert ist, hergestellt werden kann oder das Verbindungszeitlimit überschritten wird, gibt der RegistryLookup-Knoten die Eingabenachricht unverändert an das Fehlerterminal (Failure) weiter. Details zu dem Fehler werden in die Ausnahmeliste geschrieben.

Überschreibungen der lokalen Umgebung

Sie können die Eigenschaften des RegistryLookup-Knotens über Einstellungen der lokalen Umgebung überschreiben. Weitere Informationen hierzu finden Sie unter Suchkriterien dynamisch definieren.

Terminals und Eigenschaften

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:
  • Eine Zeichenfolge (der Standardwert), d. h., der Eigenschaftswert ist eine Zeichenfolge, die mit dem Wert der zusätzlichen Eigenschaft im WSRR übereinstimmen muss.
  • XPATH oder ESQL, d. h., der Eigenschaftswert ist ein XPath- oder ESQL-Ausdruck, der ein Feld in der Nachrichtenbaumstruktur angibt, das die Zeichenfolge enthält, die mit dem Wert der Eigenschaft im WSRR übereinstimmen muss.
 
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.

Die Überwachungseigenschaften des Knotens werden in der folgenden Tabelle beschrieben.
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.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:20:20


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac55900_