Résoudre les problèmes courants dans les résultats de script de migration Mobile

Trouvez des solutions à des problèmes courants suite à l’exécution du script de migration Mobile.

Consigner les messages d’erreur

Le script de migration mobile ajoute des entrées à la table Journal [syslog] lorsqu’il rencontre une erreur. Vous pouvez consulter ces journaux en accédant à Journaux Système > Journal système > Tous. Voici les erreurs que le script de migration mobile peut ajouter aux journaux.

Tableau 1. Messages d'erreur

Message d'erreur	Résolution
Champ d’application d’instance fourni non valide	Si ce message s’affiche, cela signifie que le script de migration a été abandonné. Exécutez à nouveau le script de migration pour terminer la migration. Vous pouvez réexécuter le script de migration en le rouvrant Studio et en sélectionnant le champ d’application.
Veuillez d’abord activer com.glide.mobile-employee avant la migration.	Le ServiceNow module d’extension Écrans de l’application NowMobile et lanceur d’applet [com.glide.mobile-employee] doit être actif pour exécuter le script de migration. Assurez-vous que ce module d’extension est actif. Si ce message s’affiche, cela signifie que le script de migration a été abandonné. Exécutez à nouveau le script de migration pour terminer la migration.
Impossible d’effectuer la tâche de migration sur l’enregistrement personnalisé.	L’enregistrement à l’origine de cette erreur apparaît immédiatement après ce message. Une personnalisation de cet enregistrement a empêché le script de migration de modifier ce fichier. Le script de migration ignore ce fichier et continue de s’exécuter. Le fichier nommé est inaccessible dans Studio.

Collisions

Des collisions peuvent se produire dans les applications du système de base que vous avez personnalisées avant la mise à niveau vers des New York versions ultérieures. Si le script de migration détecte des collisions, il vous invite à les examiner une fois l’exécution du script terminée.

Cliquez sur le bouton Afficher les collisions pour afficher une liste filtrée des enregistrements de détails de mise à niveau [sys_upgrade_history_log]. Cette liste affiche les enregistrements dans le champ d’application actuel que le processus de mise à niveau a ignorés. Pour résoudre un conflit, cliquez sur un enregistrement de cette liste pour l’ouvrir, puis cliquez sur le bouton Résoudre les conflits .

Le formulaire Résoudre des conflits affiche la version du système de base de l’enregistrement en même temps que la version personnalisée. Les champs qui diffèrent d’une version à l’autre sont mis en surbrillance avec un arrière-plan plus foncé.

Utilisez les boutons fléchés ( ) pour déplacer les valeurs d’une version à l’autre. Après avoir effectué vos modifications, cliquez sur le bouton Enregistrer la fusion pour enregistrer vos modifications. Vous pouvez également cliquer sur le bouton Revenir au système de base pour annuler vos personnalisations et utiliser la version non modifiée de l’enregistrement.

Les enregistrements de détails principaux [sys_sg_master_detail_screen] constituent un problème de collision courant. Les enregistrements de détails principaux ne font plus partie du schéma mobile depuis la New York version. Ces enregistrements sont remplacés par de nouveaux enregistrements d’écran de liste [sys_sg_list_screen] et de formulaire [sys_sg_form_screen]. Ils sont normalement supprimés dans le cadre du processus de mise à niveau, mais s’ils ont été personnalisés, le script ne les supprime pas automatiquement. Si vous avez, par exemple, renommé une application de système de base, ce type de collision peut se produire.

Pour résoudre le problème, vérifiez Mobile Studio pour vous assurer que votre applet est toujours disponible et fonctionne comme prévu. Une fois que vous avez confirmé que l’applet est disponible, vous pouvez supprimer l’enregistrement de détail principal.

Problèmes courants de migration

Un applet est manquant

Après la migration, vos applets doivent être visibles dans l’onglet Applications de la barre de navigation. Si les applets n’apparaissent pas, vous pouvez migrer manuellement ces applets.

1. Dans Studio, ouvert Studio mobile > Menu d’application Dans l’explorateur d’application, et sélectionnez l’application dans laquelle il vous manque un applet.
2. Dans la liste connexe Onglets de navigation , cliquez sur l’onglet Navigation des applications .
3. Notez le lanceur d’applet associé à l’onglet Applications .
4. Dans Studio, ouvert Studio mobile > Lanceurs d'appletet ouvrez le lanceur d’applet indiqué à la dernière étape.
5. Dans le formulaire du lanceur d’applet, sélectionnez une section de l’interface utilisateur portant le même nom que le dossier dans lequel se trouvait l’applet manquant avant la migration.
6. Recherchez l’applet manquante dans la liste Toutes les applets et déplacez-la vers la liste Applets sélectionnés .
7. Cliquez sur Enregistrer.

Une liste connexe est manquante dans un applet

Ce problème peut être dû à une référence obsolète sur la table de mappage des listes connexes [sys_sg_related_list_map]. Vous pouvez associer à nouveau l’écran de destination à votre liste connexe pour résoudre le problème.

1. Dans Studio, accédez à Studio mobile > Appletset sélectionnez l’applet avec le segment manquant.
2. Cliquez sur l’onglet Écran de formulaire .
3. Cliquez sur Corps.
4. Cliquez sur le bouton Listes connexes .
5. Consultez la liste pour les éléments dont la valeur Écran de destination est vide.
6. Cliquez sur l’élément de liste, puis sélectionnez une valeur dans le champ Écran de destination .

Les utilisateurs ne sont pas invités à saisir des paramètres d’entrée ou ITSM des Gestion des services sur site applets

Normalement, les applets paramétrés invitent vos utilisateurs à saisir une valeur. Si cette invite ne s’affiche plus après une migration, procédez comme suit pour corriger le problème.

1. Ouvrez la liste UI Parameter (Paramètres d’interface utilisateur) [sys_sg_ui_parameter] en saisissant sys_sg_ui_parameter.list dans le navigateur de filtre de votre instance.
2. Recherchez le paramètre qui ne génère pas d’invite pour vos utilisateurs.
3. Vérifiez la valeur du champ Écran . Si ce champ semble vide, il peut pointer vers un enregistrement de l’écran de détails principaux [sys_sg_master_detail_screen].
4. Mettez à jour le champ en sélectionnant l’enregistrement d’applet [sys_sg_screen] utilisé par ce paramètre.

Résultats incorrects pour un applet personnalisé Gestion des services sur site ou ITSM personnalisé.

Ce problème peut se produire si vous avez ajouté un paramètre client à un système de base.

1. Ouvrez la liste des mappages des paramètres d’écran [sys_sg_screen_param_map] en saisissant sys_sg_screen_param_map.list dans le navigateur de filtre de votre instance.
2. Recherchez l’enregistrement dont le champ Item Parameter (Paramètre de l’élément ) correspond au paramètre de l’élément que vous avez ajouté à votre élément de données.
3. Vérifiez la valeur du champ Écran . Si ce champ semble vide, il peut pointer vers un enregistrement inutilisé de l’écran de détails principaux [sys_sg_master_detail_screen].
4. Mettez à jour le champ en sélectionnant l’enregistrement d’applet [sys_sg_screen] utilisé par ce paramètre.