Activer ou désactiver l'actualisation automatique des applications

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 la propriété clientRefresh pour ajuster le champ d'application de l'actualisation sur votre application mobile.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    La propriété mobile clientRefresh est activée par défaut sur le serveur de la plateforme ServiceNow. Les applications mobiles gérées par la version San Diego et les versions ultérieures de l'instance du serveur s'actualisent automatiquement après qu'un utilisateur final exécute 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. Lorsque cette fonctionnalité est activée, l'image Nouvelle mise à jour n'apparaît plus pour inviter l'utilisateur à actualiser une application. Cette fonctionnalité n'a aucun impact sur les performances de l'application mobile. Les applications mobiles actualisent uniquement les écrans qui ont déjà été visités. Si vous souhaitez désactiver ce comportement, suivez les étapes décrites dans cette tâche.

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

    La propriété clientRefresh est un objet JSON avec deux clés : isEnabled et refreshScope, qui sont décrites dans le formulaire de nouvel enregistrement Propriétés mobiles.
    Important :
    À partir de la version San Diego du serveur ServiceNow, pour désactiver le comportement d'actualisation, vous devez créer un 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 Tout > 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. Renseignez les champs du formulaire.
      Tableau 1. Formulaire de nouvel enregistrement Propriétés mobiles
      Champ Description
      Nom Nom de l'enregistrement de propriété mobile. Saisissez 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. Elle n'est pas visible sur l'instance tant que vous ne l'avez pas créée.
      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 périmètre d'application différent, sélectionnez l'icône de globe ( icône de globe.) sur la bannière de l'instance. Ensuite, sélectionnez Périmètre de l'application :application_scope.

      Pour en savoir plus sur l'affectation des propriétés mobiles par le périmètre de l'application, reportez-vous à la rubrique 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 Mobile.
      Type Type de données de l'enregistrement de propriété mobile. Vous devez sélectionner JSON pour la propriété mobile clientRefresh.
      Valeur Code JSON qui configure cette fonctionnalité.
      • Pour désactiver la fonctionnalité, saisissez le code suivant :
        {"isEnabled":false,"refreshScope":"all_tabs"}
      • Pour activer la fonctionnalité, saisissez le code suivant :
        {"isEnabled":true,"refreshScope":"all_tabs"}
      • Pour augmenter le champ d'application des données actualisées, saisissez le code suivant :
        {"isEnabled":true,"refreshScope":"all_tabs"}

        L'utilisation de "all_tabs" actualise tous les écrans de tous les onglets de 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 champ d'application des données actualisées, saisissez le code suivant :
        {"isEnabled":true,"refreshScope":"current_tab"}

        L'utilisation de "current_tab" actualise uniquement l'onglet de barre de navigation actuel 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 aucun problème de syntaxe.
      Actifs 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.
      Configuration d'application mobile Configuration de l'application mobile pour laquelle vous souhaitez utiliser la propriété mobile. Ce paramètre limite le comportement des propriétés mobiles aux utilisateurs qui ont accès à 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 d'application mobile.

      Application mobile Application mobile vers 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 avoir mis à jour cette propriété, l'utilisateur final doit effectuer une opération Pull pour actualiser et obtenir les dernières configurations de fonctionnalités.