Partilhar via


Contexto de execução (referência do cliente)

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

O contexto de execução é um parâmetro opcional que pode ser passado para uma função de biblioteca do JavaScript por meio de um manipulador de eventos. Essa opção é apresentada na caixa de diálogo de propriedades do manipulador quando você especifica o nome da função. Essa opção é definida para um elemento <Handler> (FormXml) usando o atributo passExecutionContext.

O contexto de execução é passado automaticamente para funções definidas usando os métodos Xrm.Page.data.addOnSave e Xrm.Page.data.entityAttribute.addOnChange e Xrm.Page.uiControl.addPreSearch.

Métodos do contexto de execução

  • getContext
    Método que retorna o objeto Contexto do cliente (referência do cliente).

  • getDepth
    O método que retorna um valor que indica a ordem em que esse manipulador é executado.

  • getEventArgs
    Método que retorna um objeto com métodos para gerenciar o evento Save.

  • getEventSource
    Método que retorna uma referência ao objeto em que o evento ocorreu.

  • Variáveis compartilhadas
    Variáveis compartilhadas permitem compartilhamento de uma variável com outros manipuladores para o mesmo evento. Você usa os métodos setSharedVariable e getSharedVariable para trabalhar com variáveis compartilhadas.

getContext

Método que retorna o objeto Contexto do cliente (referência do cliente)

ExecutionContextObj.getContext()
  • Valor de Retorno
    Tipo: Objeto

getDepth

O método que retorna um valor que indica a ordem em que esse manipulador é executado.

  • Valor de Retorno
    Tipo: Número

    O pedido começa com 0.

getEventArgs

Método que retorna um objeto com métodos para gerenciar o evento Save.

Observação

Esse método retornará nulo para qualquer evento diferente do evento Save.

ExecutionContextObj.getEventArgs()

getEventSource

Método que retorna uma referência ao objeto em que o evento ocorreu.

ExecutionContextObj.getEventSource()
  • Valor de Retorno
    Tipo: Objeto

    Esse método retornará o objeto do modelo de objeto Xrm.Page que é a origem do evento, não um objeto HTMLDOM. Por exemplo, em um evento OnChange, este método retorna o objeto de atributo Xrm.Page.data.entity que representa o atributo alterado.

Variáveis compartilhadas

Variáveis compartilhadas permitem compartilhamento de uma variável com outros manipuladores para o mesmo evento. Você usa os métodos setSharedVariable e getSharedVariable para passar variáveis entre as funções.

setSharedVariable

Define o valor de uma variável para ser usada por um manipulador depois que o manipulador concluir.

ExecutionContextObj.setSharedVariable(key, value)
  • Argumentos
    String: O nome da variável

    Object: O valor para definir.

getSharedVariable

Recupera um conjunto de variáveis usando setSharedVariable.

ExecutionContextObj.getSharedVariable(key)
  • Argumentos
    String: O nome da variável.

  • Valor de Retorno
    Tipo: Objeto

    O tipo específico depende qual é o objeto para o valor.

Confira Também

Referência de programação do cliente

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais