Activation et configuration du transport SMS

L'activation du transport des SMS étend l'accès transcanal en offrant des capacités d'unité mobile dans HCL Commerce. La messagerie mobile améliore l'accès du client aux informations en lui permettant d'y accéder par le biais de leur unité mobile.

Pourquoi et quand exécuter cette tâche

Cette tâche active et configure le transport des SMS dans HCL Commerce avec la Console d'administration. Les étapes de cette tâche sont les suivantes :

Ajout d'un transport SMS au site, si nécessaire, avec les transports de la Console d'administration.
Création et configuration d'un type de message avec les types de message de la Console d'administration.
Mappage du type de message avec un fichier JSP, en éditant le fichier de configuration struts-config.xml.

Procédure

Ouvrez la Console d'administration et sélectionnez Site ou Magasin, dans la page Console d'administration - Sélection de site/magasin.
Cliquez sur Configuration > Transports.
Les transports SMS-HTTP et SMS-WS doivent s'afficher dans la liste et être actifs.
1. Si le transfert que vous souhaitez configurer n'apparaît pas dans la liste :
  1. Cliquez sur Ajouter pour ouvrir la page Ajout d'un transport.
  2. Cochez la case en regard du transfert SMS que vous voulez ajouter au site.
  3. Cliquez sur Ajouter pour accepter les modifications. Lorsque vous ajoutez une méthode de transfert à un site, elle est automatiquement activée.
2. Si le transport que vous souhaitez configurer est inactif :
  1. Cochez la case en regard du transport inactif.
  2. Cliquez sur Modifier l'état.
  3. L'état du transport doit passe d'Inactif à Actif.
Cochez la case en regard du transport SMS, puis cliquez sur Configurer.
Fournissez les valeurs des paramètres correspondant au transport SMS que vous avez créé. Voir Configuration des services de transport utilisés pour un message pour afficher la description de ces valeurs. Cliquez sur OK.
Cliquez sur Configuration > Types de messages.
Cliquez sur Nouveau.
Dans la liste Type de message, sélectionnez un type de message.
Pour envoyer des messages de texte marketing avec une activité de dialogue, sélectionnez Message marketing.
Spécifiez une plage de gravité du message. En général, une gravité de message de 0,0 est recommandée.
Dans la liste Transport, sélectionnez SMS-HTTP ou SMS-WS.
Dans la liste Format d'unité, sélectionnez Messages SMS.
Cliquez sur Terminer. La page Configuration du type de message s'affiche. La colonne Etat du transfert doit être active. Si elle ne l'est pas, le transfert a été désactivé ou supprimé.
Remarque : Vous pouvez rencontrer l'erreur suivante si le type de message n'est pas entièrement configuré :
```
CMN8413E: The messaging system cannot find an appropriate profile for MSGTYPE_ID "350"
```
Pour éviter ce problème, assurez-vous de terminer toutes les étapes de configuration du type de message précédentes.
Facultatif : Modifiez le fichier de configuration Struts si vous souhaitez personnaliser le mappage du modèle de message avec un autre fichier JSP. Pour les messages de texte marketing, vous pouvez sauter cette étape car ces messages texte sont créés dans l'outil Marketing sous forme de contenu.
1. Ouvrez le fichier de configuration struts-config.xml et ajoutez une nouvelle entrée pour le type de message SMS que vous avez créé. Par exemple :
```
<forward className="com.ibm.commerce.struts.ECActionForward"
            name="yourView/0/-7" path="/yourJSPfile.jsp">
            <set-property property="resourceClassName" value="com.ibm.commerce.messaging.viewcommands.MessagingViewCommandImpl"/>
            <set-property property="properties" value="storeDir=no"/>
            <set-property property="interfaceName" value="com.ibm.commerce.messaging.viewcommands.MessagingViewCommand"/>
            <set-property property="implClassName" value="com.ibm.commerce.messaging.viewcommands.MessagingViewCommandImpl"/>
            <set-property property="direct" value="true"/>
        </forward>
```
  Le fichier de configuration utilise -7 comme format d'unité SMS, comme défini dans la table de base de données DEVICEFMT. Le paramètre de chemin dans votre nouvelle entrée est mappé avec un fichier JSP.
2. Enregistrez vos modifications et fermez le fichier de configuration.

Résultats

Lorsque vous avez terminé les étapes précédentes dans l'ordre indiqué, vous avez :

Ajouté un transport SMS au site, si nécessaire, avec les transports de la Console d'administration.
Créé et configuré un type de message avec les types de message de la Console d'administration.
Facultatif : Mappage du type de message à un fichier JSP, en éditant le fichier de configuration struts-config.xml.

Exemple

Un mappage d'exemple est créé entre le transport SMS et le fichier OrderReceivedSMS.jsp d'exemple.

Exécutez les étapes 1 à 14, sur la base du type de message OrderReceived pour le transport SMS.

Créez un nouveau fichier OrderReceivedSMS.jsp avec le contenu d'exemple suivant :


<%@ page import="com.ibm.commerce.command.*" 
%><%@ page import="com.ibm.commerce.common.objects.*" 
%><%@ page import="com.ibm.commerce.server.*"
%>

<%
try
{
	JSPHelper jhelper = new JSPHelper(request);
	String orderId = jhelper.getParameter("orderId");
	CommandContext commandContext = (CommandContext)request.getAttribute(ECConstants.EC_COMMANDCONTEXT);
	StoreAccessBean storeAB = commandContext.getStore();
	StoreEntityDescriptionAccessBean storeEntDescAB = storeAB.getDescription(new Integer(storeAB.getLanguageId()));
	String storeName = storeEntDescAB.getDisplayName();
	out.println("Thank you for shopping at "+ storeName + ". We received your order, number " + orderId + ".");
} 
catch (Exception e)
{
	out.println(e);
}
%>

Ouvrez le fichier de configuration struts-config.xml et insérez le fragment de code suivant :


<forward className="com.ibm.commerce.struts.ECActionForward"
            name="OrderReceivedView/0/-7" path="/OrderReceivedSMS.jsp">
            <set-property property="resourceClassName" value="com.ibm.commerce.messaging.viewcommands.MessagingViewCommandImpl"/>
            <set-property property="properties" value="storeDir=no"/>
            <set-property property="interfaceName" value="com.ibm.commerce.messaging.viewcommands.MessagingViewCommand"/>
            <set-property property="implClassName" value="com.ibm.commerce.messaging.viewcommands.MessagingViewCommandImpl"/>
            <set-property property="direct" value="true"/>
        </forward>

Dans cet exemple, la valeur -7 représente le format d'unité SMS définie dans la table de la base de données DEVICEFMT, et mappe la vue OrderReceived avec le fichier OrderReceivedSMS.jsp.

Enregistrez le fichier de configuration struts-config.xml. Le fichier d'exemple OrderReceivedSMS.jsp est maintenant mappé avec la vue OrderReceived pour le transport SMS.