Variables de notification

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture
  • Utilisez des 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 les préférences système.

    Syntaxe

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

    ${variable-name+variable-parameters}

    La variable-name portion est toujours requise. Toutes les variables de notification ne prennent pas en charge la partie variable-paramètres . Lorsqu’ils sont disponibles, la plupart des paramètres variables sont facultatifs. Consultez la liste des variables de notification disponibles pour 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é. Aucun
    ${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 d’image. Aucun
    • ${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 de messagerie qui imprime une URL vers une notification. Pour plus d'informations, consultez Liaison à un enregistrement dans Espace de travail.
    N’importe quel paramètre d’URL valide sysparm . Par exemple :
    • sysparm_scriptlet
    • sysparm_view
    • ${champ-référence. URI}
    • ${champ-référence. URI_REF}
    Affichez 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.
    N’importe quel paramètre d’URL valide sysparm . Par exemple :
    • sysparm_scriptlet
    • sysparm_view
    ${CMS_URI} Affichez un lien vers l’enregistrement spécifié dans une page CMS. <CMS-site>/<CMS-page>: chemin d’accès relatif requis vers la page CMS.
    ${notification :corps} Affichez le 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. Aucun
    ${mail_script :nom-script} Exécuter le script d’e-mail spécifié. Aucun
    ${NOTIF_UNSUB} Afficher un lien pour vous désabonner de cette notification. link_text: spécifiez le texte à afficher sous forme de lien entre guillemets.
    ${NOTIF_PREFS} Afficher 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 à 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é formulés 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é faits à 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

    Consultez les exemples suivants pour voir comment chaque variable de notification est affiché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 afficher l’incident : ${URI}

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

    ${URI_REF} Source : cliquez ici pour afficher 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}

    La 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 pour le lien vers les préférences de notification.

    ${mail_script :nom-script}
    ${NOTIF_UNSUB}
    ${NOTIF_PREFS}