Formuliergebeurtenissen (clientreferentie)

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Alle code aan de clientzijde wordt uitgevoerd door gebeurtenissen. In Microsoft Dynamics 365 moet u een speciale functie binnen een JavaScript-bibliotheek koppelen die moet worden uitgevoerd wanneer bepaalde gebeurtenissen optreden.

Alle formuliergebeurtenissen hebben een gebruikersinterface die u gebruikt om een of meer gebeurtenishandlers op te geven. Elke gebeurtenishandler geeft één functie in een JavaScript-bibliotheek op en eventuele parameters die aan de functie kunnen worden doorgegeven.

Gebeurtenissen

Gebeurtenis OnLoad

Gebeurtenis OnSave

Veldgebeurtenis OnChange

Tabbladgebeurtenis TabStateChange

IFRAME-gebeurtenis OnReadyStateComplete

Gebeurtenis PreSearch van opzoekbesturingselement

Gebeurtenis OnStageChange

Gebeurtenis OnStageSelected

Gebeurtenissen voor zoekbesturingselement voor Parature Knowledge Base

Gebeurtenis OnLoad voor subrasters

Gebeurtenis OnLoad

De OnLoad-gebeurtenis vindt plaats nadat het formulier is geladen. De gebeurtenis kan niet voorkomen dat het venster wordt geladen. Gebruik de gebeurtenis OnLoad om logica toe te passen over hoe het formulier moet worden weergegeven, om eigenschappen voor velden in te stellen en om met andere pagina-elementen te communiceren.

Als de verbinding van de Microsoft Dynamics CRM voor tablets-client wordt verbroken, is de gebeurtenis OnLoad de enige gebeurtenis die optreedt.

Notitie

Formulieren voor Bijgewerkte entiteiten laden de pagina niet opnieuw nadat voor het eerst wordt opgeslagen om de record te maken of nadat volgende keren wordt opgeslagen. Daarom treedt de gebeurtenis OnLoad alleen op tijdens de eerste keer dat het formulier wordt geladen.

Gebeurtenis OnSave

De OnSave-gebeurtenis vindt plaats wanneer:

• De gebruiker klikt op de knop in de rechterbenedenhoek van het formulier, zelfs wanneer er geen gewijzigde gegevens zijn om op te slaan.

• Code voert de methode Xrm.Page.data.entity.Opslaan uit, zelfs wanneer er geen gewijzigde gegevens zijn om op te slaan.

• De gebruiker navigeert weg van het formulier en er zijn niet-opgeslagen gegevens in het formulier.

• Als automatisch opslaan is ingeschakeld, 30 seconden nadat gegevens zijn gewijzigd en er zijn niet-opgeslagen gegevens in het formulier.

• Code voert de methode Xrm.Page.data.Opslaan uit en er zijn niet-opgeslagen gegevens in het formulier.

• Code voert de methode Xrm.Page.data.vernieuwen uit door een waarde te geven als eerste parameter en er zijn niet-opgeslagen gegevens in het formulier.

Om te bepalen op welke knop is gedrukt om op te slaan gebruikt u de methode getSaveMode.

U kunt de opslagbewerking annuleren met de methode preventDefault in het object met gebeurtenisargumenten. De methode preventDefault die toegankelijk is door middel van de methode 279ca720-e304-4e51-b99f-91722431c2c8#BKMK_GetEventArgs, die deel uitmaakt van de uitvoeringscontext. U moet de formuliergebeurtenishandler configureren zodat de uitvoeringscontext wordt doorgegeven. Zie Uitvoeringscontext en de formuliergebeurtenispipeline gebruiken voor meer informatie.

Veldgebeurtenis OnChange

De gebeurtenis OnChange wordt meestal in gang gezet als de gegevens in een formulierveld zijn gewijzigd en het veld niet meer is geselecteerd.

Notitie

Is er een uitzondering op gedrag dat van toepassing is op (Booleaanse) velden met twee opties die zo zijn opgemaakt dat ze keuzerondjes of selectievakjes gebruikt. In dergelijke gevallen treedt de gebeurtenis direct op.

Deze gebeurtenis vindt ook plaats wanneer de gewijzigde gegevens offline op de server worden opgehaald voor een veld als het formulier is vernieuwd, zoals bij te werken nadat een record is opgeslagen.

Gebruik van de methode Xrm.Page.data.entity kenmerk.fireOnChange zorgt er ook voor dat deze gebeurtenis zich voordoet.

De gebeurtenis OnChange vindt niet plaats wanneer het veld via programmering wordt gewijzigd met de setValue-methode. Als u wilt dat de gebeurtenishandlers voor de OnChange-gebeurtenis worden uitgevoerd nadat u de waarde hebt ingesteld, moet u de methode Xrm.Page.data.entity kenmerk.fireOnChange gebruiken in uw code.

Alle velden ondersteunen de gebeurtenis OnChange. De gegevens in het veld worden gevalideerd voor en na de gebeurtenis OnChange.

Notitie

Hoewel het veld Status de gebeurtenis OnChange ondersteunt, is het veld alleen-lezen in het formulier, zodat de gebeurtenis niet kan optreden door middel van gebruikersinteractie. Een ander script kan deze andere gebeurtenis veroorzaken met behulp van de methode fireOnChange op het veld.

Tabbladgebeurtenis TabStateChange

De gebeurtenis TabStateChange treedt op wanneer de DisplayState van het tabblad verandert wegens gebruikersinteractie of wanneer de methode setDisplayState in code wordt toegepast. Gebruik deze gebeurtenis als u de src-eigenschap van een IFRAME in het tabblad wilt wijzigen.

Deze gebeurtenis treedt niet in CRM voor tablets op omdat tabbladen niet worden uit- of samengevouwen.

Notitie

Als u de eigenschap IFrame.src instelt in de gebeurtenis OnLoad voor een IFRAME binnen een samengevouwen tabblad, wordt de waarde overschreven wanneer het tabblad wordt uitgevouwen.

IFRAME-gebeurtenis OnReadyStateComplete

De gebeurtenis OnReadyStateComplete geeft aan of de inhoud van de IFRAME is geladen en in code toegankelijk is. Gebruik deze gebeurtenis wanneer u in uw scripts verwijst naar IFRAME-besturingselementen.

Deze gebeurtenis vindt niet in CRM voor tablets plaats omdat IFRAMES niet worden ondersteund.

Gebeurtenis PreSearch van opzoekbesturingselement

Het opzoekbesturingselement heeft een gebeurtenis PreSearch die optreedt vlak voor het besturingselement een dialoogvenster start om records te zoeken. Er is geen gebruikersinterface om gebeurtenishandlers voor deze gebeurtenis in te stellen. U moet de methode addPreSearch en removePreSearch in het opzoekbesturingselement gebruiken om gebeurtenishandlers voor deze gebeurtenis toe te voegen of te verwijderen.

Gebruik deze gebeurtenis met andere Beheer van opzoekmethoden en evenementen om de resultaten te wijzigen die in een opzoekactie worden weergegeven op basis van de huidige formuliergegevens vlak voordat het opzoekbesturingselement zoekresultaten weergeeft waaruit een gebruiker kan kiezen.

Gebeurtenis OnStageChange

Deze gebeurtenis vindt plaats wanneer de fase van een bedrijfsprocesstroombesturingselement wordt gewijzigd. Deze gebeurtenis vindt plaats wanneer de gebruiker op de knop voor Volgende fase of Terug naar vorige fase klikt in de gebruikersinterface of wanneer een ontwikkelaar de methoden Xrm.Page.data.process.moveNext of Xrm.Page.data.process.movePrevious gebruikt. U kunt de fasewijziging niet annuleren met code in een handler voor deze gebeurtenis.

Er wordt een uitvoeringscontextobject aan gebeurtenishandlers doorgegeven voor deze gebeurtenis. U kunt de functie getEventArgs gebruiken om een object op te halen dat de volgende methoden heeft:

• getDirection
  Retourneert een tekenreeks die "next" of "previous" is om de richting van de fasewijziging aan te geven.

• getStage
  Retourneert een faseobject. Behalve wanneer de navigatie naar een nieuwe entiteit gaat, vertegenwoordigt de geretourneerde fase het bestemmingsfaseobject, oftewel de volgende actieve fase. Wanneer de navigatie naar een nieuwe entiteit gaat, is de fase de fase waar vandaan wordt genavigeerd, oftewel het vorige actieve faseobject.Meer informatie:Fasemethoden.

Gebruik de methode Xrm.Page.data.process.addOnStageChange om gebeurtenishandlers voor deze gebeurtenis toe te voegen en de methode Xrm.Page.data.process.removeOnStageChange om deze te verwijderen.Meer informatie:Scripts schrijven voor bedrijfsprocesstromen.

Gebeurtenis OnStageSelected

Deze gebeurtenis vindt plaats wanneer een fase van een bedrijfsprocesstroombesturingselement wordt geselecteerd. U kunt de faseselectie niet annuleren met code in een handler voor deze gebeurtenis.

Er wordt een uitvoeringscontextobject aan gebeurtenishandlers doorgegeven voor deze gebeurtenis. U kunt de functie getEventArgs gebruiken om een object op te halen dat de volgende methoden heeft:

• getStage
  Retourneert een faseobject dat de geselecteerde fase vertegenwoordigt.Meer informatie:Fasemethoden.

Gebruik de methode Xrm.Page.data.process.addOnStageSelected om gebeurtenishandlers voor deze gebeurtenis toe te voegen en de methode Xrm.Page.data.process.removeOnStageSelected om deze te verwijderen.Meer informatie:Scripts schrijven voor bedrijfsprocesstromen.

Gebeurtenissen voor zoekbesturingselement voor Parature Knowledge Base

Update 1 voor Microsoft Dynamics CRM Online 2015 heeft een nieuw zoekbesturingselement voor Knowledge Base geïntroduceerd dat alleen kan worden toegevoegd aan formulieren voor organisatie die zijn geïntegreerd met Parature. Dit besturingselement heeft twee gebeurtenissen (OnResultOpened en OnSelection) waarmee ontwikkelaar via programmeren gebeurtenishandlers kunnen toevoegen.Meer informatie:Zoekbesturingselement voor Parature Knowledge Base (clientreferentie)

Gebeurtenis OnLoad voor subrasters

Met CRM Online 2015 Update 1 kunt u gebeurtenishandlers koppelen aan de OnLoad-gebeurtenis van subrasters.Meer informatie:Scripts schrijven voor subrasters

Zie ook

Beknopte naslag voor het opstellen van formulierscripts
Code schrijven voor Microsoft Dynamics CRM 2015-formulieren
Het objectmodel Xrm.Page gebruiken
Programmeerreferentie op de client
Scripts schrijven voor bedrijfsprocesstromen

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht