Widget-Diagnose

Beheben Sie Serviceportal-Seitenprobleme, indem Sie Widget-Anpassungsebenen identifizieren und den Widget-Code direkt über eine Portalseite überprüfen.

Wenn eine Portalseite nicht wie erwartet funktioniert, kann dies an einem Fehler im Widget-Code liegen. Um die Seite zu diagnostizieren, versuchen Sie, die Widgets auf der Seite zu diagnostizieren.

Die Diagnose von Widgets umfasst:

• Identifizieren der Widget-Anpassungsebenen
• Code wird überprüft, der in jedem Widget verwendet wird

Anpassungsebenen werden identifiziert

Anpassungsebenen Beschreiben Sie, wie Widgets geändert oder entwickelt wurden. Die Identifizierung der Anpassungsebene eines Widgets kann Ihnen helfen, zu wissen, welcher Teil des Widget-Codes am wichtigsten zu überprüfen ist. Es gibt vier Ebenen der Widget-Anpassung.

Anpassungsebene	Beschreibung
Basis	Basis-Widget, das auf einem Basissystem oder mit einem anderen installiert ist ServiceNow Plugins. Basis-Widgets haben keine Änderungen, können jedoch Widget-Instanzen haben, für die Sie Instanzoptionen festgelegt haben.
Geklont	Widget, das Sie aus einem Basis-Widget geklont haben.
Neu	Widget, das Sie erstellt haben.
Angepasst	Basis-Widget, das Sie auf eine der folgenden Arten konfiguriert haben: Widget-Code direkt geändert Geändertes Widget-Optionsschema Geänderte Widget-Abhängigkeiten, ng-Templates oder Angular-Provider

Um die Anpassungsebenen von Widgets auf einer Portalseite zu identifizieren, öffnen Sie das Widget-Kontextmenü, und wählen Sie aus Widget-Anpassungen Anzeigen . Widgets sind wie folgt farbcodiert:

• Grün: Basis-Widget
• Gelb: Geklontes Widget
• Blau: Neues Widget
• Rot: Anwenderdefiniertes Widget

Abbildung : 1. Widget-Anpassungen, die auf einer Portalseite hervorgehoben sind

Widget-Code wird überprüft

Nachdem Sie die Anpassungsebenen von Widgets auf einer Portalseite identifiziert haben, überprüfen Sie den Code in jedem Widget.

Um den Widget-Code auf der Portalseite anzuzeigen, klicken Sie auf das Informationssymbol ( ) In einem Widget.

Im Widget-Diagnosefenster können Sie den Widget-Code auf verschiedene Arten überprüfen:

• Zeigen Sie einen Widget-Datensatz auf einer Portalseite an

  Zeigen Sie potenziell problematischen Code im Widget-Datensatz an, und identifizieren Sie ihn, ohne von der Portalseite weg zu navigieren.

• Identifizieren Sie Anpassungen in Widget-bezogenen Datensätzen

  Zeigen und identifizieren Sie potenziell problematischen Code in den Widget-Abhängigkeiten, Winkelanbietern und ng-Vorlagen, die vom Widget verwendet werden.

• Vergleichen Sie Versionen eines Widget-bezogenen Datensatzes

  Vergleichen Sie eine Winkelanbieter- oder ng-Vorlage mit der vorherigen Version, um zu prüfen, ob Ihre neuesten Code-Changes Probleme auf einer Portalseite verursachen.

• Vergleichen Sie Versionen eines anwenderdefinierten Widgets

  Vergleichen Sie Ihre neueste Aktualisierung eines benutzerdefinierten Widgets mit der vorherigen Version, um zu prüfen, ob Ihre neuesten Code-Changes Probleme auf einer Portalseite verursachen.

• Vergleichen Sie ein geklontes oder anwenderdefiniertes Widget mit einem Basis-Widget

  Identifizieren Sie Anpassungen an einem Widget, damit Sie Ihre geklonten oder anwenderdefinierten Widgets wiederherstellen und Probleme auf einer Portalseite lösen können.

Empfehlungen für die Diagnose von Widgets

Von den vier Anpassungsebenen sind anwenderdefinierte Widgets das Problem mit der höchsten Priorität. Diese Widgets werden bei System-Upgrades nicht unterstützt. Wenn während eines Upgrades Seitenprobleme auftreten, kann dies daran liegen, dass Sie ein anwenderdefiniertes Widget auf Ihrer Portalseite haben.

Um Seitenprobleme zu beheben, die durch anwenderdefinierte Widgets verursacht werden können, identifizieren Sie, welche Teile des Widget-Codes angepasst wurden. Setzen Sie dann den Code auf die ursprüngliche Konfiguration zurück. Weitere Informationen zum Identifizieren dieser Codeunterschiede finden Sie unter Vergleichen Sie ein geklontes oder anwenderdefiniertes Widget mit einem Basis-Widget.

Tipp:

Auch wenn ein anwenderdefiniertes Widget jetzt keine Seitenprobleme verursacht, möchten Sie möglicherweise das ursprüngliche Widget wiederherstellen, um Probleme bei späteren Upgrades zu vermeiden.

Wenn nach dem Zurücksetzen anwenderdefinierter Widgets weiterhin Seitenprobleme auftreten, überprüfen Sie als Nächstes Ihre neuen und geklonten Widgets.

Mit einem neuen Widget verursachen Ihre letzten Codeänderungen wahrscheinlich Probleme auf Ihrer Portalseite. Um Ihre letzten Änderungen zu identifizieren, damit Sie Ihren Code debuggen können, führen Sie die Schritte unter aus Vergleichen Sie Versionen eines Widget-bezogenen Datensatzes.

Wenn Sie ein Widget vor einem System-Upgrade geklont haben, hat das geklonte Widget wahrscheinlich nicht denselben aktualisierten Code wie das Basis-Widget erhalten. In diesem Fall wird empfohlen, das Widget erneut zu klonen und dem Klon Ihre Anpassungen hinzuzufügen.

Ein Basis-Widget verursacht am wenigsten Seitenprobleme. Wenn Sie bereits andere Widgets überprüft haben und weiterhin Seitenprobleme auftreten, entfernen Sie Basis-Widgets von der Seite, und fügen Sie sie erneut hinzu, ohne dass Widget-Optionen festgelegt sind. Sie können stattdessen auch versuchen, Basis-Widgets zu einer anderen Seite hinzuzufügen.

Einschränkungen

Es gibt mehrere bekannte Einschränkungen bei der Verwendung der Widget-Diagnose von einer Portalseite:

• Obwohl Sie Widget-Code anzeigen und vergleichen können, können Sie Code nicht direkt korrigieren oder rückgängig machen. Navigieren Sie vom Portal weg, um den Code zu ändern.
• Wenn Sie während der Widget-Diagnose zu einer anderen Portalseite navigieren, deaktiviert das System das Tool.
• Da das Tool zur Kategorisierung von Widgets Farbe verwendet, ist es für Anwender mit Sehbehinderungen möglicherweise nicht zugänglich.
• Die Widget-Abhängigkeiten, die auf der Portalseite aufgeführt sind, spiegeln nur die Abhängigkeiten der ersten Ebene wider. Jede Abhängigkeit, die tiefer als die erste Ebene geschachtelt ist, ist nicht enthalten. Um weitere Probleme mit dem Widget zu beheben, überprüfen Sie die geschachtelten Abhängigkeiten im Widget-Datensatz.
• Das System kann eine Widget-Abhängigkeit nicht nachverfolgen, nachdem Sie sie gelöscht haben.