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.

Das Diagnostizieren von Widgets umfasst:

• Identifiziert die Anpassungsebenen von Widgets
• Es wird der Code überprüft, der in den einzelnen Widgets verwendet wird

Anpassungsebenen identifizieren

Anpassungsebenen beschreiben, wie Widgets geändert oder entwickelt wurden. Indem Sie die Anpassungsebene eines Widgets identifizieren, wissen Sie, welcher Teil des Widget-Codes am wichtigsten ist. Es gibt vier Anpassungsstufen für Widgets.

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: anwenderdefiniertes 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 von der Portalseite aus 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 mit 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 mit einem anwenderdefinierten 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 anwenderdefiniertes 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 sind angepasste Widgets das Problem mit der höchsten Priorität. Diese Widgets werden in System-Upgrades nicht unterstützt. Wenn während eines Upgrades Seitenprobleme auftreten, kann dies an einem anwenderdefinierten Widget auf Ihrer Portalseite liegen.

Um Seitenprobleme zu beheben, die durch anwenderdefinierte Widgets verursacht wurden, geben Sie an, welche Teile des Widget-Codes angepasst wurden. Setzen Sie den Code dann auf die ursprüngliche Konfiguration zurück. Weitere Informationen zum Identifizieren dieser Codeunterschiede finden Sie unter Vergleichen Sie ein anwenderdefiniertes Widget mit dem Basissystem.

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 von anwenderdefinierten Widgets immer noch 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. Um Ihre letzten Änderungen zu identifizieren und Ihren Code zu debuggen, führen Sie die Schritte in Änderungen mit zugehörigen Datensätzen vergleichenaus.

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 mit der geringsten Wahrscheinlichkeit Seitenprobleme. Wenn Sie bereits andere Widgets aktiviert haben und weiterhin Seitenprobleme auftreten, entfernen Sie Basissystem-Widgets von der Seite, und fügen Sie sie ohne festgelegte Widget-Optionen erneut hinzu. Sie können stattdessen auch versuchen, Basissystem-Widgets zu einer anderen Seite hinzuzufügen.

Einschränkungen

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

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

• 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 mit 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 mit einem anwenderdefinierten 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 anwenderdefiniertes 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.