getRecords

レコードのデータを一括で一度に取得するには、このワイヤアダプタを使用します。複数のオブジェクトまたは異なるレコードタイプを要求できます。

getRecords ワイヤアダプタでは、このユーザインターフェース API リソースが使用されますが、そのすべてのパラメータはサポートされません。

  • records — 複数のオブジェクトまたはレコードタイプにわたる可能性があるレコードデータの配列。
  • recordIds — (少なくとも 1 つが必須) サポートされているオブジェクトから取得するレコードの ID。
  • fields — 返される項目の配列。コンテキストユーザに項目へのアクセス権がない場合、エラーが返されます。コンテキストユーザに項目へのアクセス権があるかどうかがわからず、ない場合に要求を失敗させないようにする場合は、optionalFields パラメータを使用します。

ObjectApiName.FieldName または ObjectApiName.JunctionIdListName 形式で項目名を指定します。

多態的な項目はサポートされていません。fields に多態的な項目を含めると、無効な項目のエラーが発生することがあります。

  • optionalFields — (省略可能) 省略可能項目名の配列。コンテキストユーザに項目へのアクセス権がある場合、その項目は応答に含まれます。コンテキストユーザに項目へのアクセス権がない場合、その項目は応答に含まれませんが、エラーも発生しません。ObjectApiName.FieldName または ObjectApiName.JunctionIdListName 形式で項目名を指定します。

propertyOrFunction — ワイヤサービスからデータのストリームを受信する非公開のプロパティまたは関数。プロパティが @wire でデコレートされている場合、結果はそのプロパティの data プロパティまたは error プロパティに返されます。関数が @wire でデコレートされている場合、結果は data プロパティと error プロパティを持つオブジェクトで返されます。

  • resultsバッチの結果
  • hasErrors — 結果セットに HTTP 状況コードが 400 番台または 500 番台の結果が 1 つ以上ある場合は true、それ以外の場合は false

1 つのレコードのデータを取得するには、getRecord を使用します。

次の例では、レコード ID を使用して複数のレコードを読み込んでいます。recordId の値を適切な値に置き換えます。

代わりに、複数のオブジェクトにわたるレコードを要求できます。

ワイヤアダプタをコールすると、ユーザインターフェース API によって要求の SOQL クエリが作成されます。この SOQL クエリには 10 万文字の制限があります。この制限を超えることが予想される場合は、クエリを複数のクエリに分割してバッチで実行することをお勧めします。

getRecordserror プロパティでエラーを返します。エラーを表示するには、then() ブロックと catch() ブロックが含まれる Promise を使用して lightning/platformShowToastEvent モジュールで提供されるトーストを使用できます。