Ressource ListItem

  • Article
  • 2 minutes de lecture

Cette ressource représente un élément d’une [liste][]  SharePoint. Les valeurs des colonnes de la liste sont disponibles dans le dictionnaire fieldValueSet.

Tâches disponibles pour une ressource listItem

Les tâches suivantes peuvent être exécutées sur les ressources listItem. Tous les exemples ci-dessous concernent une [liste][], par exemple : https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}.

Tâche courante Méthode HTTP
Get GET /items/{item-id}
Obtenir les valeurs de colonne GET /items/{item-id}?expand=fields
Créer POST /items
[Supprimer][] DELETE /items/{item-id}
Mettre à jour PATCH /items/{item-id}
[Mettre à jour les valeurs de colonne][Update] PATCH /items/{item-id}/fields

Représentation JSON

Voici une représentation JSON de la ressource listItem.

{
  "contentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
  "fields": { "@odata.type": "microsoft.graph.fieldValueSet" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "driveItem": { "@odata.type": "microsoft.graph.driveItem" },
  "versions": [{"@odata.type": "microsoft.graph.listItemVersion"}],

  /* inherited from baseItem */
  "id": "string",
  "name": "name of resource",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "timestamp",
  "description": "description of resource",
  "eTag": "string",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "timestamp",
  "parentReference": { "@odata.type": "microsoft.graph.itemReference"},
  "webUrl": "url"
}

Propriétés

La ressource listItem possède les propriétés suivantes.

Nom de la propriété Type Description
contentType contentTypeInfo Type de contenu de l’élément de cette liste.

Les propriétés suivantes sont héritées de la ressource baseItem.

Nom de la propriété Type Description
id string Identificateur unique de l’élément. En lecture seule.
name string Nom/titre de l’élément.
createdBy identitySet Identité du créateur de cet élément. En lecture seule.
createdDateTime DateTimeOffset Date et heure de création de l’élément. En lecture seule.
description string Description de l’élément.
eTag string ETag pour l’élément. En lecture seule.
lastModifiedBy identitySet Identité du dernier modificateur de cet élément. En lecture seule.
lastModifiedDateTime DateTimeOffset Date et heure de dernière modification de l’élément. En lecture seule.
parentReference itemReference Informations de l’élément parent, si l’élément possède un parent. En lecture-écriture.
sharepointIds sharepointIds Renvoie les identificateurs utiles pour garantir la compatibilité de SharePoint REST. En lecture seule.
webUrl chaîne (URL) URL qui affiche l’élément dans le navigateur. En lecture seule.

Relations

La ressource listItem a les relations suivantes avec les autres ressources.

Nom de la relation Type Description
activities Collection itemActivity Liste des activités qui ont récemment eu lieu sur cet élément.
driveItem driveItem Pour les bibliothèques de documents, la relation driveItem présente la ressource listItem comme une ressource driveItem
fields fieldValueSet Valeurs des colonnes définies sur cet élément de liste.
versions Collection listItemVersion Liste des versions précédentes de l’élément de liste.