SharePoint: Fehlerbehebung
Das Webpart zeigt seine Meldungen auf Englisch, unabhängig von der Sprache der Seite. Suche hier nach dem Text, den du auf der Seite siehst. Die Einrichtung selbst beschreibt Widgets auf SharePoint.
Einrichtung und Anmeldung
| Meldung oder Symptom | Ursache | Lösung |
|---|---|---|
„This Microsoft tenant is not registered in Widget Builder yet.“ (API-Code TENANT_NOT_REGISTERED) | Der Mandant ist bei diesem Widget Builder nicht registriert. Häufig ist er bei einer anderen Installation registriert, etwa wenn das Paket von dort stammt, oder die Registrierung wurde entfernt. | Klicke auf Register tenant in Widget Builder und bestätige in den Einstellungen (Schritt 5). |
| „Dieser Registrierungslink ist abgelaufen. Lade die SharePoint-Seite neu, um einen neuen zu erhalten.“ | Der Registrierungslink ist älter als 15 Minuten oder wurde schon benutzt. | Lade die SharePoint-Seite neu und klicke erneut auf den Link. |
| „Dieser Microsoft-Mandant ist bereits mit einem anderen Client des Widget Builders verbunden.“ | Ein Mandant gehört zu genau einem Client. | Entferne die Registrierung beim anderen Client und registriere den Mandanten dann hier. |
| „Widget Builder is not authorised in this tenant yet. …“ oder jeder Aufruf endet mit 401 | Die API-Berechtigung Widget Builder SharePoint ist nicht genehmigt, oder es wurde eine andere App genehmigt. | SharePoint Admin Center → Erweitert → API-Zugriff: Anforderung Widget Builder SharePoint / user_impersonation genehmigen (Schritt 3). |
| Karte zeigt „Es hat sich noch kein Webpart beim Widget Builder gemeldet“ | Der Mandant ist registriert, aber kein Webpart hat ein Widget geladen. Meist fehlt die API-Genehmigung. | Schritt 3 prüfen, dann eine Seite mit dem Webpart öffnen. |
„Tenant awaiting release“ (API-Code TENANT_PENDING) | Euer Widget-Builder-Client wartet noch auf die Freigabe. | Wende dich an support@jasp.eu. |
| 403 „origin not allowed for installation“ | Die Registrierung ist auf bestimmte SharePoint-Adressen beschränkt, und diese Seite gehört nicht dazu. | Bitte den Betreiber eures Widget Builders, die Adresse freizugeben. |
| „Could not reach Widget Builder. Check that it is running.“ | Das Webpart erreicht die Adresse nicht, die beim Download ins Paket geschrieben wurde: Das Paket stammt aus einer anderen Installation, oder ein Proxy oder eine Firewall blockiert sie. | Lade das Paket aus dem Widget Builder herunter, den eure Seiten nutzen sollen, und lade es erneut in den App-Katalog (Webpart aktualisieren). |
| „This Widget Builder is not set up for SharePoint yet.“ | Diese Installation hat SharePoint nicht eingerichtet. | Betrifft eigene Installationen: Der Betreiber muss die Microsoft-Entra-Einrichtung abschließen. |
| Paket herunterladen ist deaktiviert, die Karte meldet „Dieser Widget Builder ist fehlerhaft konfiguriert“ | Das Paket würde um Genehmigung einer anderen Entra-App bitten, als diese Installation akzeptiert (SHAREPOINT_ENTRA_CLIENT_ID und SHAREPOINT_ENTRA_RESOURCE_NAME zeigen auf verschiedene App-Registrierungen). | Nur der Betreiber kann das beheben. Schick ihm die Meldung. |
Widget-Auswahl
| Meldung oder Symptom | Ursache | Lösung |
|---|---|---|
| „No widgets or built-ins are active for your Widget Builder client yet.“ | Im Widget Builder ist kein Widget und kein Standard-Widget aktiv. | Aktiviere ein Widget im Widget Builder und lade die Seite neu. |
| „No widget selected — A widget can only be chosen while the page is in edit mode.“ | Das Webpart steht ohne Widget auf einer veröffentlichten Seite. | Seite bearbeiten, Webpart anklicken und ein Widget wählen. |
| Kachel ausgegraut mit Not available here | Das Element kann auf SharePoint nicht dargestellt werden. Den Grund zeigt der Tooltip der Kachel. | Siehe Element nicht verfügbar. |
Element nicht verfügbar
| Tooltip | Lösung |
|---|---|
| „This item has no template and no native bundle, so SharePoint cannot render it.“ | Das Widget hat weder eine Handlebars-Vorlage noch ein Bundle. Gib ihm im Widget Builder ein Layout. |
| „Native widgets are not included in this licence. Ask a Widget Builder administrator to enable them.“ | Das Standard-Widget braucht native Widgets, die eure Lizenz nicht enthält. Wende dich an JASP. |
| „This widget has no active bundle version. Ask a Widget Builder administrator to publish one.“ | Für dieses Standard-Widget ist keine Bundle-Version aktiv. Wende dich an JASP. |
Darstellung
| Meldung oder Symptom | Ursache | Lösung |
|---|---|---|
| „This widget needs to be configured before it can be shown.“ | Pflichtfelder in den Einstellungen sind leer. | Open settings und die mit * markierten Felder ausfüllen. Lesende sehen „Ask a page author …“ — dann muss jemand mit Bearbeitungsrechten die Einstellungen setzen. |
| „This widget is no longer available“ | Das Widget wurde im Widget Builder deaktiviert oder gelöscht. | Widget wieder aktivieren, oder im Bearbeitungsmodus Choose another widget. |
| „Problem rendering this widget“ (nur im Bearbeitungsmodus) | Der Widget Builder hat beim Rendern Warnungen gemeldet, etwa für fehlende Daten oder Einstellungen. | Teste das Widget in der Vorschau des Widget Builders mit denselben Einstellungen. |
| „This widget is not supported on SharePoint.“ | Das Widget hat keine darstellbare Vorlage. | Wie Element nicht verfügbar. |
| „This widget renders through a native bundle, which the server cannot render. Update the Widget Builder web part …“ | Das Webpart im App-Katalog ist älter als die Unterstützung nativer Widgets. | Webpart aktualisieren. |
| „This widget could not be loaded“ mit „The widget bundle could not be loaded from …“ | Das Bundle eines nativen Widgets kam nicht an: Netzwerkfehler, oder eine Content Security Policy eures Mandanten blockiert Skripte von der Widget-Builder-Adresse. | Prüfe in der Browser-Konsole, welche Anfrage blockiert wird, und gib die Widget-Builder-Adresse für Skripte frei. |
| Widget erscheint, sieht aber ungestylt aus | Das serverseitige Styling war nicht verfügbar. | Prüfe das Widget in der Vorschau des Widget Builders. |
| Widget zeigt Staffbase-Inhalte als nicht verfügbar | Staffbase-Benutzer, -Bereiche und -Anmeldung gibt es auf SharePoint nicht. | Kein Fehler. Solche Widgets sind für Staffbase gebaut. |
| „Something went wrong. Cannot read properties of undefined (reading 'replace')“ | Webpart älter als 0.16.9 auf einer Seite, die per Vorlage, PnP oder REST angelegt wurde. | Webpart aktualisieren. |
Änderungen kommen nicht an
| Symptom | Ursache | Lösung |
|---|---|---|
| Eine Änderung an einem Widget erscheint nicht | Die Seite wurde seit dem Speichern nicht neu geladen. | Seite neu laden. Widgets brauchen kein neues Paket. |
| Eine neue Funktion oder Korrektur des Webparts erscheint nicht | Im App-Katalog liegt noch das alte Paket, oder ein Paket mit derselben Version wurde erneut hochgeladen. | Aktuelles Paket herunterladen und hochladen, dann in der Spalte App-Version prüfen (Webpart aktualisieren). |
| Karte zeigt Installiertes Webpart: nicht gemeldet | Das Webpart hat seit der Registrierung kein Widget geladen, oder es ist älter als 0.16.9 und meldet seine Version nicht. | Seite mit dem Webpart öffnen; bleibt die Anzeige, das Webpart aktualisieren. |