Durchführen spezieller Vorgänge mithilfe des Updates
Veröffentlicht: November 2016
Gilt für: Dynamics CRM 2015
Vor diesem Release wurden spezielle Nachrichten benötigt, um bestimmte Entitätsattributwerte zu aktualisieren. In dieser Version kann UpdateRequest nun verwendet werden, um diese Attribute festzulegen. In der folgenden Tabelle werden die speziellen veralteten Nachrichtenanforderungen und die zugehörigen Nachrichtenattribute angegeben, die mit UpdateRequest aktualisiert werden können.
Veraltete Nachrichtenanforderung |
Zu aktualisierendes Attribut |
|---|---|
<Entität>.OwnerId* |
|
<Entität>.StateCode* Wichtig Für SLA- und RoutingRule-Entitäten wird die Änderung von OwnerId und StateCode in einem einzelnen Update-Nachrichtenaufruf nicht unterstützt und verursacht eine Ausnahme. |
|
SystemUser.ParentSystemUserId |
|
Team.BusinessUnitId |
|
BusinessUnit.ParentBusinessUnitId |
|
Equipment.BusinessUnitId |
|
SystemUser.BusinessUnitId |
*<Entität> verweist auf eine beliebige Entität, die dieses Attribut bereitstellt.
Hinweis
Für Microsoft Dynamics CRM Online-Organisationen steht diese Funktion nur zur Verfügung, wenn die Organisation auf Dynamics CRM Online 2015 Update 1 aktualisiert hat. Diese Funktion ist nicht für Dynamics CRM (lokal) verfügbar.
Diese spezialisierten Nachrichten funktonieren weiterhin mit dem Endpunkt von 2011. Allerdings empfiehlt es sich, nach Möglichkeit die Methode UpdateRequest oder Update zu nutzen, um diese Attribute festzulegen. Die Nachricht Update vereinfacht die SDK-API und erleichtert die Codierung von standardmäßigen Datenintegrationstools, die mit Dynamics CRM verwendet werden. Außerdem ist es einfacher, ein Plug-In zu codieren und zu registrieren, um anstelle von mehreren speziellen Nachrichten eine einzelne Update-Nachricht auszuführen. Die Eigenschaft AttributeMetadata.IsValidForUpdate für die oben aufgeführten Attribute wurde in diesem Release in true geändert, um diese Funktion zu aktivieren.
Sie können weiterhin die speziellen Nachrichten des Endpunkts von 2011 in Ihrem Code verwenden. Die Web-API, die den Endpunkt von 2011 jedoch letztendlich ersetzt, unterstützt jedoch nur die Aktualisierungsnachricht für diese Arten von Vorgängen. Wenn Sie sich einen Vorsprung für die Abstimmung des Codes auf die Web-API verschaffen möchten, können Sie dies jetzt tun. Siehe Web API Preview für weitere Informationen.
Auswirkungen dieser Änderung auf Plug-Ins
Wenn Updateanforderungen verarbeitet werden, die beide Besitzerfelder sowie andere Standardfelder für Entitäten im Besitz von Unternehmenseinheiten enthalten, werden Plug-Ins, die für die Update-Nachricht in Phase 20 und/oder 40 der Pipeline registriert sind, einmal für alle Nicht-Besitzerfelder und dann einmal für die Besitzerfelder ausgeführt. Beispiele für Besitzersfelder sind businessunit und manager (für eine SystemUser-Entität). Beispiele für Entitäten im Besitzen von Unternehmen sind SystemUser, BusinessUnit, Equipment und Team.
Wenn Updateanforderungen verarbeitet werden, die beide Statusfelder sowie andere Standardfelder enthalten, werden Plug-Ins, die für die Update-Nachricht in Phase 20 und/oder 40 der Pipeline registriert sind, einmal für alle Nicht-Statusfelder und dann einmal für die Statusfelder ausgeführt.
Damit Plug-In-Code die gesamten Datenänderungen des Updates erhält, müssen Sie das Plug-In in Phase 10 registrieren und die relevanten Informationen in SharedVariables im Plug-In-Kontext speichern, damit spätere Plug-Ins (in der Pipeline) sie nutzen können.
Auswirkungen dieser Änderung auf Workflows
Wenn Updateanforderungen verarbeitet werden, die beide Besitzerfelder sowie andere Standardfelder enthalten, werden Workflows, die für die Update-Nachricht registriert sind, einmal für alle Nicht-Besitzerfelder und dann einmal für die Besitzerfelder ausgeführt. Die Workflows, die von Benutzern für die Assign-Nachricht registriert werden, werden weiterhin durch Updates von Besitzerfeldern gestartet.
Wenn Updateanforderungen verarbeitet werden, die beide Statusfelder sowie andere Standardfelder enthalten, werden Workflows, die für die Update-Nachricht registriert sind, einmal für alle Nicht-Statusfelder und dann einmal für die Statusfelder ausgeführt. Die Workflows, die für den Schritt Status ändern registriert werden, werden weiterhin über Updates an Statusfeldern gestartet.
Siehe auch
Schreiben von Plug-Ins, um Geschäftsprozesse zu erweitern
Erstellen von Workflows zum Automatisieren von Geschäftsprozessen
© 2017 Microsoft. Alle Rechte vorbehalten. Copyright