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
• Überprüfen des Codes, der in jedem Widget verwendet wird

Anpassungsebenen identifizieren

Anpassungsebenen beschreiben, wie Widgets geändert oder entwickelt wurden. Das Identifizieren der Anpassungsebene eines Widgets kann Ihnen helfen zu wissen, welcher Teil des Widget-Codes am wichtigsten ist. Es gibt vier Ebenen der Widget-Anpassung.

Anpassungsebene	Beschreibung
Basissystem	Basissystem-Widget ohne Änderungen, einschließlich Widgets, für die Sie Instanzoptionen festgelegt haben.
Geklont	Widget, das Sie aus einem Basissystem-Widget geklont haben
Neu	Widget, das Sie erstellt haben.
Angepasst	Basissystem-Widget, das Sie auf eine der folgenden Arten konfiguriert haben: Widget-Code direkt geändert Geändertes Widget-Optionsschema Widget-Abhängigkeiten, ng-Vorlagen oder Angular Provider geändert

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

Grün: Basissystem-Widget Gelb – geklontes Widget Blau – neues Widget Rot – angepasstes Widget

Der 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 in einem Widget auf das Informationssymbol ( ).

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

• Zeigen Sie einen Widget-Datensatz von einer Portalseite aus an

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

• Zeigen Sie zugehörige Datensätze an

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

• Änderungen an zugehörigen Datensätzen vergleichen

  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.

• Änderungen an einem benutzerdefinierten Widget vergleichen

  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 benutzerdefiniertes Widget mit dem Basissystem

  Identifizieren Sie Anpassungen für ein Basissystem-Widget, damit Sie Ihre benutzerdefinierten Widgets wiederherstellen und Probleme auf einer Portalseite beheben können.

Empfehlungen für die Diagnose von Widgets

Von den vier Anpassungsebenen haben benutzerdefinierte Widgets die höchste Priorität. Diese Widgets werden in System-Upgrades nicht unterstützt. Wenn während eines Upgrades Seitenprobleme auftreten, kann dies an einem benutzerdefinierten Widget auf Ihrer Portalseite liegen.

Um Seitenprobleme zu beheben, die durch benutzerdefinierte 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 Erkennen dieser Codeunterschiede finden Sie unter Vergleichen Sie ein benutzerdefiniertes Widget mit dem Basissystem.

Tipp:

Auch wenn ein benutzerdefiniertes Widget derzeit keine Seitenprobleme verursacht, sollten Sie das ursprüngliche Widget wiederherstellen, um Probleme bei späteren Upgrades zu vermeiden.

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

Bei einem neuen Widget verursachen Ihre letzten Codeänderungen wahrscheinlich Probleme auf Ihrer Portalseite. Führen Sie die Schritte in Änderungen an zugehörigen Datensätzen vergleichenaus, um Ihre letzten Änderungen zu identifizieren, damit Sie Ihren Code debuggen können.

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

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

Einschränkungen

Bei der Verwendung der Widget-Diagnose über eine Portalseite sind mehrere Einschränkungen bekannt:

• Sie können zwar Widget-Code anzeigen und vergleichen, aber Sie können 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 Farben zur Kategorisierung von Widgets verwendet, ist es für sehbehinderte Benutzer möglicherweise nicht zugänglich.
• Die Widget-Abhängigkeiten, die auf der Portalseite aufgelistet werden, spiegeln nur die Abhängigkeiten der ersten Ebene wider. Jede Abhängigkeit, die tiefer als die erste Ebene verschachtelt ist, wird nicht berücksichtigt. Um weitere Probleme mit dem Widget zu beheben, überprüfen Sie die verschachtelten Abhängigkeiten im Widget-Datensatz.
• Es gibt keine Möglichkeit für das System, eine Widget-Abhängigkeit nachzuverfolgen, nachdem Sie sie gelöscht haben.

• Zeigen Sie einen Widget-Datensatz von einer Portalseite aus an
  Zeigen Sie potenziell problematischen Code im Widget-Datensatz an, und identifizieren Sie ihn, ohne von der Portalseite weg zu navigieren.
• Zeigen Sie zugehörige Datensätze an
  Zeigen und identifizieren Sie potenziell problematischen Code in den Widget-Abhängigkeiten, Winkelanbietern und ng-Vorlagen, die vom Widget verwendet werden.
• Änderungen an zugehörigen Datensätzen vergleichen
  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.
• Änderungen an einem benutzerdefinierten Widget vergleichen
  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 benutzerdefiniertes Widget mit dem Basissystem
  Identifizieren Sie Anpassungen für ein Basissystem-Widget, damit Sie Ihre benutzerdefinierten Widgets wiederherstellen und Probleme auf einer Portalseite beheben können.