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.

Messages d’erreur du journal

Le script de migration mobile ajoute des entrées à la table Journal [syslog] lorsqu’il rencontre une erreur. Vous pouvez examiner ces journaux en accédant à Journaux Système > Journal système > Tout. Les erreurs que le script de migration Mobile peut ajouter aux journaux sont répertoriées ici.

Tableau 1. Messages d’erreur

Message d'erreur	Résolution
Périmètre d’instance non valide fourni	Si vous voyez ce message, le script de migration a été abandonné. Exécutez à nouveau le script de migration pour terminer la migration. Vous pouvez exécuter à nouveau le script de migration en rouvrant Studio et en sélectionnant le périmètre.
Veuillez commencer par activer com.glide.mobile-employee avant la migration.	Le module d’extension ServiceNow NowMobile App and Applet Launcher [com.glide.mobile-employee] doit être actif pour exécuter le script de migration. Vérifiez que ce module d’extension est actif. Si vous voyez ce message, 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 un enregistrement personnalisé.	L’enregistrement à l’origine de cette erreur s’affiche 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 à s’exécuter. Le fichier nommé est inaccessible dans Studio.

Collisions

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

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

Le formulaire Résoudre des conflits montre la version de système de base de l’enregistrement, ainsi que la version personnalisée. Un arrière-plan plus sombre est utilisé pour mettre en évidence les champs qui diffèrent entre les versions.

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

Les enregistrements de détail du maître [sys_sg_master_detail_screen] sont un problème de collision courant. À compter de la version New York, les enregistrements Détail du maître ne font plus partie du schéma Mobile. Ces enregistrements sont remplacés par de nouveaux enregistrements d’écran de formulaire [sys_sg_form_screen] et de liste [sys_sg_list_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, consultez Mobile Studio pour vous assurer que votre applet est toujours disponible et qu'il fonctionne comme prévu. Après avoir confirmé la disponibilité de l'applet, vous pouvez supprimer l'enregistrement de détail du maître.

Problèmes de migration courants

une 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 les migrer manuellement.

1. Dans Studio, ouvrir Studio mobile > Menu d'application dans l’explorateur d’applications, puis sélectionnez l’application pour laquelle il vous manque un applet.
2. Dans la liste connexe Onglets Navigation, cliquez sur l’onglet de navigation Applications.
3. Notez le lanceur d’applet associé à l’onglet Applications.
4. Dans Studio, ouvrir Studio mobile > Lanceurs d'appletet ouvrez le lanceur d’applet indiqué à la dernière étape.
5. Dans le formulaire de 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 manquant dans la liste Tous les applets et déplacez-le dans la liste Applets sélectionnés.
7. Cliquez sur Enregistrer.

Une liste connexe d’applet est manquante

Ce problème peut être la conséquence d’une référence obsolète dans la table de mappage des listes connexes [sys_sg_related_list_map]. Vous pouvez réassocier l’écran de destination de 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 détecter les éléments avec une valeur Écran de destination vide.
6. Cliquez sur l’élément de liste et sélectionnez une valeur dans le champ Écran de destination.

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

Les applets paramétrés normalement invitent les utilisateurs à indiquer une valeur. Si vous ne voyez plus cette invite après une migration, suivez ces étapes pour corriger le problème.

1. Ouvrez la liste Paramètres de l’interface utilisateur [sys_sg_ui_parameter] en entrant sys_sg_ui_parameter.list dans le Navigateur de filtre pour votre instance.
2. Recherchez le paramètre qui ne génère pas d’invite pour les utilisateurs.
3. Vérifiez la valeur du champ Écran. Si ce champ est vide, il peut pointer vers un enregistrement Écran maître-détail [sys_sg_master_detail_screen] non utilisé.
4. Mettez à jour le champ en sélectionnant l'enregistrement d'applet [sys_sg_screen] utilisé par ce paramètre.

Résultats incorrects pour une applet 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 Mappages des paramètres d’écran [sys_sg_screen_param_map] en entrant sys_sg_screen_param_map.list dans le Navigateur de filtre pour votre instance.
2. Recherchez l’enregistrement avec le champ Paramètre de l’élément correspondant 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 est vide, il peut pointer vers un enregistrement Écran maître-détail [sys_sg_master_detail_screen] non utilisé.
4. Mettez à jour le champ en sélectionnant l’enregistrement d’applet [sys_sg_screen] utilisé par ce paramètre.