Beispiel der Verwendung des Kompositionsservices für das Nachrichtensystem

Nachfolgend ein Beispiel dafür, wie Sie die Kompositionsservices für das Nachrichtensystem verwenden können. Wenn Sie über ein Geschäft namens DemoStore verfügen und zwei Transporte (E-Mail und Datei) zur Nachrichtenart OrderAuthorized zuordnen wollen, könnten Sie wie folgt vorgehen:

  1. Fügen Sie einen Eintrag zur Tabelle VIEWREG für die JSP-Datei hinzu, die zur Erstellung dieser ausgehenden Nachricht verwendet werden soll. Die Schlüssel für die Tabelle VIEWREG sind der Name des Anzeigebefehls, die Geschäfts-ID und die Einheitenformat-ID. Weitere Informationen zur Verwendung der Tabelle VIEWREG finden Sie im Handbuch WebSphere Commerce Programmer's Guide.

    Wichtig: Jede Anzeige, die für die Verwendung mit dem Kompositionsservice des Nachrichtensystems erstellt wurde, muss den Befehl für die Nachrichtenanzeige für die Felder Schnittstelle und Klassenname verwenden. Außerdem muss das Feld Docname den Namen der JSP-Datei enthalten. Zusammenfassung:

    INTERFACENAME
    com.ibm.commerce.messaging.viewcommands.MessagingViewCommand
    CLASSNAME
    com.ibm.commerce.messaging.viewcommands.MessagingViewCommandImpl
    PROPERTIES
    Verwenden Sie folgendes Format, um auf die JSP-Datei 'docname=jsp file' zu zeigen.
    DEVICEFMT_ID
    Stellt das Einheitenformat dar und sollte den Wert -3 (Standardeinheitenformat) verwenden, sofern keine benutzerdefinierten Einheitenformate für Ihre Anwendung verwendet werden. Die im VIEWREG-Eintrag angegebene DEVICEFMT_ID muss mit dem Einheitenformat übereinstimmen, das beim Zuordnen einer Nachrichtenart zu einem Transport ausgewählt ist.

    Beispiel: Wenn die Geschäfts-ID für DemoStore 5 ist und der Anzeigename OrderAuthorized lautet, können Sie den Satz mit der folgenden SQL-Anweisung einfügen:

    insert into viewreg (VIEWNAME,STOREENT_ID,DEVICEFMT_ID,INTERFACENAME,CLASSNAME, PROPERTIES)values
    ('OrderAuthorizedView',5,-3,
    'ibm.commerce.messaging.viewcommands.MessagingViewCommand'
    'ibm.commerce.messaging.viewcommands.MessagingViewCommandImpl',
    'docname=OrderAuthorized.jsp');

  2. Verwenden Sie die Verwaltungskonsole, um die Transporte 'E-Mail' und 'Datei' der Nachricht OrderAuthorized zuzuordnen und die Einstellungen zu konfigurieren. Dies können Sie mit der Berechtigung zur Verwaltung auf Site- oder Geschäftsebene vornehmen. Durch Erstellung von Einstellungen auf Site-Ebene ist der Zugriff für alle Geschäfte möglich.
  3. Bei der Implementierung eines Befehls erstellen Sie ein Exemplar des Befehls SendMsgCmd, um Nachrichtenservices zu verwenden und die Methoden setMsgType() sowie setStoreID() aufzurufen, indem Sie für die Nachrichtenart OrderAuthorized die Nachrichten-ID sowie für DemoStore die Geschäfts-ID verwenden. Falls Sie eine Konfiguration auf Site-Ebene benötigen, geben Sie den Wert 0 als Geschäfts-ID an, und fügen Sie "&storeDir=no" am Ende des JSP-Namens hinzu. Andernfalls verwenden Sie die Geschäfts-ID. (Falls für Ihr Geschäft keine Konfiguration vorhanden ist, ruft der Nachrichtenservice standardmäßig die Konfiguration auf Site-Ebene ab.)
  4. Rufen Sie die Methode compose der Schnittstelle des Nachrichtensystems für ausgehende Nachrichten auf und übergeben Sie alle zusätzlichen Parameter in Form eines Objekts TypedProperty. Durch Angeben eines Anzeigenamens setzen Sie beim Erstellen der Nachricht den Standardanzeigenamen der Nachrichtenart außer Kraft.
  5. Rufen Sie die Methoden sendImediate oder sendTransacted bei SendMsgCmd auf, wenn die Nachricht sofort oder nach erfolgreicher Festschreibung der Transaktion gesendet werden soll. Ausführlichere Erläuterungen zur Verwendung der jeweiligen Methoden finden Sie in der Dokumentation über das Nachrichtensystem.
  6. Rufen Sie die Methode execute des Befehls SendMsgCmd auf, um den Versand auszuführen.

Verwandte Konzepte

Verwandte Aufgaben

Verwandte Referenzen

IBM Copyright