Den Hauptnachrichtenfluss erstellen

Dies ist die erste einer Reihe von Anweisungen zur Konfiguration Ihres Systems für die Verwendung des SOAP-Parsers mit WebSphere Message Broker, in der die Erstellung eines zur Verwendung dieser Funktion erforderlichen Nachrichtenflusses erläutert wird.

Dieses Kapitel beschreibt an einem Beispiel die Erstellung eines Hauptnachrichtenflusses bei Verwendung des SOAP-Parsers:

  1. Wechseln Sie in die Ansicht 'Brokeranwendungsentwicklung'.
  2. Erstellen Sie mit Hilfe des Assistenten Von WSDL- und/oder XSD-Dateien ausgehen einen Nachrichtenfluss sowie Nachrichtengruppenprojekte. Weitere Informationen hierzu finden Sie im Abschnitt Anwendungen auf Basis von WSDL- oder XSD-Dateien erstellen.

    Sie benötigen einen Port für die Eingabe in den Nachrichtenfluss und die Antwort aus dem Nachrichtenfluss, zum Beispiel einen Port mit dem Namen OrderService, und einen Port für die Definition eines Web-Services, der aus dem Nachrichtenfluss aufgerufen wird, zum Beispiel einen Port mit dem Namen ShippingService.

  3. Wählen Sie für den Import der benötigten Datenbankdateien den von Ihnen verwendeten Projektnamen aus, und drücken Sie die rechte Maustaste.
    1. Wählen Sie Neu->Datenbankdefinitionsdateien aus, um den Assistenten für die Datenbankdefinition zu starten. Weitere Informationen hierzu finden Sie im Abschnitt Datenbankdefinitionen zum Message Broker Toolkit hinzufügen.
  4. Wählen Sie aus der aktiven Arbeitsmappe unter Implementierbare WSDL die WSDL-Datei mit dem Namen OrderService aus.
    1. Ziehen Sie den Mauszeiger auf den Nachrichtenflusseditor.
    2. Lassen Sie die linke Maustaste los. Der Assistent Verwendung des neuen Web-Service konfigurieren wird gestartet.
    3. Weitere Informationen finden Sie im Abschnitt Mit dem Assistenten 'Verwendung des neuen Web-Service konfigurieren' eine Anwendung erstellen. Achten Sie darauf, dass folgende Optionen ausgewählt sind:
      • Nachrichtenfluss als Web-Service zugänglich machen auf der ersten Seite des Assistenten.
      • SOAP-Knoten auf der zweiten Seite des Assistenten.
      Wenn Sie Fertig stellen auswählen, wird ein aus folgenden Komponenten bestehendes Nachrichtenflussgerüst generiert:
      • Ein für den Web-Service vorkonfigurierter SOAPInput-Knoten, verbunden mit einem
      • SOAPExtract-Knoten zum Entfernen der SOAP-Rahmenanweisung von der ankommenden Nachricht
      • SOAPReply-Knoten
  5. Wählen Sie den Ordner Erstellung in der Nachrichtenflusspalette, um den Inhalt anzuzeigen.
  6. Wählen Sie einen Trace-Knoten aus, und bewegen Sie die Maus auf die rechte Seite des SOAPExtract-Knotens.
    1. Klicken Sie mit der linken Maustaste, um den Knoten zum Nachrichtenfluss hinzuzufügen. Der Name wird automatisch ausgewählt.
    2. Drücken Sie die Eingabetaste, um den Standardnamen anzunehmen.
    3. Verbinden Sie das submitPORequest-Terminal des SOAPExtract-Knotens mit dem Eingabeterminal des Trace-Knotens.
  7. Wählen Sie den Trace-Knoten aus, um die Eigenschaften anzuzeigen.
    1. Verwenden Sie das Dropdown-Menü, um im Ordner Zieladresse die Option Datei einzustellen.
    2. Legen Sie den erforderlichen Dateipfad fest.
    3. Geben Sie das gewünschteMuster ein.
  8. Blenden Sie den Ordner Routing auf der Palette ein und wählen Sie die Option Filtern.
  9. Fügen Sie den Filterknoten rechts vom Trace-Knoten ein.
    1. Geben Sie den Namen des gewünschten Knotens ein und drücken Sie die Eingabetaste.
    2. Verbinden Sie das Ausgangsterminal des Trace-Knotens mit dem Eingabeterminal des Filterknotens.
  10. Wählen Sie den Filterknoten aus, um die Eigenschaften anzuzeigen.
    1. Geben Sie den Namen der gewünschten Datenquelle ein.
    2. Ändern Sie den Filterausdruck-Namen in den Namen, den Sie für den Filterknoten ausgewählt haben.
    3. Entfernen Sie die Markierung des Kontrollkästchens Ausnahme für Datenbankfehler ausgeben.
  11. Wählen Sie den Filterknoten aus, und klicken Sie doppelt mit der linken Maustaste, um den ESQL-Editor zu öffnen. Erstellen oder ändern Sie die ESQL für den Knoten; siehe ESQL-Code für einen Knoten erstellen und ESQL für einen Knoten modifizieren.
  12. Blenden Sie den Ordner Transformation auf der Palette ein und wählen Sie einen Zuordnungs-Knoten.
  13. Fügen Sie den Zuordnungsknoten rechts vom Filterknoten ein.
    1. Geben Sie den Namen des gewünschten Knotens ein und drücken Sie die Eingabetaste.
    2. Verbinden Sie das False-Terminal des Filterknotens mit dem Eingabeterminal des Zuordnungsknotens.
  14. Wählen Sie den Zuordnungsknoten aus, um die Eigenschaften anzuzeigen.
    1. Ändern Sie den Zuordnungsroutine-Namen in den Namen, den Sie für den Zuordnungsknoten ausgewählt haben.
  15. Wählen Sie den Zuordnungsknoten aus, und klicken Sie doppelt mit der linken Maustaste, um den Zuordnungseditor zu öffnen.
    1. Wählen Sie die erforderliche Zuordnungsquelle und das erforderliche Zuordnungsziel aus.
    2. Wählen Sie OK aus
    3. Wählen Sie bei dem Tipp, der zum Öffnen des Zuordnungseditors angezeigt wird, die Option OK.
    Weitere Informationen finden Sie im Abschnitt Nachrichtenzuordnungsdatei von einem Zuordnungsknoten erstellen.
  16. Wählen sie sowohl im Quell- als auch im Ziel-Fenster die Option Eigenschaften.
    1. Drücken Sie die rechte Maustaste.
    2. Wählen Sie Nach Namen sortieren aus dem Menü aus.
    3. Ordnen Sie mit Hilfe von Drag-and-drop-Zuordnung die Quelleigenschaften den Zieleigenschaften zu. Das Dialogfenster Nach Namen sortieren wird angezeigt.
    4. Wählen Sie OK, um die Zuordnung durchzuführen.
  17. Blenden Sie den Ordner WebSphere MQ auf der Palette ein, und wählen Sie einen MQOutput-Knoten aus.
  18. Fügen Sie den MQOutput-Knoten rechts vom Zuordnungsknoten ein.
    1. Geben Sie den Namen des gewünschten Knotens ein und drücken Sie die Eingabetaste.
    2. Verbinden Sie das Ausgangsterminal des Zuordnungsknotens mit dem Eingabeterminal des MQOutput-Knotens.
  19. Wählen Sie den MQOutput-Knoten aus, um die Eigenschaften anzuzeigen.
    1. Geben Sie den gewünschten Warteschlangennamen ein.
    2. Klicken Sie bei Bedarf auf die Registerkarte Erweitert, um die Felder im nächsten Fenster zu bearbeiten.
  20. Blenden Sie den Ordner Transformation auf der Palette ein und wählen Sie einen Zuordnungs-Knoten.
  21. Fügen Sie den zweiten Zuordnungsknoten unter dem ersten Zuordnungsknoten ein.
    1. Geben Sie den Namen des gewünschten Knotens ein und drücken Sie die Eingabetaste.
    2. Verbinden Sie das False-Terminal des Filterknotens mit dem Eingabeterminal dieses Zuordnungsknotens.
  22. Fügen Sie den Zuordnungsknoten rechts vom Filterknoten ein.
    1. Geben Sie den Namen des gewünschten Knotens ein und drücken Sie die Eingabetaste.
    2. Verbinden Sie das False-Terminal des Filterknotens mit dem Eingabeterminal des Zuordnungsknotens.
    3. Verbinden Sie das Ausgangsterminal des Zuordnungsknotens mit dem Eingabeterminal des SOAPReply-Knotens.
  23. Wählen Sie den Zuordnungsknoten aus, um die Eigenschaften anzuzeigen.
    1. Ändern Sie den Zuordnungsroutine-Namen in den Namen, den Sie für den Zuordnungsknoten ausgewählt haben.
  24. Wählen Sie den zweiten Zuordnungsknoten aus, und klicken Sie doppelt mit der linken Maustaste, um den Zuordnungseditor zu öffnen. Bei der Antwortnachricht handelt es sich um eine SOAP-Nachricht. Da die Eingabenachricht von einem SOAPExtract-Knoten verarbeitet wurde, enthält sie keine SOAP-Rahmenanweisung.
    1. Wählen Sie submitPORequest als Quellennachricht aus.
    2. Wählen Sie SOAP_Domain_Msg als Zielnachricht aus.
    3. Wählen Sie OK aus
    4. Wählen Sie bei dem Tipp, der zum Öffnen des Zuordnungseditors angezeigt wird, die Option OK.
    Weitere Informationen finden Sie im Abschnitt Nachrichtenzuordnungsdatei von einem Zuordnungsknoten erstellen.
  25. Wählen sie sowohl im Quell- als auch im Ziel-Fenster die Option Eigenschaften.
    1. Drücken Sie die rechte Maustaste.
    2. Wählen Sie Nach Namen sortieren aus dem Menü aus.
    3. Ordnen Sie mit Hilfe von Drag-and-drop-Zuordnung die Quelleigenschaften den Zieleigenschaften zu. Das Dialogfenster Nach Namen sortieren wird angezeigt.
    4. Wählen Sie OK, um die Zuordnung durchzuführen.
  26. Blenden Sie die Option SOAP_Domain_Msg, dann Hauptteil und Nachrichtenelemente im Zielfenster ein.
  27. Wählen Sie im Quellenfenster das Element tns:submitPORequest aus.
  28. Wählen Sie das Element Platzhalterzeichennachricht im Zielfenster aus.
    1. Drücken Sie die rechte Maustaste.
    2. Wählen Sie Neue Unterzuordnung erstellen aus dem Menü aus.
    3. Blenden Sie das ElementPlatzhalterzeichen ein.
    4. Blättern Sie zu dem Element submitPOResponse herunter und wählen Sie es aus.
    5. Drücken Sie OK, um die Submap zu erstellen.
  29. Wählen Sie mit Hilfe von Drag-and-drop-Zuordnung das gewünschte Element im Fenster Quelle aus.
  30. Wählen Sie das erste gewünschte Element im Fenster Ziel aus.
    1. Drücken Sie die rechte Maustaste.
    2. Wählen Sie Ausdruck eingeben aus dem Menü aus.
    3. Geben Sie den gewünschten Wert im Ausdruckseditor ein und drücken Sie die Eingabetaste, um die Zuordnung zu beenden. Ein Ausdruck, der aus einer Zeichenfolge besteht, muss in einfachen Anführungszeichen eingeschlossen sein.
    Wiederholen Sie die oben beschriebenen Schritte für alle Elemente, die Sie im Ziel-Fenster benötigen und speichern Sie Submap und Map mit Hilfe der Tastenkombination Strg+S.
  31. Richten Sie einen weiteren Nachrichtenfluss ein, der einen Zuordnungsknoten für die Erstellung einer Versandanforderungsnachricht, einen SOAPRequest-Knoten zum Versenden der Anforderung an den Web-Service ShippingService sowie einen weiteren Zuordnungsknoten für die Erstellung der Antwortnachricht an den ursprünglichen Requester verwendet.
    1. Wiederholen Sie die vorangegangenen Schritte zur Erstellung eines Zuordnungsknotens und einer untergeordneten Zuordnung. Verbinden Sie das True-Terminal des Filterknotens mit dem Eingabeterminal des neuen Zuordnungsknotens.
    2. Wählen Sie im Projekt 'MessageSet' im Ordner Implementierbare WSDL die Datei ShippingService.wsdl aus, die Sie verwenden.
    3. Halten Sie die linke Maustaste gedrückt, verschieben Sie den Mauszeiger an eine Stelle rechts des neuen Zuordnungsknotens, und lassen Sie die Maustaste dort wieder los. Der Assistent 'Verwendung des Web-Service konfigurieren' wird gestartet.
    4. Setzen Sie Web-Service-Verwendung auf Web-Service über Nachrichtenfluss aufrufen, und wählen Sie im nächsten Fenster SOAP-Knoten aus.
    5. Klicken Sie auf Fertig stellen, um einen SOAPRequest-Knoten zu erstellen. Weitere Informationen zur Verwendung dieses Assistenten finden Sie im Abschnitt Mit dem Assistenten 'Verwendung des neuen Web-Service konfigurieren' eine Anwendung erstellen.

      Verbinden Sie das Ausgangsterminal des neuen Zuordnungsknotens mit dem Eingabeterminal des SOAPRequest-Knotens.

    6. Wiederholen Sie die vorangegangenen Schritte zur Erstellung eines Zuordnungsknotens und einer untergeordneten Zuordnung ein weiteres Mal. Verbinden Sie folgende Terminals:
      • Das shipPartResponse-Terminal des SOAPRequest-Knotens mit dem Eingabeterminal des zweiten neuen Zuordnungsknotens.
      • Das Ausgangsterminal des neuen Zuordnungsknotens mit dem Eingabeterminal des SOAPReply-Knotens.
  32. Speichern Sie den gesamten Nachrichtenfluss.
Zugehörige Konzepte
Die Struktur einer SOAP-Nachricht
Zugehörige Tasks
SOAP-Parser verwenden
Zugehörige Verweise
Ansicht 'Brokeranwendungsentwicklung'
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac64610_