Konfiguration des Nachrichteninhalts einer Push-Benachrichtigung

Konfigurieren Sie den Inhalt von Push-Benachrichtigungen, und wählen Sie aus, welche mobile Anwendung Benachrichtigungen erhält. Sie können Benachrichtigungen zu kritischen Warnungen konfigurieren, die Darstellung von Nachrichten anpassen und den verwendeten Deep-Link festlegen, 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 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.
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 Name der Standard-Mobile-App angezeigt.

   

   Fügen Sie im Skriptblock „Generierung von Push-Nachrichten “ im Abschnitt „ json “ den folgenden Beispielcode hinzu:

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

   Der JSON-Beispielcode enthält folgende Elemente:

   • Die Variable msg_title mit der Bezeichnung Systemupdates! ist der Name des Benachrichtigungstitels, 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 für den Aktivierungsmodus zu aktivieren, 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 Wörterbuchnamenwert aus dem Skripting.

   Android spezifische Felder, die die Nachrichtenzustellung steuern, werden unter sncGoogleKeysunterstützt. Weitere Informationen hierzu finden Sie unter HTTP-Protokoll für Firebase-Cloud-Messaging.

   Hinweis:

   Der Parameter priority wird auf „ Hoch “ festgelegt, um Android -Geräte zu aktivieren, wenn sich ein Gerät im Ruhemodus befindet. Dieser Parameter hilft bei der Übermittlung 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.