Alterne para as etapas do Frame Flow

Last Updated junho 29, 2026

Breve Visão Geral

Switch to frame é uma etapa de fluxo que permite que o Smart Walk-Thru continue sendo executado em vários domínios, como em um iFrame ou em uma janela popup HTML.

Se o seu Smart Walk-Thru for executado em diferentes domínios, adicione uma etapa de Switch to frame flow para orientar o WalkMe para o local correto. Isso garante uma reprodução contínua, desde que o WalkMe Snippet esteja instalado em todos os domínios.

Essa etapa é comumente usada para:

  • IFrames – páginas incorporadas que carregam a partir de um URL diferente

  • Pop-ups HTML – janelas de sobreposição que também usam um URL separado

Como Funciona

Quando você captura uma etapa em um domínio diferente, o WalkMe geralmente adiciona uma etapa de Switch to frame flow automaticamente. Isso acontece com mais frequência com iFrames ou popups. Se a etapa não for adicionada, você pode inseri-la manualmente no caminho Smart Walk-Thru.

Cada etapa de mudança para quadro inclui uma regra que informa ao WalkMe quando ativar. Quando atingido, o WalkMe verifica a regra:

  • Se verdadeiro, o WalkMe muda para o URL definido

  • O WalkMe procura o elemento da próxima etapa nesse local.

A regra também determina se o destino está dentro de um iFrame ou uma nova janela.

Por exemplo, você está criando um Smart Walk-Thru em um site, mas uma etapa está dentro de um iFrame hospedado em outro domínio. Ao capturar essa etapa, o WalkMe insere automaticamente uma etapa de switch to frame antes dela.

As regras são criadas automaticamente:

Se você capturar outra etapa fora do iFrame, o WalkMe adicionará outra etapa de switch to frame antes dessa, usando a regra de que o fluxo atual não está em um iframe interno.

Como usar um Switch to Frame

Insira uma etapa de switch to frame

O WalkMe geralmente adiciona uma etapa de switch to frame automaticamente. Se isso não acontecer, passe o mouse sobre o caminho antes da etapa que é reproduzida em um domínio diferente e selecione switch to frame no Menu Opções.

Criar uma regra para definir a condição

Se a etapa de alternar para enquadrar foi adicionada automaticamente, ela vem com uma regra pré-criada. Sempre abra e reveja-o.

Se você adicionar a etapa manualmente:

  1. Abra o menu Opções da etapa do fluxo e clique em Criar uma condição

  2. Use o tipo de regra de fluxo atual para definir o domínio de destino

  3. Se você estiver mudando para uma janela popup, abra esse URL em uma nova guia do navegador para capturar elementos. O WalkMe só pode selecionar elementos no domínio em que está sendo executado

Pop-ups que não são baseados na web

Algumas janelas, como caixas de diálogo de upload ou download de arquivos, fazem parte do sistema operacional e não são baseadas na Web. O WalkMe não pode interagir com eles diretamente.

Para resolver isso:

  • Adicione uma etapa antes do popup do sistema com instruções claras

  • Inclua recursos visuais como um GIF ou vídeo curto, se necessário

  • Permita que os usuários cliquem em Avançar depois de concluir a ação fora do navegador

Alternativas ao Switch to frame

Se a mudança para um popup ou iFrame não for confiável, você pode ignorá-la. Em vez disso, crie uma etapa fora da estrutura com instruções detalhadas para guiar o usuário. Uma etapa instrucional bem colocada pode ser igualmente eficaz.

Notas técnicas

  • Ao usar o Smart Walk-Thru com iFrames entre domínios, o Smart Walk-Thru pode falhar na etapa Switch to Frame se o UUID dentro do iFrame não corresponder ao UUID no frame de nível superior (pai).

Was this article helpful?

Thanks for your feedback!

Faça parte de algo maior.

Interaja com colegas, tire dúvidas e compartilhe ideias.

Explore nossa comunidade
×
×