[S’applique également à la v8.]{class="badge positive" title="S’applique également à Campaign v8."}
Cas dʼutilisation : création dʼune gestion de contenu use-case-creating-content-management
Pour créer une gestion de contenu dans Adobe Campaign, suivez la procédure ci-dessous :
Étape 1 : analyse du contenu à produire step-1---analyzing-the-content-to-be-produced
Avant de démarrer, vous devez procéder à une analyse précise du contenu à produire : identifier les éléments à afficher, étudier les contraintes qui y sont liées, définir les types de chaque élément, etc. Vous devez différencier les éléments statiques et les éléments variables du contenu.
Par exemple, nous allons créer une newsletter en HTML dont le contenu est du type :
Cette newsletter contient trois types d'éléments :
-
Des éléments variables, dont le contenu est saisi ou sélectionné par l'utilisateur lors de la création de la diffusion, au travers d'un formulaire de saisie.
-
Des champs de personnalisation qui sont renseignés dynamiquement à partir des informations stockées dans la base de données (ici, le prénom et le nom du destinataire).
-
Les éléments statiques, qui ne changent pas d'une newsletter à l'autre.
Les différents éléments de cette newsletter sont assemblés selon les règles définies dans un template Javascript qui référence tous les éléments à insérer et modélise leur disposition.
Ces éléments sont créés via un schéma dédié qui précise pour chaque contenu : son nom, son libellé, son type, sa taille et toute autre information utile à son exploitation dans Adobe Campaign.
Étape 2 : création du schéma de données step-2---creating-the-data-schema
Un schéma de données est un document XML associé à un contenu, il décrit la structure XML des données de ce contenu.
Pour créer un schéma de données, les étapes sont les suivantes :
-
Ouvrez l'Explorateur Adobe Campaign et sélectionnez le noeud Administration > Paramétrages > Schémas de données.
Cliquez sur l'icône Nouveau située au-dessus de la liste des schémas de données.
-
Sélectionnez l'option Créer un schéma pour la gestion de contenu puis cliquez sur Suivant.
-
Saisissez le nom et le libellé du schéma dans les champs correspondants. Vous pouvez ajouter une description et associer une image spécifique, au besoin.
Cliquez sur Suivant pour valider.
-
Saisissez le contenu du schéma dans la fenêtre Edition du schéma.
Utilisez le bouton Insérer pour créer le contenu du schéma.
Voir à ce sujet la section Edition des schémas.
Pour chaque élément référencé dans le contenu, vous devez sélectionner le type correspondant.
Dans notre exemple, les contenus identifiés, leur format et leur type sont les suivants :
Le schéma contiendra donc les informations suivantes :
<element label="Invitation" name="invitation" template="ncm:content" xmlChildren="true">
<compute-string expr="@name"/>
<attribute label="Title" length="40" name="title" type="string"/>
<element label="Presentation" name="presentation" type="html"/>
<attribute label="Date" name="date" type="date"/>
<attribute label="Name" length="10" name="name" type="string"/>
<attribute label="URL" name="url" type="string"/>
<element label="Author" name="author" type="memo"/>
<element label="Image" name="image" target="xtk:fileRes" type="link"/>
</element>
- Cliquez sur Enregistrer pour créer le schéma de données.
Étape 3 : création du formulaire de saisie step-3---creating-the-input-form
Le formulaire de saisie permet d'éditer une instance de contenu via une interface de saisie à partir de la console cliente Adobe Campaign.
La description d'un formulaire est un document XML structuré respectant la grammaire du schéma des formes "xtk:form".
Pour créer un formulaire de saisie pour la gestion de contenu, les étapes sont les suivantes :
-
Ouvrez l'Explorateur Adobe Campaign et sélectionnez le noeud Administration > Paramétrages > Formulaires de saisie.
Cliquez sur l'icône Nouveau située au-dessus de la liste des formulaires.
-
Saisissez le nom du formulaire et le libellé associé au formulaire, puis sélectionnez le type Gestion de contenu.
note note NOTE Afin de permettre l'association automatique entre les deux éléments, il est recommandé d'utiliser le même nom que celui du schéma de données correspondant. Vous pourrez ainsi utiliser le bouton Insérer situé au-dessus de la zone de saisie pour ajouter les champs issus du schéma associé au formulaire. -
Dans la section centrale de l'éditeur, indiquez les champs que vous souhaitez afficher dans le formulaire de saisie.
Dans notre exemple, les informations seront du type :
code language-none <input xpath="@title"/> <input xpath="@date"/> <input xpath="presentation"/> <input xpath="@name"/> <input xpath="@url"/> <input xpath="author"/> <input img="nl:sryimage.png" newEntityFormChoice="true" xpath="image"> <sysFilter> <condition expr="@isImage = true"/> </sysFilter> </input>
L'onglet Aperçu permet de contrôler le rendu du formulaire en cours de réalisation :
-
Cliquez sur Enregistrer pour créer le formulaire de saisie.
Étape 4 : création du modèle de construction step-4---creating-the-construction-template
Le langage XSLT permet de transformer un document XML en un autre document de sortie. Cette transformation est elle-même décrite en XML dans un document appelé feuille de style.
Dans notre exemple, nous allons utiliser un template Javascript pour définir le mode de construction et de disposition des données dans le document généré.
Pour utiliser un template Javascript dans Adobe Campaign, les étapes sont les suivantes :
-
Ouvrez l'Explorateur Adobe Campaign et sélectionnez le noeud Administration > Paramétrages > Templates JavaScript.
Cliquez sur l'icône Nouveau située au-dessus de la liste des templates.
-
Indiquez le nom du template et sélectionnez le schéma que vous avez créé pour la gestion de contenu.
-
Importez le contenu fixe que vous souhaitez afficher dans le message.
Ajoutez les éléments variables en respectant la syntaxe présentée dans la section Templates JavaScript.
Pour afficher le contenu proposé dans notre exemple, le template JavaScript contient les éléments suivants :
code language-none <html> <% eval(xtk.javascript.load("xac:perso").data); %> <head> <title>Invitation to an exceptional dedication session</title> </head> <body link="#0E59AE" vlink="#0E59AE" alink="#0E59AE" style="background-color:white;"> <table width="546" border="0" align="center" cellpadding="0" cellspacing="0" style="border-left: solid 1px gray;border-top: solid 1px gray;border-right: solid 1px gray;"> <tr> <td colspan="3"> <%= generateImgTag(content.@["image-id"]) %> </td> </tr> </table> <table width="546" border="0" align="center" cellpadding="0" cellspacing="0" style="border-left: solid 1px gray;border-right: solid 1px gray;"> <tr> <td> <table border="0" cellspacing="0" cellpadding="5"> <tr> <td width="10"> </td> <td style="padding-top:2em; padding-bottom:2em;" width="730" align="middle"> <b> <font style="font-family:Verdana, Arial, Helvetica, sans-serif; font-size:14px; color:#800080;"> <span style="FONT-VARIANT: small-caps"><%= content.@title %> - <%= content.@name %></span> </font> </b> </td> <td width="10"> </td> </tr> <tr> <td width="10"> </td> <td style="padding-top:1em; padding-bottom:1em;" width="730"> <font style="font-family:Verdana, Arial, Helvetica, sans-serif; font-size:11px; color:#666666;"> Hello <%= perso('recipient.firstName') %> <%= perso('recipient.lastName') %>, <p> <%= content.presentation %> </p> <center> <b><%= formatDate(content.@date, "%2D %Bl %4Y") %></b> come to our Book Fair and meet our favorite authors and illustrators.<br> <br> <a href="https://www.site.web.com/registration" target="_blank"><b>REGISTER</b></a> </center> </font> </td> <td width="10"> </td> </tr> <tr> <td width="10"> </td> <td style="padding-top:1em; padding-bottom:1em;" width="730"> <font style="font-family:Verdana, Arial, Helvetica, sans-serif; font-size:11px; color:#666666;"> <img style="float:left;margin-right:10px" border="0" src="<%= content.@url %>" width="70" height="70"> <b><%= content.author %></b>, will be signing their book between 2 and 5:30PM. </font> </td> <td width="10"> </td> </tr> <tr> <td width="10"> </td> <td width="730"> <font style="font-family:Verdana, Arial, Helvetica, sans-serif; font-size:11px; color:#666666;"> </td> <td width="10"> </td> </tr> <tr> <td width="10"> </td> <td> <font style="font-family:Verdana, Arial, Helvetica, sans-serif; font-size:11px; color:#666666;"> <center> <p> <a href="https://www.site.web.com/program" target="_blank"><span style="FONT-VARIANT: small-caps"><b>Program</b></span></a> | <a href="https://www.site.web.com/information" target="_blank"><span style="FONT-VARIANT: small-caps"><b>Useful information</b></span></a> | <a href="https://www.site.web.com/registration" target="_blank"><span style="FONT-VARIANT: small-caps"><b>Register</b></span></a></p> </center> </font> </td> <td width="10"> </td> </tr> </table> <br> </td> </tr> </table> </body> </html>
L'appel à une fonction en début de template permet de mettre en forme l'appel à des données de personnalisation issues de la base de données Adobe Campaign (ici : recipient.firstName et recipient.lastName), afin qu'elles soient interprétées lors de leur utilisation dans une diffusion. Pour plus dʼinformations, consultez la section Inclusion d’un template JavaScript.
Dans notre exemple, la fonction contiendra le code suivant :
code language-none function perso(strPerso) { var strStart = '<' + '%' + '='; var strEnd = '%' + '>'; return strStart + strPerso + strEnd; } function bloc(strPerso) { var strStart = '<' + '%' + '@ include view="'; var strEnd = '" %' + '>'; return strStart + strPerso + strEnd; }
Afin que le template javascript soit valide, cette fonction doit être préalablement créée depuis le noeud Code Javascript de l'arborescence, comme ci-dessous :
Étape 5 : création du modèle de publication step-5---creating-the-publication-template
Vous devez ensuite créer un modèle de publication de contenu qui permettra de faire le lien entre le schéma, le formulaire et le modèle de construction du contenu. Ce modèle de publication peut proposer plusieurs formats de sortie.
Pour notre exemple, les étapes sont les suivantes :
-
Créez un nouveau modèle de publication à partir du noeud Administration > Paramétrages > Modèles de publication.
-
Indiquez son nom, le libellé associé et sélectionnez le schéma et le formulaire à utiliser.
-
Saisissez ensuite le nom du modèle et choisissez le mode de rendu à appliquer. Ici, il s'agit d'un rendu de type JavaScript, basé sur le modèle créé à l'étape précédente.
note note NOTE L'option interface DOM est cochée par défaut, ce qui signifie qu'il ne sera pas possible d'accéder à ce document au moyen de la syntaxe E4X. L'interface DOM doit être utilisée lorsque cette option est cochée et lorsqu'elle est la syntaxe recommandée. Vous pouvez continuer à utiliser la syntaxe E4X. Le cas échéant, vérifiez que l'option est décochée. Utilisez le bouton Ajouter si vous souhaitez créer d'autres modèles de transformation.
-
Cliquez sur Enregistrer pour créer le modèle de publication.
Étape 6 : création du contenu step-6---creating-contents
Vous êtes fin prêt pour créer du contenu à partir de ce modèle de publication.
Créer du contenu dans lʼassistant de diffusion creating-content-in-the-delivery-assistant
Pour créer un contenu directement dans les diffusions, la procédure est la suivante :
-
Vous devez d'abord référencer le modèle de publication à partir de l'onglet Avancé des propriétés de la diffusion.
Un onglet supplémentaire est ajouté dans l’assistant de diffusion afin de définir le contenu, via le formulaire de la gestion de contenu.
-
Renseignez les informations variables de votre newsletter.
-
Cliquez sur l'onglet Aperçu HTML pour visualiser le rendu. Vous devez sélectionner un destinataire pour tester la personnalisation.