Variabili delle email: riferimento ed esempi
01A cosa serve una variabile? #sec_aaa796f4
Una variabile riserva nel modello il posto di un'informazione che sarà nota solo al momento dell'invio: la risorsa interessata, il nome del revisore, la scadenza o il motivo di una decisione. REVIEWIT sostituisce questo segnaposto con il valore fornito dall'evento di business.
<title>Votre avis est attendu sur {ResourceName}</title>
<p>La réponse est attendue avant le {DueDate}.</p>Il contenuto di <title> diventa l'oggetto dell'email. Le variabili funzionano anche nel pre-header, nel corpo e negli attributi HTML.
02Le cinque regole di sintassi #sec_f4ae7b0c
- Utilizzate una sola coppia di parentesi graffe: {ResourceName}.
- Rispettate le maiuscole e minuscole: {ResourceName} e {resourcename} sono diversi.
- Non inventate una variabile a partire dal suo nome in francese.
- Utilizzate solo le variabili garantite per l'evento selezionato.
- Inviate un test e verificate che nessuna stringa {Variable} rimanga visibile.
I valori vengono codificati prima dell'inserimento: un nome contenente < o & non può modificare la struttura HTML. Tuttavia, una variabile assente non viene eliminata: rimane leggibile com'è nel messaggio.
03Risorsa e campagna #sec_920795bd
| Variabile | Significato | Esempio | Punto di attenzione |
|---|---|---|---|
| {ResourceName} | Nome o riferimento della risorsa | Spazio Finanza o #123 | Non supponete che si tratti sempre di un nome leggibile |
| {ResourceType} | Tipo funzionale della risorsa | SharePoint | Presentatelo come una categoria |
| {Solution} | Soluzione sorgente | Microsoft 365 | Può differire dal tipo di risorsa |
| {CampaignId} | Identificativo tecnico della campagna | 1842 | Non è un titolo |
| {CampaignTitle} | Titolo leggibile della campagna | Revisione trimestrale degli accessi | Da privilegiare quando disponibile |
| {SizeFormatted} | Dimensione già formattata | 2,4 GB | Non fate conversioni nell'HTML |
04Persone e responsabilità #sec_a976ada6
| Variabile | Significato | Esempio |
|---|---|---|
| {OwnerName} | Proprietario o responsabile interessato | Camille Martin |
| {ReviewerName} | Revisore all'origine della decisione | Alex Bernard |
| {DelegatorName} | Persona che delega | Samira Diallo |
| {EscalatedByName} | Persona che attiva l'escalation | Morgan Petit |
| {ReassignedByName} | Persona che riassegna la richiesta | Noah Robert |
| {RequesterName} | Autore di una richiesta di cancellazione | Lina Moreau |
| {RequestedByName} | Autore di una richiesta di parere | Hugo Simon |
| {AnsweredByName} | Autore della risposta | Inès Laurent |
| {RedirectedByName} | Autore della reindirizzamento | Louis Michel |
| {NewRecipientName} | Nuovo destinatario di una consultazione | Émilie Garcia |
| {CancelledByName} | Autore di una cancellazione | Adam Roux |
| {RevokedBy} | Persona o servizio che revoca l'accesso | Team Sicurezza |
| {DecidedBy} | Persona che emette la decisione | Nora Fournier |
05Date e scadenze #sec_0071f336
| Variabile | Significato | Esempio |
|---|---|---|
| {DueDate} | Scadenza della revisione | 2026-09-15 |
| {AnswerDueDate} | Scadenza della risposta a una contestazione | 15/09/2026 |
| {DaysToAnswer} | Numero di giorni concessi | 7 |
| {WithdrawnDate} | Data di ritiro della contestazione | 31/08/2026 |
| {CancelledDate} | Data di cancellazione della richiesta | 31/08/2026 |
| {ProcessedDate} | Data di elaborazione della cancellazione | 01/09/2026 |
I formati possono differire a seconda dell'evento. Il valore arriva già formattato: non tentate di trasformarlo nell'HTML.
06Decisioni e testi liberi #sec_4d708521
| Variabile | Significato | Esempio |
|---|---|---|
| {Decision} | Decisione emessa dopo l'escalation | Accesso revocato |
| {NewDecision} | Decisione applicata dopo la contestazione | Conforme |
| {Reason} | Motivo inserito da una persona | Il ruolo non è più necessario |
| {Argument} | Argomento di una contestazione | Questo accesso rimane richiesto per la chiusura |
| {Question} | Domanda rivolta al consultato | Questo accesso è ancora necessario? |
| {Answer} | Risposta fornita al richiedente | Sì, fino alla fine del progetto |
| {Comment} | Commento associato a una richiesta | Cancellazione convalidata con il business |
| {ResolutionNote} | Nota che riassume la risoluzione | Giustificazione accettata dopo il controllo |
I testi liberi devono essere presentati in una citazione o in un blocco isolato. Non inseriteli nel mezzo di una frase: la loro punteggiatura e il loro contenuto sono imprevedibili.
07Variabili sicure per gli eventi di revisione #sec_26ebb516
| Evento | Variabili garantite |
|---|---|
| ReviewsAssigned | {ResourceName} {CampaignId} {DueDate} |
| ReviewReminder | {ResourceName} {CampaignId} {DueDate} |
| ReviewsExpired | {ResourceName} {CampaignId} {DueDate} |
| EscalationNotice | {ResourceName} {CampaignId} {DueDate} |
| EscalationReceived | {ResourceName} soltanto |
| DelegationReceived | {ResourceName} {DelegatorName} {Reason} |
| RequestReassigned | {ResourceName} {ReassignedByName} {Reason} |
EscalationReceived ha diversi percorsi. {EscalatedByName}, {Reason}, {CampaignId} e {DueDate} sono presenti solo in alcuni casi: il modello predefinito non deve dipenderne.
08Variabili sicure per le contestazioni #sec_168763f9
| Evento | Variabili garantite |
|---|---|
| ChallengeRaised | {ResourceName} {ResourceType} {Solution} {OwnerName} {Argument} {AnswerDueDate} {DaysToAnswer} |
| ChallengeAccepted | {ReviewerName} {NewDecision} {ResolutionNote} |
| ChallengeDeclined | {ReviewerName} {ResolutionNote} |
| ChallengeWithdrawn | {OwnerName} {WithdrawnDate} |
| EscalatedDecisionNotice | {ResourceName} {DecidedBy} {Decision} {CampaignTitle} {Reason} |
09Variabili sicure per le eliminazioni e gli accessi #sec_f74356e3
| Evento | Variabili garantite |
|---|---|
| DeletionRequested | {ResourceName} {ResourceType} {Solution} {RequesterName} {Reason} {Comment} {SizeFormatted} |
| DeletionCancelled | {ResourceName} {CancelledByName} {CancelledDate} |
| DeletionProcessed | {ResourceName} {ProcessedDate} |
| AccessRevokedNotice | {ResourceName} {RevokedBy} {Reason} {CampaignTitle} |
10Variabili sicure per le consultazioni #sec_ae8e18fe
| Evento | Variabili garantite |
|---|---|
| AdviceRequestedNotice | {ResourceName} {RequestedByName} {Question} |
| AdviceReceivedNotice | {ResourceName} {AnsweredByName} {Answer} |
| AdviceRedirectedNotice | {ResourceName} {RedirectedByName} {NewRecipientName} |
11Eventi dormienti #sec_f453ddcd
I seguenti eventi sono presenti nel catalogo ma non sono ancora emessi automaticamente:
- PendingReviewsDigest ;
- ChallengeReminder ;
- DecisionAmended ;
- DeletionRejected ;
- ExceptionExpiring ;
- GracePeriodEntered.
Il loro modello può essere preparato e visualizzato in anteprima. Non deve essere interpretato come prova che una comunicazione automatica è già attiva.
12Due variabili non disponibili #sec_ad0f2f57
{DeepLink} e {SettingsLink} esistono in alcuni modelli storici, ma attualmente non viene fornito alcun valore. Non create pulsanti o collegamenti che ne dipendano.
Alcune rilanci manuali storici utilizzano anche {{ReviewerName}}. Questa sintassi a doppie parentesi graffe non è quella delle notifiche automatiche. L'editor deve segnalarla e chiedervi di tornare a {ReviewerName}.
13Il controllo prima della pubblicazione #sec_b3e3a4da
Un modello è pronto quando :
- il suo evento è selezionato;
- ogni variabile è garantita per questo evento;
- non sono presenti doppie parentesi graffe;
- i testi liberi sono isolati in blocchi adatti;
- l'oggetto e il corpo sono stati visualizzati in anteprima;
- un test reale non lascia apparire alcuna variabile non risolta.
L'editor del Subscription Manager applica questo riferimento al momento della redazione: la palette propone le variabili autorizzate, fornisce un esempio e le inserisce nella posizione del cursore. Le variabili sconosciute o indisponibili bloccano la registrazione; le variabili contestuali attivano un avviso.