Scripts schrijven voor subrasters

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Met Update 1 voor Microsoft Dynamics CRM Online 2015 kunt u meer doen met besturingselementen voor subrasters in formulieren door nieuwe gebeurtenissen en objecten te gebruiken.

Belangrijk

Voor Microsoft Dynamics CRM Online-organisaties is deze functie alleen beschikbaar als uw organisatie is bijgewerkt naar Dynamics CRM Online 2015 Update 1. Deze functie is niet beschikbaar voor Dynamics CRM (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 en -methoden (clientreferentie)
Verzamelingen (clientreferentie)
Code schrijven voor Microsoft Dynamics CRM 2015-formulieren
Uitbreidingen van clienttoepassingen schrijven

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht