Konfiguration des Nachrichteninhalts einer Push-Benachrichtigung

Konfigurieren Sie den Inhalt von Push-Benachrichtigungsnachrichten, und wählen Sie aus, welche mobile Anwendung Benachrichtigungen erhält. Sie können Benachrichtigungen zu kritischen Warnungen konfigurieren, die Nachrichtendarstellung anpassen und den Deep-Link bestimmen, der verwendet wird, wenn Anwender 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 Push-Nachrichtan.
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.
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 anwenderdefinierten Benachrichtigungstitel hinzufügen, wird in der Benachrichtigung der standardmäßige Name der mobilen App angezeigt.

   

   In Push-Nachrichtengenerierung Skriptblock fügen Sie den folgenden Beispielcode in hinzu json Abschnitt:

   var json= {};
   var msg_title  = "System updates!";
   json= {
     "android_title" : msg_title,
     "aps": {
       "alert": {
         "title": msg_title,
       }
     }
   

   Die Elemente im Beispiel-JSON-Code lauten wie folgt:

   • Die msg_titleVariable aufgerufen System-Updates! Ist der Name des Benachrichtigungstitels, der für beide gilt iOS Und Android.
   • Der Knoten json["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 ihn zu aktivieren Android Geräte, die aktiviert werden sollen, damit Benachrichtigungen ausgelöst werden können.

   AS-Anwender verwenden beides iOS Und Android Geräte, die Sie diesen Code hinzufügen müssen. Der JSON-Eintrag im Code ist ein zurückgegebener Wörterbuchnamenwert aus dem Skripting.

   Android Bestimmte Felder, die die Nachrichtenzustellung steuern, werden unter unterstützt sncGoogleKeys. Weitere Informationen finden Sie unter Firebase Cloud Messaging-HTTP-Protokoll .

   Hinweis:

   Die priorityParameter ist auf festgelegt Hoch Zum Aufwachen Android Geräte, wenn sich ein Gerät im Ruhemodus befindet. Dieser Parameter hilft bei der Bereitstellung kritischer Warnungen an Endanwender.

   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.