Ressource FieldValueSetFieldValueSet resource

  • 2 minutes de lecture

Espace de noms: microsoft.graphNamespace: microsoft.graph

Représente les valeurs de colonne dans une ressource listItem.Represents the column values in a listItem resource.

Représentation JSONJSON representation

Voici une représentation JSON d’une ressource fieldValueSet.Here is a JSON representation of a fieldValueSet resource.

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

PropriétésProperties

Tous les champs visibles par l’utilisateur dans la ressource listItem sont renvoyés en tant que paire nom-valeur dans la ressource fieldValueSet.Each user-visible field in the listItem is returned as a name-value pair in the fieldValueSet. L’exemple ci-dessus concerne une liste qui contient quatre colonnes, Author, Name, Color et Quantity.The example above is for a list that contains four columns, Author, Name, Color, and Quantity.

Les champs de recherche (comme Author ci-dessus) ne sont pas renvoyés par défaut.Lookup fields (like Author above) are not returned by default. En revanche, le serveur renvoie un champ « LookupId » (comme AuthorLookupId ci-dessus) qui référence la ressource listItem ciblée dans la recherche.Instead, the server returns a 'LookupId' field (like AuthorLookupId above) referencing the listItem targeted in the lookup. Le nom du champ « LookupId » est le nom de champ d’origine suivi par LookupId.The name of the 'LookupId' field is the original field name followed by LookupId.

Vous pouvez utiliser jusqu’à 12 champs Liste de choix par requête.Up to 12 lookup fields may be requested in a single query. Le serveur renverra les valeurs Liste de choix si votre demande comprend une instruction select avec les champs dont vous avez besoin.The server will return lookup values if your request includes a select statement with the fields you need. Exemple :Example:

GET https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}/items?expand=fields(select=Author,BookTitle,PageCount)

Vous pouvez utiliser jusqu’à 12 champs Liste de choix par requête, ainsi qu’un nombre quelconque de champs normaux.You may request up to 12 lookup fields in a single query, plus any number of regular fields.