WalkMe wird in einem iFrame nicht geladen

Last Updated Juni 12, 2026

Problem

WalkMe-Inhalte werden nicht innerhalb eines iFrames geladen.

Lösung

Die Lösung hängt davon ab, ob der iFrame derselben Domäne angehört oder domänenübergreifend ist. Beginnen Sie mit der Identifizierung der URL des iFrames und folgen Sie dann den relevanten Schritten unten.

Finden der iFrame-URL

Die URL des iFrames ist nicht immer im HTML-Code der Website sichtbar. Verwenden Sie die Browser-Konsole, um sie zu finden – dies ist auch hilfreich bei der Einrichtung der Schritte „Zu Frame wechseln“, um zu bestätigen, dass Ihre URL-Regeln nicht auf andere iFrames angewendet werden.

In Chrome:

  1. Klicken Sie mit der rechten Maustaste auf ein Element innerhalb des iFrame und wählen Sie Untersuchen
  2. Gehen Sie zur Registerkarte Konsole – Sie werden automatisch in die iFrame-Konsole des von Ihnen untersuchten Elements platziert
  3. Geben Sie document.URL ein und drücken Sie die Enter-Taste
  4. Die zurückgegebene URL ist die Quell-URL für diesen iFrame.

In Firefox:

  1. Klicken Sie mit der rechten Maustaste auf ein Element innerhalb des iFrame und wählen Sie Untersuchen
  2. Suchen Sie auf der Registerkarte Element den iFrame und notieren Sie seinen Namen, seine ID, seine Klasse oder ein anderes eindeutiges Attribut
  3. Gehen Sie zur Registerkarte Konsole
  4. Öffnen Sie das Dropdown-Menü und wählen Sie den iFrame aus, der dem entspricht, was Sie auf der Registerkarte Element gesehen haben
  5. Geben Sie document.URL ein und drücken Sie die Enter-Taste
  6. Die zurückgegebene URL ist die Quell-URL für diesen iFrame.

iFrame für dieselbe Domain

Wenn der iFrame zur gleichen Domain gehört, müssen Sie das WalkMe-Snippet nicht erneut hinzufügen, solange es bereits im oberen Frame vorhanden ist.

Wenn Sie an ein Element innerhalb eines iFrames in der gleichen Domäne mit jQuery anstelle eines Bildschirmelements ankern möchten, müssen Sie iFrame jQuery konfigurieren.

Domain-übergreifender iFrame

Wenn der iFrame domänenübergreifend ist, muss das WalkMe-Snippet innerhalb des iFrames selbst vorhanden sein.

Wenn Sie eine Erweiterung verwenden, wenden Sie sich an Ihren Customer Success Manager oder Ihren WalkMe-Kontakt, um sicherzustellen, dass die Domäne des iFrames zum Selbst-Regex des richtigen Pakets hinzugefügt wurde.

Überprüfen, ob das WalkMe-Snippet im iFrame vorhanden ist

  1. Geben Sie in der iFrame-Konsole _walkmeInternals ein und drücken Sie die Enter-Taste.
  2. Wenn das Ergebnis undefiniert ist, ist das Snippet nicht vorhanden und muss hinzugefügt werden.
  3. Wenn das Ergebnis ein Objekt zurückgibt, wird WalkMe innerhalb des iFrame korrekt geladen

Domänenübergreifende iFrame- und UUID-Diskrepanz

Bei der Verwendung des Smart Walk-Thru mit domänenübergreifenden iFrames kann der Smart Walk-Thru im Schritt „Switch to Frame“ möglicherweise fehlschlagen, wenn die UUID innerhalb des iFrames nicht mit der UUID im übergeordneten Frame übereinstimmt.

Was Sie überprüfen sollten, wenn Ihr SWT beim Switch to Frame abbricht:

  • Bestätigen Sie, ob der Ziel-iFrame domänenübergreifend ist
  • Vergleichen Sie die UUID im iFrame mit der UUID im übergeordneten Frame
  • Wenn die UUIDs nicht übereinstimmen, ist diese Inkongruenz die wahrscheinliche Ursache für den Fehler

War dies hilfreich?

Vielen Dank für Ihr Feedback!

Be part of something bigger.

Engage with peers, ask questions, share ideas

Ask the Community
×