Delen via

Bewerkbare rasterobjecten en -methoden (clientreferentie)

  • Artikel

 

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 u te abonneren op gebeurtenissen die via bewerkbare rasters worden geactiveerd wanneer er gegevens worden geselecteerd, gewijzigd of opgeslagen in een bewerkbaar raster. Bewerkbare rasters ondersteunen de meeste clientmethoden die door niet-bewerkbare rasters worden ondersteund. Meer info: Gebruik in bewerkbare rasters Dynamics 365

Notitie

Het bewerkbare raster is geïntroduceerd in Update voor Dynamics 365 (online en on-premises) - december 2016.

In dit onderwerp

Gebeurtenissen voor bewerkbare rasters

Methoden voor bewerkbare rasters

Gebeurtenissen voor bewerkbare rasters

Het bewerkbare raster ondersteunt de volgende gebeurtenissen die u voor het registreren en uitvoeren van uw clientscripts kunt gebruiken. U kunt u voor deze gebeurtenissen registreren via het tabblad Gebeurtenissen van de Microsoft Dynamics 365-pagina voor het inschakelen van bewerkbare rasters voor een entiteit of een alleen-lezenraster:

  • OnRecordSelect

  • OnChange

  • OnSave

Belangrijk

Gebruik de methode getFormContext voor uitvoeringscontext om veelvoorkomende gebeurtenishandlers te maken voor een bewerkbaar raster GridCell of formulierveld, afhankelijk van waar de gebeurtenishandler wordt uitgevoerd.Meer informatie:getFormContext

OnRecordSelect

De gebeurtenis OnRecordSelect vindt plaats wanneer één rij (record) in het bewerkbare raster wordt geselecteerd. Deze gebeurtenis vindt niet plaats als een gebruiker verschillende cellen in dezelfde rij of meerdere rijen selecteert.

OnChange

De gebeurtenis OnChange vindt plaats als een waarde in een cel in het bewerkbare raster wordt gewijzigd en de cel de focus kwijtraakt. Deze gebeurtenis kan zich ook voordoen wanneer een kenmerkwaarde met de methode setValue wordt bijgewerkt.

OnSave

De gebeurtenis OnSave wordt uitgevoerd voordat de bijgewerkte gegevens naar de server worden verzenden en wanneer het volgende zich voordoet:

  • Er is een wijziging in de recordselectie.

  • De gebruiker activeert expliciet een opslagbewerking met de knop voor opslaan van het bewerkbare raster.

  • De gebruiker past een bewerking voor sorteren, filteren, groeperen, paginering of navigatie van het bewerkbare raster toe wanneer er in behandeling zijnde wijzigingen zijn.

Hier zijn een aantal belangrijke punten om rekening mee te houden bij gebruik van de gebeurtenis OnSave:

  • Als een gebruiker meerdere kolommen van dezelfde record op volgorde bewerkt, wordt de gebeurtenis OnSave maar één keer geactiveerd om optimale prestaties en compatibel formuliergedrag te garanderen.

  • Het bewerkbare raster en het bovenliggende formulier hebben aparte knoppen voor opslaan. Deze werken alleen voor de eigen inhoud.

  • In het bewerkbare raster worden wijzigingen in behandeling niet opgeslagen wanneer er navigatiebewerkingen buiten de context worden uitgevoerd. Als er voor het besturingselement niet-opgeslagen gegevens bestaan, kunnen die gegevens verloren gaan. In dat geval wordt de gebeurtenis OnSave mogelijk niet geactiveerd. Dit kan bijvoorbeeld gebeuren bij het navigeren naar een andere record met een formulieropzoekveld of via het lint.

  • Wanneer op de knop voor vernieuwen in het bewerkbare raster wordt geklikt, worden wijzigingen in behandeling genegeerd en wordt de gebeurtenis OnSave niet geactiveerd.

  • Met het besturingselement voor een bewerkbaar raster wordt geen timer voor automatisch opslaan geïmplementeerd.

  • In een bewerkbaar raster worden duplicaatdetectieregels onderdrukt.

Methoden voor bewerkbare rasters

Het bewerkbare raster ondersteunt enkele nieuwe en de meeste bestaande methoden die door alleen-lezenrasters worden ondersteund:

  • Rasterbesturingselement

  • Raster

  • GridRow

  • GridRowData

  • GridEntity

  • GridAttribute

  • GridCell

Rasterbesturingselement

Als u de naam van het besturingselement voor bewerkbare rasters weet, kunt u dit openen met de volgende code. Ga bijvoorbeeld als volgt te werk om toegang te krijgen tot het subraster CONTACTPERSONEN in het standaardaccountformulier:

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

Tip

Zie de informatie in Ontwikkelingshulpmiddelen voor browsers gebruiken voor het identificeren van de namen van rasterbesturingselementen in het formulier zonder de formuliereneditor te openen.

Het bewerkbare raster ondersteunt de volgende methoden voor alleen-lezenrasterbesturingselementen: getEntityName en getGrid.

Raster

Het bewerkbare raster ondersteunt de volgende methoden voor de geretourneerde Grid door GridControl.getGrid-methode: getRows, getSelectedRows en getTotalRecordCount.

GridRow

Het bewerkbare raster ondersteunt de getData-methode voor de geretourneerde GridRow door de methoden Grid.getRows en Grid.getSelectedRows.

GridRow ondersteunt ook de data-verzameling die manieren biedt om met een bewerkbare rasterrij te werken. Zie Verzamelingen (clientreferentie) voor informatie over de methoden die beschikbaar zijn om toegang te verkrijgen tot gegevens in een verzameling.

GridRowData

Het bewerkbare raster ondersteunt de getEntity-methode voor de geretourneerde GridRowData door de methode GridRow.getData.

GridRowData biedt ook methoden om informatie op te halen die specifiek is voor een weergegeven record in een bewerkbare rasterrij, inclusief een verzameling van alle kenmerken die in de rij zijn opgenomen. Kenmerkgegevens zijn beperkt tot de kolommen die worden weergegeven door het bewerkbare raster. Zie Verzamelingen (clientreferentie) voor informatie over de methoden die beschikbaar zijn om toegang te verkrijgen tot gegevens in een verzameling.

GridEntity

Het bewerkbare raster ondersteunt de volgende methoden voor de geretourneerde GridEntity door de GridRowData.getEntity-methode:

Behalve met de methode GridRowData.getEntity kunt u de GridEntity ook ophalen door rechtstreeks toegang te verkrijgen tot het GridRowData.entity-object.

GridEntity ondersteunt ook de attributes-verzameling die methoden biedt om te werken met een verzameling kenmerken voor een entiteit in het bewerkbare raster. Elk kenmerk (GridAttribute) staat voor de gegevens in de cel van een bewerkbaar raster en bevat een verwijzing naar alle cellen die zijn gekoppeld aan het kenmerk. Zie Verzamelingen (clientreferentie) voor informatie over de methoden die beschikbaar zijn om toegang te verkrijgen tot gegevens in een verzameling.

GridAttribute

De GridAttribute ondersteunt de volgende methoden voor kenmerken van een geselecteerde rasterrij: getName, getRequiredLevel, setRequiredLevel, getValue en setValue.

Gebruik methode Grid.getSelectedRows om de geselecteerde rij in een bewerkbaar raster op te halen.

GridAttribute ondersteunt ook de controls-verzameling voor kenmerken van een geselecteerde rasterrij, wat methoden biedt voor het werken met een verzameling cellen die zijn gekoppeld aan het kenmerk. Elke cel (GridCell) van een geselecteerde rasterrij is analoog aan een besturingselement in een formulier dat is gekoppeld aan een bewerkbaar raster. Zie Verzamelingen (clientreferentie) voor informatie over de methoden die beschikbaar zijn om toegang te verkrijgen tot gegevens in een verzameling.

Tip

Voor optimale prestaties kan een rij (record) in een bewerkbaar raster pas worden bewerkt als de record is geselecteerd. Gebruikers moeten één record in een raster selecteren om deze te bewerken. Zodra een record in een bewerkbaar raster is geselecteerd, evalueert Dynamics 365 intern een aantal zaken, waaronder gebruikerstoegang tot de record, of de record actief is en veldvalidaties, om er zeker van te zijn dat de gegevensbeveiliging en geldigheid gehandhaafd blijven terwijl u gegevens bewerkt. Overweeg het gebruik van de OnRecordSelect-gebeurtenis met de methode getFormContextom toegang tot records in het raster te krijgen die bewerkbaar zijn.

GridCell

Naast setNotification en clearNotification ondersteunt de GridCell de volgende methoden voor besturingselementen:

Notitie

In bewerkbare rasters kunnen niet meerdere meldingen tegelijk worden weergegeven.

getDisabled

Geeft aan of de cel is uitgeschakeld (alleen-lezen).

gridCellObj.getDisabled()
  • Retourwaarde
    Type: Boole-waarde. Waar als de cel is uitgeschakeld, anders niet waar.

setDisabled

Stelt in of de cel is uitgeschakeld.

gridCellObj.setDisabled(bool)

  • Argumenten
    Type: Boole-waarde. Waar als de cel uitgeschakeld moet zijn, anders niet waar.

  • Opmerkingen
    Het inschakelen van een alleen-lezencel voor bewerken kan een fout veroorzaken wanneer de record wordt opgeslagen. Als het veld door de server als een alleen-lezenveld wordt beschouwd, kan een fout optreden als de waarde wordt gewijzigd. Dit kan gebeuren wanneer de gebruiker geen schrijfbevoegdheden voor de record heeft, de record is uitgeschakeld of de gebruiker niet over de vereiste beveiligingsbevoegdheden op veldniveau beschikt.

getLabel

Retourneert het label van de kolom die de cel bevat.

gridCellObj.getLabel()
  • Retourwaarde
    Type: Tekenreeks. Het label van de kolom.

Zie ook

Rasterobjecten (alleen-lezen) en -methoden (clientreferentie)
Gebruik in bewerkbare rasters Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht