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

  • [アーティクル]

 

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

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

削除されたメッセージ要求

更新される属性

AssignRequest

<entity>.OwnerId*

SetStateRequest

<entity>.StateCode*

重要

SLA および RoutingRule エンティティについては、単一の 更新 メッセージ呼び出しでの OwnerId と StateCode の変更はサポートされていないので、例外が発生します。

SetParentSystemUserRequest

SystemUser.ParentSystemUserId

SetParentTeamRequest

Team.BusinessUnitId

SetParentBusinessUnitRequest

BusinessUnit.ParentBusinessUnitId

SetBusinessEquipmentRequest

Equipment.BusinessUnitId

SetBusinessSystemUserRequest

SystemUser.BusinessUnitId

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

これらの特化されたメッセージは、2011 エンドポイントで引き続き動作します。 ただし、これらの属性の設定には、可能であれば、UpdateRequest または Update メソッドを使用することを推奨します。Update メッセージを使用すると、組織サービスが簡素化されて、Dynamics 365 で使用される標準のデータ統合ツールのコーディングが容易になります。 また、複数の特化されたメッセージではなく、単一の 更新 メッセージに対して実行するプラグインのコーディングと登録は容易です。 この機能を有効にするために、このリリースでは、上記の属性の AttributeMetadata.IsValidForUpdate プロパティは true に変更されました。

2011 エンドポイントのこれらの特化されたメッセージを、自分のコード内で引き続き使用できます。 ただし、組織サービスに取って代わった Web API は、これらの種類の操作に対する 更新 メッセージのみをサポートします。 現在は、Web API に合わせるために、一足先にお客様のコードを変更できます。 詳細については、「Microsoft Dynamics 365 Web API の使用」を参照してください。

プラグインへのこの変更の影響

両方の所有者フィールドのほかに部署所有のエンティティ用のその他のフィールドを含む更新要求が処理されると、パイプライン ステージ 20 および / またはステージ 40 の 更新 メッセージに対して登録されたプラグインは、所有者以外のすべてのフィールドに対して 1 回実行され、次に所有者フィールドに対して 1 回実行されます。 所有者フィールドの例は、businessunit および manager (SystemUser エンティティの場合) です。 部署所有のエンティティの例には、SystemUser、BusinessUnit、Equipment、および Team があります。

状態 / ステータスの両フィールドのほかにその他の標準フィールドを含む更新要求が処理されると、パイプライン ステージ 20 および / またはステージ 40 の 更新 メッセージに対して登録されたプラグインは、状態 / ステータス以外のすべてのフィールドに対して 1 回実行され、次に状態 / ステータス フィールドに対して 1 回実行されます。

プラグイン コードが更新の完全なデータ変更を受け取るには、プラグインをステージ 10 に登録した後、後のプラグイン (プラグインに含まれる) が消費する場合のプラグインのコンテキストで、関連情報を SharedVariables に格納する必要があります。

この変更のワークフローへの影響

両方の所有者フィールドのほかにその他の標準フィールドを含む更新要求が処理されると、更新 メッセージに対して登録されたワークフローは、所有者以外のすべてのフィールドに対して 1 回実行され、次に所有者フィールドに対して 1 回実行されます。 ユーザーによって 割り当て メッセージに対して登録されたワークフローは、所有者フィールドの更新によって起動されます。

両方の状態 / ステータス フィールドのほかにその他の標準フィールドを含む更新要求が処理されると、更新 メッセージに対して登録されたワークフローは、状態 / ステータス以外のすべてのフィールドに対して 1 回実行され、次に状態 / ステータス フィールドに対して 1 回実行されます。[状態の変更] ステップに対して登録されたワークフローは、状態 / ステータス フィールドの更新によって引き続きトリガーされます。

関連項目

ビジネス プロセスを拡張するためのプラグインを記述する
Dynamics 365 プロセスを使用したビジネス プロセスの自動化

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権