Contesto di esecuzione (riferimento sul lato client)

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

Il contesto di esecuzione è un parametro facoltativo che è possibile passare a una funzione della libreria JavaScript tramite un gestore eventi. Questa opzione è presentata nella finestra di dialogo delle proprietà del gestore quando si specifica il nome della funzione. Questa opzione viene impostata per un elemento <Handler> (FormXml) che utilizza l'attributo passExecutionContext.

Il contesto di esecuzione viene automaticamente passato alle funzioni impostate utilizzando i metodi Xrm.Page.data.addOnSave e Xrm.Page.data.entityAttribute.addOnChange e Xrm.Page.uiControl.addPreSearch.

Metodi del contesto di esecuzione

• getContext
  Metodo che restituisce l'oggetto Contesto sul lato client (riferimento sul lato client).

• getDepth
  Metodo che restituisce un valore che indica l'ordine in cui questo gestore viene eseguito.

• getEventArgs
  Metodo che restituisce un oggetto con i metodi per gestire l'evento Save.

• getEventSource
  Metodo che restituisce un riferimento all'oggetto in cui si è verificato l'evento.

• Variabili condivise
  Le variabili condivise consentono la condivisione di una variabile con altri gestori per lo stesso evento. Utilizzare i metodi getSharedVariable e setSharedVariable da utilizzare con le variabili condivise.

getContext

Metodo che restituisce l'oggetto Contesto sul lato client (riferimento sul lato client)

ExecutionContextObj.getContext()

• Valore restituito
  Tipo: oggetto.

getDepth

Metodo che restituisce un valore che indica l'ordine in cui questo gestore viene eseguito.

• Valore restituito
  Tipo: numero

  L'ordine inizia con 0.

getEventArgs

Metodo che restituisce un oggetto con i metodi per gestire l'evento Save.

Nota

Questo metodo restituisce null per ogni evento diverso dall'evento Save.

ExecutionContextObj.getEventArgs()

• Valore restituito
  Tipo: oggetto.

  Ulteriori informazioni:Argomenti dell'evento di salvataggio (riferimento sul lato client).

getEventSource

Metodo che restituisce un riferimento all'oggetto in cui si è verificato l'evento.

ExecutionContextObj.getEventSource()

• Valore restituito
  Tipo: oggetto.

  Questo metodo restituisce l'oggetto dal modello a oggetti Xrm.Page che è l'origine dell'evento, non un oggetto HTMLDOM. Ad esempio, in un evento OnChange, questo metodo restituisce l'oggetto dell'attributo Xrm.Page.data.entity che rappresenta l'attributo modificato.

Variabili condivise

Le variabili condivise consentono la condivisione di una variabile con altri gestori per lo stesso evento. Utilizzare i metodi di getSharedVariable e setSharedVariable per passare le variabili tra le funzioni.

setSharedVariable

Imposta il valore di una variabile da utilizzare da un gestore al termine del gestore corrente.

ExecutionContextObj.setSharedVariable(key, value)

• Argomenti
  String: il nome della variabile

  Object: il valore da impostare.

getSharedVariable

Recupera una variabile impostata tramite setSharedVariable.

ExecutionContextObj.getSharedVariable(key)

• Argomenti
  String: il nome della variabile.

• Valore restituito
  Tipo: oggetto.

  Il tipo specifico dipende dall'oggetto del valore.

Vedere anche

Riferimento programmazione sul lato client

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright