[更新] を使用して特化された操作を実行する
公開日: 2016年11月
対象: Dynamics CRM 2015
このリリースの前では、特定のエンティティの属性値を更新するためには、特化されたメッセージが要求されました。 このリリースでは、現在は、これらの属性を設定するために、UpdateRequest を使用できます。 次の表は、特化された削除されたメッセージ要求と、UpdateRequest を使用して更新できる関連のメッセージ属性を示しています 。
削除されたメッセージ要求 |
更新される属性 |
|---|---|
<entity>.OwnerId* |
|
<entity>.StateCode* 重要 SLA および RoutingRule エンティティについては、単一の 更新 メッセージ呼び出しでの OwnerId と StateCode の変更はサポートされていないので、例外が発生します。 |
|
SystemUser.ParentSystemUserId |
|
Team.BusinessUnitId |
|
BusinessUnit.ParentBusinessUnitId |
|
Equipment.BusinessUnitId |
|
SystemUser.BusinessUnitId |
*<entity> はこの属性を提供する任意のエンティティを参照します。
注意
Microsoft Dynamics CRM Online 組織の場合、この機能は、組織が Dynamics CRM Online 2015 更新プログラム 1 に更新されている場合にのみ使用できます。 この機能は内部設置型の Dynamics CRM では使用できません。
これらの特化されたメッセージは、2011 エンドポイントで引き続き動作します。 ただし、これらの属性の設定には、可能であれば、UpdateRequest または Update メソッドを使用することを推奨します。Update メッセージを使用すると、SDK API が簡素化されて、Dynamics CRM で使用される標準のデータ統合ツールのコーディングが容易になります。 また、複数の特化されたメッセージではなく、単一の 更新 メッセージに対して実行するプラグインのコーディングと登録は容易です。 この機能を有効にするために、このリリースでは、上記の属性の AttributeMetadata.IsValidForUpdate プロパティは true に変更されました。
2011 エンドポイントのこれらの特化されたメッセージを、自分のコード内で引き続き使用できます。 ただし、2011 エンドポイントに取って代わった Web API は、これらの種類の操作に対する [更新] メッセージのみをサポートします。 現在は、Web API に合わせるために、一足先にお客様のコードを変更できます。 詳細については、「Web API プレビュー」を参照してください。
プラグインへのこの変更の影響
両方の所有者フィールドのほかに部署所有のエンティティ用のその他のフィールドを含む更新要求が処理されると、パイプライン ステージ 20 および / またはステージ 40 の 更新 メッセージに対して登録されたプラグインは、所有者以外のすべてのフィールドに対して 1 回実行され、次に所有者フィールドに対して 1 回実行されます。 所有者フィールドの例は、businessunit および manager (SystemUser エンティティの場合) です。 部署所有のエンティティの例には、SystemUser、BusinessUnit、Equipment、および Team があります。
状態 / ステータスの両フィールドのほかにその他の標準フィールドを含む更新要求が処理されると、パイプライン ステージ 20 および / またはステージ 40 の 更新 メッセージに対して登録されたプラグインは、状態 / ステータス以外のすべてのフィールドに対して 1 回実行され、次に状態 / ステータス フィールドに対して 1 回実行されます。
プラグイン コードが更新の完全なデータ変更を受け取るには、プラグインをステージ 10 に登録した後、後のプラグイン (プラグインに含まれる) が消費する場合のプラグインのコンテキストで、関連情報を SharedVariables に格納する必要があります。
この変更のワークフローへの影響
両方の所有者フィールドのほかにその他の標準フィールドを含む更新要求が処理されると、更新 メッセージに対して登録されたワークフローは、所有者以外のすべてのフィールドに対して 1 回実行され、次に所有者フィールドに対して 1 回実行されます。 ユーザーによって 割り当て メッセージに対して登録されたワークフローは、所有者フィールドの更新によって起動されます。
両方の状態 / ステータス フィールドのほかにその他の標準フィールドを含む更新要求が処理されると、更新 メッセージに対して登録されたワークフローは、状態 / ステータス以外のすべてのフィールドに対して 1 回実行され、次に状態 / ステータス フィールドに対して 1 回実行されます。[状態の変更] ステップに対して登録されたワークフローは、状態 / ステータス フィールドの更新によって引き続きトリガーされます。
関連項目
ビジネス プロセスを拡張するためのプラグインを記述する
ビジネス プロセスを自動化するワークフローの記述
© 2017 Microsoft. All rights reserved. 著作権