Configurar manipuladores de eventos para um formulário
Este tópico se aplica a Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Configurar manipuladores de eventos para formulários de aplicativos baseados em modelo
Manipuladores de eventos de formulário para Dynamics 365 Customer Engagement (on-premises) podem ser configurados nas seguintes áreas de um formulário:
| Elemento | Evento | Descrição |
|---|---|---|
| Formulário | OnLoad |
Ocorre quando o formulário é carregado. |
OnSave |
Ocorre quando os dados são salvos. | |
| Guia | TabStateChange |
Ocorre quando a guia é expandida ou recolhida. |
| Campo | OnChange |
Ocorre quando os dados no campo são modificados e o controle perde o foco. |
| IFRAME | OnReadyStateComplete |
Ocorre quando o conteúdo de um IFRAME é carregado. |
Um manipulador de eventos consiste de uma referência a um recurso JavaScript da Web, e uma função definida dentro desse recurso da Web será executada quando o evento ocorrer. Cada elemento pode ter até 50 manipuladores de eventos separados configurados.
Importante
Configurar um manipulador de eventos incorretamente pode causar erros de script que podem fazer com que o formulário falhe ao carregar ou funcionar corretamente. Se você não for o desenvolvedor do script, certifique-se de que entenda exatamente as opções de configuração que o script exige.
Não configure um manipulador de evento do script usando uma biblioteca que não seja fornecida de uma origem confiável. Os scripts podem ser usados para executar qualquer ação que um usuário pode realizar e um script mal escrito pode danificar significativamente o desempenho de um formulário.
Após configurar um manipulador de eventos, sempre teste-o para verificar está funcionando corretamente.
Para configurar um manipulador de eventos
No editor de formulários, selecione o elemento com o evento para o qual você deseja configurar um manipulador.
Na guia Página Inicial, no grupo Editar, selecione Alterar Propriedades ou clique duas vezes no elemento.
Na caixa de diálogo de propriedades do elemento, selecione a guia Eventos.
Expanda a área Bibliotecas de Formulários. Se a biblioteca contendo a função que você deseja definir como o manipulador de eventos ainda não estiver listada, adicione a biblioteca.
Para adicionar uma biblioteca de formulários a um manipulador de eventos:
Na seção Bibliotecas de Formulários da Lista de Eventos, selecione Adicionar.
Encontre o recurso JavaScript da Web na lista de recursos da Web disponíveis. Selecione-o e clique em Adicionar.
Se o recurso JavaScript da Web de que você precisa não existir, clique em Novo para abrir um novo formulário e criar um recurso.
Para criar um recurso JavaScript da Web:
No formulário do recurso da Web, defina as seguintes propriedades:
Propriedade Valor Nome Necessário. Digite o nome do recurso da Web. Nome para exibição Necessário. Digite o nome para exibição na lista de recursos da Web. Descrição Opcional. Digite uma descrição do recurso da Web. Tipo Necessário. Selecione Script (JScript). Idioma Opcional. Escolha um dos idiomas disponíveis para a sua organização. Se você foi fornecido com um script, é altamente recomendável usar o botão Procurar para localizar o arquivo e carregá-lo.
Como alternativa você pode selecionar o botão Editor de Texto e colar ou digitar o conteúdo do script na caixa de diálogo Editar Conteúdo.
Nota
Como esse editor de texto simples não oferece recursos para verificar a exatidão do script, deve sempre deve tentar usar um aplicativo separado como o Visual Studio para editar scripts e carregá-los.
Selecione Salvar e feche a caixa de diálogo do recurso da Web.
O recurso da Web criado está selecionado na caixa de diálogo Registro de Pesquisa. Selecione Adicionar para fechar a caixa de diálogo.
Na seção Manipuladores de Eventos, selecione o evento para o qual você deseja definir um manipulador de eventos.
Selecione Adicionar para abrir a caixa de diálogo Propriedades do Manipulador.
Na guia Detalhes, escolha a biblioteca apropriada e digite o nome da função que deve ser executada para o evento.
Por padrão, o manipulador de eventos está habilitado. Desmarque a caixa de seleção Habilitado se você não deseja habilitar esse evento.
Algumas funções exigem que um contexto de execução seja transferido para função. Selecione Transmitir o contexto de execução como o primeiro parâmetro, se for necessário.
Algumas funções podem aceitar um conjunto de parâmetros para controlar o comportamento de uma função. Se forem necessários, insira-os em Lista separada por vírgulas de parâmetros que serão transmitidos para a função.
Na guia Dependências, adicione todos os campos que o script depende na área Campos Dependentes.
Clique em OK para fechar a caixa de diálogo Propriedades do Manipulador.
Quando o manipulador de eventos for inserido, pode ser necessário ajustar a ordem na qual a função será executada em relação às outras funções usando as setas verdes para mover para cima ou para baixo.
Selecione OK para fechar a caixa de diálogo de propriedades do elemento.
Selecione Salvar para salvar suas alterações. Selecione Publicar para publicar o formulário.
Nota
Embora a interface do usuário permita ajustar a ordem em que os scripts são carregados usando as setas verdes para cima e para baixo, na verdade os scripts não são carregados sequencialmente.