DatabaseRetrieve-Knoten

Verwenden Sie den DatabaseRetrieve-Knoten, um sicherzustellen, dass die Informationen in einer Nachricht aktuell sind.

Dieses Thema enthält folgende Abschnitte:

Zweck

Verwenden Sie den DatabaseRetrieve-Knoten, um eine Nachricht mit Informationen aus einer Datenbank zu modifizieren. Beispielsweise können Sie mit Hilfe eines Schlüssels, der in einer Nachricht enthalten ist, Informationen zu einer Nachricht hinzufügen; bei dem Schlüssel kann es sich z.B. um eine Accountnummer handeln.

Der DatabaseRetrieve-Knoten befindet sich im Ablagefach Database (Datenbank) der Nachrichtenflussknotenpalette und wird in Workbench durch folgendes Symbol dargestellt:

Symbol für DatabaseRetrieve-Knoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Anhand des Beispielprogramms Beispielprogramm 'Simplified Database Routing' wird die Verwendung dieses Knotens deutlich. Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.

Eingabeparameterwerte aus Nachrichtenelementen der eingehenden Nachricht können in vorbereitete, von diesem Knoten verwendete Anweisungen eingefügt werden. Diese Werte werden aus Namens-, Wert und Namens-/Wert-Elementen der eingehenden, analysierten Eingabenachricht abgerufen. Die Elemente werden zunächst in der Form eines com.ibm.broker.plugin.MbElement-Objekts übernommen. Daher wird der Bereich der unterstützten Java-Objekttypen, die die Werte annehmen können, durch die Schnittstelle dieses Objekts bestimmt. Wenn die Werte in Form von primitiven Java-Typen oder -Objekten vorliegen, werden sie, wie in nachfolgender Tabelle gezeigt, in den entsprechenden JDBC-Datentyp konvertiert.
Java JDBC
Ganzzahl INTEGER (Ganze Zahl)
Long BIGINT
Double DOUBLE
BigDecimal NUMERIC
Boolescher Wert BIT
byte[] VARBINARY oder LONGVARBINARY
BitSet VARBINARY oder LONGVARBINARY
Zeichenfolge VARCHAR oder LONGVARCHAR
MbTime java.sql.Time
MbTimestamp java.sql.Timestamp
MbDate java.sql.Date
Es werden nur dann Werte aus einem Element übernommen, wenn der Typ des Elements bekannt und sein Wertestatus gültig ist. Anderenfalls wird eine Ausnahme zurückgegeben. Die Werte der abgerufenen Ausgabespalten aus dem Ergebnis von SQL-Abfragen, die von diesem Knoten ausgeführt wurden, werden zunächst in passende Java-Typen und danach gemäß folgender Tabelle in interne Nachrichtenelement-Wertetypen konvertiert.
JDBC Java ESQL-Typ
SMALLINT Ganzzahl INTEGER (Ganze Zahl)
INTEGER (Ganze Zahl) Ganzzahl INTEGER (Ganze Zahl)
BIGINT Long DECIMAL
DOUBLE Double FLOAT (Gleitkommazahl)
REAL Double FLOAT (Gleitkommazahl)
FLOAT (Gleitkommazahl) Double FLOAT (Gleitkommazahl)
NUMERIC BigDecimal DECIMAL
DECIMAL BigDecimal DECIMAL
BIT Boolescher Wert Boolesch
Boolesch Boolescher Wert Boolesch
BINARY byte[] BLOB (Binary large object)
VARBINARY byte[] BLOB (Binary large object)
LONGVARBINARY byte[] BLOB (Binary large object)
CHAR (Zeichen) Zeichenfolge CHARACTER
VARCHAR Zeichenfolge CHARACTER
LONGVARCHAR Zeichenfolge CHARACTER
TINYINT byte[1] BLOB (Binary large object)
TIME java.util.Date TIME
TIMESTAMP java.util.Date TIMESTAMP
DATE java.util.Date DATE
Sie können eine Nachricht an dieselbe Adresse weiterleiten, unabhängig davon, ob eine Abfrage für eine bestimmte Datenbank erfolgreich ist oder nicht, indem Sie beide fehlerfreien Ausgabeterminals mit derselben Ausgabeadresse verbinden.

Wenn ein Fehler im XPath-Ausdruck eines Musters festgestellt wird, wird dieser Fehler bei der Auswertung im Workbench gemeldet. In der Fehlernachricht ist möglicherweise der fehlerhafte Ausdruck und der eindeutige Name des zugehörigen dynamischen oder statischen Terminals angegeben, oder die Zeichenfolge ist als fehlerhaft in der Tabelle markiert.

Der DatabaseRetrieve-Knoten sucht Werte in einer Datenbank und speichert sie als Elemente in den Baumstrukturen der Ausgabenachrichtenassemblierung. Der von der Datenbank in Form von Ausgabespaltenwerten abgerufene Informationstyp, der durch SQL-Abfragen abgerufen und in deren Ergebnismengen zurückgegeben wird, wird zunächst in einen passenden Java-Typ und danach in einen internen Nachrichtenelement-Wertetyp konvertiert und schließlich in der Baumstruktur einer Ausgabenachrichtenassemblierung gespeichert. Wenn ein Nachrichtenelement bereits in der Baumstruktur der ausgehenden Nachrichten vorhanden ist, wird der alte Wert durch den neuen Wert überschrieben. Falls das Zielelement nicht vorhanden ist, wird es erstellt und der Wert wird gespeichert.

Der Knoten benötigt Abfrageinformationen, die zur Generierung einer SQL-SELECT-Abfrage verwendet werden, die mittels mehrerer Prüfbedingungen auf mehrere Tabellen in einer Datenbank zugreifen kann. Nicht immer befinden sich alle Informationen, die Sie in einer Ergebnismenge abrufen möchten, in einer einzigen Datenbank. Eventuell müssen Sie die gewünschten Spaltenwerte daher aus zwei oder mehr Tabellen abrufen. Dieser Knoten unterstützt die Verwendung von SELECT-Anweisungen, mit denen Sie Spalten einer oder mehrerer Tabellen in einer Ergebnismenge abrufen können. Die normale Join-Syntax, die von diesem Knoten unterstützt wird, wird als Inner Join bezeichnet.

Inner Join-Informationen, die zur Generierung einer Abfrage erfasst werden, umfassen eine Liste mit tabellenqualifizierten Spaltenwerten für den Abruf und eine Liste mit Prüfbedingungen, mit denen die WHERE-Klausel einer SELECT-Anweisung gebildet wird. Tabellenqualifizierte Spaltenwerte können den linken Operanden in einer Prüfbedingung bilden. Wählen Sie einen Vergleichsoperator aus, der für diesen Operanden angewendet wird, und geben Sie optional einen rechten Operanden an, um die Prüfbedingung zu vervollständigen. Bei dem Operator könnte es sich um einen NULL-Vergleichstest handeln, für den kein rechter Operand erforderlich ist. Bei dem Wert des rechten Operanden kann es sich um einen Datenbanktyp handeln (z. B. 'Integer' (ganze Zahl), 'Boolean' (Boolesch) oder 'Long' (Langzeichen)), eine weitere tabellenqualifizierte Spalte oder einen Wert, der mittels eines allgemeinen XPath 1.0-Ausdrucks aus einem Element in der eingehenden Nachricht abgerufen wird.

Der Ausdruck sollte ein einzelnes Element, einen Booleschen Wert oder eine Zeichenfolge zurückgeben. Anderenfalls wird eine Ausnahme generiert. Wenn die Abfrage mehrere Zeilen zurückgibt, wird die erste Zeile ausgewählt und alle anderen Zeilen werden ignoriert, es sei denn, die Option Mehrere Zeilen ist aktiviert. Im letzteren Fall werden alle Zeilen verarbeitet und die Werte dieser Zeilen werden zur Aktualisierung der Baumstrukturen der Ausgabenachrichtenassemblierung verwendet.

Es ist kann hilfreich sein, einen DatabaseRetrieve-Knoten mit anderen Nachrichtenflussknoten zu kombinieren. Beispielsweise können Sie einen XSLTransform-Knoten verwenden, um Daten vor und nach dem Aufruf des DatabaseRetrieve-Knotens zu bearbeiten.

Der DatabaseRetrieve-Knoten verfügt über ein Eingabeterminal (IN) und drei Ausgabeterminals ('Out', 'keyNotFound' und 'Failure'). Wenn die Nachricht erfolgreich modifiziert wurde, wird sie an das Terminal 'Out' weitergeleitet. Wenn die Modifizierung der Nachricht fehlschlägt bzw. während der Verarbeitung ein Fehler festgestellt wird, wird die Nachricht an das Terminal 'Failure' weitergegeben. Wenn nach der Ausführung einer bestimmten SQL-SELECT-Abfrage in der Ergebnismenge keine Zeilen zurückgegeben werden, wird die Originalnachricht an das Terminal 'keyNotFound' weitergeleitet.

Den JDBC-Provider-Service für den DatabaseRetrieve-Knoten verfügbar machen

Der DatabaseRetrieve-Knoten erstellt seine JDBC-Verbindungen unter Verwendung der Verbindungsdetails, die in der Brokerregistry als konfigurierbarer Service gespeichert sind. Die konfigurierbaren JDBC-Provider-Services stehen allen unterstützten Datenbanken zur Verfügung. Sie können die Einstellungen des für Ihre Datenbank bereitgestellten Services mit dem Befehl mqsichangeproperties anpassen, oder Sie können mit dem Befehl mqsicreateconfigurableservice einen neuen Service erstellen. Weitere Informationen zur Verwendung der JDBC-Provider-Services finden Sie im Abschnitt JDBC-Provider für Verbindungen des Typs 4 einrichten. Sie müssen für jede Datenbank, zu der Sie eine Verbindung herstellen möchten, einen anderen JDBC-Provider-Service einrichten.

Nachdem Sie den Service definiert haben, müssen Sie die Eigenschaft Datenquellenname dieses Knotens auf den Namen des dafür erstellten JDBC-Provider-Service setzen. Die Attribute des Service werden für Verbindungen des DatabaseRetrieve-Knotens benötigt.

Damit die Änderungen wirksam werden, müssen Sie den Broker beenden und neu starten, es sei denn, Sie möchten eine neue Ausführungsgruppe für den Broker erstellen, in dem Sie den Nachrichtenfluss mit diesem Knoten implementieren.

Datenquellen mit Hilfe der Datenbankexplorer-Anzeige abfragen

In der Datenbankexplorer-Anzeige können Sie die Namen von Tabellen der Zieldatenbank sowie die Namen von Spalten dieser Tabellen ermitteln. Zunächst müssen Sie aber die Datenbankdefinitionen Ihrer Datenbanken in die Workbench importieren, damit sie in der Datenbankexplorer-Anzeige angezeigt werden. Informationen hierzu finden Sie im Abschnitt Datenbankdefinitionen zum Message Broker Toolkit hinzufügen.
  1. Wechseln Sie in die Ansicht 'Brokeranwendungsentwicklung'.
  2. Erweitern Sie in der Datenbankexploreransicht den Eintrag 'Connections' (Verbindungen). Die Datenbankverbindungen werden angezeigt.
  3. Erweitern Sie eine Datenbankverbindung, um die Datenbanken aufzulisten, und erweitern Sie dann die entsprechenden Datenbank.
  4. Erweitern Sie Schemas, um die Schemas aufzulisten, und erweitern Sie dann das entsprechende Schema.
  5. Erweitern Sie Tabellen, um alle Tabellen aufzulisten.
  6. Klicken Sie auf eine Tabelle, um die Eigenschaften in der Eigenschaftenansicht anzuzeigen.
  7. Klicken Sie in der Eigenschaftenansicht auf die Registerkarte Spalten, um die Spaltennamen anzuzeigen.

DatabaseRetrieve-Knoten konfigurieren

Wenn Sie eine Instanz des DatabaseRetrieve-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Der Abschnitt Nachrichtenflussknoten konfigurieren enthält weitere Informationen hierzu. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

Beispiel

Im folgenden Beispiel werden neue Elemente ('surname' und 'wage'; Nachname und Gehalt) zur Struktur der eingehenden Nachricht hinzugefügt. In diesem Beispiel wird eine Tabelle Namens 'employee' (Mitarbeiter) verwendet.
EmployeeNumber (Personalnummer) FamilyName (Nachname) FirstName (Vorname) Salary (Gehalt)
00001 Smith John 20000
00002 Jones Harry 26000
00003 Doe Jane 31000
Um eine Kopie der eingehenden Nachricht zu erstellen, müssen Sie das Kontrollkästchen Nachricht kopieren aktivieren. Wenn diese Eigenschaft ausgewählt ist, erstellt der Knoten die Ausgangsnachrichtenassemblierung immer auf Basis der Eingabenachrichtenassemblierung und die Baumstrukturen der neuen Ausgangsnachrichtenassemblierung werden modifiziert und an das Ausgangsterminal des Knotens weitergeleitet. Dieses Verhalten ermöglicht neben der Modifizierung aller logischen Baumstrukturen der Nachrichtenassemblierung ($OutputLocalEnvironment, $OutputDestinationList, $OutputExceptionList und $Environment) auch die Modifizierung der Baumstruktur für abgehende Nachrichten ($OutputRoot). Wenn dieser Knoten nur die logischen Baumstrukturen der Nachrichtenassemblierung modifizieren soll, sollten Sie das Kontrollkästchen Nachricht kopieren aus Leistungsgründen inaktivieren. Wenn diese Eigenschaft nicht ausgewählt ist, arbeitet der Knoten immer mit der ursprünglichen Eingabenachrichtenassemblierung. Er erwartet in diesem Fall, dass an der Nachrichtenbaumstruktur keine Aktualisierungsversuche unternommen werden. Falls ein XPath-Ausdruck der Datenelementtabelle versucht, diese Nachrichtenbaumstruktur mittels einer Referenz auf $OutputRoot zu aktualisieren, wird die Ausnahme 'MbReadOnlyMessageException' generiert. Die eingehende Nachricht lautet:
<EmployeeRecord>
	<EmployeeNumber>00001</EmployeeNumber>
</EmployeeRecord>
Die Tabelle mit den Datenelementen sieht wie folgt aus:
Tabellenname Spaltenname Operator Wertetyp Wert
Employee (Mitarbeiter) FamilyName (Nachname)      
Employee (Mitarbeiter) Salary (Gehalt)      
Employee (Mitarbeiter) EmployeeNumber (Personalnummer) = Option $OutputRoot/XMLNSC/EmpRecord/EmpNumber
und die Tabelle mit den Datenelementen sieht wie folgt aus:
Spaltenname Nachrichtenelement
Employee.FamilyName $OutputRoot/XMLNSC/EmployeeRecord/Surname
Employee.Salary $OutputRoot/XMLNSC/EmployeeRecord/Wage
Der DatabaseRetrieve-Knoten stellt eine Verbindung zur Datenbanktabelle 'Employee' her und extrahiert den zu vergleichenden Wert aus jeder eingehenden Nachricht. Der XPath-Ausdruck zur Navigation im Nachrichtentext lautet $InputBody/EmployeeRecord/EmployeeNumber. Die SQL-Abfrage lautet:
SELECT Employee.FamilyName, Employee.Salary
FROM Employee
WHERE EmployeeNumber=?
ORDER BY Employee.FamilyName ASC, Employee.Salary ASC
Dabei ist ? der Wert, der aus der eingehenden Nachricht abgerufen wird und über die Eigenschaft Wert in der dritten Zeile der Abfrageelementtabelle lokalisiert wird, die den Wertetyp Element aufweist.
  • Wenn der Wert an dieser Adresse 00001 ist, werden Informationen für John Smith abgerufen. Die erste Datenelementzeile gibt an, dass der Wert der Spalte 'FamilyName', der von der Abfrage zurückgegeben wird, abgerufen werden und in ein neues Element namens "Surname" unter 'EmployeeRecord' eingefügt werden soll. Die zweite Datenelementzeile gibt an, dass der Wert der Spalte 'Salary', der von der Abfrage zurückgegeben wird, abgerufen werden und in ein neues Element namens "Wage" unter 'EmployeeRecord' eingefügt werden soll. Die erstellte Ausgabenachricht lautet wie folgt:
    <EmployeeRecord>
    	<EmployeeNumber>00001</EmployeeNumber>
    	<Surname>Smith</Surname>
    	<Wage>20000</Wage>
    </EmployeeRecord>
  • Wenn der Wert an dieser Adresse 00002 ist, werden Informationen für Harry Jones abgerufen. Die erstellte Ausgabenachricht lautet wie folgt:
    <EmployeeRecord>
    	<EmployeeNumber>00002</EmployeeNumber>
    	<Surname>Jones</Surname>
    	<Wage>26000</Wage>
    </EmployeeRecord>
Wenn die Eigenschaft Mehrere Zeilen ausgewählt ist und die Informationen beider Mitarbeiter durch eine Abfrage in einer zweizeiligen Ergebnismenge zurückgegeben werden, lautet die Ausgabenachricht wie folgt:
<EmployeeRecord>
	<EmployeeNumber>00001</EmployeeNumber>
	<Surname>Smith</Surname>
	<Wage>20000</Wage>
	<EmployeeNumber>00002</EmployeeNumber>
	<Surname>Jones</Surname>
	<Wage>26000</Wage>
</EmployeeRecord>

Nachrichten auswerten

Durch die Festlegung der Auswertungseigenschaften können Sie festlegen, wie die vom DatabaseRetrieve-Knoten generierte Nachricht ausgewertet werden soll. Diese Eigenschaften führen nicht dazu, dass die Eingabenachricht ausgewertet wird. Falls diese Auswertung erforderlich ist, wird davon ausgegangen, dass die Auswertung bereits durch den Empfangsknoten oder einen vorhergehenden Auswertungsknoten ausgeführt wurde.

Weitere Informationen finden Sie unter Nachrichten überprüfen und Auswertungseigenschaften.

Terminals und Eigenschaften

Der Terminals des DatabaseRetrieve-Knotens werden in der folgenden Tabelle beschrieben.

Terminal Beschreibung
Eingangsterminal Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt.
Ausgang Das Ausgabeterminal, an das die abgehende Nachricht bei erfolgreicher Verarbeitung geleitet wird.
keyNotFound Das Ausgabeterminal, an das die unveränderte Originalnachricht weitergeleitet wird, wenn die Ergebnismenge leer ist.
Fehlerterminal Das Ausgabeterminal, an das die Eingabenachricht gesendet wird, wenn während der Verarbeitung ein Fehler auftritt.

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 DatabaseRetrieve-Knotens beschrieben.
Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Der Knotentyp, DatabaseRetrieve 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 grundlegenden Eigenschaften des DatabaseRetrieve-Knotens beschrieben.
Eigenschaft M C Standardwert Beschreibung
Datenquellenname Ja Ja DB2 Der Aliasname zum Lokalisieren der in der Brokerregistry gespeicherten Definition des JDBC-Provider-Service. Der Aliasname wird zum Lokalisieren und Erstellen der JDBC-Verbindungs-URL verwendet, die zum Herstellen einer Verbindung zu einem DBMS verwendet wird. Die Verbindungs-URL ist treiberspezifisch, enthält jedoch den Namen der Datenbank, zu der die Verbindung hergestellt werden soll.

Wenn die Verbindung zur Datenbank über ein Anmeldeaccount und -Kennwort hergestellt wird, verwendet der Knoten diese Eigenschaft auch als Suchschlüssel, mit dem diese Werte von einem erwarteten entsprechenden DSN-Eintrag in der Brokerregistry abgerufen werden können.

Wenn das Datenbankmanagementsystem (DBMS) durch ein Kennwort geschützt ist, geben Sie den Parameter -n im Befehl mqsisetdbparms für den eindeutigen JDBC-Sicherheitsschlüssel an, bevor Sie den Nachrichtenfluss implementieren, in dem dieser DatabaseRetrieve-Knoten enthalten sind.

Nachricht kopieren Nein Ja Nicht ausgewählt Diese Eigenschaft gibt an, ob eine Kopie der eingehenden Originalnachricht erforderlich ist, da die Nachrichtenbaumstruktur möglicherweise zusätzlich zu logischen Baumstrukturen in der Nachrichtenassemblierung aktualisiert wird. Das Kontrollkästchen ist standardmäßig inaktiviert. Aus Leistungsgründen sollten Sie diese Eigenschaft nur auswählen, wenn die Eingabenachricht erweitert wird.
Mehrere Zeilen Nein Ja Nicht ausgewählt Diese Eigenschaft gibt an, ob alle Zeilen verarbeitet werden, wenn eine Abfrage mehrere Zeilen zurückgibt. Wenn Sie Mehrere Zeilen auswählen, werden alle Zeilen verarbeitet und die Werte dieser Zeilen werden zur Aktualisierung der Baumstrukturen der Ausgabenachrichtenassemblierung verwendet. Wenn Sie diese Eigenschaft nicht auswählen, wird die erste Zeile ausgewählt und alle anderen Zeilen werden ignoriert.
Abfrageelemente Ja Nein   Eine Tabelle mit Abfrageelementen, die zum Erstellen einer einzelnen SQL-Anweisung SELECT verwendet werden. Die Tabelle besteht aus fünf Spalten und einer oder mehreren Zeilen. Folgende Spalten sind in der Tabelle enthalten: Tabellenname, Spaltenname, Operator, Wertetyp und Wert. Diese fünf Eigenschaften beschreiben ein Abfrageelement und geben einen tabellenqualifizierten Spaltenwert an, der aus der Datenbank abgerufen werden soll. In diesem Fall bildet das Element einen Teil der SELECT- und ORDER BY-Klauseln der generierten Abfrage. Ansonsten dient das Abfrageelement als Prüfbedingung, die innerhalb der WHERE-Klausel der generierten Abfrage ein Vergleichselement darstellt.
Tabellenname Ja Nein   Der Name der Datenbanktabelle, die Bestandteil der SQL-Anweisung SELECT ist, einschließlich des Schemanamens; z. B. myschema.mytable.
Spaltenname Ja Nein   Der Name der Spalte in der Datenbanktabelle, die in den Ergebnissen abgerufen wird und über den Wert für die Eigenschaft Tabellenname bestimmt wurde. Diese SELECT-Klausel kann auf diesen Namen als Spaltenwert für die Rücklieferung von einer Abfrage oder für den Verweis in einer Prüfbedingung innerhalb der WEHRE-Klausel verweisen.
Operator Ja Nein   Ein Vergleichsoperator, der für einen Wert des linken Operanden (die in den ersten zwei Spalten der Zeile angegebene Tabellenspalte) und optional des rechten Operanden angewendet wird. Wenn Sie für diese Eigenschaft einen aufsteigenden oder absteigenden Operatorwert (ASC oder DESC) angeben, gibt diese Zeile die Deklaration einer tabellenqualifizierten Spalte an, die einen Teil der SELECT- und ORDER BY-Klauseln der generierten Abfrage bildet und auf die in künftigen Zeilen optional als Wert für den rechten Operanden verwiesen werden kann.
Wertetyp Ja Nein   Ein Wert, der entweder auf None (Keiner) gesetzt ist oder der den Typ des Werts angibt, der in der letzten Spalte dieser Zeile definiert ist. Wenn diese Eigenschaft nicht auf None gesetzt ist, verweist sie auf eine Zeile, die innerhalb der WHERE-Klausel der SQL-SELECT-Anweisung eine Prüfbedingung beschreibt.
Wert Ja Nein   Ein Wert, der entweder auf None (Keiner) gesetzt ist oder der einen von mehreren Eigenschaftentypen angibt, die in der Eigenschaft Wertetyp definiert sind. Wenn die Eigenschaft Wertetyp beispielsweise auf Element gesetzt ist, erfasst die Eigenschaft Wert einen allgemeinen XPath 1.0-Ausdruck. Der Wert, der von dem Ausdruck zurückgegeben wird, wenn er auf die eingehende Nachricht des Knotens angewendet wird, wird als Wert für den rechten Operanden verwendet, der mit diesem Prädikat verglichen wird. Der Vergleichswert des rechten Operanden muss dem Typ entsprechen, der für die Tabellenspalte abgerufen wird, die als linker Operand für den Vergleich verwendet wird. Es sind auch komplexe Ausdrücke möglich, die keinen bis mehrere Werte aus der eingehenden Nachricht abrufen und so manipulieren, dass sie für den Vergleich einen einzigen Wert ergeben. Beispielsweise kann durch einen allgemeinen Ausdruck für den Wertetyp Element die Summe aus mehreren Feldwerten der eingehenden Nachricht berechnet werden.
In der folgenden Tabelle werden die Eigenschaften der Datenelementtabelle des DatabaseRetrieve-Knotens beschrieben.
Eigenschaft M C Standardwert Beschreibung
Datenelemente Ja Nein   Eine Liste mit Datenelementen. Ein Datenelement wird über die Eigenschaften Spaltenname für Wert und Nachrichtenelement beschrieben.
Spaltenname für Wert Ja Nein   Der Name der Datenbankspalte, aus der der Elementwert abgerufen wird. Die Liste mit Namen wird auf Basis der Einträge, die in die Tabelle mit den Abfrageelementen eingefügt werden, dynamisch aktualisiert.
Nachrichtenelement Ja Nein   Ein XPath 1.0-Schreib-/Lesepfadausdruck, der die Pfadposition eines Nachrichtenelements beschreibt. Im Nachrichtenelement ist der Datenbankwert gespeichert. Der XPath-Ausdruck muss ein einzelnes Element in der Nachricht ergeben.

In der folgenden Tabelle werden die Validierungseigenschaften des DatabaseRetrieve-Knotens beschrieben.

Eine umfassende Beschreibung dieser Eigenschaften finden Sie im Abschnitt Auswertungseigenschaften.
Eigenschaft M C Standardwert Beschreibung
Auswertung Nein Ja Keines Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen.
Aktion bei Fehler Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Diese Eigenschaft kann nur festgelegt werden, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert setzen. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste.
Zugehörige Konzepte
Nachrichtenflüsse - Übersicht
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac37390_