特化された更新操作の動作

更新操作を実行する複数の削除され特化されたメッセージです。 以前のバージョンではこれらのメッセージを使用する必要がありましたが、現在は同じ操作でIOrganizationService.Updateを使用して実行されます。 またはUpdateRequestクラスおよびIOrganizationService.Execute

廃止されたメッセージ要求	更新が必要な属性
AssignRequest	<entity>.OwnerId
SetStateRequest	<entity>.StateCode <entity>.StatusCode
SetParentSystemUserRequest	SystemUser.ParentSystemUserId
SetParentTeamRequest	Team.BusinessUnitId
SetParentBusinessUnitRequest	BusinessUnit.ParentBusinessUnitId
SetBusinessEquipmentRequest	Equipment.BusinessUnitId
SetBusinessSystemUserRequest	SystemUser.BusinessUnitId

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

重要

StateCode 列を更新するときは、常に目的の StatusCode を設定することが重要です。

StateCode と StatusCode には従属値があります。 特定の StateCode 値に対して複数の有効な StatusCode 値がある可能性がありますが、各 StateCode 列には 1 つの DefaultStatus 値が設定されています。 StatusCode を指定せずに StateCode を更新すると、デフォルトのステータス値がシステムによって設定されます。

また、テーブルと StatusCode 列で監査が有効になっている場合、更新操作で指定しない限り、StatusCode 列の変更された値は監査データに取り込まれません。

詳細: 従来の更新メッセージ

この変更では、プラグインとワークフローで注意する必要がある特別な動作が追加されました。

プラグインの場合

所有者フィールドとビジネスが所有するテーブルの他の標準フィールドの両方を含む更新要求が処理されると、PreOperation または PostOperation ステージで 更新 メッセージで使用する登録されたプラグインが、すべての非所有者フィールドに対して 1 回実行され、その後に所有者フィールドに対して 1 回実行されます。 所有者フィールドの例は、businessunit および manager (SystemUser テーブル の場合) です。 ビジネスが所有するテーブルの例には、SystemUser、BusinessUnit、装置Equipment、および Team などがあります。

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

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

ワークフローの場合

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

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

参照

.NET 用 SDK を使用しテーブルを更新および削除する
イベント フレームワーク

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。