[更新] を使用して特化された操作を実行する

公開日: 2016年11月

対象: Dynamics CRM 2015

このリリースの前では、特定のエンティティの属性値を更新するためには、特化されたメッセージが要求されました。 このリリースでは、現在は、これらの属性を設定するために、UpdateRequest を使用できます。 次の表は、特化された削除されたメッセージ要求と、UpdateRequest を使用して更新できる関連のメッセージ属性を示しています 。

*<entity> はこの属性を提供する任意のエンティティを参照します。

これらの特化されたメッセージは、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. 著作権