Como usar JavaScript Personalizado em Telas de Formulário no Wakeme Pro

Modificado em Ter, 22 Jul na (o) 10:10 AM

Versão
Wakeme Essencial
Wakeme Pro
Disponível em:
  
Opcional


(Caso tenha interesse em utilizar essa funcionalidade, entre em contato com o Analista de CS responsável pela sua Instituição de Ensino.)


Gostaria de adaptar ainda mais os formulários do Wakeme Pro à sua realidade? Com este recurso, você consegue aplicar um JavaScript personalizado em formulários de edição, permitindo ajustes finos e específicos para o seu processo. 

Primeiramente será necessário alterar o campo “Permitir JS no Formulário" do seu registro cadastrado na entidade “CRM Educacional” para “Sim”, fazendo com que o script possa ser configurado e executado na tela. Em seguida, deve ser efetuado o cadastro de um script personalizado.  Vamos entender como cadastrá-lo?

  • No menu lateral, clique em Administração.


  • Em seguida, clique em Campos Customizados.

Na tela de Campos Customizados, você deverá selecionar entre as entidades Lead, Inscrição ou Telefonema e o preencher na aba de Scripts.

Imagem 1206032648, Imagem, Imagem 


Durante o desenvolvimento dos seus scripts, você poderá utilizar algumas variáveis pré-estabelecidas, sendo elas: 

  • usuárioCargoLogado: Retorna true caso o usuário tenha permissão de acesso a entidade ou false caso não. 

  • emailUsuario: Retorna o endereço de e-mail do usuário logado. 

  • cargoUsuario: Retorna qual o nome do Cargo do usuário logado. 


Para salvar o código inserido, é utilizado o mesmo botão de salvar do formulário. 


Após o script ser salvo e estar ativo, ao abrir sua respectiva tela no Wakeme Pro, ele já será renderizado dentro de um IFrame, limitado a ações dentro do escopo da tela. 
     

  • No exemplo abaixo, ocultamos o campo Telefone Celular do formulário. 

 Imagem 1591275240, Imagem, Imagem 

Observações Importantes: 

  • Para realizar alterações em elementos da tela, é necessário utilizar o window.parent.document, já que por renderizarmos o script em um IFrame, não existe o acesso direto aos componentes da página; 

  • Só serão executados scripts ativos. 

  • Toda criação ou alteração de script é salva em nossa auditoria; 

  • Apenas um script pode ser criado por tela. 

Recomendações: 

  • Não altere campos nativos: Alterações em campos, IDs ou eventos padrão do sistema podem causar falhas impactando na experiência do usuário. 

  • Prefira escrever scripts modulares e isolados: Envolva seu código em funções ou IF’s para evitar conflitos. 

  • Não mude as regras de negócio: Scripts que modificação a lógica de exibição, obrigatoriedade da campos ou envio de dados podem comprometer a lógica da aplicação. 

  • Teste antes de publicar: Valide seu script antes de liberar para os usuários. 

 

Veja alguns exemplos: 

if(emailUsuario === "exemplo@crmeducacional.com"){ 

    const campo = $(window.parent.document).find("input[name='Nome']"); 

    campo.prop("disabled", true); 

} 

 

Imagem 1508148037, Imagem, Imagem 

  • Desabilitar um campo caso o cargo do usuário seja: Exemplo.

if(cargoUsuario === "Exemplo"){ 

    $("button[data-id='info-lead']").text("Aba de Exemplo") 

} 

Imagem 681245575, Imagem, Imagem 

  • Informar no console de desenvolvedor caso o usuário tenha permissão de acesso 

if(usuarioCargoLogado){ 

    const estrangeiro =  $(window.parent.document).find("select[name='Estrangeiro']"); 

    if(estrangeiro.val() == 'true'){ 

        const numeroDoPassaporte =  $(window.parent.document).find("input[name='NumeroDoPassaporte']"); 

        numeroDoPassaporte.hide(); 

    } 

} 

Imagem 1748572216, Imagem, Imagem 

 

 

 
     

 

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos
A verificação do CAPTCHA é obrigatória.

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo