Diagnostics des widgets

Résolvez Portail de services les problèmes de page en identifiant les niveaux de personnalisation des widgets et en vérifiant le code des widgets directement à partir d’une page de portail.

Si une page de 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 comment 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 aucune modification, mais peuvent avoir des instances de widget pour lesquelles vous avez défini des options d’instance.
Cloné	Widget que vous avez cloné à partir d’un widget de base.
Nouveau	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é 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 des widgets et sélectionnez Afficher les personnalisations des widgets. 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

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 ) sur un widget.

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

• Afficher un enregistrement de widget à partir d’une page de portail

  Affichez et identifiez le code potentiellement problématique dans l’enregistrement de widget sans avoir à naviguer hors de la page du portail.

• Identifier les personnalisations dans les enregistrements connexes des widgets

  Affichez et identifiez le code potentiellement problématique dans les dépendances de widget, les fournisseurs d’angle et les modèles ng-templates utilisés par le widget.

• Comparer les versions d’un enregistrement connexe de widget

  Comparez un fournisseur Angular ou ng-template à sa version précédente afin de vérifier si vos modifications de code les plus récentes entraînent des problèmes sur une page de portail.

• Comparer les versions d’un widget personnalisé

  Comparez la mise à jour la plus récente d’un widget personnalisé à la version précédente pour vérifier si vos modifications récentes sont à l’origine de problèmes sur une page du portail.

• Comparer un widget cloné ou personnalisé à un widget de base

  Identifiez les personnalisations d’un widget afin de pouvoir rétablir vos widgets clonés ou personnalisés et résoudre les problèmes sur une page du portail.

Recommandations pour le diagnostic des widgets

Des quatre niveaux de personnalisation, le problème auquel la priorité est la plus élevée 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 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 cloné ou personnalisé à un widget de base.

Conseil :

Même si un widget personnalisé n’est pas à l’origine 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 widgets nouveaux et clonés.

Avec un nouveau widget, il est probable que vos modifications de code les plus récentes provoquent 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 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 qu’aucune option de widget ne soit définie. Vous pouvez également essayer d’ajouter des widgets de base à une autre page à la place.

Limitations

Il existe plusieurs limitations connues liées à l’utilisation des diagnostics de widget à partir d’une page de portail :

• Bien que vous puissiez afficher et comparer le code d’un widget, vous ne pouvez pas corriger ou rétablir le code directement. Quittez le portail pour modifier le code.
• Si vous accédez à une autre page du portail tout en utilisant les diagnostics des widgets, 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 après sa suppression.