Del via

Kontekst for udførelse (klientsidereference)

  • Artikel

 

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

Kørselskonteksten er en valgfri parameter, der kan overføres til en JavaScript biblioteksfunktion via en hændelseshandler. Denne indstilling vises i dialogboksen med egenskaber for handleren, når du angiver navnet på funktionen. Denne indstilling er angivet for et <Handler> (FormXml)-element ved hjælp af attributten passExecutionContext.

Kørselskonteksten overføres automatisk til funktioner, der er angivet ved hjælp af metoderne Xrm.Page.data.addOnSave og Xrm.Page.data.entityAttribute.addOnChange og Xrm.Page.uiControl.addPreSearch.

Metoder til udførelse af kontekst

  • getContext
    Metode, der returnerer objektet Klientsidekontekst (klientsidereference).

  • getDepth
    Metode, der returnerer en værdi, der angiver den rækkefølge, hvori denne handler udføres.

  • getEventArgs
    Metode, der returnerer et objekt med metoder til at administrere hændelsen Save.

  • getEventSource
    Metode, der returnerer en reference til det objekt, som hændelsen opstod på.

  • Delte variabler
    Delte variabler tillader deling af en variabel med andre handlere for den samme hændelse. Du kan bruge metoderne setSharedVariable og getSharedVariable til at arbejde med delte variabler.

getContext

Metode, der returnerer objektet Klientsidekontekst (klientsidereference)

ExecutionContextObj.getContext()
  • Returværdi
    Type: objekt

getDepth

Metode, der returnerer en værdi, der angiver den rækkefølge, hvori denne handler udføres.

  • Returværdi
    Type: Tal

    Rækkefølgen begynder med 0.

getEventArgs

Metode, der returnerer et objekt med metoder til at administrere hændelsen Save.

Bemærk

Denne metode returnerer null for en hvilken som helst hændelse, bortset fra hændelsen Save.

ExecutionContextObj.getEventArgs()

getEventSource

Metode, der returnerer en reference til det objekt, som hændelsen opstod på.

ExecutionContextObj.getEventSource()

  • Returværdi
    Type: objekt

    Denne metode returnerer objektet fra objektmodellen Xrm.Page, der er kilden til hændelsen, ikke et HTMLDOM-objekt. I en OnChange-hændelse returnerer denne metode f.eks. attributobjektet Xrm.Page.data.entity, der repræsenterer den ændrede attribut.

Delte variabler

Delte variabler tillader deling af en variabel med andre handlere for den samme hændelse. Du bruger metoderne setSharedVariable og getSharedVariable til at overføre variabler mellem funktioner.

setSharedVariable

Angiver værdien af en variabel, som skal bruges af en handler, når den aktuelle handler er fuldført.

ExecutionContextObj.setSharedVariable(key, value)

  • Argumenter
    String: Navnet på variablen

    Object: Værdien, som skal angives.

getSharedVariable

Henter en variabel, der er angivet vha. setSharedVariable.

ExecutionContextObj.getSharedVariable(key)

  • Argumenter
    String: Navnet på variablen.

  • Returværdi
    Type: objekt

    Den specifikke type afhænger af, hvad objektets værdi er.

Se også

Programmeringsreference på klientsiden

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret