Variables de notification

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture

    • Utilisez les variables de notification pour afficher des informations dynamiques dans le corps d’une notification, telles qu’une valeur de champ, un lien vers un enregistrement ou un lien vers des préférences système.

    Syntaxe

    Spécifiez une variable de notification à l’aide de cette syntaxe :

    ${variable-name+variable-parameters}

    La variable-name portion est toujours requise. Toutes les variables de notification ne prennent pas en charge la partie variables-paramètres . Lorsqu’ils sont disponibles, la plupart des paramètres variables sont facultatifs. Consultez la liste des variables de notification disponibles pour connaître les noms de variables et les paramètres disponibles.

    Variables disponibles

    Le système fournit ces variables de notification.

    Tableau 1. Variables de notification disponibles
    Variable Description Paramètres disponibles
    ${nom_champ} Affichez la valeur du champ spécifié. Néant
    ${nom-champ-image} Affichez une image associée à un enregistrement. Cette variable est généralement utilisée avec HTML pour spécifier la source d’un élément image. Néant
    • ${URI}
    • ${URI_REF}
    		 Affichez un lien vers l’enregistrement actuel.
    • URI: Le texte du lien est le mot LINK.
    • URI_REF: le texte du lien est la valeur d’affichage de l’enregistrement.
    Remarque :
    Ces variables ne s’appliquent pas aux enregistrements dans Espace de travail. Pour créer un lien vers un enregistrement dans Espace de travail, créez un script d’e-mail qui imprime une URL vers une notification. Pour plus d'informations, consultez Liaison à un enregistrement dans Espace de travail.
    		 Tout paramètre d’URL valide sysparm . Par exemple :
    • sysparm_scriptlet
    • sysparm_view
    • ${champ_référence. URI}
    • ${champ_référence. URI_REF}
    		 Afficher un lien vers l’enregistrement répertorié dans un champ de référence.
    • URI: le texte du lien est le mot LINK
    • URI_REF: le texte du lien est la valeur d’affichage de l’enregistrement.
    		 Tout paramètre d’URL valide sysparm . Par exemple :
    • sysparm_scriptlet
    • sysparm_view
    ${CMS_URI} Afficher un lien vers l’enregistrement spécifié dans une page CMS. <CMS-site>/<CMS-page>: chemin relatif requis vers la page CMS.
    ${notification :corps} Affichez le contenu du corps d’un modèle d’e-mail ou d’une notification par e-mail. Utilisez cette variable de notification pour spécifier où afficher le contenu du corps dans la mise en page d’un e-mail. Néant
    ${mail_script :nom-script} Exécutez le script de messagerie spécifié. Néant
    ${NOTIF_UNSUB} Afficher un lien Se désabonner de cette notification. link_text: spécifiez le texte à afficher sous forme de lien entre guillemets.
    ${NOTIF_PREFS} Affichez un lien pour définir les préférences de notification. link_text: spécifiez le texte à afficher sous forme de lien entre guillemets.
    ${commentaires :n}

    Affichez les commentaires les plus récents qui ont été faits sur l’enregistrement cible. Le nombre de commentaires à afficher est n. Par exemple, ${comments :3} affiche les trois derniers commentaires qui ont été faits sur l’enregistrement.

    Pour afficher tous les commentaires, utilisez la variable ${comments}.

    		 N’importe quel nombre supérieur à 0.
    ${comments_and_work_notes :n}

    Affichez les commentaires et notes de travail les plus récents qui ont été faits sur l’enregistrement cible. Le nombre de commentaires et de notes de travail à afficher est n. Par exemple, ${comments_and_work_notes :3} affiche les trois derniers commentaires et notes de travail qui ont été ajoutés à l’enregistrement.

    Pour afficher tous les commentaires et notes de travail, utilisez la variable ${comments_and_work_notes}.

    		 N’importe quel nombre supérieur à 0.

    Exemples

    Reportez-vous aux exemples suivants pour voir comment chaque variable de notification est restituée dans la sortie :
    Variable Exemple
    ${nom_champ}

    Source : Incident ${number} - commentaires ajoutés

    Sortie : INC1000001 d’incident - commentaires ajoutés
    ${nom-champ-image}

    Source: <img src='${picture}?t=medium'/>

    Sortie : variable d’image de notification
    • ${URI}
    • ${URI_REF}

    ${URI} Source : Cliquez ici pour voir l’incident : ${URI}

    ${URI} Sortie : exemple qui montre comment le mot Lien du texte du lien sert de lien vers l’enregistrement actuel

    ${URI_REF} Source : Cliquez ici pour voir l’incident : ${URI_REF}

    ${URI_REF} Sortie : Exemple qui montre comment le texte du lien affiché est la valeur de l’enregistrement
    • ${champ_référence. URI}
    • ${champ_référence. URI_REF}
    Source : 
    Click here to view Incident: ${URI_REF}
Click here to view Related Problem: ${problem_id.URI_REF}

    Sortie : exemple qui montre un lien vers un enregistrement répertorié dans un champ de référence
    ${CMS_URI}

    Source : ${CMS_URI+ess/incident_detail}

    Sortie : un lien vers une page CMS cible telle que https://<nom d’instance>.service-now.com/ess/incident_detail.do?sysparm_document_key=incident,46e18c0fa9fe19810066a0083f76bd56
    ${notification :corps}

    Source : fonctionnement d’une variable pour le corps de l’e-mail dans la mise en page d’un e-mail.

    Sortie : fonctionnement de la variable du lien vers les préférences de notification.
    ${mail_script :nom-script}
    ${NOTIF_UNSUB}
    ${NOTIF_PREFS}