Enregistrer les enregistrements associés dans le cache hors ligne

Les administrateurs peuvent configurer le mode hors ligne pour inclure les enregistrements associés dans le cache hors ligne lorsqu’un utilisateur effectue une action en mode en ligne sur son Agent mobile.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Lorsque le mode hors connexion est activé sur votre ServiceNow instance, vous pouvez configurer son instance pour inclure des enregistrements supplémentaires dans le cache hors connexion. Ensuite, ces enregistrements supplémentaires sont disponibles lorsque l’utilisateur final est en mode hors ligne.

Important :

Cette fonctionnalité est prise en charge uniquement pour les actions d’écriture différée scriptées.

Vous devez configurer un élément d’action avant de pouvoir procéder comme suit pour enregistrer les enregistrements associés dans le cache hors connexion. Pour en savoir plus sur la configuration d’un élément d’action, reportez-vous à la rubrique Configurer les éléments d'action et les étapes d'action en mode hors ligne .

Vous devez utiliser un scripting pour configurer cette tâche, ce qui nécessite l’utilisation d’une API.

Procédure

1. Accédez à la Tout > Mobile système > Mobile App Builder.
   Générateur d'apps mobiles s'ouvre dans un onglet de navigateur séparé et affiche l'écran de sélection du périmètre de l'application.
2. Recherchez le périmètre de l'application dans lequel vous travaillez, puis sélectionnez le nom du périmètre de l'application.
   L'écran d'accueil des catégories Générateur d'apps mobiles s'affiche.
3. Sélectionnez Tous les enregistrements Mobile dans le menu.
4. Dans le champ Type d’enregistrement , sélectionnez l’élément d’action [sys_sg_write_back_action_item], puis sélectionnez l’élément d’action que vous avez créé.
5. Dans le champ Type , sélectionnez Script.
6. Dans le champ Script d’exécution , ajoutez le script de synchronisation.
   Par exemple, le script suivant crée automatiquement une tâche de commande de travaux lorsqu’une commande de travaux est créée alors que l’utilisateur final est en ligne. La tâche de commande de travaux est alors disponible pour l’utilisateur final lorsqu’il est en mode hors ligne :

   (function WriteBackAction(input) {
       //Register additional record for offline mode
       actionResult.addRecordForSync("work-order-task","ef1a8b34df113100dca6a5f59bf26327")
   })(input);

   Où « work-order-task » est la table à inclure dans la section des données du document de la réponse d’écriture différée et « ef1a8b34df113100dca6a5f59bf26327 » est la sys_id de la table.

   Remarque :

   • Cette API peut être appelée plusieurs fois pour enregistrer plusieurs enregistrements sur différentes tables ou sur la même table.
   • Pour spécifier l’enregistrement que vous souhaitez inclure dans la base de données hors connexion, utilisez le nom de table (chaîne) et le sys_id (chaîne) de l’enregistrement.
   • L’enregistrement spécifié par sys_id et ses champs associés apparaissent dans la section des données du document de la réponse d’écriture différée.
   • L’enregistrement spécifié par sys_id est ensuite synchronisé avec la base de données hors connexion.
   • Les données que vous ajoutez avec cette API doivent être encapsulées dans le document actualisé ou dans le document de destination de la réponse d’écriture différée. Pour vous assurer qu’au moins un document actualisé ou de destination est présent dans votre réponse d’écriture différée, vous pouvez configurer un écran de destination sur le bouton qui appelle cette API. Lorsque vous configurez un écran de destination sur le bouton qui invoque cette API, il est garanti que vos données seront incluses dans le document de destination.
7. Sélectionnez Enregistrer.