Zielelement aus gespeicherter Datenbankprozedur zuordnen

Verwenden Sie in einem Zuordnungsknoten eine gespeicherte DB2- oder Oracle-Datenbankprozedur als Quelle.

Vorbereitungen:

Sie müssen die gespeicherte Datenbankprozedur zunächst in die Datenbankdefinition einfügen. Weitere Informationen hierzu finden Sie unter Datenbankdefinitionen zum WebSphere Message Broker Toolkit hinzufügen. Für diese Task werden nur DB2- und Oracle-Datenbanken unterstützt.

Damit ein Zielelement aus einer gespeicherten Datenbankprozedur zugeordnet werden kann, müssen Sie den Zuordnungsknoten so konfigurieren, dass er:
  • mit der gespeicherten Prozedur die relevanten Zeilen aus der Datenbank abruft;
  • die Nachrichtenzielelemente mit den Werten aus der Datenbank füllt.

So ordnen Sie ein Zielelement aus einer gespeicherten Prozedur zu:

  1. Fügen Sie wie im Abschnitt Datenbank als Quelle oder Ziel hinzufügen beschrieben eine gespeicherte Prozedur als Quelle für die Zuordnung hinzu. Nachdem die gespeicherte Prozedur der Zuordnung hinzugefügt wurde, enthalten die Teilfenster für die Quelle und das Spreadsheet $db:proc-Einträge. Diese Einträge enthalten Details zu den von der gespeicherten Prozedur verwendeten Parametern. Zu jedem Parameter werden Name, Modus (IN, INOUT oder OUT) und Datentyp aufgeführt.

    Der $db:proc-Eintrag im Teilfenster für das Spreadsheet enthält außerdem noch eine for-Zeile. Standardmäßig weist die Position dieser for-Zeile im $db:proc-Eintrag darauf hin, dass der Ausgabenachrichtentext sich wiederholenden Elemente enthält, wenn das Ergebnis mehrere Datensätze umfasst. Soll für jeden Datensatz in einer Ergebnisliste eine eigene Nachricht ausgegeben werden, müssen Sie das Element '$target' unter die for-Zeile im Teilfenster für das Spreadsheet verschieben.

    Bei Verwendung der gespeicherten DB2-Prozedur, bei der eine maximal mögliche Anzahl von Ergebnislisten angegeben ist, enthält das Teilfenster für die Quelle auch eine Liste der Ergebnislisten. Bei Verwendung einer gespeicherten Oracle-Prozedur, bei der REF_CURSOR-Parameter des Modus INOUT oder OUT angegeben werden, werden diese Parameter vom Zuordnungsknoten nicht als Parameter, sondern als benannte Ergebnislisten behandelt. REF_CURSOR-Parameter des Modus IN werden vom Zuordnungsknoten nicht unterstützt.

  2. Wenn die gespeicherte Prozedur Parameter des Modus IN oder INOUT enthält, müssen für diese Werte angegeben werden:
    1. Geben Sie im Teilfenster für das Spreadsheet im Feld Wert neben dem Parameter einen Ausdruck ein.
    2. Wählen Sie den Parameter im Teilfenster für das Spreadsheet aus, ziehen Sie ein Element aus der Quellennachricht in das Teilfenster zum Bearbeiten und drücken Sie die Eingabetaste.
  3. Wenn von der gespeicherten Prozedur ein Rückgabewert gesetzt wird, klicken Sie im Teilfenster für die Quelle mit der rechten Maustaste auf den $db:proc-Eintrag und wählen Sie Umschalten zwischen Hinzufügen und Entfernen des Rückgabewerts der gespeicherten Prozedur aus. Im Teilfenster für die Quelle wird das Element 'ReturnValue' des Typs INTEGER hinzugefügt.

    Bei DB2 auf verteilten Systemen wird SQLCODE zurückgegeben, wenn von der gespeicherten Prozedur kein Rückgabewert gesetzt wird.

    Gespeicherte DB2-Prozeduren unter z/OS sowie gespeicherte Oracle-Prozeduren setzen keinen Rückgabewert.

  4. Definieren Sie für jede Ergebnisliste, die von der gespeicherten Prozedur zurückgegeben wird, die Spalten, die diese Ergebnisliste enthält:
    1. Klicken Sie im Teilfenster für die Quelle mit der rechten Maustaste auf den Ergebnislisteneintrag und wählen Sie Ergebnisspalten hinzufügen oder entfernen aus. Das Fenster 'Ergebnisspalten hinzufügen oder entfernen' wird geöffnet.
    2. (Optional) Wählen Sie in der Liste Bestehende Einstellungen wiederherstellen aus: ein Element aus. Die Liste Ergebnisspalten wird ersetzt.
    3. (Optional) Wählen Sie in der Liste Verfügbare Datenbanktabellenspalten: die Spalten aus und fügen Sie sie der Liste Ergebnisspalten hinzu.
    4. (Optional) Geben Sie im Feld Neue Spalte einen Spaltennamen ein und fügen Sie ihn der Liste Ergebnisspalten hinzu. Fügen Sie auf diese Weise berechnete Spalten hinzu, die in der gespeicherten Prozedur angegeben sind.
    5. (Optional) Ändern Sie den Namen im Feld Aktuelle Einstellungen speichern in:; unter diesem Namen werden die in Ergebnisspalten enthaltenen Spalten gespeichert, wenn Sie auf Finish (Fertigstellen). Die Einstellungen werden im Verzeichnis \.metadata gespeichert. Diese Einstellungen können wie unter Schritt 4a beschrieben für eine andere Nachrichtenzuordnung abgerufen werden. Wenn der Standardname nicht geändert wird, werden die Einstellungen bei Verwendung der gespeicherten Prozedur in einer anderen Nachrichtenzuordnung automatisch abgerufen.
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-08-06 17:58:24


TaskthemaTaskthema | Version 7.0.0.5 | ar25284_