FieldValueSet リソース

  • [アーティクル]

listItem リソースでの列の値を表します。

JSON 表記

以下は、fieldValueSet リソースの JSON 表記です。

{
    "Author": "Brad Cleaver",
    "AuthorLookupId": "13",
    "Name": "Kangaroos and Wallabies: A Deep Dive",
    "Color": "Red",
    "Quantity": 350,
}

プロパティ

listItem の各ユーザーに表示されるフィールドは、fieldValueSet の名前と値のペアとして返されます。 上記の例は、Author、Name、Color、Quantity の 4 つの列を含むリストを示しています。

既定では、ルックアップ フィールド (上記の Author など) は返されません。 代わりにサーバーは、ルックアップの対象となる listItem を参照する 'LookupId' フィールド (上記の AuthorLookupId など) を返します。 'LookupId' フィールドの名前は元のフィールド名の末尾に LookupId を付けたものです。

1 つのクエリでは、ルックアップ フィールドを最大 12 個まで要求できます。 サーバーは、要求に select ステートメントと必要なフィールドが含まれていると、ルックアップ値を返します。 例:

GET /sites/{site-id}/lists/{list-id}/items?expand=fields(select=Author,BookTitle,PageCount)

1 つのクエリでは、最大 12 個のルックアップ フィールドと、任意の数の通常のフィールドを要求できます。