Configurer le contenu du message de notification push

Configurez le contenu des messages de notification push et sélectionnez l’application mobile qui reçoit les notifications. Vous pouvez configurer les notifications d’alerte critique, personnaliser l’apparence du message et déterminer le lien profond utilisé lorsque les utilisateurs appuient sur la notification.

Avant de commencer

Pour configurer le contenu du message de notification push, vous devez générer un lien profond à l'aide du générateur de liens profonds mobile. Pour plus d’informations, voir Liens profonds pour mobile.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Remplissez le formulaire Contenu du message push pour :

• donner un nom à la notification ;
• sélectionner l'application Mobile vers laquelle envoyer la notification ;
• personnaliser éventuellement l'apparence du message de notification ;
• déterminer le lien profond utilisé lorsque les utilisateurs appuient sur la notification.

Le contenu du message de notification push prend en charge jusqu'à trois champs supplémentaires. Si ces champs sont utilisés en tant qu'emplacements de texte facultatifs, ces derniers peuvent afficher des champs à partir de l'enregistrement source.

Remarque :

les emplacements de texte sont fixes sur l'application Mobile ; vous ne pouvez donc pas changer leur localisation ni leur taille. Chaque emplacement est mappé à un élément Status, Identifier et Description dans l'objet JSON du script de contenu du message de notification push.

Des styles d'interface utilisateur mobile sont également disponibles pour les champs supplémentaires. Pour obtenir plus d'informations sur l'application d'un style, consultez Styles d’interface utilisateur Mobile.

Procédure

1. Accédez à la Tous > Notification système > Transmettre par push > Contenu du message push.
2. Sélectionnez Nouveau.
3. Remplissez les champs suivants du formulaire Contenu du message push :

   Tableau 1. Formulaire Contenu du message push

   Champ	Description
   Nom	Valeur de chaîne pour cet enregistrement. Remarque : ce nom n'est pas visible dans la notification, il ne s'agit que d'une référence à utiliser pendant la configuration.
   Application push	Fait référence à l'application Mobile vers laquelle vous souhaitez envoyer une notification. Utilisez ServiceNow Mobile Application pour Agent mobile. Utilisez ServiceNow Request Application pour Application Now Mobile.
   Génération de messages push	Le bloc de script qui contient le lien de notification. Dans le bloc de script, l'objet JSON doit renvoyer un lien et une clé Link doit exister. La clé doit avoir une valeur de lien profond correspondante, créée via le générateur de liens profonds mobiles.

   Cet exemple montre le formulaire rempli et un objet JSON avec la clé Link appropriée et une valeur de lien profond correspondante.
4. Facultatif : Ajoutez des champs supplémentaires au contenu de la notification, tels qu'un emplacement de texte.

   Dans le bloc de script Génération de messages push, créez un objet de champ de mise en page pour chaque champ.

   1. Instanciez un objet de mise en page de notification.

      var layoutGen = new global.NotificationLayoutFieldGenerator();

   2. Utilisez le script de mise en page de notification et incluez le périmètre global de l'application pour générer des champs de mise en page.
      Pour en savoir plus sur les includes de script, consultez Includes de script.

      Remarque :

      ne modifiez pas le script include du générateur de mises en page de notification.
   3. Créez le champ de mise en page.
      Chaque champ de mise en page nécessite un élément Table, Sys_Id et Column.

      Remarque :

      les valeurs Table et Sys_Id doivent provenir directement de l'enregistrement actuel en utilisant current.getTableName() et current.sys_id. La valeur Column doit exister pour la table souhaitée et correspondre exactement au nom de colonne du dictionnaire.

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

   4. Transmettez les champs de mise en page dans l'objet JSON d'origine comme un autre objet.

      Les applications Mobile écoutent la clé Layout facultative, qui est un objet qui contient les champs supplémentaires souhaités. Dans l'objet Layout, associez chaque champ supplémentaire aux clés Status, Identifier ou Description. L'exemple suivant est disponible en tant que référence.

      (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. Facultatif : Ajoutez un titre de notification personnalisé.
   Si vous n’ajoutez pas de titre de notification personnalisé, la notification affiche le nom de l’application mobile par défaut.

   

   Dans le bloc de script Génération de message push , ajoutez l’exemple de code suivant dans la section JSON :

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

   Les éléments de l’exemple de code JSON sont les suivants :

   • La msg_title variable intitulée Mises à jour système ! est le nom du titre de la notification qui s’applique à la fois à et iOSAndroid.
   • Le nœudjson["android_title"] est la variable pour Android.
   • Le nœud json["aps"]["alert"]["title"] est la variable pour iOS.
6. Ajoutez le code suivant pour activer Android les appareils pour qu’ils se réveillent, afin que les notifications puissent être déclenchées.

   Comme les utilisateurs utilisent les deux iOS appareils and Android , vous devez ajouter ce code. L’entrée JSON dans le code est une valeur de nom de dictionnaire renvoyée par le scripting.

   Android Les champs spécifiques qui contrôlent la remise des messages sont pris en charge dans .sncGoogleKeys Pour plus d’informations, consultez Protocole HTTP Firebase Cloud Messaging.

   Remarque :

   Le priority paramètre est réglé sur élevé pour réveiller les Android appareils, si un appareil est en mode veille. Ce paramètre permet de transmettre les alertes critiques aux utilisateurs finaux.

   json["sncGoogleKeys"] = {
       "priority": "high",
       "android": {
         "priority": "high"
       }
   }
   

7. Sélectionnez Mettre à jour.

Résultats

Vous avez créé un enregistrement de contenu de message de notification push qui contient un lien profond.

Que faire ensuite

Après avoir configuré le contenu du message de notification push, il doit être associé à un enregistrement de message de notification push. Pour obtenir plus d'informations sur la configuration d'un message de notification push, consultez Configurer un message de notification push.