Inscrire 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 leur Agent mobilefichier .

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Lorsque le mode hors ligne est activé sur votre ServiceNow instance, vous pouvez configurer son instance pour inclure des enregistrements supplémentaires dans le cache hors ligne. 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 utiliser les étapes suivantes pour inscrire les enregistrements associés dans le cache hors ligne. Pour plus d’informations sur la configuration d’un élément d’action, reportez-vous à la section 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 Tous > Mobile système > Générateur d'application mobile.
   Générateur d'application mobile 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'application mobile s'affiche.
3. Sélectionnez Tous les enregistrements Mobile dans le menu.
4. Dans le champ Type d’enregistrement , sélectionnez É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 de document de la réponse d’écriture différée et « ef1a8b34df113100dca6a5f59bf26327 » est le sys_id sur 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 ligne, 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 s’affichent dans la section 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 ligne.
   • 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 appelle cette API, vos données sont garanties d’être incluses dans le document de destination.
7. Sélectionnez Enregistrer.