WalKme ne se charge pas dans un iFrame

Last Updated juin 12, 2026

Problème

Le contenu WalkMe ne se charge pas dans un iFrame.

Solution

La correction dépend du fait que l'iFrame est du même domaine ou cross-domain. Commencez par identifier l'URL de l'iFrame, puis suivez les étapes pertinentes ci-dessous.

Trouver l'URL iFrame

L'URL de l'iFrame n'est pas toujours visible dans le code HTML du site. Utilisez la console du navigateur pour le trouver — cela est également utile lors de la configuration des étapes Switch to Frame (Passer au cadre) pour confirmer que vos règles d'URL ne s'appliqueront pas à d'autres iFrames.

Dans Chrome :

  1. Cliquez avec le bouton droit sur un élément à l'intérieur de l'iFrame et sélectionnez Inspecter
  2. Accédez à l'onglet Console : vous serez automatiquement placé dans la console iFrame de l'élément que vous avez inspecté
  3. Saisissez document.URL et appuyez sur Entrée
  4. l'URL renvoyée est l'URL source pour cet iFrame.

Dans Firefox :

  1. Cliquez avec le bouton droit sur un élément à l'intérieur de l'iFrame et sélectionnez Inspecter
  2. Dans l'onglet Élément, localisez l'iFrame et notez son nom, son ID, sa classe ou tout autre attribut unique
  3. Allez sur l'onglet Console
  4. Ouvrez le menu déroulant et sélectionnez l'iFrame qui correspond à ce que vous avez vu dans l'onglet Élément
  5. Saisissez document.URL et appuyez sur Entrée
  6. l'URL renvoyée est l'URL source pour cet iFrame.

iFrame de même domaine

Si l'iFrame est de même domaine, vous n'avez pas besoin d'ajouter à nouveau le snippet WalkMe tant qu'il est déjà présent dans le cadre supérieur.

Si vous souhaitez vous ancrer à un élément dans l'iFrame de même domaine à l'aide de jQuery au lieu d'un élément à l'écran, vous devrez configurer iFrame jQuery.

iFrame multidomaine

Si l'iFrame est inter-domaines, le snippet WalkMe doit être présent à l'intérieur de l'iFrame lui-même.

Si vous utilisez une extension, contactez votre responsable de la réussite client ou votre contact WalkMe pour vous assurer que le domaine de l'iFrame est ajouté à l'auto-régex du package correct.

Vérifier si le snippet WalkMe est présent dans l'iFrame

  1. Dans la console iFrame, tapez _walkmeInternals et appuyez sur Entrée
  2. Si le résultat est indéfini, le snippet n'est pas présent et doit être ajouté
  3. Si le résultat renvoie un objet, WalkMe se charge correctement à l'intérieur de l'iFrame

Inadéquation entre l'iFrame et l'UUID entre les domaines

Lorsque vous utilisez le Smart Walk-Thru avec des iFrames inter-domaines, le Smart Walk-Thru peut échouer à l'étape Passer au cadre si l'UUID à l'intérieur de l'iFrame ne correspond pas à l'UUID dans le cadre de premier niveau (parent).

Que vérifier si votre SWT se rompt à Switch to Frame :

  • Confirmez si l'iFrame cible est inter-domaines
  • Comparez l'UUID dans l'iFrame avec l'UUID dans le cadre parent
  • Si les UUID ne correspondent pas, cette inadéquation est la cause probable de l'échec

Cet article a-t-il été utile?

Merci pour votre avis!

Be part of something bigger.

Engage with peers, ask questions, share ideas

Ask the Community
×