Uitvoeringscontext (clientreferentie)

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

De uitvoeringscontext is een optionele parameter die kan worden doorgegeven aan een JavaScript-bibliotheekfunctie via een gebeurtenishandler. Deze optie wordt weergegeven in het dialoogvenster met handlereigenschappen als u de naam van de functie opgeeft. Deze optie is ingesteld voor een <Handler> (FormXml)-element dat gebruikmaakt van het kenmerk passExecutionContext.

De uitvoeringscontext wordt automatisch doorgegeven aan functies die zijn ingesteld met de methoden Xrm.Page.data.addOnSave en Xrm.Page.data.entityAttribute.addOnChange en Xrm.Page.uiControl.addPreSearch.

Methoden voor uitvoeringscontext

• getContext
  Methode die het Clientcontext (clientreferentie)-object retourneren.

• getDepth
  Methode die een waarde retourneert die de volgorde aangeeft waarin deze handler wordt uitgevoerd.

• getEventArgs
  Methode die een object retouteert met methoden voor het beheren van de Save-gebeurtenis.

• getEventSource
  Methode die een verwijzing retourneert naar het object waarbij de gebeurtenis is opgetreden.

• Gedeelde variabelen
  Gedeelde variabelen maken het delen van een variabele met andere handlers voor dezelfde gebeurtenis mogelijk. U gebruikt de methoden setSharedVariable en getSharedVariable om met gedeelde variabelen te werken.

getContext

Methode die het Clientcontext (clientreferentie)-object retourneert.

ExecutionContextObj.getContext()

• Retourwaarde
  Type: Object

getDepth

Methode die een waarde retourneert die de volgorde aangeeft waarin deze handler wordt uitgevoerd.

• Retourwaarde
  Type: Getal

  De volgorde begint met 0.

getEventArgs

Methode die een object retouteert met methoden voor het beheren van de Save-gebeurtenis.

Notitie

Deze methode retourneert null voor elke gebeurtenis behalve de gebeurtenis Save.

ExecutionContextObj.getEventArgs()

• Retourwaarde
  **Type:**Object

  Meer informatie:Argumenten van gebeurtenis Opslaan (clientreferentie).

getEventSource

Methode die een verwijzing retourneert naar het object waarbij de gebeurtenis is opgetreden.

ExecutionContextObj.getEventSource()

• Retourwaarde
  Type: Object

  Deze methode retourneert het object van het Xrm.Page-objectmodel dat de bron van de gebeurtenis is, geen HTMLDOM-object. In een gebeurtenis OnChange retourneert deze methode bijvoorbeeld het kenmerkobject Xrm.Page.data.entity dat het gewijzigde kenmerk vertegenwoordigt.

Gedeelde variabelen

Gedeelde variabelen maken het delen van een variabele met andere handlers voor dezelfde gebeurtenis mogelijk. U gebruikt de methoden setSharedVariable en getSharedVariable om variabelen tussen functies door te geven.

setSharedVariable

Stelt de waarde van een variabele in die door een hander moet worden gebruikt nadat de huidige handler is voltooid.

ExecutionContextObj.setSharedVariable(key, value)

• Argumenten
  String: De naam van de variabele

  Object: De in te stellen waarde.

getSharedVariable

Haalt de variabelenset op met setSharedVariable.

ExecutionContextObj.getSharedVariable(key)

• Argumenten
  String: De naam van de variabele.

• Retourwaarde
  Type: Object

  Het specifieke type is afhankelijk van wat het waardeobject is.

Zie ook

Programmeerreferentie op de client

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht