Partilhar via

Configure processadores de eventos para um formulário

  • Artigo

Este tópico aplica-se ao Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Configurar processadores de eventos de formulário de aplicações condicionadas por modelo

Os processadores de eventos de para os formulários do Dynamics 365 Customer Engagement (on-premises) podem ser configurados para as seguintes áreas num formulário:

Elemento Evento Descrição
Formulário OnLoad Ocorre quando o formulário é possível.
OnSave Ocorre quando os dados guardada.
Tabulação TabStateChange Ocorre quando o separador é expandido ou minimizado.
Campo OnChange Ocorre quando os dados no campo e alterem o controlo perder o foco.
IFRAME OnReadyStateComplete Ocorre quando o conteúdo possível de uma IFRAME.

Um processador de eventos consiste numa referência a um recurso Web de JavaScript e uma função definidos nesse recurso Web que será executado quando o evento ocorre. Cada elemento pode ter 50 processadores de eventos separados configurados.

Importante

Configurar um processador de eventos incorretamente pode dar azo a erros de script que poderão fazer com que o formulário não carregam ou não funcionam corretamente. Se não for desenvolvimento de script, certifique-se de que precisa de compreender as opções de configuração necessita de script.

Não configurar um processador de eventos de script utilizando uma biblioteca que não venha de uma origem que é confia. Os scripts podem ser utilizados para efetuar qualquer ação que um utilizador pode efetuar e um script deficientemente escrito pode significativamente danificar o desempenho de um formulário.

Depois de configurar um teste do processador de eventos para verificar sempre que está a funcionar corretamente.

Para configurar um processador de eventos

  1. No editor de formulários, selecione o elemento com o evento para o qual pretende configurar um processador.

  2. No Separador Base, no grupo Editar, selecione Alterar Propriedades ou simplesmente faça duplo clique no elemento.

  3. No diálogo propriedades do elemento, selecione o separador de Eventos.

  4. Expanda a área de Bibliotecas de formulário. Se a biblioteca de documentos que contém a função que pretende definir para o processador de eventos já não estiver listado, adicione uma biblioteca.

  5. Para adicionar uma biblioteca de formulário a um processador de eventos:

    1. Na secção de Bibliotecas de formulário de Lista de eventos, selecione Adicionar.

    2. Localize o recurso Web de JavaScript na lista de recursos Web disponíveis. Selecione-o e selecione Adicionar.

      Se o recurso Web de JavaScript de que necessita não existir, selecione Novo para abrir um novo formulário de recurso Web e criar um.

    3. Para criar um recurso Web JavaScript:

      1. No formulário de recurso Web definir as seguintes propriedades:

        Propriedade Valor
        Nome Necessário. Introduza o nome do recurso Web.
        Nome a Apres. Necessário. Escreva o nome a apresentar na lista de recursos Web.
        Descrição Opcional. Introduza uma descrição do recurso Web.
        Tipo Necessário. Selecione Script (JScript).
        Idioma Opcional. Selecione um dos idiomas disponíveis para a sua organização.

      2. Se foi fornecido com um script, recomendamos vivamente que utiliza o botão Procurar para localizar o ficheiro e para o carregar.

        Alternativamente, poderá selecionar o botão Editor de texto e colar ou introduzir ou conteúdo do script do diálogo Editar conteúdo.

        Nota

        Dado que este editor de texto simples não fornece as funcionalidades para verificar a exatidão de script, normalmente deverá sempre experimentar utilizar uma aplicação separada como Visual Studio para editar scripts e transferi-los para carregar em.

      3. Selecione Guardar e feche a caixa de diálogo do recurso Web.

      4. O recurso Web que criou agora está selecionado no diálogo de Pesquisar registo. Selecione Adicionar para fechar a caixa de diálogo.

  6. Na secção de Processadores de eventos, selecione o evento que pretende definir um processador de eventos para.

  7. Selecione Adicionar para abrir a caixa de diálogo Propriedades do processador.

  8. No separador de Detalhes escolha a biblioteca apropriada e escreva o nome da função que deve ser efetuada para o evento.

  9. Por predefinição, o processador de eventos está ativado. Desmarque a caixa de verificação de Ativado se não quiser ativar o evento.

    Algumas funções de um contexto de execução ser passadas a função. Selecione se Transmitir o contexto de execução como primeiro parâmetro se for necessário.

    Algumas funções podem aceitar um grupo de parâmetros para gerir o comportamento de uma função. Se estes são necessários, inscreva-os em Lista separada por vírgulas de parâmetros que serão transmitidos para a função.

  10. No separador, Dependências de adicionar todos os campos que o script depende de Campos dependentes na área.

  11. Selecione OK para fechar a caixa de diálogo Propriedade do Processador.

  12. Quando o processador de eventos é acrescentado manualmente pode ajustar a ordem em que a função será efetuada relativos a todas as outras funções utilizando as setas verdes para mover para cima ou para baixo.

  13. Selecione OK para fechar a caixa de diálogo de propriedades do elemento.

  14. Selecione Guardar para guardar as alterações. Selecione Publicar para publicar o formulário.

Nota

Apesar da interface de utilizador (UI) permitir ajustar a ordem pela qual os scripts são carregados utilizando as setas verdes para cima e para baixo, os scripts não são geralmente carregados sequencialmente.

Consultar também

Utilizar o formulário Principal e os respetivos componentes