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 Inhalt von Push-Benachrichtigungen zu konfigurieren, müssen Sie mit dem mobilen Deep-Link-Generator einen Deep-Link generieren. Weitere Informationen finden Sie unter Deep-Links für Mobile.

Erforderliche Rolle: Administrator

Warum und wann dieser Vorgang ausgeführt wird

Füllen Sie das Formular „Inhalt der Push-Nachricht“ aus, um:

• Benennen Sie die Benachrichtigung
• Wählen Sie die mobile App aus, an die die Benachrichtigung gesendet wird
• Passen Sie optional die Darstellung der Benachrichtigungsnachricht an
• Bestimmen Sie den Deep-Link, der verwendet wird, wenn Anwender auf die Benachrichtigung tippen

Der Inhalt der Push-Benachrichtigungsnachricht unterstützt bis zu drei zusätzliche Felder. Wenn diese Felder als optionale Textfenster verwendet werden, können die Slots Felder aus dem Quelldatensatz anzeigen.

Hinweis:

Die Text-Slots sind in der mobilen App festgelegt, sodass Sie ihren Standort oder ihre Größe nicht ändern können. Jeder Slot ist einem zugeordnet Status , Bezeichner , Und Beschreibung Innerhalb von JSON Objekt im Inhaltsskript der Push-Benachrichtigungsnachricht.

Mobile UI-Stile sind auch für zusätzliche Felder verfügbar. Weitere Informationen zum Stil finden Sie unter Stile der mobilen UI.

Prozedur

1. Navigieren zu Alle > Systembenachrichtigung > Veröffentlichen > Inhalt Pushnachrichtan.
2. Wählen Sie Neu.
3. Füllen Sie im Formular „Inhalt der Push-Nachricht“ die folgenden Felder aus:

   Tabelle : 1. Inhaltsformular für Push-Nachricht

   Feld	Beschreibung
   Name	Zeichenfolgenwert für diesen Datensatz. Hinweis: Dieser Name ist in der Benachrichtigung nicht sichtbar. Er ist nur eine Referenz zur Verwendung während der Konfiguration.
   Push-App	Verweist auf die mobile App, an die Sie eine Benachrichtigung senden möchten. Verwenden ServiceNow Mobile Anwendung für Mobile Agent. Verwenden ServiceNow Antrag für anfordern Now Mobile-App.
   Push-Nachricht-Generation	Der Skriptblock, der den Benachrichtigungslink enthält. Im Skriptblock JSON Objekt muss einen Link und zurückgeben Link Schlüssel muss vorhanden sein. Der Schlüssel muss über einen entsprechenden Deep-Link-Wert verfügen, der über den mobilen Deep-Link-Generator generiert wird.

   Dieses Beispiel zeigt das ausgefüllte Formular und ein JSON Objekt mit dem entsprechenden Link Schlüssel und entsprechender Deep-Link-Wert.
4. Wahlweise: Fügen Sie dem Benachrichtigungsinhalt zusätzliche Felder hinzu, z. B. ein Textfenster.

   In Generierung Von Push-Nachrichten Skriptblock: Erstellen Sie ein Layoutfeldobjekt für jedes Feld.

   1. Instanziieren Sie ein Benachrichtigungslayoutobjekt.

      var layoutGen = new global.NotificationLayoutFieldGenerator();

   2. Verwenden Sie das Benachrichtigungslayout-Skript, und fügen Sie den globalen Anwendungsbereich hinzu, um Layoutfelder zu generieren.
      Weitere Informationen zu Skripteinbindungen finden Sie unter Skripteinbindungen .

      Hinweis:

      Ändern Sie die Skripteinbindung des Benachrichtigungslayout-Generators nicht.
   3. Erstellen Sie das Layoutfeld.
      Jedes Layoutfeld erfordert einen Tabelle , Sys_Id , Und Spalte .

      Hinweis:

      Die Tabelle Und Sys_Id Werte müssen direkt aus dem aktuellen Datensatz mit stammen Current.getTableName() Und Aktuelle.sys_ID . Die Spalte Der Wert muss für die gewünschte Tabelle vorhanden sein und genau mit dem Namen der Wörterbuchspalte übereinstimmen.

      var text_01 = layoutGen.layoutField(current.getTableName(), current.sys_id, "priority");

   4. Übergeben Sie die Layoutfelder an das Original JSON Objekt als anderes Objekt.

      Die mobilen Anwendungen hören auf optionale Layout Schlüssel, bei dem es sich um ein Objekt handelt, das die gewünschten zusätzlichen Felder enthält. In Layout Objekt, ordnen Sie jedes zusätzliche Feld zu Status , Bezeichner , Oder Beschreibung Schlüssel. Das folgende Beispiel ist als Referenz verfügbar.

      (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 anwenderdefinierten Benachrichtigungstitel hinzu.
   Wenn Sie keinen anwenderdefinierten Benachrichtigungstitel hinzufügen, zeigt die Benachrichtigung den standardmäßigen Namen der mobilen App an.

   

   In Generierung Von Push-Nachrichten 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 Inhaltsdatensatz für Push-Benachrichtigungen erstellt, der einen Deep-Link enthält.

Nächste Maßnahme

Nach der Konfiguration des Inhalts von Push-Benachrichtigungsnachrichten muss er mit einem Datensatz für Push-Benachrichtigungsnachrichten gekoppelt werden. Weitere Informationen zum Konfigurieren einer Push-Benachrichtigungsnachricht finden Sie unter Nachricht einer Push-Benachrichtigung konfigurieren.