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’alertes critiques, 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 des messages de notification push, vous devez générer un lien profond à l’aide du générateur de liens profonds mobiles. Pour plus d'informations, consultez Liens profonds pour mobile.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Remplissez le formulaire Contenu du message push pour :

• Attribuer un nom à la notification
• Sélectionnez l’application mobile à laquelle la notification est envoyée
• Personnaliser éventuellement l’apparence du message de notification
• Déterminer le lien profond utilisé lorsque les utilisateurs appuient sur la notification

Le contenu des messages de notification push prend en charge jusqu’à trois champs supplémentaires. Si ces champs sont utilisés comme emplacements de texte facultatifs, ils peuvent afficher des champs de l’enregistrement source.

Remarque :

Les emplacements de texte sont fixes sur l’application mobile, vous ne pouvez donc pas modifier leur emplacement ou leur taille. Chaque emplacement est mappé à un état, un identificateur et une description à l’intérieur de l’objet JSON dans le script de contenu du message de notification push.

Les styles d’interface utilisateur mobile sont également disponibles pour les champs supplémentaires. Pour plus d’informations sur le style, reportez-vous à la section 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. Dans le formulaire Contenu du message push, renseignez les champs suivants :

   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 s’agit uniquement d’une référence à utiliser lors de la configuration.
   Application push	Référence l’application mobile à laquelle vous souhaitez envoyer une notification. Utiliser ServiceNow Mobile l’application pour Agent mobile. Utilisez l’application ServiceNow de demande pour Application Now Mobile.
   Génération de messages push	Bloc de script qui contient le lien de notification. Dans le bloc de script, l’objet JSON doit renvoyer un lien et une clé de lien doit exister. La clé doit avoir une valeur de lien profond correspondante générée par le générateur de lien profond mobile.

   Cet exemple montre le formulaire rempli et un JSON objet avec la clé de lien 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 du message 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 de l’application global pour générer les 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 mise en page de notification.
   3. Créez le champ de mise en page.
      Chaque champ de mise en page nécessite une table, un Sys_Id et une colonne.

      Remarque :

      Les valeurs Table et Sys_Id doivent provenir directement de l’enregistrement actuel à l’aide de current.getTableName() et current.sys_id. La valeur Colonne 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 d’origine JSON en tant qu’autre objet.

      Les applications mobiles écoutent la clé de mise en page facultative, qui est un objet contenant les champs supplémentaires souhaités. Dans l’objet Mise en page , associez chaque champ supplémentaire aux clés État, Identificateur ou Description . L’exemple suivant est disponible à titre de 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 du 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 System updates ! est le nom du titre de la notification qui s’applique à la fois à et iOSAndroid.
   • Lenœud json["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 des 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 le 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 des 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 plus d’informations sur la configuration d’un message de notification push, reportez-vous à la section Configurer un message de notification push.