Contesto di esecuzione (riferimento sul lato client)

Articolo
06/12/2017

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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.fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_addOnSave e Xrm.Page.data.entityAttribute.6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_addOnChange e Xrm.Page.uiControl.51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_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.
getFormContext
Metodo che restituisce il riferimento a un modulo o a una griglia modificabile in base alla posizione da cui il metodo è stato chiamato.
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.

getFormContext

Metodo che restituisce un riferimento al modulo (Xrm.Page) o alla griglia modificabile in base alla posizione da cui il metodo è stato chiamato.

ExecutionContextObj.getFormContext()

Valore restituito
Tipo: oggetto.

Questo metodo restituisce un riferimento all'oggetto dal modello a oggetti Xrm.Page o all'oggetto in dabc9332-54f3-4b1e-ac98-a3c5a4641b0c#BKMK_GridRow in una griglia modificabile in base alla posizione da cui il metodo è stato chiamato. Questa procedura ti consente di creare i gestori eventi comuni che possono funzionare in un modulo o in una griglia modificabile in base alla posizione da cui sono stati chiamati.

Ulteriori informazioni: Utilizzare il modello a oggetti Xrm.Page e Oggetti e metodi della griglia modificabile (riferimento lato client).

Nota

Questo metodo è stato introdotto in Aggiornamento di dicembre 2016 per Dynamics 365 (online e locale).

Esempio
Nel seguente esempio di codice viene illustrato come creare un metodo che imposta una notifica in un campo del modulo o in una cella di griglia modificabile a seconda di dove è stato registrato lo script (d88d5f21-6385-443b-91f2-0ec0c16b1324#BKMK_FieldOnChangeEvent o l'evento dabc9332-54f3-4b1e-ac98-a3c5a4641b0c#BKMK_OnChange di griglia modificabile):

function commonEventHandler(executionContext) {
    var entityObject = executionContext.getFormContext().data.entity;
    var telephoneAttr = entityObject.attributes.getByName('telephone1');
    var isNumberWithCountryCode = telephoneAttr.getValue().substring(0,1) === '+';

    // telephoneField will be an Xrm.Page control if invoked from a form OnChange event;
    // telephoneField will be a editable grid GridCell object if invoked from editable grid OnChange event.
    var telephoneField = telephoneAttr.controls.getByIndex(0);

    if (!isNumberWithCountryCode) {
        telephoneField.setNotification('Please include the country code beginning with ‘+’.', 'countryCodeNotification');
    }
    else {
        telephoneField.clearNotification('countryCodeNotification');
    }
}

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

Microsoft Dynamics 365

Condividi tramite