Encontre Dicas Básicas de Solução de Problemas de Elementos

Last Updated janeiro 6, 2026

Breve Visão Geral

As instruções abaixo não são um guia passo a passo para investigar o comportamento relacionado ao "elemento de localização". Eles fornecem várias opções a serem consideradas com base no caso específico.

Procure a descrição que melhor se adapta à sua situação e veja se ela pode ajudar com o comportamento que você está enfrentando.

Elementos de tempo e dinâmicos

Se o elemento para o qual o WalkMe está apontando aparecer na página como resultado da interação humana ou puder mudar dinamicamente, considere ativar configurações que possam fazer o conteúdo reagir a essas alterações.

  • No Smart-Walk Thrus, é chamado de "Balão Aderente" e pode ser encontrado em Balão >Aderente de Aparência
  • Em aplicativos como Lançadores e SmartTips, configurações semelhantes podem ser encontradas em Comportamento do >Elemento Selecionado. Você encontrará mais opções aqui, pois vários itens podem aparecer na mesma página da web, enquanto os Smart-Walk Thrus geralmente exibem um balão de cada vez, a menos que você também esteja usando etapas de pares.

    Tente usar a configuração que melhor se adapta ao seu caso de uso e testar o conteúdo em ambientes de visualização e publicados para confirmar que ele se comporta conforme o esperado.No geral, essas configurações não são necessárias para todos os itens e podem até causar lentidão no conteúdo ou na página da Web se for esperado que uma quantidade enorme de conteúdo apareça na mesma página com essa configuração ativada.No entanto, eles também podem desempenhar um papel fundamental na UX suave quando o elemento ao qual o WalkMe está conectado aparece atrasado ou desaparece e reaparece como resultado da interação do usuário.
    Observação

    'Automático' é a melhor opção devido à natureza da sua lógica e à capacidade de ajustar o comportamento do elemento com base na análise de dados.

Valide sem alterações na interface do usuário ou estrutura da página, relacionadas ao elemento capturado

Ao contrário da primeira opção, em que o elemento pode ser exibido ou oculto, mas permanece o mesmo estruturalmente, às vezes os elementos passam por uma reforma da interface do usuário, onde o código do elemento muda e o WalkMe não é mais capaz de reconhecer o elemento devido às diferenças nos detalhes, como ID do elemento/classe/estilo/posição na página e posicionar a hierarquia de elementos na estrutura da página.


Em alguns casos, a interface do usuário da página permanece a mesma, mas a estrutura muda drasticamente, fazendo com que o WalkMe perca o elemento.

Nem sempre é possível dizer se essa alteração ocorreu ou se é significativa o suficiente para causar problemas, no entanto, se você vir uma diferença óbvia na interface do usuário e o conteúdo quebrado funcionava corretamente antes da alteração da interface do usuário - esse é provavelmente o motivo! Sinta-se à vontade para recuperar esses elementos na interface do usuário atualizada e republicá-la depois.

Considere usar a configuração Capturar capturas de tela por padrão, pois isso geralmente pode ajudar você a descobrir como o elemento estava quando foi criado originalmente.

Você pode encontrar essa configuração em Configurações do sistema. >Configurações gerais >de captura de tela

Observação

Você pode querer adicionar uma etapa de espera antes das etapas que devem ser executadas após a alteração da página ou da interface do usuário, às vezes isso pode ajudar na exibição das etapas exatamente quando necessário ou, em outras palavras, esperar que algo aconteça e exibir a etapa depois, especialmente se o fluxo deve aguardar por um comportamento específico e não estiver incluído como um gatilho para a etapa anterior.

Excluir a possibilidade de acesso/permissão do usuário

Outro item que às vezes é superestimado é o acesso a seções específicas de aplicativos web. Por exemplo, ao criar uma orientação Smart-Walk Thru que deve orientar o usuário por todas as configurações de perfil, uma das etapas aponta para um componente exclusivo disponível apenas para usuários administradores. Essa etapa provavelmente ficará presa no fluxo, pois nunca encontrará o elemento quando um usuário regular estiver seguindo as orientações, quebrando o fluxo sem querer.

Certifique-se de criar ramificações para diferentes grupos de usuários ou segmentar o conteúdo por grupos de usuários, se possível.

Detalhes do Elemento Selecionado, identificação por texto e opções do seletor jQuery

Se você estiver modificando as configurações padrão do item e trocando de Automático para Identificar por texto ou seletor jQuery, preste atenção ao contexto, pois é necessária a menor alteração para quebrar a configuração devido à sua natureza codificada. Aqui estão alguns exemplos:

  • Identificar por texto A opção é usada aqui e o título do elemento é "Texto do Widget do recurso principal"
    Mesmo que uma letra mude no título, isso não será mais considerado o mesmo elemento e o conteúdo não será exibido. Veja como o recurso se tornou recursos e o WalkMe já está alertando sobre o elemento não presente na página, pois o texto não corresponde mais ao que foi capturado originalmente.
  • Seletores jQuery Compartilham o mesmo sintoma, pois é uma função de segmentação muito precisa que não deixa espaço para alterações. Neste exemplo, analisaremos o mesmo título, mas digamos que você gostaria de usar o seletor jQuery, pois o texto não é confiável, pois pode mudar ligeiramente ou parecer completamente diferente se o aplicativo da Web oferecer suporte a vários idiomas.

    Parece que a classe "recurso de widget" é confiável, vamos usá-la!Usamos a função wmjQuery() para validar o seletor e confirmar que ele foi encontrado sem problemas.
    No entanto, essa opção também está bloqueada ao valor exato do seletor e até mesmo uma pequena alteração na estrutura da página quebrará o seletor.

    Recomendamos evitar usar seletores jQuery ou opções de identificação por texto, a menos que seja necessária uma solução temporária devido a um caso de emergência. A opção Automático provavelmente será capaz de lidar com modificações insignificantes e ainda deve encontrar o elemento na página.


Multilíngue faz a diferença!

Conforme descrito acima, vários idiomas muitas vezes podem fazer com que o conteúdo não funcione em determinados idiomas e seja exibido apenas no idioma originalmente capturado. Para resolver esse problema, recomendamos que você use nossa funcionalidade Léxico, que permite que o WalkMe aprenda sobre as variações de palavras e até mesmo permita que você carregue transições diretamente para o dicionário específico do sistema, caso a tradução seja feita sob medida ou não seja reconhecida por padrão.

Leia mais sobre o Léxico aqui:

Reconhecimento de Elementos e
Carregamento de Traduções do Léxico

Assistente via Assist Me

Uma arma secreta que permite que você fique sentado enquanto o WalkMe faz todo o trabalho pesado! Na WalkMe, estamos ansiosos para alcançar o melhor nível de suporte possível com o mínimo de esforço da sua parte. Mesmo que você tenha passado pela solução de problemas inicial e ainda não consiga encontrar o motivo pelo qual o conteúdo não se comporta como esperado, basta usar o botão Ajudar-me e fornecer as informações necessárias no ticket. O Assistente analisará a situação e fornecerá uma solução o mais rápido possível e, se não conseguir resolver o problema automaticamente, um ticket de suporte será enviado em seu nome, melhorando muito o tempo de resolução, pois você já forneceu as informações iniciais.

Leia mais sobre o Assistente WalkMe aqui:

Assistente WalkMe
Assistente WalkMe: Guia de Introdução
Assistente WalkMe: Tickets

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
×