> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/features/general/email-templates.md).

# Modèles e-mail

Apprenez à écrire des modèles de messages avec des champs dynamiques, des conditions et des boucles pour communiquer avec vos clients ou collaborateurs.

## Généralités

Les modèles de messages sont disponibles dans les demandes d'exercice de droits, les tâches, les invitations aux questionnaires, les invitations à compléter un traitement ou une violation, et les règles de workflow qui envoient un message. Une fois enregistrés, ils permettent de communiquer rapidement avec les parties prenantes. Les données de l'objet concerné peuvent être insérées dans le texte, avec des conditions et des boucles pour récupérer plus d'informations.

Cette page explique comment écrire un modèle. Pour les types de modèles, le partage, l'import et l'export, consultez la page [Modèles de messages](https://doc.dastra.eu/features/settings/message-templates.md).

## Utilisation

Pour utiliser un modèle, cliquez sur **Sélectionner un modèle** à côté de la zone de rédaction du message.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-d21660a7a29de8d069dbb4fe11c2dc67202cc698%2Fgeneral-email-templates-1.png?alt=media" alt="Zone de rédaction d&#x27;un message de demande d&#x27;exercice de droits avec le bouton Sélectionner un modèle"><figcaption><p>Le bouton Sélectionner un modèle dans une demande d'exercice de droits</p></figcaption></figure>

Le panneau **Sélection du modèle** s'ouvre. Recherchez un modèle dans la liste, parcourez les modèles **Partagé** ou **Privé** de chaque type, ou choisissez un autre espace de travail auquel vous avez accès. Cliquez sur **Sélectionner** en face du modèle voulu.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-7d72a293c7531ea2a7eedd99bc7eb50b8075bb89%2Fgeneral-email-templates-2.png?alt=media" alt="Panneau Sélection du modèle avec la recherche, les onglets par type et le bouton Créer modèle"><figcaption><p>Le panneau de sélection d'un modèle</p></figcaption></figure>

Si aucun modèle ne convient, cliquez sur **Créer modèle**. La fenêtre de création comprend :

* le **Nom** du modèle, qui permet de le retrouver ;
* le **Corps du modèle**, la zone de saisie ;
* l'option de partage avec tous les utilisateurs de l'espace de travail ;
* l'onglet **Aperçu**, qui affiche le rendu du message en temps réel ;
* l'onglet **Input Data**, qui affiche les données de l'objet concerné par le modèle.

Les onglets **Aperçu** et **Input Data** n'apparaissent que si vous créez le modèle depuis l'endroit où vous rédigez le message, et pas depuis les réglages.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-d94ccf96af487bd4d14622468c1a4256ede3b434%2Fgeneral-email-templates-3.png?alt=media" alt="Fenêtre de création d&#x27;un modèle avec le nom, le corps du modèle, l&#x27;aperçu et l&#x27;onglet Input Data"><figcaption><p>La fenêtre de création d'un modèle</p></figcaption></figure>

## Personnalisez le modèle

Dans le corps du modèle, vous pouvez appliquer des styles, insérer des images ou des tableaux. Le résultat s'affiche dans l'onglet **Aperçu**.

Pour insérer une donnée de l'objet, cliquez sur l'icône accolades de la barre d'outils (**Insérer des champs dynamiques**) et choisissez un champ dans la liste. La valeur du champ est insérée à l'emplacement du curseur.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-bf854acee7ee8ed340d3ca0acfb1b139bc227a0d%2Fgeneral-email-templates-4.png?alt=media" alt="Liste des champs dynamiques ouverte depuis la barre d&#x27;outils de l&#x27;éditeur du modèle"><figcaption><p>L'insertion d'un champ dynamique</p></figcaption></figure>

## Les champs dynamiques

Les champs entourés de doubles accolades sont des variables : elles sont remplacées par les valeurs de l'objet correspondant (ici une demande d'exercice de droits).

### Utiliser un champ de l'Input Data

L'onglet **Input Data** liste les propriétés de l'objet lié. Pour afficher par exemple le message de la demande :

1. Repérez le champ dans l'onglet **Input Data**.
2. Saisissez son nom dans le corps du modèle avec la syntaxe `{{message}}`.
3. Vérifiez le résultat dans l'onglet **Aperçu**.

Vous pouvez aller plus loin avec des boucles, des conditions et des formats de date.

### Les conditions

Un bloc conditionnel ne s'affiche que dans certaines conditions. Il commence par une balise `if` et se termine par une balise `endif`. Par exemple :

```liquid
{% if attachments != blank %}
  Vous avez une pièce jointe
{% endif %}
```

Le bloc ne s'affiche que si la demande contient une pièce jointe.

### Les boucles

Les boucles fonctionnent de la même manière, avec une variable propre à la boucle :

```liquid
{% for purpose in purposes %}
  {{ purpose }}
{% endfor %}
```

Dans cet exemple, la boucle parcourt la liste `purposes` et affiche chaque élément dans la variable `purpose`.

### Format des dates

Les dates de l'Input Data ne sont pas présentables en l'état. Appliquez-leur un format :

```liquid
{{ dateCreation | date: "%d-%m-%Y à %H:%M" }}
```

Ce modèle donne par exemple 15-03-2023 à 15:40.

### Un exemple plus complet

Le corps de texte ci-dessous utilise tous les éléments précédents :

```liquid
Bonjour,

Nous avons bien reçu votre demande d'exercice de droit le {{ dateCreation | date: "%d-%m-%Y à %H:%M" }} concernant {{ givenName }} {{ familyName }}.

La demande porte sur les finalités suivantes :
{% for purpose in purposes %}
* {{ purpose }}
{% endfor %}

{% if attachments != blank %}
Nous avons bien reçu les pièces suivantes :
{% for attachment in attachments %}
* {{ attachment.fileName }}
{% endfor %}
{% endif %}

Nous vous tiendrons informé de la suite du traitement de votre demande.

Cordialement,
{{ operator.displayName }}
```

Pour la demande en cours de traitement, le message est transformé de la manière suivante :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-3f7890cc58fc2cb07d9bfdcacba4803a29c1f1c0%2Fgeneral-email-templates-5.png?alt=media" alt="Aperçu du message généré à partir du modèle complet pour une demande d&#x27;exercice de droits"><figcaption><p>Le rendu d'un modèle complet</p></figcaption></figure>

## Aller plus loin

Les modèles utilisent la syntaxe Liquid. Consultez la [documentation de Liquid](https://shopify.github.io/liquid/) pour la liste des balises et des filtres.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.dastra.eu/features/general/email-templates.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
