Diagnostics des widgets

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 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 du portail ne fonctionne pas comme prévu, cela peut être dû à un bogue dans le code du widget. 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. Identifier le 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
    Système de base Widget de système de base sans modifications, y compris les widgets pour lesquels vous avez défini des options d'instance.
    Cloné Widget que vous avez cloné à partir d'un widget de système de base.
    Nouveau Widget que vous avez créé.
    Personnalisé Widget de système 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 :

    Identification des niveaux de personnalisation
    • Vert – widget de système de base
    • Jaune : widget cloné
    • Bleu – nouveau widget
    • Rouge – widget personnalisé

    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 du widget à partir de la page du portail, cliquez sur l’icône d’informations ( icône d’informations) sur un widget.

    Fenêtre de diagnostic de widget

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

    Recommandations pour les widgets de diagnostic

    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, c’est peut-être parce 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 quelles parties du code du widget ont été personnalisées. Ensuite, rétablissez la configuration d’origine du code. Pour plus d’informations sur l’identification de ces différences de code, reportez-vous à la section Comparer un widget personnalisé au système de base.

    Conseil :
    Même si un widget personnalisé n’est pas à l’origine de problèmes de page maintenant, vous souhaiterez peut-être revenir au widget d’origine pour éviter des problèmes lors des mises à niveau ultérieures.

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

    Avec un nouveau widget, il est probable que vos modifications de code les plus récentes entraînent des problèmes sur votre page de portail. Pour identifier vos modifications les plus récentes afin de pouvoir déboguer votre code, suivez les étapes de la section Comparer les changements aux enregistrements connexes.

    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 du système de base. Dans ce cas, il est recommandé de cloner à nouveau le widget et d’ajouter vos personnalisations au clone.

    Un widget de système de base est moins susceptible de causer des problèmes de page. Si vous avez déjà consulté d’autres widgets et que vous rencontrez toujours des problèmes de page, supprimez les widgets du système 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 système 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 du widget, vous ne pouvez pas corriger ou rétablir le code directement. Sortez du portail pour changer le code.
    • Si vous naviguez vers 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.