Variables des courriels : référence et exemples
01À quoi sert une variable ? #sec_aaa796f4
Une variable réserve dans le modèle la place d'une information qui ne sera connue qu'au moment de l'envoi : ressource concernée, nom du relecteur, échéance ou motif d'une décision. REVIEWIT remplace cette balise par la valeur fournie par l'événement métier.
<title>Votre avis est attendu sur {ResourceName}</title>
<p>La réponse est attendue avant le {DueDate}.</p>Le contenu de <title> devient le sujet du courriel. Les variables fonctionnent aussi dans le pré-en-tête, le corps et les attributs HTML.
02Les cinq règles de syntaxe #sec_f4ae7b0c
- Utilisez une seule paire d'accolades : {ResourceName} .
- Respectez la casse : {ResourceName} et {resourcename} sont différents.
- N'inventez pas une variable à partir de son libellé français.
- Utilisez uniquement les variables garanties pour l'événement sélectionné.
- Envoyez un test et vérifiez qu'aucune chaîne {Variable} ne reste visible.
Les valeurs sont encodées avant leur insertion : un nom contenant < ou & ne peut pas modifier la structure HTML. Une variable absente n'est toutefois pas supprimée : elle reste lisible telle quelle dans le message.
03Ressource et campagne #sec_920795bd
| Variable | Signification | Exemple | Point d'attention |
|---|---|---|---|
| {ResourceName} | Nom ou référence de la ressource | Espace Finance ou #123 | Ne supposez pas qu'il s'agit toujours d'un nom lisible |
| {ResourceType} | Type fonctionnel de la ressource | SharePoint | Présentez-le comme une catégorie |
| {Solution} | Solution source | Microsoft 365 | Peut différer du type de ressource |
| {CampaignId} | Identifiant technique de campagne | 1842 | Ce n'est pas un titre |
| {CampaignTitle} | Titre lisible de campagne | Revue trimestrielle des accès | À privilégier lorsqu'il est disponible |
| {SizeFormatted} | Taille déjà formatée | 2,4 Go | Ne faites pas de conversion dans le HTML |
04Personnes et responsabilités #sec_a976ada6
| Variable | Signification | Exemple |
|---|---|---|
| {OwnerName} | Propriétaire ou responsable concerné | Camille Martin |
| {ReviewerName} | Relecteur à l'origine de la décision | Alex Bernard |
| {DelegatorName} | Personne qui délègue | Samira Diallo |
| {EscalatedByName} | Personne qui déclenche l'escalade | Morgan Petit |
| {ReassignedByName} | Personne qui réaffecte la demande | Noah Robert |
| {RequesterName} | Auteur d'une demande de suppression | Lina Moreau |
| {RequestedByName} | Auteur d'une demande d'avis | Hugo Simon |
| {AnsweredByName} | Auteur de la réponse | Inès Laurent |
| {RedirectedByName} | Auteur de la redirection | Louis Michel |
| {NewRecipientName} | Nouveau destinataire d'une consultation | Émilie Garcia |
| {CancelledByName} | Auteur d'une annulation | Adam Roux |
| {RevokedBy} | Personne ou service qui révoque l'accès | Équipe Sécurité |
| {DecidedBy} | Personne qui rend la décision | Nora Fournier |
05Dates et délais #sec_0071f336
| Variable | Signification | Exemple |
|---|---|---|
| {DueDate} | Échéance de la revue | 2026-09-15 |
| {AnswerDueDate} | Échéance de réponse à une contestation | 15/09/2026 |
| {DaysToAnswer} | Nombre de jours accordés | 7 |
| {WithdrawnDate} | Date de retrait de la contestation | 31/08/2026 |
| {CancelledDate} | Date d'annulation de la demande | 31/08/2026 |
| {ProcessedDate} | Date de traitement de la suppression | 01/09/2026 |
Les formats peuvent différer selon l'événement. La valeur arrive déjà formatée : ne tentez pas de la transformer dans le HTML.
06Décisions et textes libres #sec_4d708521
| Variable | Signification | Exemple |
|---|---|---|
| {Decision} | Décision rendue après escalade | Accès retiré |
| {NewDecision} | Décision appliquée après contestation | Conforme |
| {Reason} | Motif saisi par une personne | Le rôle n'est plus nécessaire |
| {Argument} | Argument d'une contestation | Cet accès reste requis pour la clôture |
| {Question} | Question adressée au consulté | Cet accès est-il encore nécessaire ? |
| {Answer} | Réponse fournie au demandeur | Oui, jusqu'à la fin du projet |
| {Comment} | Commentaire associé à une demande | Suppression validée avec le métier |
| {ResolutionNote} | Note résumant la résolution | Justification acceptée après contrôle |
Les textes libres doivent être présentés dans une citation ou un bloc isolé. Ne les insérez pas au milieu d'une phrase : leur ponctuation et leur contenu sont imprévisibles.
07Variables sûres pour les événements de revue #sec_26ebb516
| Événement | Variables garanties |
|---|---|
| ReviewsAssigned | {ResourceName} {CampaignId} {DueDate} |
| ReviewReminder | {ResourceName} {CampaignId} {DueDate} |
| ReviewsExpired | {ResourceName} {CampaignId} {DueDate} |
| EscalationNotice | {ResourceName} {CampaignId} {DueDate} |
| EscalationReceived | {ResourceName} uniquement |
| DelegationReceived | {ResourceName} {DelegatorName} {Reason} |
| RequestReassigned | {ResourceName} {ReassignedByName} {Reason} |
EscalationReceived possède plusieurs chemins. {EscalatedByName} , {Reason} , {CampaignId} et {DueDate} ne sont présents que dans certains cas : le modèle par défaut ne doit pas en dépendre.
08Variables sûres pour les contestations #sec_168763f9
| Événement | Variables garanties |
|---|---|
| ChallengeRaised | {ResourceName} {ResourceType} {Solution} {OwnerName} {Argument} {AnswerDueDate} {DaysToAnswer} |
| ChallengeAccepted | {ReviewerName} {NewDecision} {ResolutionNote} |
| ChallengeDeclined | {ReviewerName} {ResolutionNote} |
| ChallengeWithdrawn | {OwnerName} {WithdrawnDate} |
| EscalatedDecisionNotice | {ResourceName} {DecidedBy} {Decision} {CampaignTitle} {Reason} |
09Variables sûres pour les suppressions et les accès #sec_f74356e3
| Événement | Variables garanties |
|---|---|
| DeletionRequested | {ResourceName} {ResourceType} {Solution} {RequesterName} {Reason} {Comment} {SizeFormatted} |
| DeletionCancelled | {ResourceName} {CancelledByName} {CancelledDate} |
| DeletionProcessed | {ResourceName} {ProcessedDate} |
| AccessRevokedNotice | {ResourceName} {RevokedBy} {Reason} {CampaignTitle} |
10Variables sûres pour les consultations #sec_ae8e18fe
| Événement | Variables garanties |
|---|---|
| AdviceRequestedNotice | {ResourceName} {RequestedByName} {Question} |
| AdviceReceivedNotice | {ResourceName} {AnsweredByName} {Answer} |
| AdviceRedirectedNotice | {ResourceName} {RedirectedByName} {NewRecipientName} |
11Événements dormants #sec_f453ddcd
Les événements suivants sont présents dans le catalogue mais ne sont pas encore émis automatiquement :
- PendingReviewsDigest ;
- ChallengeReminder ;
- DecisionAmended ;
- DeletionRejected ;
- ExceptionExpiring ;
- GracePeriodEntered .
Leur modèle peut être préparé et prévisualisé. Il ne doit pas être interprété comme la preuve qu'une communication automatique est déjà active.
12Deux variables indisponibles #sec_ad0f2f57
{DeepLink} et {SettingsLink} existent dans certains modèles historiques, mais aucune valeur ne leur est actuellement fournie. Ne créez pas de bouton ou de lien qui en dépend.
Certaines relances manuelles historiques utilisent aussi {{ReviewerName}} . Cette syntaxe à doubles accolades n'est pas celle des notifications automatiques. L'éditeur doit la signaler et vous demander de revenir à {ReviewerName} .
13Le contrôle avant publication #sec_b3e3a4da
Un modèle est prêt lorsque :
- son événement est sélectionné ;
- chaque variable est garantie pour cet événement ;
- aucune double accolade n'est présente ;
- les textes libres sont isolés dans des blocs adaptés ;
- le sujet et le corps ont été prévisualisés ;
- un test réel ne laisse apparaître aucune variable non résolue.
L'éditeur du Subscription Manager applique cette référence au moment de rédiger : la palette propose les variables autorisées, fournit un exemple et les insère à la position du curseur. Les variables inconnues ou indisponibles bloquent l'enregistrement ; les variables contextuelles déclenchent un avertissement.