Exemple d'utilisation du service de composition du système de messagerie

L'exemple suivant montre comment utiliser le service de composition du système de messagerie. Si vous disposez d'un magasin appelé DemoStore et si vous souhaitez affecter deux méthodes de transfert (par courrier électronique et par fichier) au type de message OrderAuthorized, procédez comme suit :

  1. Ajoutez une entrée dans la table VIEWREG associée au fichier JSP afin de l'utiliser dans la composition de ce message sortant. Les clés de la table VIEWREG sont le nom de la vue, l'ID de magasin et l'ID de format d'unité. Pour obtenir de plus amples informations sur l'utilisation de la table VIEWREG, reportez-vous au manuel WebSphere Commerce Programmer's Guide.

    Important : chaque vue créée pour être utilisée par le service de composition du système de messagerie doit utiliser l'instruction de vue de message associée aux zones de nom de classe et de l'interface. Elle doit également contenir le nom du fichier JSP dans la zone docname. Pour résumer :

    INTERFACENAME
    com.ibm.commerce.messaging.viewcommands.MessagingViewCommand
    CLASSNAME
    com.ibm.commerce.messaging.viewcommands.MessagingViewCommandImpl
    PROPERTIES
    Utilisez le format suivant pour pointer sur le fichier JSP 'docname=jsp file'.
    DEVICEFMT_ID
    Représente le format d'unité et doit utiliser la valeur -3 (format d'unité standard) excepté si des formats d'unité personnalisés sont utilisés pour votre application. Le paramètre DEVICEFMT_ID défini dans l'entrée VIEWREG doit correspondre au format d'unité sélectionné lors de l'attribution d'un type de message pour un transfert.

    Par exemple, si l'ID magasin de DemoStore est 5 et si le nom de la vue est OrderAuthorized, vous avez la possibilité d'insérer un enregistrement à l'aide de l'instruction SQL ci-après :

    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. Utilisez la Console d'administration pour affecter le courrier électronique et les transferts de fichier au message OrderAuthorized et configurer les paramètres. Vous pouvez le faire avec les droits d'administration de niveau site ou magasin. La création de paramètres sur le niveau de site permettra de le rendre accessible depuis tous les magasins.
  3. Lors de la mise en oeuvre d'une instruction, instanciez l'instruction SendMsgCmd pour utiliser des services de messagerie et appeler les méthodes setMsgType() et setStoreID(), à l'aide de l'ID message du type de message OrderAuthorized et de l'ID magasin de DemoStore. Si vous souhaitez utiliser la configuration au niveau site, indiquez 0 en tant qu'ID de magasin et faites suivre le nom du fichier JSP de "&storeDir=no". Sinon, utilisez votre ID magasin. (Si aucune configuration n'est paramétrée pour votre magasin, le système de messagerie établit automatiquement par défaut une configuration au niveau du site)
  4. Appelez la méthode de composition de l'interface du système de messagerie sortante et transmettez tout paramètre supplémentaire sous la forme d'un objet TypedProperty. En spécifiant un nom de vue, vous allez substituer le nom de vue par défaut des types de message utilisé lors de la composition du message.
  5. Appelez sendImediate ou sendTransacted sur SendMsgCmd si vous souhaitez envoyer le message immédiatement ou après la validation de la transaction. Reportez-vous à la documentation consacrée au système de messagerie afin d'obtenir de plus amples explications concernant l'utilisation de chaque méthode.
  6. Appelez la méthode d'exécution de SendMsgCmd pour effectuer l'envoi.

Rubrique connexe

Tâches connexes

Référence connexe

IBM copyright