Zum Hauptinhalt springen

Fehlerbehebung

Diese Seite behandelt die häufigsten Probleme, die bei der Verwendung des Widget Builders auftreten können, und wie Sie diese beheben.

Widget erscheint nicht in Staffbase​

Ihr Widget ist erstellt und gespeichert, aber es wird nicht angezeigt, wenn Sie es in Staffbase hinzufügen möchten.

Ursache: Das Widget ist nicht als verfügbar markiert, oder die Widget Bundle URL muss registriert werden.

Lösung:

  1. Öffnen Sie Ihr Widget im Widget Builder und gehen Sie zum General-Tab.
  2. Stellen Sie sicher, dass der Schalter Available in Staffbase aktiviert ist.
  3. Klicken Sie auf Save.
  4. Wenn das Widget immer noch nicht erscheint, gehen Sie zu Settings > Widget Bundle URL und klicken Sie auf Re-register, um die Registrierung bei Staffbase zu aktualisieren.

API-Anfrage gibt CORS-Fehler zurück​

Der API-Aufruf Ihres Widgets schlägt in der Browser-Konsole mit einer Meldung wie Access-Control-Allow-Origin oder CORS policy fehl.

Ursache: Die externe API, die Sie aufrufen, erlaubt keine direkten Anfragen vom Browser.

Lösung: Aktivieren Sie die Option Route through Widget Builder im API-Tab Ihres Widgets. Dies leitet die Anfrage über den Widget Builder Server und umgeht CORS-Einschränkungen vollständig.

Weitere Details zur Funktionsweise des Proxys und zur Konfiguration von Authentifizierungs-Headern finden Sie im API Proxy-Leitfaden.

Widget-Vorschau zeigt einen Fehler​

Das Live-Vorschau-Panel im Editor zeigt anstelle Ihres Widgets einen Fehler an.

Ursache: Dies wird in der Regel durch einen nicht erreichbaren API-Endpunkt, eine ungültige API-Antwort oder einen Handlebars-Syntaxfehler in Ihrem Template verursacht.

Lösung:

  1. Gehen Sie zum API-Tab und prüfen Sie den Antwortstatus und den Body. Seit v3.3 zeigt die Vorschau den HTTP-Statuscode und den vollständigen Antwort-Body für einfacheres Debugging an.
  2. Überprüfen Sie, ob die API-Endpunkt-URL korrekt und erreichbar ist.
  3. Wechseln Sie zum Layout-Tab und suchen Sie nach Handlebars-Kompilierungsfehler-Markierungen im Editor -- diese heben Syntaxprobleme wie nicht geschlossene Tags hervor.
  4. Beheben Sie alle Fehler und die Vorschau wird automatisch aktualisiert.

Änderungen werden in Staffbase nicht übernommen​

Sie haben Ihr Widget im Widget Builder aktualisiert, aber die Staffbase-Seite zeigt noch die alte Version.

Ursache: Die Änderungen wurden nicht gespeichert, oder der Browser liefert eine zwischengespeicherte Version aus.

Lösung:

  1. Stellen Sie sicher, dass Sie nach dem Vornehmen von Änderungen auf Save im Widget Builder geklickt haben.
  2. Aktualisieren Sie die Staffbase-Seite -- es ist nicht nötig, das Widget zu entfernen und neu hinzuzufügen.
  3. Wenn die alte Version bestehen bleibt, versuchen Sie ein hartes Neuladen mit Ctrl+Shift+R (Windows/Linux) oder Cmd+Shift+R (Mac), um den Browser-Cache zu umgehen.

"Powered by JASP"-Text am unteren Widget-Rand​

Eine kleine "Powered by JASP"-Zeile erscheint unter Ihrem Widget, wenn es in Staffbase gerendert wird.

Ursache: Dieser Branding-Text wird für Widgets im kostenlosen Plan angezeigt.

Lösung: Wechseln Sie zu einem kostenpflichtigen Plan, um das Branding zu entfernen. Sie können Ihr Abonnement unter Settings > Billing verwalten.

Kein Zugriff auf den Widget Builder möglich​

Sie sehen einen Berechtigungsfehler oder eine leere Seite, wenn Sie versuchen, den Widget Builder zu öffnen.

Ursache: Ihr Staffbase-Konto verfügt möglicherweise nicht über die erforderlichen Berechtigungen, oder die OAuth-Integration ist falsch konfiguriert.

Lösung:

  1. Bestätigen Sie, dass Ihr Staffbase-Konto die Rolle Administrator hat.
  2. Prüfen Sie, ob Ihrer Staffbase-Gruppe unter Settings > Permissions im Widget Builder Zugriff gewährt wurde.
  3. Überprüfen Sie, ob der OAuth-Client korrekt konfiguriert ist -- siehe den Leitfaden zur Ersteinrichtung für die vollständigen Konfigurationsschritte.

Registrierung der Widget Bundle URL fehlgeschlagen​

Sie haben die Widget Bundle URL aus dem Widget Builder kopiert, aber die Registrierung in Staffbase hat nicht funktioniert.

Ursache: Die URL wurde möglicherweise nicht korrekt eingefügt, oder die Staffbase Custom Widgets-Einstellungsseite erfordert ein bestimmtes Format.

Lösung:

  1. Gehen Sie im Widget Builder zu Settings und kopieren Sie die Widget Bundle URL.
  2. Navigieren Sie im Staffbase Studio zu den Custom Widgets-Einstellungen.
  3. Fügen Sie die URL genau wie kopiert ein und klicken Sie auf Install.
  4. Wenn es weiterhin fehlschlägt, überprüfen Sie, ob Ihre Widget Builder-Instanz von Staffbase aus erreichbar ist. Siehe den Leitfaden zur Ersteinrichtung für die vollständige Anleitung.

Handlebars-Template-Fehler​

Der Layout-Editor zeigt Warnungen an oder Ihr Widget wird aufgrund von Template-Problemen fehlerhaft dargestellt.

Ursache: Handlebars-Templates erfordern eine strikte Syntax -- fehlende schließende Tags und falsche Klammerverwendung sind die häufigsten Fehler.

Lösung:

  • Stellen Sie sicher, dass jeder Block-Helper ein passendes schließendes Tag hat: {{#if}} benötigt {{/if}}, {{#each}} benötigt {{/each}}.
  • Verwenden Sie doppelte geschweifte Klammern {{ }} für escaped Ausgabe (in den meisten Fällen empfohlen).
  • Verwenden Sie dreifache geschweifte Klammern {{{ }}} nur, wenn Sie unescaped HTML rendern müssen.
  • Lesen Sie die Handlebars-Referenz für die vollständige Liste der unterstützten Helpers und Syntax.

API-Daten werden in der Vorschau nicht geladen​

Das Vorschau-Panel ist leer oder zeigt "No data", obwohl Sie einen API-Endpunkt konfiguriert haben.

Ursache: Die Daten wurden möglicherweise noch nicht abgerufen, oder die API-Konfiguration hat ein Problem.

Lösung:

  1. Öffnen Sie den API-Tab und klicken Sie auf Load Data, um eine frische Antwort abzurufen.
  2. Überprüfen Sie, ob die API-Endpunkt-URL korrekt und erreichbar ist.
  3. Wenn der Endpunkt eine Authentifizierung erfordert, stellen Sie sicher, dass die Tokens oder Header in den API-Einstellungen konfiguriert sind.
  4. Prüfen Sie das JSON-Antwortformat im Vorschau-Panel -- Ihr Handlebars-Template muss die korrekten Feldnamen aus der Antwort referenzieren.

Widget sieht auf Mobilgeräten anders aus​

Ihr Widget sieht auf dem Desktop großartig aus, aber das Layout bricht auf kleineren Bildschirmen zusammen oder wird falsch dargestellt.

Ursache: Das Template enthält möglicherweise keine responsiven Stile für verschiedene Bildschirmgrößen.

Lösung:

  1. Verwenden Sie die Gerätevorschau-Buttons (Mobil, Tablet, Desktop) im Layout-Editor, um zu testen, wie Ihr Widget bei verschiedenen Breiten gerendert wird.
  2. Wenden Sie responsive Tailwind CSS-Präfixe in Ihrem Template an: sm: für kleine Bildschirme, md: für mittlere und lg: für große.
  3. Weitere Informationen zu responsiven Design-Mustern und Beispielen finden Sie im Tailwind CSS-Leitfaden.

Benötigen Sie weitere Hilfe?​

  • Lesen Sie die FAQ für Antworten auf häufig gestellte Fragen.
  • Kontaktieren Sie unser Support-Team unter support@jasp.eu, wenn Ihr Problem hier nicht behandelt wird.