Freigeben über

Wartungsmodus für clientseitige Webparts

Wenn Sie mit clientseitigen Webparts arbeiten, können Sie diese im Wartungsmodus laden. Der Wartungsmodus kann hilfreich sein, wenn Sie versuchen, Probleme im Zusammenhang mit Webparts auf der Seite zu debuggen.

Wechseln in den Wartungsmodus

Hinweis

Um eine Seite im Wartungsmodus zu laden, benötigen Sie Bearbeitungsberechtigungen für diese spezielle Seite.

Um in den Wartungsmodus zu wechseln, navigieren Sie zur Seite, und fügen Sie in der URL ?maintenancemode=true an, z. B.:

https://contoso.sharepoint.com/sites/team?maintenancemode=true

Um den Wartungsmodus zu verlassen, entfernen Sie ?maintenancemode=true aus der URL, und laden Sie die Seite erneut.

Verfügbare Informationen

Im Wartungsmodus werden unterschiedliche Informationen zu jedem Webpart auf der Seite angezeigt.

Webpart-Zusammenfassung

Im Wartungsmodus werden für jedes Webpart die folgenden Zusammenfassungsinformationen angezeigt:

Zusammenfassende Webpartinformationen, die im Wartungsmodus angezeigt werden

Eigenschaft Beschreibung
Alias Webpart-Alias
ID Die eindeutige ID des Webparts.
InstanceID Die ID eines bestimmten instance eines Webparts (d. h., wenn Sie zwei weitere der gleichen Webparts auf einer Seite haben, weisen diese jeweils dieselbe Webpart-ID, aber eine andere instance-ID auf.
IsInternal Gibt an, ob das Webpart von Microsoft oder von einem Drittanbieter erstellt wurde. Wenn true, wird es von Microsoft erstellt. Gibt falsean, dass sie von einem Drittanbieter erstellt wird.
Version Die Versionsnummer des Webparts.
Umgebung Eine Aufzählung, die die Umgebung angibt, in der das Webpart ausgeführt wird. Mögliche Werte: 1 - Lokale Workbench, 2 - SharePoint
UserAgent Eine Zeichenfolge, die Informationen zu dem verwendeten Gerät und zu der verwendeten Software enthält (z. B. Browsertyp und Version).

Webpart-Manifest

Wechseln Sie zur Registerkarte Manifest, um weitere Informationen zu dem Webpart zu erhalten.

Webpart-Manifestinformationen, die im Wartungsmodus angezeigt werden

Wenn Sie sich die Manifestinformationen näher ansehen, erhalten Sie Details über Folgendes:

  • Wo das Webpart-Bundle gehostet wird.
  • welche externen Skripts das Webpart laden und von wo aus
  • Auf welcher Version von SharePoint Framework das Webpart basiert.
  • Welche Komponenten von SharePoint Framework das Webpart verwendet.

Diese Informationen können hilfreich sein, wenn Sie herausfinden möchten, warum ein bestimmtes Webpart nicht funktioniert.

Webpartdaten

Weitere Angaben, die im Wartungsmodus verfügbar sind, sind die Webpartdaten.

Webpartdaten, die im Wartungsmodus angezeigt werden

Anhand der Informationen der Registerkarte Daten können Sie die Konfiguration jedes Webparts ermitteln. Dies ist hilfreich, wenn Sie versuchen, von Benutzern gemeldete Fehler zu reproduzieren, die durch eine bestimmte Webpartkonfiguration verursacht werden können.

Wenn die Eigenschaften des Webparts in SharePoint integriert sind, werden im Datenabschnitt die Typen und Werte angezeigt, die zur weiteren Verarbeitung an SharePoint übergeben werden.

Überlegungen

  • Der Wartungsmodus funktioniert für clientseitige Webparts, die sowohl auf modernen als auch auf klassischen SharePoint-Seiten platziert werden. Weitere Informationen zum Öffnen klassischer Webparts in der Wartungsansicht finden Sie im Artikel Öffnen und Verwenden der Webpart-Wartungsseite .
  • Zum Öffnen der Seite im Wartungsmodus müssen Sie über Bearbeitungsberechtigungen für diese Seite verfügen.
  • Im Wartungsmodus wird Webpartcode nicht ausgeführt, und Sie können webpart-Eigenschaften nicht bearbeiten.
  • Im Wartungsmodus können Sie Webparts auf der Seite löschen oder verschieben.
  • Der Wartungsmodus zeigt nur Informationen zu Webparts an. Sie können es nicht verwenden, um Informationen zu SharePoint-Framework Erweiterungen anzuzeigen, die auf der Seite ausgeführt werden.
  • Wenn Sie in den Wartungsmodus wechseln, wird nur die Ausführung von Webpartcode deaktiviert. Alle SharePoint-Framework Erweiterungen, die auf der Seite registriert sind, werden weiterhin ausgeführt.

Deaktivieren von SPFx-Webparts und -Erweiterungen

Wenn Sie eine Problembehandlung für eine SharePoint-Seite durchführen müssen, um festzustellen, ob eine SharePoint-Framework Erweiterung oder ein Webpart Probleme verursacht, können Sie ?disable3PCode an die URL anfügen, um das Laden von SPFx-Komponenten zu deaktivieren, z. B.:

https://contoso.sharepoint.com/sites/team?disable3PCode

Dadurch wird verhindert, dass SPFx-Komponenten von Drittanbietern auf der Seite geladen werden.

Siehe auch