SOAP API 開発者ガイド
jAllOrNoneHeader
AllOrNoneHeader ヘッダーがない場合、エラーのないレコードはコミットされますが、エラーのあったレコードはコールの結果では失敗とマークされます。このヘッダーは、API バージョン 20.0 以降で使用できます。
ヘッダーが有効な場合でも、エラーのあるレコードを特定するには、レコードごとにコールの結果の success 項目を確認する必要があります。各 success 項目には true または false が含まれ、コールが正常に処理されたかどうかを示します。
少なくとも 1 つのレコードに関連するエラーがある場合、レコードのコールの結果の errors 項目でエラーの詳細情報が提供されます。同じコールのその他のレコードにエラーがない場合、errors 項目は他のエラーによりレコードがロールバックされたことを示します。
API コール
項目
| 要素名 | 型 | 説明 |
|---|---|---|
| allOrNone | boolean |
true の場合、コールに失敗したレコードが存在すると、コールに対するすべての変更がロールバックされます。すべてのレコードが正常に処理されない限りレコードの変更はコミットされません。 デフォルトは、false です。一部のレコードは正常に処理されますが、その他のレコードはコールの結果で失敗とマークされます。 |
サンプルコード —Java
このサンプルでは、AllOrNoneHeader の使用方法を示します。2 つの取引先責任者の作成を試みますが、2 番目の取引先責任者について必須項目の一部が設定されていないため、作成に失敗します。次に、このサンプルでは allOrNone 項目を true に設定し、取引先責任者の作成を試みます。2 番目の取引先責任者の作成でエラーが発生します。そのため、トランザクション全体がロールバックされ、取引先責任者は作成されません。