Argumenten van gebeurtenis Opslaan (clientreferentie)

Artikel
03/04/2017

Gepubliceerd: januari 2017

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

In de opslaggebeurtenis kunt u de methode getEventArgs voor het uitvoeringscontextobject gebruiken om een object op te halen dat methoden bevat die u kunt gebruiken om de opslaggebeurtenis te beheren.

Gebeurtenisargumentmethoden opslaan

getSaveMode
Retourneert een waarde die aangeeft hoe de opslaggebeurtenis is gestart door de gebruiker.
isDefaultPrevented
Retourneert een waarde die aangeeft of de opslaggebeurtenis is geannuleerd omdat de methode preventDefault in deze gebeurtenishandler of een eerdere gebeurtenishandler is gebruikt.
preventDefault
Annuleert de werking, maar alle resterende handlers voor de gebeurtenis worden nog steeds uitgevoerd.

getSaveMode

Retourneert een waarde die aangeeft hoe de opslaggebeurtenis is gestart door de gebruiker.

execObj.getEventArgs().getSaveMode()

Retourwaarde
Type: getal

De volgende tabel beschrijft de ondersteunde waarden die worden geretourneerd om verschillende manieren te detecteren waarop entiteitrecords kunnen worden opgeslagen door de gebruiker.

Entiteit	Gebeurtenismodus	Waarde
Alle	Opslaan	1
Alle	Opslaan en sluiten	2
Alle	Opslaan en nieuwe	59
Alle	AutoSave	70
Activiteiten	Opslaan als voltooid	58
Alle	Deactiveren	5
Alle	Opnieuw activeren	6
Entiteiten die eigendom zijn van gebruikers of teams	Toewijzen	47
Email (e-mail)	Verzenden	7
Potentiële klant	Kwalificeren	16
Potentiële klant	Diskwalificeren	15

Opmerkingen
Deze methode is essentieel als u automatisch opslaan wilt inschakelen voor de meeste formulieren in een organisatie, maar het voor specifieke formulieren wilt uitschakelen. De volgende code die is geregistreerd voor de gebeurtenis onSave, met de uitvoeringscontext die eraan wordt doorgegeven, voorkomt opslagbewerkingen die worden gestart door automatisch opslaan, maar staat alle overige toe. Met automatisch opslaan ingeschakeld, is weg navigeren hetzelfde als opslaan en sluiten. Deze code voorkomt dat opslaan wordt gestart door de timer van 30 seconden of wanneer gebruikers weg navigeren van een formulier met niet-opgeslagen gegevens.
```
function preventAutoSave(econtext) {
    var eventArgs = econtext.getEventArgs();
    if (eventArgs.getSaveMode() == 70 || eventArgs.getSaveMode() == 2) {
        eventArgs.preventDefault();
    }
}
```
Om een record op te slaan moet de gebruiker klikken op het pictogram Opslaan onder aan het formulier of moet een aangepaste opdracht Opslaan worden toegevoegd aan de opdrachtbalk.

isDefaultPrevented

Retourneert een waarde die aangeeft of de opslaggebeurtenis is geannuleerd omdat de methode preventDefault in deze gebeurtenishandler of een eerdere gebeurtenishandler is gebruikt.

execObj.getEventArgs().isDefaultPrevented()

Retourwaarde
Type: Boole-waarde.

preventDefault

Annuleert de werking, maar alle resterende handlers voor de gebeurtenis worden nog steeds uitgevoerd.

execObj.getEventArgs().preventDefault()

Zie ook

Programmeerreferentie op de client
Verzamelingen (clientreferentie)
Beknopte naslag voor het opstellen van formulierscripts
Uitvoeringscontext (clientreferentie)
getEventArgs
Code schrijven voor Microsoft Dynamics 365-formulieren
Het objectmodel Xrm.Page gebruiken

Microsoft Dynamics 365

Delen via