Neolae Message Ceter Neolae v6.0
Ce documet, aisi que le logiciel qu'il décrit, est fouri das le cadre d'u accord de licece et e peut être utilisé ou copié que das les coditios prévues par cet accord. Cette publicatio e peut être reproduite ou trasmise, itégralemet ou partiellemet, sous quelque forme et par quelque moye que ce soit, sauf autorisatio écrite préalable de Neolae. Ce documet est sujet à révisios. Neolae e garatit pas l'exhaustivité des iformatios coteues das ce documet. Toute référece à des oms de sociétés das les illustratios fouries 'est utilisée qu'à titre d'exemple et e fait référece à aucue société réelle. Toutes les marques citées sot la propriété de leurs déteteurs respectifs. Microsoft et Widows sot des marques ou des marques déposées apparteat à Microsoft Corporatio aux Etats-Uis et/ou das d'autres pays. Java, MySQL et Ope Office sot des marques commerciales ou des marques déposées apparteat à Oracle Corporatio aux Etats-Uis et das d'autres pays. Liux est la marque déposée de Lius Torvalds aux Etats-Uis et das d'autres pays. Ce produit iclut des logiciels développés par Apache Software Foudatio (http://www.apache.org/). Sauf metio cotraire, les déomiatios sociales, les logos, les produits et marques cités das ce documet, sot la propriété de Neolae S.A. ou de ses filiales. Ils e peuvet être utilisés sas l'autorisatio préalable et écrite de Neolae. Numéro de versio : 6884 Neolae 18 rue Roger Simo Barboux, 94110 Arcueil - Frace +33 1 41 98 35 35 www.eolae.com
Table des matières Neolae v6.0 - Neolae Message Ceter Chapitre 1. Présetatio de Neolae Message Ceter........... 5 Itroductio............................ 5 Modèle de doées......................... 5 Architecture............................ 5 Istallatio des istaces...................... 7 Ajout d'u caal de diffusio..................... 7 Descriptio des évéemets..................... 8 Méthodes SOAP......................... 8 Iformatios retourées par l'appel SOAP............... 10 Chapitre 2. Paramétrage des istaces................ 13 Créer ue coexio partagée.................... 13 Istace de pilotage....................... 13 Istace d'exécutio....................... 16 Idetifier les istaces d'exécutio................... 17 Seuils de surveillace des évéemets................. 18 Purge des évéemets....................... 18 Démarrer les workflows techiques.................. 19 Liste des workflows techiques propres à Neolae Message Ceter..... 19 Créatio des types d'évéemet.................... 20 Chapitre 3. Défiitio des modèles de message trasactioels...... 23 Créatio du modèle de message................... 23 Gestio des adresses de cotrôle................... 26 Créer ue adresse de cotrôle................... 26 Créer plusieurs adresses de cotrôle................. 27 Créatio des doées de persoalisatio................ 29 Créatio du coteu du message................... 30 Aperçu du message trasactioel................... 31 Evoi d'u BAT.......................... 33 Chapitre 4. Publicatio des modèles................. 37 Chapitre 5. Traitemet des évéemets................ 39 Méthode de collecte des évéemets.................. 40 Neolae v6.0 - Neolae Message Ceter 3
Neolae Erichissemet de l'évéemet avat achemiemet............... 40 Achemiemet vers u modèle de message.................. 41 Erichissemet de l'évéemet avec des doées de persoalisatio........ 41 Exécutio de la diffusio.......................... 42 Recyclage de l'évéemet......................... 43 Chapitre 6. Suivi............................ 45 Rapports................................ 45 Surveillace des istaces......................... 47 4 Neolae 2013
CHAPITRE 1 Présetatio de Neolae Message Ceter Table des matières Itroductio............................ 5 Modèle de doées.......................... 5 Architecture............................ 5 Istallatio des istaces....................... 7 Ajout d'u caal de diffusio...................... 7 Descriptio des évéemets....................... 8 Méthodes SOAP.......................... 8 Iformatios retourées par l'appel SOAP................. 10 Itroductio Neolae Message Ceter est ue applicatio de gestio de messages trasactioels (factures, cofirmatio de commade, chagemet de mot de passe ou créatio d'u compte sur u site web par exemple). Elle s'itègre à u système d'iformatio qui lui evoie des évéemets destiés à être trasformés e messages trasactioels persoalisés. Ces messages peuvet être evoyés à l'uité ou e lot via le caal email ou mobile. Cette applicatio s'adresse pricipalemet au service iformatique, à l'admiistrateur techique, au support techique d'ue société ou à u itégrateur. Modèle de doées Le modèle de doées de Neolae Message Ceter repose sur deux tables distictes coteat les mêmes champs qui permettet de gérer respectivemet les évéemets de type temps réel et batch : NmsRtEvet et NmsBatchEvet. Reportez-vous au Guide de cofiguratio pour coaître la descriptio du modèle de doées. Architecture Neolae Message Ceter a été coçue pour supporter les motées e charge et assurer u service e cotiu 24h/24h et 7/7 jours. Elle est costituée de plusieurs istaces : ue istace de pilotage das laquelle les modèles de messages sot créés, Neolae v6.0 - Neolae Message Ceter - Présetatio de Neolae Message Ceter 5
Neolae ue ou plusieurs istaces d'exécutio qui assuret la réceptio des évéemets et l'evoi des messages. Les utilisateurs de Neolae Message Ceter se coectet à l'istace de pilotage pour créer les modèles de messages trasactioels, géérer l'aperçu du message grâce à ue adresse de cotrôle, afficher des rapports et surveiller les istaces d'exécutio. Les istaces d'exécutio reçoivet les évéemets, les associet aux modèles de message trasactioel et evoiet les diffusios persoalisées pour chaque destiataire. Selo que le volume de doées destié à être traité est importat ou o, l'architecture de Neolae Message Ceter peut être, au choix, de type : répartie : l'istace de pilotage est istallée sur ue machie et les différetes istaces d'exécutio sur des serveurs disticts. Reportez-vous à la sectio Créer ue coexio partagée [page 13] pour savoir commet faire commuiquer les différetes istaces etre elles via leurs comptes exteres. miimale : l'istace de pilotage et d'exécutio sot istallées sur la même machie. Pour ce type d'istallatio, il 'est pas écessaire de paramétrer les comptes exteres des istaces. 6 Neolae 2013
Présetatio de Neolae Message Ceter Istallatio des istaces Pour istaller l'istace de pilotage sur votre machie, sélectioez le module Pilotage des messages trasactioels puis les caaux de commuicatio que vous souhaitez utiliser. Pour istaller l'istace d'exécutio sur votre machie, sélectioez le module Exécutio des messages trasactioels puis les caaux de commuicatio que vous souhaitez utiliser. Ajout d'u caal de diffusio L'ajout d'u caal de diffusio (Caal mobile, Mobile App Chael, etc.) doit être impérativemet effectué avat l'istallatio du package Message Ceter. Si vous avez démarré u projet Message Ceter sur le caal email, puis que vous décidez, au cours du projet, d'ajouter u ouveau caal, vous devez suivre ces étapes : Neolae v6.0 - Neolae Message Ceter - Présetatio de Neolae Message Ceter 7
Neolae 1 Istallez le caal souhaité, par exemple le Caal mobile, à l'aide de l'assistat d'import de package (Outils > Avacé > Import de package > Package Neolae). 2 Effectuez u import de fichier (Outils > Avacé > Import de package > Fichier), et sélectioez le fichier \datakit\ms\[votre lague]\package\messageceter.xml 3 Das la partie Coteu XML des doées à importer, coservez uiquemet le modèle de diffusio Message Ceter correspodat au caal ajouté. Par exemple, si vous avez ajouté le Caal mobile, coservez uiquemet l'élémet etities correspodat au modèle Message trasactioel mobile (smstriggermessage). Descriptio des évéemets Méthodes SOAP Deux méthodes SOAP PushEvet ou PushEvets sot associées aux deux schémas de doées ms:rtevet et ms:batchevet. PushEvet permet d'isérer u seul évéemet das le message, PushEvets permet d'isérer ue collectio d'évéemets das le message. Le chemi WSDL d'accès aux deux méthodes est : http://hostame/l/jsp/schemawsdl.jsp?schema=ms:rtevet pour accéder au schéma de type temps réel. http://hostame/l/jsp/schemawsdl.jsp?schema=ms:batchevet pour accéder au schéma de type batch. Les deux méthodes cotieet u élémet <ur:sessiotoke> permettat de s'idetifier à Message Ceter. Nous vous coseillos d'utiliser ue méthode d'idetificatio par adresses IP de cofiace. La valeur du champ correspod au logi de l'opérateur das Message Ceter : <ur:sessiotoke>mc</ur:sessiotoke> (la valeur mc est la valeur fourie d'usie par Neolae). La méthode PushEvet est costituée d'u paramètre <ur:domevet> qui cotiet l'évéemet. La méthode PushEvets est costituée d'u paramètre <ur:domevetcollectio> qui cotiet des évéemets. Exemple avec PushEvet : <ur:pushevet> <ur:sessiotoke>mc/</ur:sessiotoke> 8 Neolae 2013
Présetatio de Neolae Message Ceter <ur:domevet> <rtevet>... </rtevet> </ur:domevet> </ur:pushevet> Note : Das le cas d'u appel à la méthode PushEvets, il est écessaire de rajouter u élémet XML paret afi de respecter le formalisme XML stadard. Cet élémet XML va ecadrer les différets élémets <rtevet> coteu das l'évéemet. Exemple avec PushEvets : <ur:pushevets> <ur:sessiotoke>mc/</ur:sessiotoke> <ur:domevetcollectio> <Evets> <rtevet>... </rtevet> <rtevet>... </rtevet>... </Evets> </ur:domevetcollectio> </ur:pushevet> Les élémets <rtevet> et <batchevet> possèdet u jeu d'attributs aisi qu'u élémet fils idispesable : <ctx> permettat d'itégrer les doées du message. Note : L'élémet <batchevet> permet d'alimeter la file d'attete "batch". L'élémet <rtevet> alimete la file d'attete "temps réel". Les attributs obligatoires des élémets <rtevet> et <batchevet> sot @type et @email. La valeur de @type doit être la même que la valeur de l'éumératio défiie lors du paramétrage de l'istace d'exécutio. Cette valeur permet de détermier le modèle qui va être associé au coteu de l'évéemet lors de la diffusio. Exemple de paramétrage <rtevet> : <rtevet type="cofirmatio_commade" email="joh.doe@domai.com" origi="ecommerce" wishedchael="0" exteralid="1242" mobilephoe="+33620202020"> Das cet exemple, deux caaux sot reseigés : l'adresse email et le uméro de téléphoe portable. Le champ wishedchael permet de défiir le caal qui sera utilisé lors de la trasformatio de l'évèemet e message. La valeur "0" correspod au caal email, la valeur "1" au caal mobile, etc. Reportez-vous au Guide de cofiguratio pour coaître la liste des attributs et de leurs valeurs. Si vous souhaitez différer le traitemet d'u évèemet, ajoutez le champ scheduled suivi de la date désirée. L'évèemet sera trasformé e message à cette date. Neolae v6.0 - Neolae Message Ceter - Présetatio de Neolae Message Ceter 9
Neolae Nous vous coseillos de remplir les attributs @wishedchael et @emailformat avec des valeurs umériques. La table de correspodace etre les valeurs umériques et les labels associés se trouve das la descriptio des schémas de doées. Note : La descriptio détaillée de tous les attributs autorisés et de leurs valeurs se trouve das la descriptio du schéma de doées de ms:rtevet et ms:batchevet. Reportez-vous au chapitre "Modèle de doées" du Guide de cofiguratio. L'élémet <ctx> cotiet les doées du message. So coteu XML est ouvert et il est doc paramétrable e foctio du coteu à diffuser. Note : Il est importat d'optimiser le ombre et la taille des oeuds XML coteus das le message afi de e pas surcharger les serveurs lors de la diffusio. Exemple de doées : <ctx> </ctx> <cliet> <preom>joh</preom> <om>doe</om> </cliet> <actio> <type>cofirmatio de commade</type> <umero>cn23453</umero> </actio> <detailscommade> <article um="1"> <om>clef USB géérique</om> <prix>20</prix> </article> </detailscommade> Iformatios retourées par l'appel SOAP Lors de la réceptio d'u évéemet, Neolae géère u idetifiat uique de retour. Il correspod à l'idetifiat de la versio historisée de l'évéemet. Exemple d'idetifiat revoyé par la méthode lorsque le traitemet d'u évéemet a réussi : <SOAP-ENV:Evelope xmls:xsd="http://www.w3.org/2001/xmlschema" xmls:xsi="http://www.w3.org/2001/xmlschema-istace" xmls:s="http://xml.apache.org/xml-soap" xmls:soap-env="http://schemas.xmlsoap.org/soap/evelope/"> <SOAP-ENV:Body> <ur:pushevetrespose SOAP-ENV:ecodigStyle="http://schemas.xmlsoap.org/soap/ecodig/" xmls:ur="ur:ms:rtevet"> <plid xsi:type="xsd:log">72057594037935966</plid> </ur:pushevetrespose> </SOAP-ENV:Body> </SOAP-ENV:Evelope> Lorsque la valeur de l'idetifiat de retour est strictemet supérieure à zéro, cela sigifie que l'évéemet est bie historisé das Neolae. E revache, si le traitemet de l'évéemet échoue, la méthode revoie u message d'erreur ou ue valeur égale à zéro. Exemple de traitemet d'u évéemet qui a échoué lorsque la requête e cotiet pas de logi ou que l'opérateur spécifié 'a pas les droits adéquats : 10 Neolae 2013
Présetatio de Neolae Message Ceter <SOAP-ENV:Evelope xmls:xsd="http://www.w3.org/2001/xmlschema" xmls:xsi="http://www.w3.org/2001/xmlschema-istace" xmls:soap-env="http://schemas.xmlsoap.org/soap/evelope/"> <SOAP-ENV:Body> <SOAP-ENV:Fault> <faultcode>soap-env:cliet</faultcode> <faultstrig xsi:type="xsd:strig">problème lors de la lecture des paramètres de la méthode 'PushEvet' du service 'ms:rtevet'</faultstrig> <detail xsi:type="xsd:strig">logi ou mot de passe ivalide. Coexio refusée.</detail> </SOAP-ENV:Fault> </SOAP-ENV:Body> </SOAP-ENV:Evelope> Exemple de traitemet d'u évéemet qui a échoué du fait d'ue erreur das la requête (la omeclature XML 'est pas respectée) : <SOAP-ENV:Evelope xmls:xsd="http://www.w3.org/2001/xmlschema" xmls:xsi="http://www.w3.org/2001/xmlschema-istace" xmls:soap-env="http://schemas.xmlsoap.org/soap/evelope/"> <SOAP-ENV:Body> <SOAP-ENV:Fault> <faultcode>soap-env:cliet</faultcode> <faultstrig xsi:type="xsd:strig">the XML SOAP message is ivalid (service 'PushEvet', method 'ms:rtevet').</faultstrig> <detail xsi:type="xsd:strig"><![cdata[(16:8) : Expected ed of tag 'rtevet' Error while parsig XML strig '<soapev:evelope xmls:soapev="http://schemas.xmlsoap.org/soap/evelope/" xmls:ur="ur:ms:rtevet"> <soapev:header/> <soapev:body> <ur:pushevet> <ur:sessiotoke>mc</ur:sessiotoke> <ur:domevet> <rtevet type="create_accout" email="mario.delalade@eolae.com" origi="ecommerce" wishedchael="email" exteralid="0042" laguage="fraçais" coutry="fr" emailformat="2" mobilephoe="+33620202020"> <ctx> <website ame="ecommerce" url="http://www.eco']]></detail> </SOAP-ENV:Fault> </SOAP-ENV:Body> </SOAP-ENV:Evelope> Exemple de traitemet d'u évéemet qui a échoué et du revoi d'u idetifiat à zéro (le om de la méthode est erroé) : <SOAP-ENV:Evelope xmls:xsd="http://www.w3.org/2001/xmlschema" xmls:xsi="http://www.w3.org/2001/xmlschema-istace" xmls:s="http://xml.apache.org/xml-soap" xmls:soap-env="http://schemas.xmlsoap.org/soap/evelope/"> <SOAP-ENV:Body> <ur:pushevetrespose SOAP-ENV:ecodigStyle="http://schemas.xmlsoap.org/soap/ecodig/" xmls:ur="ur:ms:rtevet"> <plid xsi:type="xsd:log">0</plid> </ur:pushevetrespose> </SOAP-ENV:Body> </SOAP-ENV:Evelope> Neolae v6.0 - Neolae Message Ceter - Présetatio de Neolae Message Ceter 11
Neolae 12 Neolae v6.0 - Neolae Message Ceter
CHAPITRE 2 Paramétrage des istaces Table des matières Créer ue coexio partagée...................... 13 Istace de pilotage........................ 13 Istace d'exécutio........................ 16 Idetifier les istaces d'exécutio.................... 17 Seuils de surveillace des évéemets................... 18 Purge des évéemets........................ 18 Démarrer les workflows techiques.................... 19 Liste des workflows techiques propres à Neolae Message Ceter........ 19 Créatio des types d'évéemet..................... 20 Créer ue coexio partagée Istace de pilotage Das le cas d'ue architecture répartie, vous devez idiquer das l'istace de pilotage les istaces d'exécutio qui lui sot reliées et établir ue coexio etre elles. Ce sot vers les istaces d'exécutio que sot déployés les modèles de message trasactioel. La coexio etre l'istace de pilotage et les istaces d'exécutio se réalise e cofigurat des comptes exteres de type Istace Message Ceter. Vous devez créer autat de compte extere que d'istace d'exécutio. Procédez comme suit pour créer u compte extere de type Message Ceter : 1 Positioez-vous au iveau du dossier Comptes exteres. Neolae v6.0 - Neolae Message Ceter - Paramétrage des istaces 13
Neolae 2 Sélectioez u des comptes exteres fouri d'usie par Neolae avec le bouto droit de la souris et choisissez Dupliquer das le meu cotextuel. 3 Modifiez le libellé selo vos besois. 4 Sélectioez l'optio Activé afi que le compte extere soit opératioel. 5 Idiquez l'adresse du serveur sur lequel est istallée l'istace d'exécutio. 14 Neolae 2013
Paramétrage des istaces 6 Le compte doit correspodre à l'aget Message Ceter tel qu'il est défii das le dossier des opérateurs. Par défaut, le compte fouri d'usie par Neolae est mc. 7 Etrez le mot de passe du compte tel qu'il a été défii das le dossier des opérateurs. Note : Pour e pas avoir à doer u mot de passe lors de la coexio à l'istace, vous pouvez spécifier l'adresse IP de l'istace de pilotage das l'istace d'exécutio. Reportez-vous à la sectio Istace d'exécutio [page 16] pour plus d'iformatios. 8 Idiquez la méthode de rapatriemet qui doit être utilisée par l'istace d'exécutio. Les doées à récupérer sot trasmises par l'istace d'exécutio à l'istace de pilotage, afi d'erichir les historiques des messages trasactioels et des évéemets. La collecte des doées s'effectue soit par u service Web qui utilise u accès e HTTP/HTTPS, soit via le module Federated Data Access (FDA). La deuxième méthode est recommadée si l'istace de pilotage peut avoir u accès direct aux bases de doées des istaces d'exécutio. Das le cas cotraire, choisissez l'accès par service Web. Le compte Neolae v6.0 - Neolae Message Ceter - Paramétrage des istaces 15
Neolae FDA à spécifier correspod à la coexio vers la base des différetes istaces d'exécutio créée sur l'istace de pilotage. Reportez-vous à la sectio Accès à ue base de doées extere pour plus d'iformatios sur le Federated Data Access (FDA). 9 Cliquez sur Tester la coexio pour vérifier que la coexio etre l'istace de pilotage et l'istace d'exécutio est effective. Istace d'exécutio Pour que l'istace de pilotage puisse se coecter à l'istace d'exécutio sas avoir à spécifier de mot de passe, il vous suffit de préciser l'adresse IP de l'istace de pilotage au iveau des droits d'accès de l'aget Message Ceter. 1 Positioez-vous au iveau du dossier des opérateurs das l'arborescece de l'istace d'exécutio (Admiistratio>Gestio des accès>opérateurs). 16 Neolae 2013
Paramétrage des istaces 2 Sélectioez l'aget Message Ceter. 3 Cliquez sur l'oglet Droits d'accès, ajoutez l'adresse IP de l'istace de pilotage. Idetifier les istaces d'exécutio Vous devez attribuer u idetifiat uique à chaque istace afi de distiguer les historiques de chaque istace d'exécutio lorsque vous les cosulterez das l'istace de pilotage. Cette étape est obligatoire y compris si votre istace de pilotage et votre istace d'exécutio sot istallées sur la même machie. Neolae v6.0 - Neolae Message Ceter - Paramétrage des istaces 17
Neolae Pour cela, lacez l'assistat de déploiemet sur chacue de vos istaces d'exécutio et das la feêtre Message Ceter, attribuez l'idetifiat de votre choix à l'istace. Seuils de surveillace des évéemets Vous pouvez paramétrer des seuils d'alerte e foctio du ombre d'évéemets temps réels présets das la file d'attete et dot le statut est E attete. Pour cela, lacez l'assistat de déploiemet de l'istace d'exécutio et depuis la page Message Ceter modifiez le seuil à l'aide des flèches ascedates et descedates. Les alertes apparaisset das la page Exploitatio de l'istace au iveau des idicateurs système. Purge des évéemets Vous pouvez paramétrer la durée pedat laquelle vous souhaitez coserver les évéemets e base depuis l'assistat de déploiemet. 18 Neolae 2013
Paramétrage des istaces La purge des évéemets est effectuée automatiquemet par le workflow Nettoyage de la base. Il s'agit des évéemets reçus et stockés sur les istaces d'exécutio et des évéemets historisés sur ue istace de pilotage. Pour modifier les paramètres de purge, utilisez la flèche ascedate et descedate. Figure 2.1. Paramètres de purge des évéemets sur ue istace de pilotage Figure 2.2. Paramètres de purge des évéemets sur ue istace d'exécutio Reportez-vous à la sectio Descriptio du workflow Nettoyage de la base pour plus d'iformatios. Démarrer les workflows techiques Vous devez vous assurer que les workflows techiques de l'istace de pilotage et des différetes istaces d'exécutio sot bie lacés avat de procéder au déploiemet des modèles de messages trasactioels. Les workflows techiques propres à Neolae Message Ceter sot accessibles depuis le dossier Admiistratio > Exploitatio > Message Ceter sur toutes les istaces. Liste des workflows techiques propres à Neolae Message Ceter Les différets workflows techiques de Neolae Message Ceter sot répartis etre l'istace de pilotage et la ou les istaces d'exécutio. Les workflows 0 à 5 de l'istace de pilotage se déclechet les us à la suite des autres et procèdet das u premier temps au traitemet des évéemets temps réels. Lorsque le workflow N 5 a termié sa tâche, il relace le workflow N 1 : u secod cycle est alors ecleché afi de traiter les évéemets batch. Ue fois les évéemets batch traités, le workflow N 5 relace le workflow N 0 afi de recommecer le cycle de traitemet des évéemets temps réel pour l'istace d'exécutio suivate. Workflows de l'istace de pilotage Neolae v6.0 - Neolae Message Ceter - Paramétrage des istaces 19
Neolae 0 - Lacemet de la sychroisatio (om itere : sychlauch) : ce workflow décleche le workflow N 1 et, toutes les trois heures, le workflow d'import des quarataies. 1 - Import des évéemets (om itere : evetsych) : ce workflow récupère la liste des évéemets traités par la ou les istaces d'exécutio. Ue fois sa tâche termiée, il décleche le workflow N 2. 2 - Import des qualificatios des messages de diffusio (om itere : broadlogmsgsych) : ce workflow effectue ue sychroisatio avec la table NmsBroadLogMsg afi de récupérer les qualificatios des messages de diffusio. Ue fois sa tâche termiée, il décleche le workflow N 3. 3 - Import des logs de diffusio des évéemets (om itere : broadlogsych) : ce workflow récupère les logs de diffusio des évéemets dès lors que la sychroisatio avec la table NmsBroadLogMsg a été effectuée via le workflow N 2. Ue fois sa tâche termiée, il décleche le workflow N 4. 4 - Import des URL trackées (om itere : trackigurlsych) : ce workflow effectue ue sychroisatio avec la table NmsTrackigUrl afi de récupérer le trackig des URL des diffusios. Ue fois sa tâche termiée, il décleche le workflow N 5. 5 - Import des logs de trackig des évéemets (om itere : trackiglogsych) : ce workflow récupère le trackig des URL des évéemets dès lors que la sychroisatio avec la table NmsTrackigUrl a été effectuée via le workflow N 4. Lorsque tous les évéemets temps réel ot été traités, il décleche le workflow N 1 afi que les évéemet batch soit traités à leur tour. Lorsque tous les évéemets ot été traités, il décleche le workflow N 0 afi de recommecer u cycle complet de traitemet des évéemets pour l'istace d'exécutio suivate. Import des quarataies (om itere : quaratiesych) : ce workflow permet de récupérer toutes les trois heures les adresses email placées e quarataie après l'evoi de la diffusio. Workflows de l'istace d'exécutio Traitemet des évéemets batch (om itere : batchevetsprocessig) : ce workflow permet de répartir les évéemets batch das ue file d'attete avat qu'ils e soiet associés à u modèle de message. Traitemet des évéemets temps réel (om itere : rtevetsprocessig) : ce workflow permet de répartir les évéemets temps réel das ue file d'attete avat qu'ils e soiet associés à u modèle de message. Mise à jour du statut des évéemets (om itere : updateevetsstatus) : ce workflow permet d'attribuer u statut à l'évéemet. Les statuts d'u évéemet sot les suivats : E attete : l'évéemet se trouve das la file d'attete. Aucu modèle de message e lui a ecore été associé. E attete de diffusio : l'évéemet est das la file d'attete, u modèle de message lui a été associé et il est e cours de traitemet par la diffusio. Evoyé : ce statut est copié depuis les logs de diffusio. Il sigifie que la diffusio a été evoyée. Igoré par la diffusio : ce statut est copié depuis les logs de diffusio. Il sigifie que la diffusio a été igorée. Erreur de diffusio : ce statut est copié depuis les logs de diffusio. Il sigifie que la diffusio a échoué. Evéemet o pris e charge : l'associatio de l'évéemet à u modèle de message a échoué. L'évéemet e sera pas retraité. Créatio des types d'évéemet Les types d'évéemets destiés à être traités par Neolae Message Ceter doivet être créés das l'istace de pilotage. Vous pouvez le faire depuis le dossier Admiistratio>Plate-forme>Eumératios de l'arborescece. A chaque type d'évéemet doit correspodre ue valeur das l'éumératio evettype. 20 Neolae 2013
Paramétrage des istaces Il peut s'agir par exemple d'ue cofirmatio de commade, de chagemet de mot de passe ou d'evoi de commade. Reportez-vous à la sectio Gestio des éumératios pour plus d'iformatios. Ue fois les valeurs de l'éumératio créées, vous devez vous décoecter puis vous recoecter à votre istace afi que la créatio soit effective. Neolae v6.0 - Neolae Message Ceter - Paramétrage des istaces 21
Neolae 22 Neolae v6.0 - Neolae Message Ceter
CHAPITRE 3 Défiitio des modèles de message trasactioels Table des matières Créatio du modèle de message..................... 23 Gestio des adresses de cotrôle..................... 26 Créer ue adresse de cotrôle..................... 26 Créer plusieurs adresses de cotrôle.................. 27 Créatio des doées de persoalisatio.................. 29 Créatio du coteu du message..................... 30 Aperçu du message trasactioel.................... 31 Evoi d'u BAT........................... 33 Pour que chaque évéemet puisse être trasformé e message persoalisé, il faut créer u modèle de message correspodat à chaque type d'évéemet. Le modèle cotiet les iformatios qui permettrot de persoaliser le message trasactioel. D'autre part, vous pouvez depuis le modèle tester l'aperçu du message et evoyer des BAT à l'aide d'adresses de cotrôles avat que les messages e soiet diffusés à la cible défiitive. Vous pouvez égalemet, toujours à l'aide d'adresses de cotrôle, afficher le redu du message chez les différets fourisseurs d'accès (ibox rederig) si vous istallez le module Délivrabilité (voir à ce sujet la ote techique Assurer la délivrabilité d'ue plate-forme d'emailig). Créatio du modèle de message 1 Positioez-vous au iveau du dossier Message Ceter>Modèles de messages trasactioels das l'arborescece Neolae. Neolae v6.0 - Neolae Message Ceter - Défiitio des modèles de message trasactioels 23
Neolae 2 Das la liste des modèles de messages trasactioels, cliquez avec le bouto droit de la souris et sélectioez Nouveau das le meu cotextuel ou cliquez sur le bouto Nouveau situé au-dessus de la liste des modèles de messages trasactioels. 3 Das la feêtre de diffusio, sélectioez le modèle de diffusio propre au caal que vous souhaitez utiliser. 4 Modifiez le libellé si écessaire. 24 Neolae 2013
Défiitio des modèles de message trasactioels 5 Sélectioez le type d'évéemet correspodat au message que vous souhaitez evoyer. Les types d'évéemets doivet avoir été préalablemet créés das la cosole. Reportez-vous à la sectio Créatio des types d'évéemet [page 20] pour plus d'iformatios. 6 Complétez la ature et la descriptio selo vos besois, puis cliquez sur Cotiuer pour créer le corps du message. Neolae v6.0 - Neolae Message Ceter - Défiitio des modèles de message trasactioels 25
Neolae Gestio des adresses de cotrôle Ue adresse de cotrôle est utilisée pour afficher l'aperçu de votre message, evoyer u BAT et tester la persoalisatio de votre message avat qu'il e soit evoyé par email ou SMS. Les adresses de cotrôle sot liées à la diffusio et e peuvet être utilisées d'ue diffusio à l'autre. Créer ue adresse de cotrôle 1 Das le modèle de message trasactioel, cliquez sur l'oglet Adresses de cotrôle. 2 Attribuez-lui u libellé afi de pouvoir sélectioer l'adresse ultérieuremet si écessaire. 3 Etrez l'adresse de cotrôle, soit l'email ou le uméro de portable selo le caal de commuicatio de la diffusio. 26 Neolae 2013
Défiitio des modèles de message trasactioels 4 Isérez des doées de test (voir Créatio des doées de persoalisatio [page 29]). Créer plusieurs adresses de cotrôle 1 Cliquez sur le lie Ajouter d'autres adresses de cotrôle, puis sur le bouto Ajouter. 2 Attribuez u libellé différet de celui des autres adresses déjà créées. Neolae v6.0 - Neolae Message Ceter - Défiitio des modèles de message trasactioels 27
Neolae 3 Précisez l'email ou le uméro de portable selo le caal de commuicatio de la diffusio. 4 Isérez des doées de test (voir Créatio des doées de persoalisatio [page 29]). 5 Répétez l'opératio pour créer le ombre d'adresses voulu. Lorsque les adresses sot créées, vous pouvez dès lors afficher l'aperçu de votre message et sa persoalisatio. Reportez-vous à la sectio Aperçu du message trasactioel [page 31]. 28 Neolae 2013
Défiitio des modèles de message trasactioels Créatio des doées de persoalisatio Vous pouvez utiliser des doées das le modèle de message afi de tester la persoalisatio de vos messages trasactioels. Cette foctioalité est utilisée pour géérer u aperçu ou evoyer u BAT. Si vous istallez le module Délivrabilité, ces doées vous permettet d'afficher le redu des messages chez différets fourisseurs d'accès (Ibox rederig, voir à ce sujet la ote techique Assurer la délivrabilité d'ue plate-forme d'emailig). Ces doées 'ot pour but que de tester vos messages avat leur evoi effectif et e correspodet pas aux doées réelles qui serot traitées par Neolae Message Ceter. E revache, la structure XML doit être idetique à celle de l'évéemet qui est stocké das l'istace d'exécutio, comme illustré ci-dessous. Ces iformatios permettet de persoaliser le coteu du message à l'aide de balises de persoalisatio (voir à ce sujet la sectio Créatio du coteu du message [page 30]. 1 Das le modèle de message, cliquez sur l'oglet Adresses de cotrôle. Neolae v6.0 - Neolae Message Ceter - Défiitio des modèles de message trasactioels 29