getRecord

レコードのデータを取得するには、このワイヤアダプタを使用します。

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

  • recordId — (必須) サポートされているオブジェクトのレコードの ID。
  • fields — (fields または layoutTypes のいずれかが必須) 返される項目または項目の配列。コンテキストユーザに項目へのアクセス権がない場合、エラーが返されます。コンテキストユーザに項目へのアクセス権があるかどうかがわからず、ない場合に要求を失敗させないようにする場合は、optionalFields パラメータを使用します。

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

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

  • layoutTypes — ({fields} または layoutTypes のいずれかが必須) 返される項目を指定します。このプロパティが指定されている場合、応答は layoutTypes、modes、optionalFields の結合になります。

    • Compact — この値を使用して、レコードの重要な項目が含まれるレイアウトを取得します。
    • Full — この値を使用して、フルレイアウトを取得します。 すべてのオブジェクトでレイアウトがサポートされるわけではありません。たとえばレポートオブジェクトには describeLayout() コールは含まれません。この場合、optionalFields を使用して項目のデフォルト設定を指定することをお勧めします。

パフォーマンスが向上するように、できる限りレイアウトではなく項目を指定します。プロビジョニングされた項目をコンポーネントではなくシステム管理者が制御する場合にのみレイアウトを指定します。コンテキストユーザのレイアウトに割り当てられているすべての項目の受信をコンポーネントで制御する必要があります。

:::

  • modes — (layoutTypes が指定されている場合は省略可能。layoutTypes が指定されていない場合、このパラメータは無視されます。)レコードのアクセスモード。この値によって、レイアウトから取得する項目が決まります。レイアウトには作成、編集、表示の各モードで異なる項目が含まれます。

    • Create — レコードをユーザが作成できる UI の構築を目的とする場合、このモードを使用します。
    • Edit — レコードをユーザが編集できる UI の構築を目的とする場合、このモードを使用します。
    • View — (デフォルト) レコードを表示する UI の構築を目的とする場合、このモードを使用します。

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

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

レコード応答では recordTypeInfo プロパティは使用しないでください。代わりに、すべてのレコードで返される recordTypeId プロパティを使用してください。

条件による絞り込みや、動的なレコード ID の操作を容易にするには、代わりに GraphQL ワイヤアダプタの使用について検討してください。

次の例では、必須および省略可能の項目を含むレコードを読み込んでいます。getRecord と getFieldValue を使用して、レコードを取得し、その項目値を表示します。recordId の値を適切な値に置き換えます。

カスタムユーザインターフェースで項目値を読み込みます。

次の例では、レイアウトでレコードを読み込んでいます。recordId の値を適切な値に置き換えます。前の例と同様に、getFieldValue ワイヤアダプタを使用して項目値を表示できます。

getRecord とカスタム UI の使用例については、「レコードデータの取得」を参照してください。

then() および catch() ブロックで Promise を使用します。エラーを表示するには、lightning/platformShowToastEvent モジュールで提供されるトーストを使用します。

関連トピック