FieldValueSet 资源

表示 listItem 资源中的列值。

JSON 表示形式

下面是 fieldValueSet 资源的 JSON 表示形式。

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

属性

listItem 中的每个用户可见字段作为 fieldValueSet 中的名称/值对返回。 上面是针对包含作者名称颜色数量这四列列表的一个示例。

默认情况下不返回查找字段(如上述 Author)。 相反,服务器会返回一个引用查找中锁定的 listItem 的“LookupId”字段(如上述 AuthorLookupId)。 “LookupId”字段的名称是原始字段名称,后跟 LookupId

单个查询中可能请求最多 12 个查找字段。 如果请求包含带所需字段的 select 语句,服务器将返回查找值。 示例:

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

你可以在单个查询中请求最多 12 个查找字段以及任意数量的常规字段。