Migration vers Agent mobile ITSM 5.0.3

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 6 minutes de lecture

    • La migration vers Agent mobile ITSM 5.0.3 permet d'utiliser le thème Next Experience et d'assurer la conformité en matière d'accessibilité dans Agent mobile ITSM.

    Cette migration comprend les changements de composants suivants :
    • Migration des sections d'icônes héritées vers de nouvelles sections d'icônes. Celle-ci offre un meilleur regroupement des sections d'icônes pour la planification d'astreinte et pour les incidents, ainsi que des variables de couleur pour les icônes.
    • Migration des paramètres hérités de l'interface utilisateur vers de nouveaux écrans du formulaire d'entrée. Celle-ci simplifie la façon dont les paramètres sont définis, permet la thématisation de l'écran du formulaire d'entrée et prend en charge les améliorations en matière d'accessibilité apportées par Plateforme mobile.
    • Migration des vues de cartes héritées vers des vues mobiles. Celle-ci permet d'utiliser des variables de couleur conformes au thème.
    • Tous les changements de style peuvent être effectués en utilisant des règles d'interface utilisateur plutôt que des styles d'interface utilisateur.
    • Pour les boutons qui permettent d'effectuer une action positive, la mise en évidence du bouton est passée de primaire à positive.
    Lorsque les clients migrent vers Agent mobile ITSM 5.0.3 à partir d'une version antérieure, les étapes suivantes sont automatiquement exécutées :
    • Lorsque l'application Agent mobile ITSM (sn_itsm_mobile_agt) déclenche l'événement plugin.upgraded, l'action des scripts Run clean upgrade for ITSM Mobile Agent est exécutée.
    • Cette action des scripts appelle les API de mise à niveau suivantes :
      • Pour les sections d'icônes héritées qui sont mises à niveau vers les nouvelles sections de navigation, utilisez la méthode cleanUpgradeIconSections() de l'include de script sn_itsm_mobile_agt.MobileUtahUpgradeEngine.
      • Pour les paramètres de l'interface utilisateur hérités qui sont mis à niveau vers le nouvel écran du formulaire d'entrée, utilisez la méthode cleanUpgradeButtonInstance() de l'include de script sn_itsm_mobile_agt.MobileUtahUpgradeEngine.
      • Pour les cartes héritées qui sont mises à niveau vers les nouvelles vues mobiles, utilisez la méthode cleanUpgradeLegacyCards() de l'include de script sn_itsm_mobile_agt.MobileUtahUpgradeEngine.
      • Une table de correspondance comportant des paires clé-valeur, sn_itsm_mobile_agt.MobileIconSectionMigrationConstant, est introduite. Chaque clé représente le sys_id de la configuration par défaut héritée, et sa valeur correspondante est un objet contenant une liste de métadonnées séparées par des virgules pour la nouvelle configuration par défaut introduite au cours du processus de mise à niveau.
    • Une fois que l'action des scripts a été exécutée et qu'elle a effectué toutes les actions requises, elle est désactivée afin de ne pas être réexécutée lors de futures mises à jour.

    Migration des sections d'icônes héritées vers les sections de navigation

    Dans ce cas, l'include de script sn_itsm_mobile_agt.MobileIconSectionMigrationConstants contient les paires clé-valeur suivantes :
    • Clé : sys_id de l'enregistrement sys_sg_icon_section par défaut hérité.
    • Valeur : objet contenant une liste séparée par des virgules des sys_id des enregistrements sys_sg_navigation_section et sys_sg_applet_launcher_m2m_section.
    Le script de mise à niveau de l'action des scripts Run clean upgrade for ITSM Mobile Agent (Exécuter une mise à niveau propre pour l'Agent mobile ITSM) s'exécute pour appliquer les étapes suivantes à chaque clé de la table de correspondance :
    1. Recherchez les personnalisations dans les enregistrements suivants.
      • Enregistrement sys_sg_icon_section par défaut hérité.
      • Vérifiez si la section d'icônes par défaut héritée comporte au moins un nouvel enregistrement sys_sg_applet_launcher_m2m_section ou un enregistrement de ce type en moins par rapport à la nouvelle section d'icônes par défaut.
    2. En fonction des personnalisations, l'une des étapes suivantes est exécutée.
      • Si l'un des enregistrements ci-dessus est personnalisé, le script désactive le nouvel enregistrement sys_sg_navigation_section par défaut.
      • Si aucun des enregistrements ci-dessus n'est personnalisé, le script désactive l'enregistrement sys_sg_icon_section par défaut hérité.
    Remarque :
    • Les sections d'icônes personnalisées qui ne sont pas disponibles par défaut continuent de fonctionner, mais peuvent ne pas prendre en charge le thème Next Experience et la conformité en matière d'accessibilité. Les clients doivent les migrer vers des sections de navigation pour bénéficier d'une meilleure expérience.
    • Pour les sections d'icônes personnalisées disponibles par défaut, les clients doivent examiner manuellement les sections d'icônes par défaut héritées qui sont encore actives et déplacer leurs personnalisations vers les nouvelles sections de navigation par défaut.
    • Si les sections d'icônes personnalisées ne sont pas migrées vers les nouvelles sections de navigation, l'expérience des utilisateurs ne sera peut-être pas totalement compatible avec le nouveau thème Next Experience et cela risque d'entraîner des problèmes d'accessibilité.

    Migration des paramètres de l'interface utilisateur vers l'écran du formulaire d'entrée

    Dans ce cas, l'include de script sn_itsm_mobile_agt.MobileInputFormScreenMigrationConstants contient les paires clé-valeur suivantes :
    • Clé : sys_id de l'enregistrement sys_sg_button_instance par défaut hérité.
    • Valeur : objet contenant la liste des sys_ids du nouvel enregistrement sys_sg_button_instance par défaut, séparés par des virgules, ainsi que d'autres métadonnées.
    Le script de mise à niveau de l'action des scripts Run clean upgrade for ITSM Mobile Agent (Exécuter une mise à niveau propre pour l'Agent mobile ITSM) s'exécute alors pour appliquer les étapes suivantes à chaque clé de la table de correspondance :
    1. Recherchez les personnalisations dans les enregistrements suivants.
      • Enregistrement sys_sg_button_instance par défaut hérité.
      • Enregistrement sys_sg_button associé à l'enregistrement sys_sg_button_instance.
      • Enregistrements sys_sg_ui_parameter et sys_sg_action_param_map associés à l'enregistrement sys_sg_button.
      • Enregistrement sys_sg_write_back_action_item associé à l'enregistrement sys_sg_button.
    2. En fonction des personnalisations, l'une des étapes suivantes est exécutée.
      • Si l'un des enregistrements ci-dessus est personnalisé, le script désactive le nouvel enregistrement sys_sg_button_instance par défaut.
      • Si aucun des enregistrements ci-dessus n'est personnalisé, le script désactive l'enregistrement sys_sg_button_instance par défaut hérité.
    Remarque :
    • Les flux d'instances de boutons personnalisés (UI Params) qui ne sont pas disponibles par défaut continuent de fonctionner mais peuvent ne pas prendre en charge le thème Next Experience et la conformité en matière d'accessibilité. Les clients doivent les migrer vers des écrans du formulaire d'entrée pour bénéficier d'une meilleure expérience.
    • Pour les flux d'instances de boutons personnalisés (UI Params) qui sont disponibles par défaut, les clients doivent examiner manuellement les enregistrements sys_sg_button_instance par défaut hérités qui sont encore actifs et déplacer leurs personnalisations vers le nouveau flux sys_sg_button_instance (consultez la table de correspondance sn_itsm_mobile_agt.MobileInputFormScreenMigrationConstants). Pour configurer les écrans du formulaire d'entrée sur mobile, consultez Écran du formulaire d'entrée.
    • Si les paramètres personnalisés de l'interface utilisateur ne sont pas migrés vers les nouveaux écrans du formulaire d'entrée, l'expérience des utilisateurs ne sera peut-être pas totalement compatible avec le nouveau thème Next Experience et cela risque d'entraîner des problèmes d'accessibilité.

    Migration des vues d'éléments vers de nouvelles cartes mobiles

    Dans ce cas, l'include de script sn_itsm_mobile_agt.MobileIconSectionMigrationConstants contient les paires clé-valeur suivantes :
    • Clé : sys_id de l'enregistrement sys_sg_item_view par défaut hérité.
    • Valeur : objet contenant une liste séparée par des virgules des sys_id des enregistrements sys_sg_form_screen et sys_sg_master_item où la carte héritée (c'est-à-dire la vue d'élément) est référencée.
    Le script de mise à niveau de l'action des scripts Run clean upgrade for ITSM Mobile Agent (Exécuter une mise à niveau propre pour l'Agent mobile ITSM) s'exécute alors pour appliquer les étapes suivantes à chaque clé de la table de correspondance :
    1. Recherchez les personnalisations dans les enregistrements suivants.
      • Enregistrement sys_sg_item_view par défaut hérité.
      • Tous les enregistrements sys_sg_ui_style associés à l'enregistrement sys_sg_item_view.
    2. Si l'un des enregistrements mentionnés est personnalisé, le script ne rétablit l'état précédent des enregistrements sys_sg_form_screen et sys_sg_master_item que si ceux-ci n'ont pas été personnalisés.
    Remarque :
    • Les vues d'éléments personnalisées qui ne sont pas disponibles par défaut continuent de fonctionner, mais peuvent ne pas prendre en charge le thème Next Experience et la conformité en matière d'accessibilité. Les clients doivent les migrer vers des écrans du formulaire d'entrée pour bénéficier d'une meilleure expérience.
    • Pour les sections d'icônes personnalisées qui sont disponibles par défaut, les clients doivent examiner manuellement les anciens flux par défaut qui sont toujours actifs et déplacer leurs personnalisations vers le nouveau flux. Pour en savoir plus sur la configuration des cartes sur mobile, consultez Personnaliser un écran à l'aide du Créateur de carte mobile.
    • Si les vues d'éléments personnalisées ne sont pas migrées vers les nouvelles cartes mobiles, l'expérience des utilisateurs ne sera peut-être pas totalement compatible avec le nouveau thème Next Experience et cela risque d'entraîner des problèmes d'accessibilité.