Développement du contenu d'un fichier JSP de modèle de courrier électronique personnalisé

Vous pouvez développer un contenu dynamique et personnalisé pour votre fichier JSP de modèle de courrier électronique personnalisé. Lorsque vous développez ce contenu, vous devez respecter les règles de spécification recommandées.

Pour recevoir des activités de message électronique, les clients doivent choisir de recevoir des messages électroniques marketing lorsqu'ils s'inscrivent ou mettent à jour leur compte. La classe EmailActivityUrlHelperDataBean permet au client de retirer rapidement ce choix.

Le contenu d'un message électronique est séparé de l'adresse (de l'expéditeur et du destinataire) ainsi que des éléments d'objet du message. Voici un exemple type d'en-tête de message électronique MIME :


Received: from localhost (localhost)
    by some.address.com (1.12.256/1.12.256) id g8UG02Hj033414;
    Tue, 22 Oct 2002 14:43:22 -0400
    Date: Tue, 22 Oct 2002 14:43:22 -0400
    From: Mail Delivery Subsystem
<MAILER-DAEMON@some.address.com>
    Message-Id:
<200209301843.g8UG02Hj033414@some.address.com>
    To: <yourname@anotherAddress.com>
    MIME-Version: 1.0
    Content-Type: multipart/report; report-type=delivery-status;
    boundary="g8UG02Hj033414.1033411402/some.address.com"
Subject: Returned mail: see transcript for details
    --g8UG02Hj033414.1033411402/some.address.com

The original message was received at Tue, 22 Oct 2002 13:57:55
-0400 from 
    yet.another.address.com [256.256.256.256]

Comme vous pouvez le constater dans les zones signalées en gras, le contenu du courrier électronique est nettement séparé des informations d'en-tête. Cette séparation influence les API et les produits logiciels développés à l'aide de ces formats de courrier électronique.

Lorsque vous créez un modèle de courrier électronique, vous devez respecter les règles de spécification suivantes :

Si la chaîne de requête d'URL qui demande la page JSP contient le paramètre "returnSubject=true", la page JSP n'affiche que les données de la ligne d'objet du message électronique.
Si la chaîne de requête d'URL qui demande la page JSP ne contient pas le paramètre "returnSubject=true", la page JSP affiche le contenu du message électronique, hormis les données de la ligne d'objet.
La chaîne de requête d'URL enregistrée dans un modèle de courrier électronique doit comporter les paramètres suivants, ajoutés lors de la demande :

recipientId

Identificateur de l'utilisateur destinataire du courrier électronique.

storeId

Identificateur d'entité du magasin pour le modèle de courrier électronique.

activityId

Identificateur de l'activité de courrier électronique ayant émis la demande.

Ces paramètres sont remplis lors de la création du courrier électronique.
Si vous utilisez IBM Digital Analytics, anciennement connu sous l'appellation Coremetrics Analytics pour les activités de courrier électronique et qu'un lien pointe vers la boutique en ligne, les paramètres cm_cr et cm_mmc. Ces paramètres sont ajoutés à l'URL avec le format suivant.
```
 
cm_cr=OS: Campaign Name-_-E-mail Activity-_-E-mail Activity Name-_-E-mail Template Name-_-Link Name 
&cm_mmc=E-mail-_-HCL Commerce-_-E-mail Activity Name-_-Link Name
```
Où
- E-mail Activity Name est le nom de l'activité de courrier électronique.
- E-mail Template Name est le nom du modèle de courrier électronique.
- Link Name est le nom du lien, qui identifie uniquement le lien dans le modèle.
Par exemple :
```
https://hostname/webapp/wcs/stores/servlet/ProductDisplay?storeId=10001&catalogId=10001&productId=10001&
cm_cr=OS:No+Campaign-_-E-mail+Activity-_-Summer+Discount+Activity-_-Show+Promotion-_-Desk+Special
&cm_mmc=E-mail-_-WebSphere+Commerce-_-Summer+Discount+Activity-_-Desk+Special
```

Lorsqu'une URL est enregistrée dans le modèle de courrier électronique, elle demande diverses ressources. En respectant les règles précédentes, vous veillez à ce que ces ressources fournissent des messages électroniques dynamiques. Etant donné que toutes les données sont transmises via la chaîne de requête d'URL, il n'est pas nécessaire que l'URL destinataire soit un fichier JSP. En fait, toute ressource capable de lire et de répondre selon les règles précédentes peut être considérée comme un modèle de courrier électronique valide.