Partilhar via


Usar o contexto de execução e o pipeline de evento de formulário

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Este tópico mostra como usar o pipeline de evento de formulário para gerenciar vários manipuladores de eventos de um evento e como usar o contexto de execução para reutilizar funções da biblioteca JavaScript para diferentes eventos.

Contexto de execução

Ao associar uma função em uma biblioteca JavaScript a um manipulador de eventos no Microsoft Dynamics 365, você pode marcar a opção Passar contexto de execução como primeiro parâmetro . A tabela a seguir lista os métodos do objeto de contexto de execução.

Método

Descrição

getContext

Retorna o objeto Xrm.Page.context. Consulte Contexto do cliente (referência do cliente) para obter mais informações.

getDepth

Retorna um valor que indica a ordem em que esse manipulador é executado.

getEventSource

Retorna uma referência ao objeto em que o evento ocorreu.

getSharedVariable

Recupera um conjunto de variáveis usando setSharedVariable.

setSharedVariable

Define o valor de uma variável que pode ser usada por um manipulador depois que o manipulador atual for finalizado.

Use o método getEventSource nas funções para torná-los mais genéricos. Por exemplo, se tiver uma função que formate o número de telefone, você pode usar o método getEventSource para consultar qual atributo causou o evento onChange. Suas funções não precisam fazer referência a um atributo específico.

Pipeline de evento de formulário

Você pode definir até 50 manipuladores para cada evento. Cada manipulador é executado na ordem em que é exibido na guia Eventos da caixa de diálogo de propriedades do elemento do formulário. Isso corresponde à lista de elementos <Handler> (FormXml) no elemento <Handlers> (FormXml) de um evento.

Use os métodos setSharedVariable e getSharedVariable para passar uma variável comum entre as funções. Use o método getDepth do contexto de execução para saber a sequência em que uma função está sendo executada em relação a outros manipuladores.

Confira Também

Crie códigos para os formulários do Microsoft Dynamics 365
Usar eventos de formulário e de campo
Use o modelo de objeto Xrm.Page
Usar controles IFRAME e de recursos da Web em um formulário
Usar o Javascript com o Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais