Konfiguration des Nachrichteninhalts einer Push-Benachrichtigung

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer

    • Konfigurieren Sie den Nachrichteninhalt von Push-Benachrichtigungen, und wählen Sie aus, welche Mobile-Anwendung Benachrichtigungen erhält. Sie können Benachrichtigungen für kritische Warnungen konfigurieren, die Darstellung von Nachrichten anpassen und den Deep-Link festlegen, der verwendet wird, wenn Benutzer auf die Benachrichtigung tippen.

    Vorbereitungen

    Um den Nachrichteninhalt von Push-Benachrichtigungen zu konfigurieren, müssen Sie mit dem Mobile Deep Link Generator einen Deep-Link generieren. Weitere Informationen finden Sie unter Deep-Links für Mobile.

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Füllen Sie das Formular „Inhalt von Pushnachrichten“ aus, um:

    • Der Benachrichtigung einen Namen zu geben
    • Auszuwählen, an welche Mobile-App die Benachrichtigung gesendet wird
    • Optional das Erscheinungsbild der Benachrichtigung anzupassen
    • Festzulegen, welcher Deep-Link verwendet wird, wenn Benutzer auf die Benachrichtigung tippen
    Für den Nachrichteninhalt von Push-Benachrichtigungen werden bis zu drei zusätzliche Felder unterstützt. Wenn diese Felder als optionale Textslots dienen, können dort Felder aus dem Quelldatensatz angezeigt werden.
    Hinweis:
    Die Textslots sind in der Mobile-App unverändlich. Ihr Standort und ihre Größe sind nicht veränderbar. Jeder Slot wird im Skript mit dem Nachrichteninhalt der Push-Benachrichtigung innerhalb des JSON-Objekts einem Status, einem Bezeichner und einer Beschreibung zugeordnet.

    Für diese zusätzlichen Felder stehen ebenfalls die Stile der mobilen Anwenderoberfläche zur Verfügung. Weitere Informationen zu Stilen finden Sie unter Mobile UI-Stile.

    Prozedur

    1. Navigieren zu Alle > Systembenachrichtigung > Veröffentlichen > Inhalt Pushnachricht.
    2. Wählen Sie Neu.
    3. Füllen Sie im Formular „Inhalt von Pushnachrichten“ folgende Felder aus:
      Tabelle : 1. Formular „Inhalt von Pushnachrichten“
      Feld Beschreibung
      Name Zeichenfolgewert für diesen Datensatz.
      Hinweis:
      Dieser Name ist in der Benachrichtigung nicht sichtbar, er dient nur als Referenz bei der Konfiguration.
      Push-App Verweist auf die Mobile-App, an die Sie eine Benachrichtigung senden möchten.
      • Verwenden Sie die Anwendung ServiceNow Mobile für Mobile Agent.
      • Verwenden Sie die Anwendung ServiceNow Request für Now Mobile-App.
      Push-Nachricht-Generation Skriptblock, der den Benachrichtigungslink enthält. Im Skriptblock muss das JSON-Objekt einen Link zurückgeben, und es muss ein Schlüssel Link vorhanden sein. Der Schlüssel muss einen entsprechenden Deep-Link-Wert besitzen, der mit dem Mobile Deep Link Generator generiert wird.
      Dieses Beispiel zeigt das ausgefüllte Formular und ein JSON-Objekt mit dem entsprechenden Schlüssel Link und einem entsprechenden Deep-Link-Wert.Formular „Inhalt von Pushnachrichten“, mit allen Feldern ausgefüllt und einem Beispiel für einen Deep-Link, der durch den Schlüssel Link angegeben wird.
    4. Wahlweise: Fügen Sie dem Inhalt der Benachrichtigung zusätzliche Felder hinzu, z. B. einen Textslot.

      Erstellen Sie im Skriptblock Push-Nachricht-Generation für jedes Feld ein Layoutfeldobjekt.

      1. Instanziieren Sie ein Benachrichtigungslayoutsobjekt. 
        var layoutGen = new global.NotificationLayoutFieldGenerator();
      2. Verwenden Sie das Benachrichtigungslayoutskript, und beziehen Sie den globalen Anwendungsbereich ein, um Layoutfelder zu generieren.
        Weitere Informationen zu Skripteinbindungen finden Sie unter Skripteinbindungen.
        Hinweis:
        Ändern Sie nicht die Skripteinbindung zur Generierung des Benachrichtigungslayouts.
      3. Erstellen Sie das Layoutfeld.
        Für jedes Layoutfeld sind eine Tabelle, eine Sys_Id und eine Spalte erforderlich.
        Hinweis:
        Die Werte für die Tabelle und die Sys_Id werden mit current.getTableName() und current.sys_id direkt aus dem aktuellen Datensatz übernommen. Der Wert für die Spalte muss für die gewünschte Tabelle vorhanden sein und genau mit dem Spaltennamen im Wörterbuch übereinstimmen.
        var text_01 = layoutGen.layoutField(current.getTableName(), current.sys_id, "priority");
      4. Übergeben Sie die Layoutfelder als weiteres Objekt an das ursprüngliche JSON-Objekt.

        Die Mobile-Anwendungen lauschen auf den optionalen Schlüssel Layout. Hierbei handelt es sich um ein Objekt, das die gewünschten zusätzlichen Felder enthält. Verbinden Sie im Objekt Layout jedes zusätzliche Feld mit einem der Schlüssel Status, Identifier, oder Description. Das folgende Beispiel dient zur Veranschaulichung.

        (function buildJSON( /*GlideRecord*/ current, /*String*/ message, /*Object*/ attributes) { 

    var layoutGen = new global.NotificationLayoutFieldGenerator(); 
    var text_01 = layoutGen.layoutField(current.getTableName(), current.sys_id, "priority"); 
    var text_02 = layoutGen.layoutField(current.getTableName(), current.sys_id, "state"); 
    var text_03 = layoutGen.layoutField(current.getTableName(), current.sys_id, "short_description"); 

    var deepLinkGenerator = new global.MobileDeepLinkGenerator("Request"); 
    var link = deepLinkGenerator.getFormScreenLink("b71040b1533a33007bc2ddeeff7b1221", current.getTableName(), current.getValue("sys_id")); 

    var json = { 

        "Link": link, 

        "Layout": { 

            "Status": text_01, 

            "Identifier": text_02, 

            "Description": text_03 

        } 

    }; 

    return json;

})(current, message, attributes);
    5. Wahlweise: Fügen Sie einen benutzerdefinierten Benachrichtigungstitel hinzu.
      Wenn Sie keinen benutzerdefinierten Benachrichtigungstitel hinzufügen, zeigt die Benachrichtigung den Standardnamen der Mobile-App an.
      Bild, das den Unterschied zwischen einem Standardbenachrichtigungstitel, der den Namen der Mobile-App anzeigt, und einem benutzerdefinierten Titel, der die Benachrichtigung beschreibt, zeigt.

      Fügen Sie im Skriptblock Push-Nachricht-Generierung im Abschnitt json den folgenden Beispielcode hinzu:

      var json= {};
var msg_title  = "System updates!";
json= {
  "android_title" : msg_title,
  "aps": {
    "alert": {
      "title": msg_title,
    }
  }
      Die Elemente im JSON-Beispielcode lauten wie folgt:
      • Die Variable msg_title mit dem Namen Systemupdates! ist der Benachrichtigungstitelname, der sowohl für iOS als auch für Androidgilt.
      • Der Knotenjson["android_title"] ist die Variable für Android.
      • Der Knoten json["aps"]["alert"]["title"] ist die Variable für iOS.
    6. Fügen Sie den folgenden Code hinzu, um Android Geräte so zu aktivieren, dass sie aktiviert werden, damit Benachrichtigungen ausgelöst werden können.

      Da Benutzer sowohl iOS - als auch Android -Geräte verwenden, müssen Sie diesen Code hinzufügen. Der JSON-Eintrag im Code ist ein zurückgegebener Dictionary-Namenswert aus der Skripterstellung.

      Android spezifische Felder, die die Nachrichtenzustellung steuern, werden unter sncGoogleKeysunterstützt. Weitere Informationen finden Sie unter Firebase Cloud Messaging HTTP-Protokoll.
      Hinweis:
      Der Parameter priority wird auf „ Hoch “ gesetzt, um Android Geräte zu aktivieren, wenn sich ein Gerät im Energiesparmodus befindet. Dieser Parameter hilft bei der Übermittlung kritischer Warnungen an Endbenutzer.
      json["sncGoogleKeys"] = {
    "priority": "high",
    "android": {
      "priority": "high"
    }
}
    7. Wählen Sie Aktualisieren.

    Ergebnisse

    Sie haben einen Nachrichteninhaltsdatensatz für eine Push-Benachrichtigung erstellt, der einen Deep-Link enthält.

    Nächste Maßnahme

    Nach der Konfiguration des Nachrichteninhalts der Push-Benachrichtigung muss dieser mit einem Nachrichtendatensatz für die Push-Benachrichtigung gekoppelt werden. Weitere Informationen zur Konfiguration der Nachricht einer Push-Benachrichtigung finden Sie unter Nachricht einer Push-Benachrichtigung konfigurieren.