Utiliser le format XML

Si vous ne souhaitez pas traiter vos données produit au format CSV, vous pouvez également utiliser le format XML pour le paragraphe d’interface de contenu. XML est un format international ouvert, qui permet de transmettre des données structurées sur Internet.

Si vous optez pour cette variante, n'enregistrez pas vos données produit sur le serveur Episerver comme vous le feriez dans le cas de la solution CSV. Au contraire, l'Episerver Campaign récupère vos données produit sur votre espace Web ou sur votre serveur via ce que l'on appelle une requête HTTP. Au moment de cette requête, vos données produit doivent être :

  1. déjà disponibles sur votre espace Web ou serveur sous forme de fichier XML (données produit statiques)
  2. ou générées depuis votre serveur par la requête HTTP au format XML et renvoyées en réponse (données produit dynamiques).

Conseil:  Le choix de variante que vous opérerez (données produit statiques ou dynamiques) dépendra de l'environnement du système dans votre entreprise. Veuillez vous adresser à votre administrateur système pour prendre les mesures techniques appropriées.

1. Stocker des données produit statiques sur le serveur

Si vous souhaitez stocker statiquement vos données produit sous forme de fichiers XML sur votre espace Web ou serveur, vous devez placer chaque produit dans un fichier XML séparé. Il est impossible de rassembler plusieurs produits dans un seul fichier XML (au contraire de la solution CSV).

Pour traiter un produit sous forme de fichier XML, procédez comme suit :

  1. Ouvrez un éditeur de texte tel que Bloc-notes (sous Windows) ou TextEdit (sous macOS/OS X).

    Conseil:  Pour créer une offre de produits pour le paragraphe d'interface de contenu, vous n'avez pas besoin de logiciel spécial. Un simple éditeur de texte suffit.

  2. Créez un nouveau document dans l'éditeur de texte.

    Attention:  Assurez-vous que votre document texte possède le codage de caractères correct UTF-8. Si votre document texte n'est pas automatiquement réglé sur UTF-8, changez votre codage de caractères de manière adéquate. Lorsque vous créez le document texte avec un autre codage de caractères, cela peut entraîner un affichage incorrect du texte.

  3. Copiez le code suivant dans votre document :

    <?xml version="1.0" encoding="UTF-8"?>
<element>
<property name="id">123456</property>
<property name="text1"><![CDATA[<b>Text field 1</b>]]></property>
<property name="text2"><![CDATA[Text field 2]]></property>
<property name="text3"><![CDATA[Text field 3]]></property>
<property name="text4"><![CDATA[Text field 4]]></property>
<property name="text5"><![CDATA[Text field 5]]></property>
<property name="text6"><![CDATA[Text field 6]]></property>
<property name="text7"><![CDATA[Text field 7]]></property>
<property name="text8"><![CDATA[Text field 8]]></property>
<property name="text9"><![CDATA[Text field 9]]></property>
<property name="text10"><![CDATA[Text field 10]]></property>
<property name="link1Text"><![CDATA[Text for link 1]]></property>
<property name="link1Url"><![CDATA[URL for link 1]]></property>
<property name="link2Text"><![CDATA[Text for link 2]]></property>
<property name="link2Url"><![CDATA[URL for link 2]]></property>
<property name="link3Text"><![CDATA[Text for link 3]]></property>
<property name="link3Url"><![CDATA[URL for link 3]]></property>
<property name="image1ImageUrl"><![CDATA[Image URL for image 1]]></property>
<property name="image1AltText"><![CDATA[Alternative text for image 1]]></property>
<property name="image1Link"><![CDATA[Link for image 1]]></property>
<property name="image2ImageUrl"><![CDATA[Image URL for image 2]]></property>
<property name="image2AltText"><![CDATA[Alternative text for image 2]]></property>
<property name="image2Link"><![CDATA[Link for image 2]]></property>
<property name="image3ImageUrl"><![CDATA[Image URL for image 3]]></property>
<property name="image3AltText"><![CDATA[Alternative text for Image 3]]></property>
<property name="image3Link"><![CDATA[Link for image 3]]></property>
<property name="image4ImageUrl"><![CDATA[Image URL for image 4]]></property>
<property name="image4AltText"><![CDATA[Alternative text for image 4]]></property>
<property name="image4Link"><![CDATA[Link for image 4]]></property>
<property name="image5ImageUrl"><![CDATA[Image URL for image 5]]></property>
<property name="image5AltText"><![CDATA[Alternative text for image 5]]></property>
<property name="image5Link"><![CDATA[Link for image 5]]></property>
<property name="image6ImageUrl"><![CDATA[Image URL for image 6]]></property>
<property name="image6AltText"><![CDATA[Alternative text for image 6]]></property>
<property name="image6Link"><![CDATA[Link for image 6]]></property>
</element>

    Remarque:  Les étapes suivantes vous guident à l'aide d'exemples à travers tout le code. La seule information obligatoire est l'ID produit. Toutes les autres valeurs sont facultatives. Si vous n'avez pas besoin de certaines valeurs, ignorez l'étape correspondante et effacez la ligne du code correspondante dans votre document texte.
    Vous pouvez également laisser vides les lignes de code non obligatoires, par exemple, parce que vous souhaitez entrer ces informations ultérieurement.

  4. Entrez l'ID produit dans la première ligne de la propriété. La suite de chiffres « 123456 » est entrée par défaut à cet endroit. Vous devez entrer l'ID de votre produit dans l'espace situé entre les crochets.

    Exemple : l'ID produit est « FR123 ». L'ID produit entré dans le code apparaîtra alors comme suit :

    <property name="id">FR123</property>

    Remarque:  Utilisez uniquement des caractères alphanumériques (lettres et chiffres) pour votre ID produit. L'utilisation de caractères spéciaux peut entraîner des erreurs lors de l'importation de vos données produit.

  5. Entre la deuxième et la onzième ligne de la propriété (« texte1 » à « texte10 »), saisissez jusqu'à dix blocs de texte de votre offre de produits. Pour votre bloc de texte, le texte « Champ de texte 1 », « Champ de texte 2 », « Champ de texte 3 » etc. est entré par défaut à cet endroit. Peuvent par exemple figurer comme blocs de texte : l'intitulé d'une offre de produits, le nom, la catégorie, la description d'un produit, l'ancien prix, le prix actuel, le fabricant/fournisseur, etc. Vous avez la liberté de choisir ce que vous souhaitez saisir dans les champs de texte. Adaptez les contenus en fonction de vos besoins et des exigences inhérentes à votre produit ou service. Vous devez saisir chaque bloc de texte dans l'espace situé entre les crochets, « après CDATA ».

    Exemple : l'offre de produits s'intitule : « Se détendre à Paris ». L'intitulé saisi dans le code apparaîtra alors comme suit :

    <property name="text1"><![CDATA[Relax in Paris]]></property>

    Conseil:  En règle générale, il est recommandé de classer les différents composants de votre offre de produits par ordre chronologique de « texte1 » à « texte10 », tels que ces composants apparaîtront ensuite de haut en bas dans votre offre de produits finale. Si vous n'êtes pas sûr de l'ordre qui vous convient le mieux, veuillez vous adresser au service client Episerver qui se fera un plaisir de vous conseiller.
    La mise en forme (par exemple la taille et la couleur de police) des différents blocs de texte se fait séparément par la suite, via une mise en page HTML.

  6. Saisissez le texte à afficher pour le lien menant à votre offre de produits dans la douzième ligne de la propriété. Exemple : « Voir l'offre », « Plus d'informations » ou « Acheter maintenant ». Le texte « Texte pour lien 1 » est entré par défaut à cet endroit. Vous devez saisir le texte à afficher pour le lien dans l'espace situé entre les crochets, après « CDATA ».

    Exemple : le texte à afficher pour le lien est le suivant : « Réserver maintenant ». Le texte à afficher pour le lien saisi dans le code apparaîtra alors comme suit :

    <property name="link1Text"><![CDATA[Book now]]></property>

  7. Saisissez dans la treizième ligne de la propriété l'URL qui mène au produit, par exemple à la page de votre produit dans votre boutique Internet. Le texte « URL pour lien 1 » est entré par défaut à cet endroit. Vous devez saisir l'URL dans l'espace situé entre les crochets, après « CDATA ».

    Exemple : l'URL menant à votre page produit « http://www.soifdesoleil/paris ». L'URL saisie dans le code apparaîtra alors comme suit :

    <property name="link1Url"><![CDATA[http://www.sonnenhungrig.com/paris]]></property>

  8. Vous pouvez entrer deux autres liens et deux autres textes à afficher pour le lien dans les lignes de propriété 14 à 17, si votre offre de produits doit avoir plus d'un lien. Procédez à la saisie conformément aux étapes 6 et 7.

    Exemple d'utilisation : outre le lien menant à la page de réservation de l'offre de voyage à Paris, un autre lien permet de s'informer sur les conditions météo actuelles.

  9. Saisissez dans la 18e ligne de propriété l'URL de l'image de votre produit. Episerver Campaign charge l'image de votre produit via l'URL indiquée et l'affiche dans votre message. Le texte « URL pour image 1 » est entré par défaut à cet endroit. Vous devez saisir l'URL de l'image de votre produit dans l'espace situé entre les crochets, après « CDATA ».

    Exemple : l'URL produit s'intitule « http://www.soifdesoleil.com/toureiffel.jpg ». L'URL produit saisie dans le code apparaîtra alors comme suit :

    <property name="image1ImageUrl"><![CDATA[http://www.sonnenhungrig.com/eiffeltower.jpg]]></property>

  10. Saisissez le texte alternatif de l'image de votre produit dans la 19e ligne de la propriété. Le texte alternatif est celui qui s'affiche lorsqu'une image ne peut pas être chargée. Il convient de toujours saisir des textes alternatifs, car ceux-ci peuvent également être lus aux malvoyants via des programmes spéciaux et facilitent l'accessibilité de l'information sur Internet. Le texte « Texte alternatif pour image 1 » est entré par défaut à cet endroit. Vous devez saisir le texte alternatif dans l'espace situé entre les crochets, après « CDATA ».

    Exemple : le texte alternatif de votre produit a pour libellé : « La Tour Eiffel à Paris au printemps ». Le texte alternatif de votre produit saisi dans le code apparaîtra alors comme suit :

    <property name="image1AltText"><![CDATA[The Eiffel Tower in Paris in springtime]]></property>

  11. Saisissez dans la 20e ligne de la propriété une URL qui doit être reliée à l'image de votre produit. Lorsqu'un destinataire cliquera plus tard sur l'image, il sera redirigé vers la cible de l'URL liée. Il peut s'agir de votre boutique en ligne ou de toute autre adresse que vous souhaitez lier à l'image de votre produit. Le texte « Lien pour image 1 » est entré par défaut à cet endroit. Vous devez saisir l'URL liée à l'image de votre produit dans l'espace situé entre les crochets, après « CDATA ».

    Attention:  Ne confondez pas le lienImage avec l'URLImage (étape 9 de ce mode d'emploi) qui mène à l'emplacement de stockage de l'image afin de pouvoir charger cette dernière et l'afficher dans vos messages. En revanche, le lienImage dirige le destinataire, sur simple clic sur l'image, vers la page recherchée, laquelle contient des informations complémentaires.

    Exemple : l'URL liée à l'image de votre produit est : « http://www.soifdesoleil.com/tourisme-francais ». L'URL saisie dans le code apparaîtra alors comme suit :

    <property name="image1ImageUrl"><![CDATA[http://www.sonnenhungrig.com/sightsinfrance]]></property>

  12. À partir de la ligne de propriété 21 jusqu'à 35, vous pouvez enregistrer cinq autres URL menant, sur un simple clic, à l'emplacement de stockage des images de votre produit, cinq autres textes alternatifs ainsi que cinq autres liens menant le destinataire à la cible recherchée. Vous pouvez donc insérer pour chaque offre de produits jusqu'à six images accompagnées d'un texte alternatif et d'un lien de renvoi. Procédez à la saisie conformément aux étapes 9 et 11 de ce mode d'emploi.

  13. Intégrez dans les lignes de propriété 36 à 55 des jeux de données complémentaires que vous pouvez utiliser, par exemple, comme métadonnées pour la logique de programme de la mise en page HTML.

  14. Une fois cette opération achevée, enregistrez votre document texte. Donnez-lui pour nom de fichier l'ID du produit, c'est-à-dire la valeur que vous avez entrée dans le code dans la ligne de propriété « id ».

    Remarque:  Vous devez enregistrer le document texte avec les types de fichier .xml. Vous devez à cet effet, dans de nombreux éditeurs de texte, sélectionner l'option Enregistrer sous, puis définir le type de fichier approprié dans une liste de sélection.

  15. Supprimez l'extension de fichier après avoir sauvegardé votre document texte. Si votre document texte se nomme par exemple « VoyageParis01.xml », renommez votre fichier « VoyageParis01 », sans l'extension de fichier .xml.

    Attention:  N'oubliez pas de supprimer l'extension de fichier. Si vous ne supprimez pas l'extension de fichier, vos données produit ne pourront pas être chargées

  16. Placez le document texte dans votre espace Web ou sur votre serveur dans le répertoire que vous avez spécifié lors de la configuration du paragraphe de produit avec l'interface de contenu.

    Attention:  Ne changez jamais l'emplacement de stockage de vos documents texte contenant les descriptions de vos produits sans consultation préalable du service client Episerver. Par exemple, si vous avez choisi l'URL « http://www.monentreprise.fr/produits » comme emplacement de stockage, vous devez toujours placer vos documents texte accompagnés des données produit dans ce répertoire. Si vous déplacez vos documents texte dans un répertoire différent sans consulter au préalable le service client Episerver (par exemple, « http://www.monentreprise.de/produits/offresspeciales »), vos données produit ne pourront plus être chargées via l'interface de contenu.

    Si vous avez enregistré avec succès votre document texte dans votre espace Web ou sur votre serveur, vous pouvez accéder à votre offre de produits via le Template Kit. Suivez les instructions données dans la section Article statique XML pour transférer vos offres de produits dans le Template Kit via l'interface de contenu.

2. Générer des données produit dynamiques sur le serveur

En principe, la préparation de données produit dynamiques suit le modèle du traitement statique des produits. La différence est la suivante : les fichiers XML ne sont pas préparés manuellement, mais chargés par génération de scripts à partir d'une base de données suite à une requête HTTP via l'interface de contenu et fournis automatiquement au format XML. Vous devez mettre en place ce processus de manière systématique dans votre entreprise. Veuillez vous adresser à votre administrateur système si vous souhaitez générer des données produit dynamiques pour ne pas devoir préparer manuellement vos offres de produits.

Lors de la configuration, veillez à ce qui suit :
  1. Le feed XML doit être codé UTF-8.
  2. L'ID produit doit être placé à la fin de l'URL.

    Correct: http://request.example.com/product?id=123456789

    Incorrect: http://request.example.com/product/123456789/data