REST API 開発者ガイド
jComposite サブ要求の結果
プロパティ
| 名前 | 型 | 説明 |
|---|---|---|
| body | データ型は、サブ要求の応答種別によって異なります。 |
このサブ要求のレスポンスボディ。詳細は、サブ要求リソースのドキュメントを参照してください。 サブ要求がエラーを返す場合、ボディにはエラーコードとエラーメッセージが含まれます。エラー応答についての詳細は「状況コードとエラー応答」を参照してください。 |
| httpHeaders | Map<String, String> | このサブ要求のレポートヘッダーとその値。Composite リソースは Content-Length ヘッダーをサポートしないため、サブ要求のレスポンスにも最上位レベルのレスポンスにもこのヘッダーは含まれません。 |
| httpStatusCode | Integer | このサブ要求の HTTP 状況コード。Composite 要求で allOrNone が true に設定されていて、サブ要求がエラーを返す場合、他のすべてのサブ要求は 400 HTTP 状況コードを返します。 |
| referenceId | String | サブ要求で指定された参照 ID。このプロパティにより、サブ要求をその結果に容易に関連付けることができます。 |
例
次の例は、Contact の作成中にエラーが発生したサブ要求への応答を示します。
参照 ID に無効な文字が含まれていた場合の動作および応答
referenceId には、文字、数字、アンダースコア (「_」) のみを使用する必要があります。
無効な文字があった場合の API の動作は、API バージョンとリリースによって異なります。(API バージョンは、Composite 要求の作成に使用されたものです。ただし、このバージョンはサブ要求の url パラメータに指定された API バージョンと必ずしも同じではありません)。
- 「Cloudy Consulting」という取引先を作成する。
- 取引先「Mary Smith」を作成して、取引先 Cloudy Consulting にリンクする。
- さらに、「Easy Spaces」という新しい取引先を作成する。
バージョン 51.0 以前
2 つの取引先が作成されます (最初の取引先が参照 ID 内の無効な文字を使用していても)。ただし、(無効な文字を含む参照 ID を使用して) 取引先を作成する試みは失敗します。
以前のリリースでのバージョン 51.0 以前の応答
上記の応答は、Summer ’21 以降のリリースのものです。Summer ’21 より前のリリースの場合、応答内の「(」または「[」を含む問題のある参照 ID は、切り捨てられました。したがって、応答は次のようになりました。
Summer ’21 リリース以降、参照 ID は、問題があっても切り捨てられなくなりました。この変更により、応答と要求の各部をより簡単に突き合わせることができます。
バージョン 52.0 以降
まとめ
Null 項目への参照に関する動作
Null 項目への参照がある場合の API の動作は、API のバージョンによって異なります。(API バージョンは、Composite 要求の作成に使用されたものです。ただし、このバージョンはサブ要求の url パラメータに指定された API バージョンと必ずしも同じではありません)。
たとえば、次の要求について考えてみましょう。この要求は、既存の取引先責任者を探して、@{refContact.FirstName} と @{refContact.LastName} を使用してレコードを作成します。
では、取引先責任者の名が NULL (未設定) の場合はどうなるかについて考えてみます。
バージョン 51.0 以前の応答
API バージョン 51.0 以前では、取引先責任者の FirstName 項目が null であることが原因で、連動サブ要求が失敗します。
この例では、allOrNone が false に設定されていることを想定しています。true の場合、Composite 要求全体がロールバックされます。「Composite 要求および Collections 要求の allOrNone パラメータ」を参照してください。
バージョン 52.0 以降の応答
API バージョン 52.0 以降では、要求が成功します。
親要求で指定されていない項目への参照に関する動作
連動サブ要求では、常に親リクエストで明示的に選択されている項目のみを使用する必要があります。この方法のとおりに設定しなかった場合、API の動作は API バージョンによって異なります。(API バージョンは、Composite 要求の作成に使用されたものです。ただし、このバージョンはサブ要求の url パラメータに指定された API バージョンと必ずしも同じではありません)。
たとえば、以下の要求を検討します。この要求では、次の操作が試みられます。
- 特定の取引先責任者を見つけます。
- @{refContact.records[0].AccountId} を使用して取引先責任者の取引先 ID を取得します。
ただし、親要求は AccountId を明示的に照会していません。
バージョン 51.0 以前の応答
API バージョン 51.0 以前では、まれにこのような要求が成功する場合があります。
バージョン 52.0 以降の応答
API バージョン 52.0 以降では、次の要求は常に失敗します。