Troubleshooting

Zuletzt geändert am:

In diesem Artikel finden Sie typische Fehlerbilder sowie Hinweise zur Analyse und Behebung häufiger Probleme.

mount() wirft sofort einen Fehler

Prüfen Sie:

  1. ob der Code wirklich in einer Browser-Umgebung läuft
  2. ob der übergebene Selector auf ein vorhandenes Element zeigt
  3. ob tatsächlich ein Konfigurationsobjekt übergeben wird
  4. ob mindestens embedId oder formDefinition gesetzt ist

Das Formular wird nicht angezeigt

Prüfen Sie:

  1. ob embedId korrekt ist
  2. ob das Formular veröffentlicht ist
  3. ob srcUrl korrekt gesetzt ist
  4. ob Ihre Domain in Formcentric hinterlegt ist
  5. ob dataUrl, formappUrl oder designUrl auf die richtigen Endpunkte zeigen
  6. ob Theme- und Template-Ressourcen korrekt konfiguriert wurden, wenn ein lokales Theme verwendet wird

Das Formular ist ungestyled

Prüfen Sie:

  1. ob das Theme-CSS geladen wird
  2. ob die Theme-Templates geladen werden
  3. ob skipThemeLoad und skipTemplatesLoad nur dann gesetzt sind, wenn Sie diese Assets wirklich selbst bundeln
  4. ob themeDir und theme oder die expliziten Asset-URLs vollständig konfiguriert sind

Konfigurationsänderungen wirken sich nicht auf die laufende Form aus

Das SDK ist restart-basiert. Viele Konfigurationswerte wirken nur beim Initialisieren.

Prüfen Sie:

  1. ob bei relevanten Konfigurationsänderungen explizit neu gemountet wird
  2. ob Sie nicht erwarten, dass Init-Time-Felder live in eine laufende Instanz übernommen werden
  3. ob embedId stabil bleibt, wenn bewusst mit Instanzübergaben gearbeitet wird

Konfliktfehler bei derselben embedId

Wenn dieselbe embedId mehrfach gemountet wird, erzwingt das SDK ein strikteres Konfliktverhalten als der Legacy-Pfad.

Prüfen Sie:

  1. ob dieselbe embedId bereits auf einem anderen Element aktiv ist
  2. ob conflictBehavior für Ihren Anwendungsfall auf 'stop-existing' gesetzt werden sollte
  3. ob stop() oder unmount() vor einem erneuten Mount korrekt awaited werden

Feedback