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 |
|---|---|
Retorna o objeto Xrm.Page.context. Consulte Contexto do cliente (referência do cliente) para obter mais informações. |
|
Retorna um valor que indica a ordem em que esse manipulador é executado. |
|
Retorna uma referência ao objeto em que o evento ocorreu. |
|
Recupera um conjunto de variáveis usando 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