Diagnostics des widgets

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture
  • Résolvez les problèmes de page Portail de services en identifiant les niveaux de personnalisation des widgets et en vérifiant le code du widget directement sur une page du portail.

    Si une page de portail ne fonctionne pas comme prévu, cela peut être dû à un bogue dans le code des widgets. Pour diagnostiquer la page, essayez de diagnostiquer les widgets sur la page.

    Le diagnostic des widgets implique :
    • Identification des niveaux de personnalisation des widgets
    • Vérification du code utilisé dans chaque widget

    Identification des niveaux de personnalisation

    Les niveaux de personnalisation décrivent la façon dont les widgets ont été modifiés ou développés. L’identification du niveau de personnalisation d’un widget peut vous aider à savoir quelle partie du code du widget est la plus importante à vérifier. Il existe quatre niveaux de personnalisation des widgets.
    Niveau de personnalisation Description
    Base Widget de base installé sur un système de base ou avec d’autres modules d’extension ServiceNow . Les widgets de base n’ont pas de modifications, mais peuvent avoir des instances de widget pour lesquelles vous avez défini des options d’instance.
    Clonés Widget que vous avez cloné à partir d’un widget de base.
    Nouvelle Widget que vous avez créé.
    Personnalisé Widget de base que vous avez configuré de l’une des façons suivantes :
    • Modification directe du code de widget
    • Schéma de l'option de widget modifiée
    • Dépendances du widget, modèles ng-templates ou fournisseurs Angular modifiés

    Pour identifier les niveaux de personnalisation des widgets sur une page de portail, ouvrez le menu contextuel Widget et sélectionnez Afficher les personnalisations de widget. Les widgets sont codés par couleur comme suit :

    • Vert : widget de base
    • Jaune : widget cloné
    • Bleu : nouveau widget
    • Rouge : widget personnalisé
    Figure 1. Personnalisations de widget mises en surbrillance sur une page de portail
    Identification des niveaux de personnalisation

    Vérification du code du widget

    Une fois que vous avez identifié les niveaux de personnalisation des widgets sur une page de portail, vérifiez le code dans chaque widget.

    Pour afficher le code de widget à partir de la page du portail, cliquez sur l’icône d’informations (icône d’informations) sur un widget.

    Fenêtre de diagnostics de widget

    Dans la fenêtre de diagnostic du widget, vous pouvez vérifier le code du widget de plusieurs manières :

    Recommandations pour le diagnostic des widgets

    Parmi les quatre niveaux de personnalisation, le problème le plus prioritaire concerne les widgets personnalisés. Ces widgets ne sont pas pris en charge dans les mises à niveau système. Si vous rencontrez des problèmes de page lors d’une mise à niveau, cela peut être dû au fait que vous avez un widget personnalisé sur votre page de portail.

    Pour résoudre les problèmes de page qui peuvent être causés par les widgets personnalisés, identifiez les parties du code de widget qui ont été personnalisées. Ensuite, rétablissez le code à la configuration d’origine. Pour plus d’informations sur l’identification de ces différences de code, reportez-vous à la section Comparer un widget cloné ou personnalisé à un widget de base.

    Conseil :
    Même si un widget personnalisé ne pose pas de problèmes de page pour le moment, vous pouvez revenir au widget d’origine pour éviter les problèmes lors des mises à niveau ultérieures.

    Si vous rencontrez toujours des problèmes de page après avoir restauré des widgets personnalisés, vérifiez ensuite vos nouveaux widgets et widgets clonés.

    Avec un nouveau widget, il est probable que vos modifications de code les plus récentes causent des problèmes sur votre page du portail. Pour identifier vos modifications les plus récentes afin de pouvoir déboguer votre code, suivez les étapes de la section Comparer les versions d’un enregistrement connexe de widget.

    Si vous avez cloné un widget avant une mise à niveau du système, il est probable que le widget cloné n’ait pas reçu le même code mis à jour que le widget de base. Dans ce cas, il est recommandé de cloner à nouveau le widget et d’ajouter vos personnalisations au clone.

    Un widget de base est le moins susceptible de causer des problèmes de page. Si vous avez déjà vérifié d’autres widgets et que vous rencontrez toujours des problèmes de page, supprimez les widgets de base de la page et ajoutez-les à nouveau sans aucune option de widget définie. Vous pouvez également essayer d’ajouter des widgets de base à une autre page à la place.

    Limitations

    Il existe plusieurs limitations connues à l’utilisation des diagnostics de widget à partir d’une page de portail :
    • Bien que vous puissiez afficher et comparer le code des widgets, vous ne pouvez pas corriger ou rétablir le code directement. Sortez du portail pour modifier le code.
    • Si vous accédez à une autre page du portail tout en utilisant les diagnostics de widget, le système désactive l’outil.
    • Étant donné que l’outil utilise la couleur pour catégoriser les widgets, il peut ne pas être accessible aux utilisateurs malvoyants.
    • Les dépendances de widget répertoriées sur la page du portail reflètent uniquement les dépendances de premier niveau. Toute dépendance imbriquée plus profondément que le premier niveau n’est pas incluse. Pour dépanner davantage le widget, vérifiez les dépendances imbriquées dans l’enregistrement du widget.
    • Il n’existe aucun moyen pour le système de suivre une dépendance de widget une fois que vous l’avez supprimée.