Benachrichtigungsvariablen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 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 mit 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 neuesten Kommentare an, die am Zieldatensatz vorgenommen wurden. Die Anzahl der anzuzeigenden Kommentare beträgt n. Beispielsweise zeigt ${comments:3} 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 im Zieldatensatz vorgenommen 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 an den Datensatz angehängt wurden.

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

    		 Beliebige Zahl größer als 0.

    Beispiele

    In den folgenden Beispielen können Sie sehen, wie die einzelnen Benachrichtigungsvariablen in der Ausgabe gerendert werden:
    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: Variable für Benachrichtigungsbild
    • ${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 Variable für den Link zu den Benachrichtigungseinstellungen.
    ${mail_script:script-name}
    $ {NOTIF_UNSUB}
    $ {NOTIF_PREFS}