Diagnostics des widgets

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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 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 de 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és 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 du 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 du 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 Diagnostics des widgets

    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, c’est peut-être parce que vous avez un widget personnalisé sur votre page du portail.

    Pour résoudre les problèmes de page qui peuvent être causés par des widgets personnalisés, identifiez les parties du code du widget qui 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 des problèmes de page maintenant, 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é les widgets personnalisés, vérifiez ensuite vos widgets nouveaux et clonés.

    Avec un nouveau widget, il est probable que les modifications apportées au code les plus récentes soient à l’origine de 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 présentées dans Comparer les changements aux enregistrements connexes.

    Si vous avez cloné un widget avant une mise à niveau 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 du système de base est moins susceptible d’entraîner 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 définir d’options de widget. Vous pouvez également essayer d’ajouter des widgets du système de base à une autre page à la place.

    Limitations

    Plusieurs limitations connues sont connues de 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 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 des couleurs pour catégoriser les widgets, il est possible qu’il ne soit pas 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 résoudre les problèmes liés au widget, vérifiez les dépendances imbriquées dans l’enregistrement du widget.
    • Le système n’a aucun moyen de suivre une dépendance de widget une fois que vous l’avez supprimée.