Toestanden van asynchrone bewerkingen

 

Gepubliceerd: januari 2017

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

Nadat asynchrone bewerkingen zijn toegevoegd aan de asynchrone wachtrij, hebben deze een goed gedefinieerde toestand. Een asynchrone bewerking kan wachten op uitvoering, kan worden uitgevoerd of kan worden voltooid. Er zijn ook andere mogelijke toestanden voordat de bewerking uiteindelijk wordt verwijderd uit de wachtrij. De toestanden definiëren de levenscyclus van de asynchrone bewerking.

In dit onderwerp

Toestanden voor asynchrone bewerkingen

AsyncOperation-toestanden ophalen en bijwerken

Toestanden voor asynchrone bewerkingen

De status van de asynchrone bewerking kan op drie manieren worden veranderd: door het platform als onderdeel van normale wachtrijverwerking, door de gebruiker die communiceert met de Microsoft Dynamics 365-webtoepassing of door een webserviceoproep die de asynchrone bewerking wijzigt. Als ontwikkelaar kunt u de huidige toestand van alle asynchrone bewerkingen ophalen waartoe u toegang hebt en de toestand ervan wijzigen.

De volgende tabel geeft de toestanden, en de statussen voor elke toestand, aan van een AsyncOperation.

Staat	Status	Numerieke statuswaarde
Ready	WaitingForResources	0
Suspended	Waiting	10
Locked	InProgress	20
Locked	Pausing	21
Locked	Canceling	22
Completed	Succeeded	30
Completed	Failed	31
Completed	Canceled	32

De ondersteunde toestanden worden gedefinieerd in de opsomming AsyncOperationState. In de eerder gebonden klasse AsyncOperation is de toestand beschikbaar in het kenmerk AsyncOperation.StateCode terwijl de status beschikbaar is in het kenmerk AsyncOperation.StatusCode. Raadpleeg voor meer informatie de metagegevens van de entiteit AsyncOperation.Als u de metagegevens van de entiteit voor uw organisatie wilt bekijken, installeert u de oplossing Metadata Browser die wordt beschreven in Blader door de metagegevens voor uw organisatie. U kunt ook metagegevens weergeven voor een niet-aangepaste organisatie in het Excel-bestand EntityMetadata.xlsx, in de bovenste map van SDK download.. De statussen worden weergegeven in de Microsoft Dynamics 365-webtoepassing in het veld Reden van status in het raster Systeemtaken. Door een willekeurige menuoptie te selecteren in het menu Meer acties in Systeemtaken, kunt u de toestand van een asynchrone bewerking interactief wijzigen. Toegestane acties omvatten het volgende: Annuleren, Hervatten, Uitstellen en Onderbreken.

Het volgende diagram laat de overgangen van de toestand van asynchrone bewerkingen zien die worden ondersteund.

Een asynchrone bewerking kan alleen overgaan van de ene toestand naar een andere langs specifieke paden zoals aangegeven in het diagram. Sommige paden worden door de gebruiker geïnitieerd via interactie met de Microsoft Dynamics 365-webtoepassing, terwijl andere paden worden geïnitieerd door het Microsoft Dynamics 365-platform als onderdeel van een normale asynchone wachtrijverwerking of vanwege een webserviceoproep. Zo kan bijvoorbeeld een asynchrone bewerking niet rechtstreeks vanuit een toestand Onderbroken overgaan naar een toestand Vergrendeld.

Een vergrendelde toestand geeft aan dat dit exemplaar van AsyncOperation wordt gebruikt door de asynchrone service. Terwijl het is vergrendeld, kan het niet door een ander exemplaar van de service worden gebruikt. Dit zorgt ervoor dat het exemplaar niet meerdere keren kan worden uitgevoerd, bijvoorbeeld door twee verschillende asynchrone services.

AsyncOperation-toestanden ophalen en bijwerken

Het controleren en bijwerken van de toestand van een asynchrone bewerking vindt meestal interactief plaats via het raster Systeemtaken in de Microsoft Dynamics 365-webtoepassing. U kunt echter ook de SDK gebruiken om codes te schrijven waarmee dezelfde taken worden uitgevoerd.

De toestand van een asynchrone bewerking lezen

1. Haal een AsyncOperation op naam op met de methode RetrieveMultiple of op id via de methode Retrieve.

2. Lees het kenmerk AsyncOperation.StateCode.

De toestandcode wijzigen

1. Wijzig het kenmerk van de opgehaalde toestandcode in een nieuwe waarde op basis van de toegestane toestanden voor bewerkingen. U kunt ook het kenmerk AsyncOperation.PostponeUntil wijzigen.

2. Roep Update aan om de waarde van deze kenmerken in de database te wijzigen.

De vorige bewerkingen kunnen ook worden uitgevoerd via de methode Execute met de juiste aanvraagberichten. Andere kenmerken van AsyncOperation dan AsyncOperation.StateCode en AsyncOperation.PostponeUntil moeten als alleen-lezen worden beschouwd.

Terugkerende systeemtaken

U kunt de meeste systeemtaken niet annuleren, onderbreken of hervatten. Raadpleeg de volgende lijst die enkele van deze beperkte systeemtaken bevat. De waarde in de eerste kolom is de waarde van het kenmerk AsyncOperation van de entiteit OperationType.

Asynchroon bewerkingstype (optiewaarde)	Beschrijving van bewerking
22	Maximale opslaggrootte voor de organisatie berekenen
18	Opslaggrootte voor de organisatie berekenen
19	Statistieken over de organisatiedatabase verzamelen
20	Statistieken over de organisatiegrootte verzamelen
16	Organisatiestatistieken verzamelen
9	SQM-gegevensverzameling
25	Volledige-tekstcatalogusindex van de organisatie
31	Melding voor de opslaglimiet
24	Statistische intervallen bijwerken
27	De status van contracten bijwerken

Voor de volledige lijst met ondersteunde asynchrone bewerkingtypen, raadpleegt u de metagegevens van de entiteit AsyncOperation.Als u de metagegevens van de entiteit voor uw organisatie wilt bekijken, installeert u de oplossing Metadata Browser die wordt beschreven in Blader door de metagegevens voor uw organisatie. U kunt ook metagegevens weergeven voor een niet-aangepaste organisatie in het Excel-bestand EntityMetadata.xlsx, in de bovenste map van SDK download.

Zie ook

Asynchrone service in Microsoft Dynamics 365
Entiteit AsyncOperation (systeemtaak)
Afhankelijkheid en uitvoeringsvolgorde in asynchrone bewerkingen

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht