Share via

Redigerbare gitterobjekter og -metoder (klientsidereference)

  • Artikel

 

Udgivet: januar 2017

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

Du kan indstille hændelseshandlere for at abonnere på hændelser, der udløses af redigerbare gitre, når data vælges, ændres eller gemmes i et redigerbart gitter. Redigerbare gitre understøtter de fleste af de metoder på klientsiden, der understøttes af ikke-redigerbare gitre. Flere oplysninger: Brug redigerbare gitre i Dynamics 365

Bemærk

Det redigerbare gitter blev introduceret i December 2016 – opdatering til Dynamics 365 (online og det lokale miljø).

Dette emne indeholder

Redigerbare gitterhændelser

Redigerbare gittermetoder

Redigerbare gitterhændelser

Redigerbare gitter understøtter følgende hændelser, som du kan bruge til registrering og kørsel af klientbaserede scripts. Du kan tilmelde dig disse hændelser under fanen Hændelser på den Microsoft Dynamics 365-side, der bruges til at aktivere redigerbare gitre for et objekt eller et skrivebeskyttet gitter:

  • OnRecordSelect

  • OnChange

  • OnSave

Vigtigt

Brug kørselskontekstens getFormContext-metode til at oprette almindelige hændelseshandlere, der kan fungere enten i et redigerbart gitter GridCell eller et formularfelt, afhængigt af hvor hændelseshandleren udføres.Flere oplysninger:getFormContext

OnRecordSelect

Hændelsen OnRecordSelect indtræffer, når en enkelt række (post) er valgt i det redigerbare gitter. Denne hændelse indtræffer ikke, hvis en bruger markerer forskellige celler i samme række eller markerer flere rækker.

OnChange

Hændelsen OnChange indtræffer, når en værdi ændres i en celle i det redigerbare gitter, og cellen mister fokus. Denne hændelse kan også opstå, når en attributværdi opdateres ved hjælp af setValue-metoden.

OnSave

HændelsenOnSave indtræffer, før de opdaterede oplysninger sendes til serveren, og når et af følgende sker:

  • Der sker en ændring i de udvalgte poster.

  • Brugeren udløser udtrykkeligt en lagringshandling ved hjælp af det redigerbare gitters Gem-knap.

  • Brugeren anvender en sorterings-, filtrerings-, grupperings-, paginerings- eller navigationshandling fra der redigerbare gitter, mens der er ventende ændringer.

Nogle vigtige punkter, du skal overveje omkring OnSave-hændelsen:

  • Hvis en bruger redigerer flere kolonner for den samme post i rækkefølge, udløses OnSave-hændelsen kun én gang for at sikre optimal ydeevne og kompatibel formularfunktion.

  • Det redigerbare gitter og den overordnede formular har separate gem-knapper. Hvis du klikker på Gem-knappen det ene sted, gemmes ændringerne ikke det andet sted.

  • Det redigerbare gitter gemmer ikke afventende ændringer, når der udføres navigationshandlinger uden for konteksten. Hvis kontrolelementet har ikke-gemte data, kan disse data gå tabt. Derfor kan OnSave-hændelsen ikke udløses. Dette kan f.eks. ske, når du navigerer til en anden post ved hjælp af et opslagsfelt i formularen eller via båndet.

  • Hvis du trykker på opdateringsknappen i det redigerbare gitter, annulleres alle ventende ændringer, og OnSave-hændelsen bliver ikke udført.

  • Redigerbare gitter-kontrolelementer implementerer ikke en timer til automatisk lagring.

  • Det redigerbare gitter undertrykker regler for registrering af dubletter.

Redigerbare gittermetoder

Det redigerbare gitter understøtter nogle nye og de fleste af de eksisterende metoder, der understøttes af skrivebeskyttede gitre:

  • GridControl

  • Gitter

  • GridRow

  • GridRowData

  • GridEntity

  • GridAttribute

  • GridCell

GridControl

Hvis du kender navnet på det redigerbare gitterkontrolelement, kan du åbne det ved hjælp af følgende kode. Sådan får du f.eks. adgang til undergitteret KONTAKT i standardfirmaformularen:

var contactsGrid = Xrm.Page.getControl("Contacts");

Tip

Hvis du vil identificere navnene på gitterkontrolelementerne i formularen uden at åbne formulareditoren, skal du se oplysningerne i Brug browserens udviklingsværktøjer.

Det redigerbare gitter understøtter følgende metoder for skrivebeskyttede gitterkontrolelementer: getEntityName og getGrid.

Gitter

Det redigerbare gitter understøtter følgende metoder for Grid, som returneres af GridControl.getGrid-metoden: getRows, getSelectedRows og getTotalRecordCount.

GridRow

Det redigerbare gitter understøtter metoden getData for GridRow, som returneres af metoderne Grid.getRows og Grid.getSelectedRows.

GridRow understøtter også den data-samling, der indeholder måder at arbejde med en redigerbar gitterrække på. Se Grupper (klientsidereference) for at få oplysninger om de metoder, der kan bruges til at få adgang til data i en samling.

GridRowData

Det redigerbare gitter understøtter metoden getEntity for GridRowData, som returneres af metoden GridRow.getData.

GridRowData indeholder også metoder til at hente specifikke oplysninger om en post, der vises i en række i et redigerbart gitter, herunder en samling af alle de attributter, der er medtaget i rækken. Attributdata er begrænset til de kolonner, som findes i det redigerbare gitteret. Se Grupper (klientsidereference) for at få oplysninger om metoder til at få adgang til data i en samling.

GridEntity

Det redigerbare gitter understøtter følgende metoder for GridEntity, som returneres af GridRowData..getEntity-metoden:

Bortset fra, når du bruger GridRowData.getEntity-metoden, kan du hente GridEntity ved direkte adgang til GridRowData.entity-objektet.

GridEntity understøtter også attributes-samlingen, der indeholder metoder til at arbejde med en samling attributter for et objekt i det redigerbare gitter. Hver attribut (GridAttribute) repræsenterer dataene i cellen i et redigerbart gitter og indeholder en reference til alle de celler, der er knyttet til attributten. Se Grupper (klientsidereference) for at få oplysninger om metoder til at få adgang til data i en samling.

GridAttribute

Den GridAttribute understøtter følgende metoder for attributter i en markeret gitterrække: getName, getRequiredLevel, setRequiredLevel, getValue og setValue.

Brug Grid.getSelectedRows-metoden til at hente den markerede række i et redigerbart gitter.

GridAttribute understøtter også controls-samlingen for attributter for en markeret gitterrække, som indeholder metoder til at arbejde med en samling celler, der er knyttet til attributten. Hver celle (GridCell) i et markeret gitter svarer til et kontrolelement i en formular, der er knyttet til en attribut i et redigerbart gitter. Se Grupper (klientsidereference) for at få oplysninger om metoder til at få adgang til data i en samling.

Tip

Af hensyn til ydeevnen kan en række (post) i et redigerbart gitter ikke redigeres, før posten er valgt. Brugerne skal vælge en enkelt post i et gitter for at redigere den. Når der er valgt en post i et redigerbart gitter, vurderer Dynamics 365 internt en række forskellige ting, herunder brugeradgang til posten, om posten er aktiv, og feltvalideringer for at sikre dataenes sikkerhed og gyldighed, når du redigerer data. Overvej at bruge hændelsen OnRecordSelect med metoden getFormContext for at åbne poster i gitteret, der er i redigerbar tilstand.

GridCell

Ud over setNotification og clearNotification understøtter GridCell følgende metoder for kontrolelementer:

Bemærk

Redigerbare gitre kan ikke vise mere end én meddelelse ad gangen.

getDisabled

Returnerer, om cellen er deaktiveret (skrivebeskyttet).

gridCellObj.getDisabled()
  • Returværdi
    Type: Boolesk værdi. Sand, hvis cellen er deaktiveret, ellers falsk.

setDisabled

Angiver, om cellen er deaktiveret.

gridCellObj.setDisabled(bool)

  • Argumenter
    Type: Boolesk værdi. Sand, hvis cellen skal være deaktiveret, ellers falsk.

  • Bemærkninger
    Når en skrivebeskyttet celle aktiveres til redigering, kan det forårsage en fejl, når posten gemmes. Hvis feltet anses som skrivebeskyttet af serveren, kan der opstår en fejl, hvis værdien ændres. Dette kan ske i situationer, hvor brugeren ikke har skriverettigheder til posten, hvor posten er deaktiveret, eller hvor brugeren ikke har de nødvendige sikkerhedstilladelser på feltniveau.

getLabel

Returnerer etiketten for den kolonne, der indeholder cellen.

gridCellObj.getLabel()
  • Returværdi
    Type: streng. Etiketten på kolonnen.

Se også

Skrivebeskyttede gitterobjekter og -metoder (klientsidereference)
Brug redigerbare gitre i Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret