Benachrichtigungsvariablen

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 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}

    Der Teil variable-name 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. Um eine Verknüpfung zu einem Datensatz in Arbeitsbereichherzustellen , erstellen Sie ein E-Mail-Skript, das eine URL zu einer Benachrichtigung ausgibt. Weitere Informationen finden Sie unter wird mit einem Datensatz in verknüpft Arbeitsbereich.
    		 Ein beliebiger gültiger sysparm-URL-Parameter. 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.
    		 Ein beliebiger gültiger sysparm-URL-Parameter. 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.
    ${Kommentare:n}

    Zeigen Sie die letzten Kommentare an, die im Zieldatensatz vorgenommen wurden. Die Anzahl der anzuzeigenden Kommentare ist n. Beispiel: ${comments:3} zeigt die letzten drei Kommentare an, die an dem Datensatz vorgenommen wurden.

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

    		 Beliebige Zahl größer als 0.
    ${comments_and_work_notes:n}

    Zeigen Sie die neuesten Kommentare und Arbeitsnotizen an, die für den Zieldatensatz erstellt 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 am Datensatz vorgenommen wurden.

    Um alle Kommentare und Arbeitsnotizen anzuzeigen, verwenden Sie die Variable ${comments_and_work_notes}.

    		 Beliebige Zahl größer als 0.

    Beispiele

    Sehen Sie sich die folgenden Beispiele an, um zu sehen, 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 das Linktextwort Link 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: Funktionsweise einer Variable für den E-Mail-Text in einem E-Mail-Layout.

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