Démarrer avec les variables
Les variables vous permettent d’afficher automatiquement les informations de vos projets Ezus dans vos documents et pages web. Au lieu de mettre à jour manuellement les mêmes informations pour chaque client, vous pouvez insérer une variable dans un modèle et laisser Ezus récupérer la valeur correspondante lors de la génération du document.
Qu’est-ce qu’une variable ?
Une variable est un élément qui relie un modèle à une information enregistrée dans Ezus.
Par exemple, vous pouvez insérer :
$$project.title$$
Lorsque vous générez le document, Ezus remplace la variable par le titre du projet actuel.
Si votre projet s’appelle Aventure en Islande, le résultat sera :
Aventure en Islande
Cela signifie que le même modèle peut être réutilisé pour différents projets sans avoir à remplacer manuellement les informations du projet à chaque fois.
💡 Considérez une variable comme une instruction indiquant à Ezus : « Affiche cette information précise ici. »
Où trouver les variables ?
Lorsque vous modifiez un modèle de document, vous pouvez trouver les variables disponibles dans le Variable Drawer, situé dans le coin supérieur gauche de l’onglet Document Modification.
Le Variable Drawer est divisé en deux zones principales :
General : informations liées au projet, au brief, à l’utilisateur, au client, aux voyageurs, au compte et aux alternatives.
Program : informations liées à l’itinéraire, notamment les jours, les étapes, les activités, les hébergements, les transports, les produits et les fournisseurs.
Dans la mesure du possible, sélectionnez et copiez les variables directement depuis le Variable Drawer plutôt que de les saisir manuellement. Cela vous permet de conserver la syntaxe correcte.
Choisir la variable en fonction de l’endroit où l’information est enregistrée
Avant de sélectionner une variable, identifiez d’où provient l’information dans Ezus.
Des informations similaires peuvent exister à différents niveaux d’un projet, et choisir une variable provenant du mauvais niveau peut renvoyer un résultat différent de celui attendu.
Par exemple :
Si vous souhaitez obtenir des informations sur l’hôtel associé à un jour particulier, utilisez les informations correspondantes dans Day / Program.
Si vous souhaitez obtenir le premier hébergement du projet, quel que soit le jour, utilisez une variable Accommodation.
Si vous souhaitez afficher des informations générales telles que le titre du projet ou le nom du client, utilisez la variable General correspondante.
💡 Ne commencez pas par vous demander « Quelle variable dois-je utiliser ? ». Commencez par vous demander « Où cette information est-elle enregistrée dans Ezus ? ». Choisissez ensuite la variable associée à ce niveau.
Variables dans Slides
Dans les modèles Slides, les variables utilisent la syntaxe $$...$$.
Par exemple :
$$project.title$$
Vous pouvez combiner du texte statique et des variables dans une même zone de texte. Le texte statique reste inchangé, tandis que la variable est remplacée par les informations du projet lors de la génération du document.
Par exemple :
Votre voyage en $$project.destination$$
peut générer :
Votre voyage en Islande
Les variables peuvent récupérer de nombreux types d’informations, notamment du texte, des dates, des descriptions, des images, des informations sur le projet et des informations sur le programme.
🔭 Consultez Liste complète des variables pour Slides pour découvrir les variables Slides disponibles, leur syntaxe et des exemples.
Variables dans les modèles HTML
Les pages web HTML utilisent également des variables pour récupérer les informations d’Ezus.
Lorsqu’une variable est utilisée en dehors d’une boucle, vous pouvez utiliser les variables disponibles dans le Variable Drawer de la même manière que dans Slides.
Par exemple :
<h1>$$project.title$$</h1>
Lorsque la page web est générée, $$project.title$$ est remplacée par le titre du projet actuel.
À l’intérieur d’une boucle HTML, la syntaxe change car vous travaillez avec l’élément actuel de cette boucle.
Par exemple, à l’intérieur d’une boucle qui parcourt les jours du programme :
{% for day in days %} <h2>{{ day.title }}</h2> {% endfor %}Ici, {{ day.title }} récupère le titre de chaque jour à mesure que la boucle parcourt le programme.
⚠️ Ne copiez pas automatiquement une variable Slides dans une boucle HTML. Les variables situées en dehors des boucles et les variables faisant référence à l’objet actuel à l’intérieur d’une boucle n’utilisent pas la même syntaxe.
🔭 Consultez Variables HTML pour découvrir les variables HTML disponibles et Utiliser les boucles dans les modèles HTML pour comprendre comment les variables fonctionnent avec du contenu répété.
Que faire si une variable n’affiche pas les informations attendues ?
Si une variable est vide ou renvoie des informations inattendues, commencez par vérifier les données sources avant de modifier le modèle.
Vérifiez que :
Les informations existent dans le projet.
Vous utilisez la variable correspondant au bon objet ou au bon niveau d’information.
La syntaxe de la variable n’a pas été modifiée.
Le modèle est testé avec un projet contenant les informations que vous souhaitez afficher.
Si vous travaillez en HTML, la variable est utilisée dans le bon contexte, en particulier lorsqu’elle se trouve à l’intérieur d’une boucle.
⚠️ Un résultat vide ne signifie pas nécessairement que la variable est incorrecte. Si les informations correspondantes n’ont pas été renseignées dans le projet, Ezus peut simplement n’avoir aucune valeur à afficher.
Tester vos variables
Après avoir ajouté ou modifié une variable :
Enregistrez le modèle.
Générez le document ou la page web à l’aide d’un projet représentatif.
Comparez le résultat généré avec les informations enregistrées dans le projet.
Vérifiez que la valeur attendue apparaît au bon endroit.
Si ce n’est pas le cas, vérifiez les informations sources et le contexte de la variable avant de modifier à nouveau le modèle.
💡 Utilisez un projet de test représentatif contenant des jours, des activités, des hébergements, des transports, des descriptions et des images lorsque cela est pertinent. Un projet contenant des informations incomplètes peut ne pas suffire pour déterminer si une variable fonctionne correctement.
🔭 Une fois que vous maîtrisez les variables, continuez avec Liste complète des variables pour Slides ou Variables HTML pour trouver la syntaxe exacte correspondant aux informations que vous souhaitez afficher.