Speciale bewerkingen uitvoeren via Update
Gepubliceerd: november 2016
Is van toepassing op: Dynamics CRM 2015
Vóór deze versie waren speciale berichten vereist om bepaalde entiteitskenmerkenwaarden bij te werken. In deze versie kan UpdateRequest nu worden gebruikt voor het instellen van deze kenmerken. In de volgende tabel worden de speciale afgeschafte berichtaanvragen en de gerelateerde berichtkenmerken geïdentificeerd die kunnen worden bijgewerkt met UpdateRequest.
Afgeschafte berichtaanvraag |
Bij te werken kenmerk |
|---|---|
<entiteit>.OwnerId* |
|
<entiteit>.StateCode* Belangrijk Voor de entiteiten SLA en RoutingRule wordt het wijzigen van OwnerId en StateCode in een enkele Update-berichtaanroep niet ondersteund en resulteert in een uitzondering. |
|
SystemUser.ParentSystemUserId |
|
Team.BusinessUnitId |
|
BusinessUnit.ParentBusinessUnitId |
|
Equipment.BusinessUnitId |
|
SystemUser.BusinessUnitId |
*<entiteit> verwijst naar enige entiteit die dit kenmerk biedt.
Notitie
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).
Deze gespecialiseerde berichten blijven werken met het 2011-eindpunt. Er wordt echter aanbevolen waar mogelijk gebruik te maken van de methode UpdateRequest of Update om deze kenmerken in te stellen. Het Update-bericht vereenvoudigt de SDK API en maakt het gemakkelijker om standaarde gegevensintegratiehulpmiddelen te coderen die worden gebruikt met Dynamics CRM. Bovendien is het gemakkelijker een plug-in te coderen en registreren om uit te voeren voor een enkel Update-bericht in plaats van meerdere gespecialiseerde berichten. De eigenschap AttributeMetadata.IsValidForUpdate voor de bovengenoemde kenmerken is gewijzigd in true in deze versie om deze voorziening mogelijk te maken.
U kunt deze gespecialiseerde berichten van het 2011-eindpunt blijven gebruiken in uw code.. De Web API die uiteindelijk het 2011-eindpunt zal vervangen ondersteunt echter alleen het bericht Update voor deze typen bewerkingen. Als u een vliegende start wilt maken met het wijzigen van uw code voor aanpassing aan de Web API, kunt u dit nu doen. Zie Voorbeeld van Web API voor meer informatie.
Gevolgen van deze verandering voor plug-ins
Als updateaanvragen worden verwerkt die zowel eigenaarvelden als andere standaardvelden voor entiteiten die het eigendom zijn van het bedrijf bevatten, worden plug-ins die zijn geregistreerd voor het Update-bericht in fase 20 en/of fase 40 van de pipeline eenmaal uitgevoerd voor alle velden die niet het eigendom van de eigenaar zijn en vervolgens eenmaal voor de velden die wel van de eigenaar zijn. Voorbeelden van velden van de eigenaar zijn businessunit en manager (voor een entiteit SystemUser). Voorbeelden van entiteiten die eigendom van het bedrijf zijn omvatten SystemUser, BusinessUnit, Equipment en Team.
Als updateaanvragen worden verwerkt die zowel toestand-/statusvelden als andere standaardvelden bevatten, worden plug-ins die zijn geregistreerd voor het Update-bericht in fase 20 en/of fase 40 van de pipeline eenmaal uitgevoerd voor alle niet-toestand-/statusvelden en vervolgens eenmaal voor de toestand-/statusvelden.
Teneinde code van plug-ins in staat te stellen de volledige gegevenswijzigingen van de update te ontvangen, moet u de plug-in registreren in fase 10 en vervolgens relevante informatie opslaan in SharedVariables in de context van de plug-in voor gebruik door latere plug-ins (in de pipeline).
Gevolgen van deze verandering voor werkstromen
Als updateaanvragen worden verwerkt die zowel eigenaarvelden als andere standaardvelden bevatten, worden werkstromen die zijn geregistreerd voor het Update-bericht eenmaal uitgevoerd voor alle niet-eigenaarvelden en vervolgens eenmaal voor de eigenaarvelden. Werkstromen die zijn geregistreerd voor het Assign-bericht door gebruikers worden nog steeds getriggerd door updates van eigenaarvelden.
Als updateaanvragen worden verwerkt die zowel toestand-/statusvelden als andere standaardvelden bevatten, worden werkstromen die zijn geregistreerd voor het Update-bericht eenmaal uitgevoerd voor alle niet-toestand-/statusvelden en vervolgens eenmaal voor de toestand-/statusvelden. Werkstromen die zijn geregistreerd voor de stap Status wijzigen worden nog steeds getriggerd door updates van toestand-/statusvelden.
Zie ook
Invoegtoepassingen schrijven om bedrijfsprocessen uit te breiden
Werkstromen schrijven om bedrijfsprocessen te automatiseren
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht