Compartir a través de

Contexto de ejecución (referencia del lado del cliente)

  • Artículo

 

Publicado: noviembre de 2016

Se aplica a: Dynamics CRM 2015

El contexto de ejecución es un parámetro opcional que puede pasarse a una función de la biblioteca de JavaScript mediante un controlador de eventos. Esta opción se muestra en el cuadro de diálogo de propiedades del controlador cuando se especifica el nombre de la función. Esta opción se establece para un elemento <Handler> (FormXml) mediante el atributo passExecutionContext.

El contexto de ejecución automáticamente se pasa a las funciones establecidas usando los métodos Xrm.Page.data.addOnSave y Xrm.Page.data.entityAttribute.addOnChange y Xrm.Page.uiControl.addPreSearch.

Métodos del contexto de ejecución

  • getContext
    Método que devuelve el objeto Contexto del lado del cliente (referencia del lado del cliente).

  • getDepth
    Método que devuelve un valor que indica el orden en el que se ejecuta el controlador.

  • getEventArgs
    Método que devuelve un objeto con métodos para administrar el evento Save.

  • getEventSource
    Método que devuelve una referencia al objeto en que se produjo el evento.

  • Variables compartidas
    Las variables compartidas permiten compartir una variable con otros controladores para el mismo evento. Utilice los métodos setSharedVariable y getSharedVariable para trabajar con variables compartidas.

getContext

Método que devuelve el objeto Contexto del lado del cliente (referencia del lado del cliente)

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

getDepth

Método que devuelve un valor que indica el orden en el que se ejecuta el controlador.

  • Valor de retorno
    Tipo: Número

    El orden empieza con 0.

getEventArgs

Método que devuelve un objeto con métodos para administrar el evento Save.

Nota

Este método devuelve null para cualquier evento distinto del evento Save.

ExecutionContextObj.getEventArgs()

getEventSource

Método que devuelve una referencia al objeto en que se produjo el evento.

ExecutionContextObj.getEventSource()

  • Valor de retorno
    Tipo: Objeto

    Este método devuelve el objeto del modelo de objetos Xrm.Page que es el origen del evento, no un objeto HTMLDOM. Por ejemplo, en un evento OnChange, este método devuelve el objeto de atributo Xrm.Page.data.entity que representa el atributo cambiado.

Variables compartidas

Las variables compartidas permiten compartir una variable con otros controladores para el mismo evento. Utilice los métodos setSharedVariable y getSharedVariable para pasar variables entre funciones.

setSharedVariable

Establece el valor de una variable que será usada por un controlador una vez que se complete el controlador actual.

ExecutionContextObj.setSharedVariable(key, value)

  • Argumentos
    String: El nombre de la variable.

    Object: El valor que se va a establecer.

getSharedVariable

Recupera un conjunto de variables definidas mediante setSharedVariable.

ExecutionContextObj.getSharedVariable(key)

  • Argumentos
    String: El nombre de la variable.

  • Valor de retorno
    Tipo: Objeto

    El tipo específico depende de cuál es el objeto del valor.

Ver también

Referencia de programación del lado del cliente

© 2017 Microsoft. Todos los derechos reservados. Copyright