この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

SOAP API 開発者ガイド

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

AllOrNoneHeader

AllOrNoneHeader ヘッダーでは、正常に処理されないレコードがあった場合に、コールによるすべての変更のロールバックを許可することができます。デフォルトの動作では、コールの部分的な成功を許可します。つまり、エラーのないレコードはコミットされますが、エラーのあったレコードはコールの結果では失敗とマークされます。このヘッダーは、API バージョン 20.0 以降で使用できます。

ヘッダーが有効な場合でも、エラーのあるレコードを特定するには、レコードごとにコールの結果の  success 項目を確認する必要があります。すべての success 項目は true または false とマークされ、コールが正常に処理されたかどうかを示します。少なくとも 1 つのレコードに関連するエラーがある場合、レコードのコールの結果の errors 項目でエラーの詳細情報が提供されます。同じコールのその他のレコードにエラーがない場合、errors 項目は同じコールの他のレコードの失敗によりレコードがロールバックされたことを示します。

API コール

create()、delete()、undelete()、update()、upsert()

項目

要素名 型 説明
allOrNone boolean true の場合、コールに失敗したレコードが存在すると、コールに対するすべての変更がロールバックされます。すべてのレコードが正常に処理されない限りレコードの変更はコミットされません。

デフォルトは、false です。一部のレコードは正常に処理されますが、その他のレコードはコールの結果で失敗とマークされます。

サンプルコード —Java

このサンプルでは、AllOrNoneHeader の使用方法を示します。2 つの取引先責任者の作成を試みますが、2 番目の取引先責任者について必須項目の一部が設定されていないため、作成に失敗します。次に、このサンプルでは AllOrNoneHeader を true に設定し、取引先責任者を作成するコールを実行します。2 番目の取引先責任者の作成でエラーが発生します。そのため、トランザクション全体がロールバックされ、取引先責任者は作成されません。これは、AllOrNoneHeader が true に設定されていたためです。