Skrive scripts til undergitre

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Du kan angive hændelseshandlere til at køre scripts, når data indlæses i undergitre. Dette giver metoder til at ændre den valgte visning og få referencer til data, der vises i gitteret.

Vigtigt

Denne funktion blev introduceret i første opdatering til CRM Online 2015 og i CRM 2016 (i det lokale miljø).

Dette emne indeholder

OnLoad-undergitterhændelse

Undergitter-objektmodel

OnLoad-undergitterhændelse

Undergitre indlæses asynkront fra formularen, så du kan ikke være sikker på at få adgang til dataene i undergitteret i formularens OnLoad-hændelse. Men du kan angive en hændelseshandler for OnLoad-hændelsen for undergitteret. Denne hændelse opstår hver gang, dataene opdateres i gitteret. Det sker også, når brugere sorterer kolonnerne i gitteret.

Der findes ingen brugergrænseflade, hvor du kan tilføje nye hændelseshandlere til denne hændelse, så for at tilføje handlere skal du bruge kode i en anden hændelse, typisk i formularens OnLoad-hændelse, og bruge GridControl.addOnLoad-metoden. Du kan fjerne hændelseshandlere fra denne hændelse ved at bruge GridControl.removeOnLoad-metoden.

Undergitter-objektmodel

Diagrammet nedenfor viser de objekter, du kan få adgang til fra et undergitter i en formular.

Undergitterkontrolelementet kaldes et GridControl i denne sammenhæng. Som Xrm.Page.ui-kontrolelement har undergitteret alle de metoder, der er tilgængelige for alle kontrolelementer, ud over refresh-metoden.

GridControl er det samme objekt, der overføres til en kommandolinje eller handlinger på båndet eller regler ved hjælp af <CrmParameter> (RibbonDiffXml), når den tilgængelig, når parameteren SelectedControl vælges.

Ændre visninger med visningsvælger

Når et undergitter er konfigureret til at åbne en visningsvælger, kan du få vist eller angive den aktuelle visning. Brug GridControl.getViewSelector-metoden til at få adgang til visningsvælgeren og derefter ViewSelector.getCurrentViewgetCurrentView og ViewSelector.setCurrentView-metoderne for at hente eller indstille den aktuelle visning til et opslagsobjekt.

Hent data fra gitteret

Brug GridControl.getGrid metoden til at få adgang til gitteret. Brug Grid.getRows metoden eller Grid.getSelectedRows metoden til at hente en samling af GridRow objekter. Du kan derefter åbne en reference til hver post i rækken ved at sammenkæde metoderne GridRow.getData, GridRowData.getEntity og GridEntity.getEntityReference.

Se også

Skrivebeskyttede gitterobjekter og -metoder (klientsidereference)
Grupper (klientsidereference)
Skriv kode til Microsoft Dynamics 365-formularer
Udvide Microsoft Dynamics 365 på klienten

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret