--- sourceDocument: Configuration et navigation mobiles Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/mobile Release : - yokohama ft:locale : - fr-FR ft:publication_title : - Configuration et navigation mobiles Yokohama ft:clusterId : - mobile bundleId : - mobile workflow : - evelopment, Data and Analytics --- # Configurer le contenu du message de notification push # Configurer le contenu du message de notification push {#ariaid-title1} * Rversion finale: Yokohama * * Mis à jour 30 janv. 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture 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](https://servicenow-prod.fluidtopics.net/mRKHGTN0nfj08HYKbRXt~A "Les liens profonds mobiles sont des formats de lien qui dirigent les utilisateurs vers un contenu et des emplacements spécifiques dans une application mobile. Ces liens peuvent être placés dans des notifications par e-mail, des messages texte, des notifications push, des écrans de lanceur et des écrans de formulaire d’entrée. Vous pouvez également configurer une URL de connexion à l’application mobile pour plusieurs fournisseurs d’identité SSO."). 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 {#config-push-notification-message-content__ul_nmt_pf2_zpb} 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](https://servicenow-prod.fluidtopics.net/WcQuevlvAqR2GbHpnOG0Jw "Les styles d’interface utilisateur définissent la police et la couleur d’arrière-plan des champs dans vos applets."). ## Procédure 1. Accédez à TousNotification systèmeTransmettre par pushContenu du message push. 2. Sélectionnez Nouveau. 3. Dans le formulaire Contenu du message push, renseignez les champs suivants : {#config-push-notification-message-content__table_fbr_1vm_5pb__entry__2} | 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. {#config-push-notification-message-content__ul_ek3_nvm_5pb} | | 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. | [Tableau 1. Formulaire Contenu du message push] {#config-push-notification-message-content__table_fbr_1vm_5pb} 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](https://www.servicenow.com/docs/access?context=c_ScriptIncludes&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US). 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); {#config-push-notification-message-content__substeps_vdb_dxm_5pb} 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. * Le`nœud json["android_title"]` est la variable pour Android. * Le nœud `json["aps"]["alert"]["title"]` est la variable pour iOS. {#config-push-notification-message-content__ul_zpp_ztj_d1c} 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](https://firebase.google.com/docs/cloud-messaging/http-server-ref#downstream-http-messages-json). 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](https://servicenow-prod.fluidtopics.net/nt7DXvzyK0SNuD~bDAB_2g "Configurez le message affiché aux utilisateurs lorsqu’ils reçoivent leur notification push.").