特化された更新操作の動作
更新操作を実行する複数の削除され特化されたメッセージです。 以前のバージョンではこれらのメッセージを使用する必要がありましたが、現在は同じ操作で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 分かかります。 個人データは収集されません (プライバシー ステートメント)。