Activer ou désactiver l'actualisation automatique des applications

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture
  • Utilisez la propriété mobile clientRefresh sur votre instance ServiceNow pour activer ou désactiver l'actualisation automatique de vos applications mobiles. Vous pouvez également utiliser cette clientRefresh propriété pour ajuster la portée de l’actualisation sur votre application mobile.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    La clientRefresh propriété mobile est activée par défaut sur le serveur de plateforme ServiceNow . Les applications mobiles gérées par San Diego et les versions ultérieures de l’instance serveur s’actualisent automatiquement après qu’un utilisateur final a exécuté des éléments d’action qui modifient les données dans les enregistrements. Le changement de données est immédiatement visible par l’utilisateur. Les utilisateurs n’ont pas besoin d’actualiser leurs applications mobiles. L’image Nouvelle mise à jour ne semble plus inviter à une actualisation de l’application lorsque cette fonctionnalité est activée. Cette fonctionnalité n’a aucun impact sur les performances de l’application mobile. Les applications mobiles actualisent uniquement les écrans qui ont été visités précédemment. Si vous souhaitez désactiver ce comportement, suivez les étapes décrites dans cette tâche.

    Les propriétés mobiles sont configurées sous forme d’enregistrements dans la table sys_sg_properties sur le serveur de ServiceNow plateforme. L’instance ServiceNow envoie la propriété mobile aux applications mobiles après authentification. Ensuite, la propriété active ou désactive une fonctionnalité sur l’application mobile. La clientRefresh propriété mobile est configurée à l’aide de scripts JSON.

    La clientRefresh propriété est un objet JSON avec deux clés : isEnabled et refreshScope, qui sont décrites dans le formulaire Nouvel enregistrement des propriétés mobiles.
    Important :
    À partir de la San Diego version du serveur, pour désactiver le ServiceNow comportement d’actualisation, vous devez créer un nouvel objet JSON clientRefresh et définir la clé isEnabled sur false dans la définition de propriété mobile.

    Procédure

    1. Accédez à la Tous > sys_sg_properties.liste.
      La liste Propriétés mobiles s’affiche.
    2. Dans la liste Propriétés mobiles, sélectionnez Nouveau.
      Le formulaire Propriétés mobiles s’affiche.
    3. Remplissez les champs du formulaire.
      Tableau 1. Propriétés mobiles : nouveau formulaire d’enregistrement
      Champ Description
      Nom Nom de l'enregistrement de propriété mobile. Entrez clientRefresh pour rendre la fonctionnalité d’actualisation automatique de l’application configurable. Bien que cette fonctionnalité soit activée par défaut, vous devez la créer pour la configurer. Il n’est pas visible sur l’instance tant que vous ne l’avez pas créé.
      Remarque :
      Le nom de l’enregistrement est sensible à la casse et doit être saisi comme clientRefresh.
      Application Périmètre de l'application dans lequel la propriété mobile est appliquée. Pour sélectionner un autre périmètre de l’application, sélectionnez l’icône en forme de globe ( icône de globe.) sur la bannière de l’instance. Sélectionnez ensuite le périmètre de l’application :application_scope.

      Pour en savoir plus sur la façon dont les propriétés mobiles sont affectées par le périmètre de l’application, reportez-vous à la section Propriétés mobiles.

      Description Description de la propriété mobile. Saisissez une description de la propriété. Par exemple, active ou désactive l’actualisation automatique des données d’instance pour les applications mobiles.
      Type Type de données de l'enregistrement de propriété mobile. Vous devez sélectionner JSON pour la clientRefresh propriété mobile.
      Valeur Code JSON qui configure cette fonctionnalité.
      • Pour désactiver la fonctionnalité, entrez les éléments suivants :
        {"isEnabled":false,"refreshScope":"all_tabs"}
      • Pour activer la fonctionnalité, entrez les éléments suivants :
        {"isEnabled":true,"refreshScope":"all_tabs"}
      • Pour élargir le champ d’application des données actualisées, entrez les éléments suivants :
        {"isEnabled":true,"refreshScope":"all_tabs"}

        L’utilisation de « all_tabs » actualise tous les écrans dans tous les onglets de la barre de navigation après l’exécution d’une action dans l’application mobile qui modifie les données d’un enregistrement.

      • Pour limiter le périmètre des données actualisées, entrez les éléments suivants :
        {"isEnabled":true,"refreshScope":"current_tab"}

        L’utilisation de « current_tab » actualise uniquement l’onglet de la barre de navigation actuelle après l’exécution d’une action dans l’application mobile.

      Remarque :
      Utilisez un formateur/validateur JSON pour vous assurer qu’il n’y a pas de problèmes de syntaxe.
      Actives Option permettant d’activer la propriété mobile. Si la case à cocher est décochée, la propriété mobile n'est pas activée pour l'utilisation.
      Est public

      Détermine si la propriété est incluse dans la pre_auth réponse API.

      Cette option n'est pas sélectionnée par défaut. Si vous souhaitez que cette propriété soit incluse dans la /pre_auth réponse API, cochez cette case. Pour plus d'informations, consultez Adaptive authentication events.

      Les propriétés mobiles pour lesquelles cette case est cochée sont exclues de la /user_client réponse API.

      Configuration d'application mobile Configuration d’application mobile pour laquelle vous souhaitez utiliser la propriété mobile. Ce paramètre limite le comportement de la propriété mobile aux utilisateurs qui peuvent accéder à cette configuration d’application mobile. Les autres utilisateurs n'ont pas accès à cette propriété mobile et expérimentent le comportement par défaut.

      Pour entrer une valeur, commencez à saisir le nom de la configuration ou sélectionnez l’icône de recherche. La boîte de dialogue de recherche répertorie les configurations que vous pouvez choisir. Sélectionnez une configuration dans la boîte de dialogue Configurations de l’application mobile.

      Application mobile Application mobile à laquelle vous souhaitez envoyer la propriété mobile. Ce paramètre limite le comportement de la propriété mobile aux utilisateurs qui ont accès à cette application mobile. Les autres utilisateurs n'ont pas accès à cette propriété mobile et expérimentent le comportement par défaut.

      Pour entrer une valeur, commencez à saisir le nom de l’application ou sélectionnez l’icône de recherche. La boîte de dialogue de recherche répertorie les applications que vous pouvez choisir. Sélectionnez une application dans la boîte de dialogue Applications mobiles.

    4. Sélectionnez Envoyer.

    Que faire ensuite

    Après la mise à jour de cette propriété, l’utilisateur final doit effectuer une opération pull pour actualiser et obtenir les dernières configurations de fonctionnalités.