Troubleshooting

Zuletzt geändert am:

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

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 Theme- und Template-Ressourcen korrekt eingebunden wurden, falls Sie lokale Themes verwenden
  6. ob bei Konfigurationsänderungen remountKey korrekt erhöht wird

Das Formular ist ungestyled

Prüfen Sie:

  1. ob Theme-Styles in Ihre Anwendung importiert wurden
  2. ob das Theme-Script importiert wurde
  3. ob skipThemeLoad und skipTemplatesLoad nur dann gesetzt sind, wenn Sie die Ressourcen wirklich selbst bundeln
  4. ob die Theme-Dateien in der richtigen Reihenfolge geladen werden

Props ändern sich, aber das Formular reagiert nicht

Die React-Komponente ist restart-basiert. Viele Props wirken nur beim Initialisieren.

Prüfen Sie:

  1. ob remountKey bei relevanten Konfigurationsänderungen geändert wird
  2. ob Sie nicht erwarten, dass init-time Props live in eine laufende Instanz übernommen werden
  3. ob embedId stabil bleibt, wenn eine Instanz bewusst weiterverwendet werden soll

Fehlerbehandlung während der Entwicklung

Nutzen Sie onError und optional debug, um Fehler früher sichtbar zu machen:


Konflikte bei mehrfacher Einbettung derselben embedId

Wenn dieselbe embedId mehrfach verwendet wird, kann es zu Konflikten zwischen bestehenden und neuen Instanzen kommen.

Prüfen Sie:

  1. ob dieselbe embedId gleichzeitig an mehreren Stellen gemountet wird
  2. ob conflictBehavior zu Ihrem Anwendungsfall passt
  3. ob bei gewollter Neuinitialisierung dieselbe embedId stabil bleibt und stattdessen remountKey geändert wird

Feedback