一括削除の実行

[アーティクル]
03/04/2017

公開日: 2017年1月

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

大量のデータを削除するには、BulkDeleteRequest メッセージを使用して一括削除ジョブを送信する必要があります。一括削除ジョブはバックグラウンドで非同期的に実行されるので他の活動を中断することはありません。一括削除ジョブを実行するレコードを記述するクエリ式は、この要求の QuerySet プロパティで指定されます。

一括削除ジョブは、一括削除操作エンティティによって表されます。このエンティティのスキーマ名は BulkDeleteOperation です。一括削除操作レコードには次の情報が含まれています。

一括削除ジョブで削除したレコードの数。
一括削除ジョブで削除できなかったレコードの数。
一括削除ジョブが定期的なジョブかどうか。
一括削除ジョブの開始時刻。

一括削除ジョブは、ジョブの実行開始前に作成されたレコードのみを削除します。

注意

一括削除ジョブが失敗するか途中で終了した場合、ジョブが失敗する前または終了する前に削除されたレコードはロールバックされず、削除されたままとなります。BulkDeleteOperation の失敗は BulkDeleteFailure レコードに保存され、RetrieveRequest メッセージまたは RetrieveMultipleRequest メッセージを使用して取得できます。

一括削除ジョブは、伝播規則に従って特定のレコードを削除します。これらの規則は、エンティティ間の関連付けの種類に基づいています。詳細については、「エンティティ関係の動作」を参照してください。

一括削除ジョブを実行するには、削除するエンティティの種類に対する BulkDelete message privilegesと Delete message privilegesが必要です。また、BulkDeleteRequest メッセージで指定されているエンティティレコードに対する読み取りアクセス許可も必要です。既定では、システム管理者には必要なアクセス許可が与えられていますが、他のユーザーにはこれらのアクセス許可を与える必要があります。

一括削除は、削除アクションでサポートされているすべてのエンティティに対して実行できます。エンティティレコードに対して使用可能なアクションについては、「エンティティレコードに対する操作」を参照してください。

プラグインまたはワークフロー (プロセス) が、特定の種類のエンティティに対する削除アクションによってトリガーされる場合は、この種類のエンティティレコードが一括削除ジョブで削除されるたびにトリガーされます。

一括削除の実行

関連項目

その他のリソース