Benachrichtigungsvariablen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer

    • Verwenden Sie Benachrichtigungsvariablen, um dynamische Informationen im Nachrichtentext anzuzeigen, z. B. einen Feldwert, eine Verknüpfung zu einem Datensatz oder eine Verknüpfung zu den Systemeinstellungen.

    Syntax

    Geben Sie eine Benachrichtigungsvariable mit dieser Syntax an:

    ${variable-name+variable-parameters}

    Die variable-nameTeil ist immer erforderlich. Nicht alle Benachrichtigungsvariablen unterstützen den Teil variable-parameters. Wenn verfügbar, sind die meisten variablen Parameter optional. In der Liste der verfügbaren Benachrichtigungsvariablen finden Sie die Variablennamen und verfügbaren Parameter.

    Verfügbare Variablen

    Das System stellt diese Benachrichtigungsvariablen zur Verfügung.

    Tabelle : 1. Verfügbare Benachrichtigungsvariablen
    Variable Beschreibung Verfügbare Parameter
    ${field-name} Den Wert des angegebenen Felds anzeigen. Keine
    ${image-field-name} Ein Bild anzeigen, das einem Datensatz zugeordnet ist. Diese Variable wird normalerweise mit HTML verwendet, um die Quelle eines Bildelements anzugeben. Keine
    • ${URI}
    • ${URI_REF}
    		 Einen Link zum aktuellen Datensatz anzeigen.
    • URI: Der Linktext ist das Wort LINK .
    • URI_REF: Der Linktext ist der Anzeigewert des Datensatzes.
    Hinweis:
    Diese Variablen gelten nicht für Datensätze in Arbeitsbereich. Zum Verknüpfen mit einem Datensatz in Arbeitsbereich, Erstellen Sie ein E-Mail-Skript, das eine URL für eine Benachrichtigung ausdruckt. Weitere Informationen finden Sie unter Verknüpfung mit einem Datensatz in Arbeitsbereich.
    		 Beliebig gültig sysparmURL-Parameter. Zum Beispiel:
    • sysparm_scriptlet
    • sysparm_view
    • ${reference-field.URI}
    • ${reference-field.URI_REF}
    		 Einen Link zu dem in einem Referenzfeld aufgelisteten Datensatz anzeigen.
    • URI: Der Linktext ist das Wort LINK
    • URI_REF: Der Linktext ist der Anzeigewert des Datensatzes.
    		 Beliebig gültig sysparmURL-Parameter. Zum Beispiel:
    • sysparm_scriptlet
    • sysparm_view
    ${CMS_URI} Zeigt einen Link zum angegebenen Datensatz innerhalb einer CMS-Seite an. <CMS-site>/<CMS-page>: Der erforderliche relative Pfad zur CMS-Seite.
    ${notification:body} Zeigt den Inhalt einer E-Mail-Vorlage oder E-Mail-Benachrichtigung an. Verwenden Sie diese Benachrichtigungsvariable, um anzugeben, wo Textinhalt in einem E-Mail-Layout angezeigt werden soll. Keine
    ${mail_script:script-name} Führen Sie das angegebene Mail-Skript aus. Keine
    $ {NOTIF_UNSUB} Einen Link anzeigen, der diese Benachrichtigung abbestellt. link_text: Geben Sie den Text an, der als Link in Anführungszeichen angezeigt werden soll.
    $ {NOTIF_PREFS} Zeigt einen Link an, um die Benachrichtigungseinstellungen festzulegen. link_text: Geben Sie den Text an, der als Link in Anführungszeichen angezeigt werden soll.
    ${comments:n}

    Zeigen Sie die neuesten Kommentare an, die zum Zieldatensatz gemacht wurden. Die Anzahl der anzuzeigenden Kommentare beträgt n. Beispiel: ${comments:3} Zeigt die letzten drei Kommentare an, die zum Datensatz gemacht wurden.

    Um alle Kommentare anzuzeigen, verwenden Sie die Variable ${comments} .

    		 Eine beliebige Zahl größer als 0.
    ${comments_and_work_Notes:n}

    Zeigen Sie die neuesten Kommentare und Arbeitsnotizen an, die für den Zieldatensatz gemacht wurden. Die Anzahl der anzuzeigenden Kommentare und Arbeitsnotizen beträgt n. Beispiel: ${comments_and_work_Notes:3} Zeigt die letzten drei Kommentare und Arbeitsnotizen an, die zum Datensatz gemacht wurden.

    Verwenden Sie die Variable, um alle Kommentare und Arbeitsnotizen anzuzeigen ${comments_and_work_Notes} .

    		 Eine beliebige Zahl größer als 0.

    Beispiele

    In den folgenden Beispielen erfahren Sie, wie jede Benachrichtigungsvariable in der Ausgabe gerendert wird:
    Variable Beispiel
    ${field-name}

    Quelle: Incident ${number} - Kommentare hinzugefügt

    Ausgabe: Incident INC1000001 - Kommentare hinzugefügt
    ${image-field-name}

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

    Ausgabe: Benachrichtigungsbildvariable
    • ${URI}
    • ${URI_REF}

    ${URI} Quelle: Klicken Sie hier, um den Incident anzuzeigen: ${URI}

    ${URI} Ausgabe: Beispiel, das zeigt, wie der Link-Textwortlink als Link zum aktuellen Datensatz dient

    ${URI_REF} Quelle: Klicken Sie hier, um den Incident anzuzeigen: ${URI_REF}

    ${URI_REF} Ausgabe: Beispiel, das zeigt, wie der angezeigte Linktext der Wert des Datensatzes ist
    • ${reference-field.URI}
    • ${reference-field.URI_REF}
    Quelle: 
    Click here to view Incident: ${URI_REF}
Click here to view Related Problem: ${problem_id.URI_REF}

    Ausgabe: Beispiel, das einen Link zu einem Datensatz zeigt, der in einem Referenzfeld aufgeführt ist
    ${CMS_URI}

    Quelle: ${CMS_URI+ess/incident_detail}

    Ausgabe: ein Link zu einer Ziel-CMS-Seite wie https://<instance name>.service-now.com/ess/incident_detail.do? sysparm_document_key=incident,46e18c0fa9fe19810066a0083f76bd56
    ${notification:body}

    Quelle: Wie eine Variable für den E-Mail-Text in einem E-Mail-Layout funktioniert.

    Ausgabe: Funktionsweise der Variable für den Link zu Benachrichtigungseinstellungen.
    ${mail_script:script-name}
    $ {NOTIF_UNSUB}
    $ {NOTIF_PREFS}