Scripts schrijven voor subrasters

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

U kunt gebeurtenishandlers instellen om scripts uit te voeren wanneer gegevens in subrasters worden geladen. Dit creëert methoden om de geselecteerde weergave aan te passen en verwijzingen te krijgen naar gegevens die in het raster worden weergegeven.

Belangrijk

Deze functie werd geïntroduceerd in update 1 van CRM Online 2015 en in CRM 2016 (on-premises).

In dit onderwerp

Gebeurtenis OnLoad voor subrasters

Objectmodel voor subrasters

Gebeurtenis OnLoad voor subrasters

Subrasters laden asynchroon vanuit het formulier, dus kunt u niet op betrouwbare wijze toegang verkrijgen tot de gegevens in het subraster in de gebeurtenis OnLoad van het formulier. Maar u kunt wel een gebeurtenishandler instellen voor de gebeurtenis OnLoad van het subraster. Deze gebeurtenis doet zich voor telkens wanneer de gegevens in het raster worden vernieuwd. Dit is inclusief wanneer gebruikers de kolommen van het raster sorteren.

Er is geen gebruikersinterface voor het toevoegen van nieuwe gebeurtenishandlers voor deze gebeurtenis, dus als u dit wilt doen, moet u code in een andere gebeurtenis, gewoonlijk het evenement OnLoad voor formulieren, gebruiken om gebruik te kunnen maken van de methode GridControl.addOnLoad. Als u gebeurtenishandlers wilt verwijderen voor deze gebeurtenis, gebruikt u de methode GridControl.removeOnLoad.

Objectmodel voor subrasters

Het onderstaande diagram toont de objecten waartoe u toegang kunt verkrijgen vanuit een subraster in een formulier.

Het besturingselement voor subrasters wordt in deze context een Rasterbesturingselement genoemd. Als Xrm.Page.ui-besturingselement, beschikt het subraster over alle methoden van alle besturingsmethoden plus de methode refresh.

De Rasterbesturingselement is hetzelfde object als wordt doorgegeven aan actgies of regels voor opdrachtbalk of lint via de <CrmParameter> (RibbonDiffXml) als deze beschikbaar is bij selectie van een parameter SelectedControl.

Weergaven in Weergave selecteren wijzigen

Als een subraster is geconfigureerd voor het weergeven van een weergaveselectie, kunt u de huidige weergave ophalen of instellen. Gebruik de methode GridControl.getViewSelector om toegang te krijgen tot de weergaveselectie en dan de methoden ViewSelector.getCurrentViewgetCurrentView en ViewSelector.setCurrentView om de huidige weergave op te halen of in te stellen met een opzoekobject.

Gegevens ophalen vanuit het raster

Gebruik de methode GridControl.getGrid om toegang te verkrijgen tot het raster. Gebruik de methode Grid.getRows method or Grid.getSelectedRows om een verzameling GridRow-objecten op te halen. U kunt vervolgens toegang verkrijgen tot een verwijzing naar elke record in de rij door de methoden GridRow.getData, GridRowData.getEntity en GridEntity.getEntityReference aan elkaar te koppelen.

Zie ook

Rasterobjecten (alleen-lezen) en -methoden (clientreferentie)
Verzamelingen (clientreferentie)
Code schrijven voor Microsoft Dynamics 365-formulieren
Microsoft Dynamics 365 uitbreiden op de client

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht