Différencier fichier et élément de liste

Un document peut être accessible comme driveItem, tandis que ses champs personnalisés appartiennent au listItem de la bibliothèque. Confondre leurs identifiants provoque des appels vers la mauvaise ressource.

Microsoft Graph documente PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/fields pour les valeurs de colonnes.

Contrôler le champ Lookup

Le libellé affiché dans SharePoint n’est pas toujours le nom interne. Les références doivent pointer vers des éléments existants dans la liste cible.

La ressource fieldValueSet documente la convention LookupId ; pour une colonne multi-valeurs, vérifiez le format réellement pris en charge avant de construire le corps JSON.

Diagnostiquer la réponse complète

Conservez le code HTTP, le corps d’erreur et un identifiant de corrélation sans exposer le jeton d’accès. Vérifiez Content-Type, permissions et IDs de liste.

Testez une valeur connue sur un fichier non critique avant de généraliser à toute la bibliothèque.

Vérifier l’écriture et la concurrence

Relisez les champs après modification, surtout quand plusieurs valeurs sont attendues. Un succès HTTP ne remplace pas la validation des données métier.

Lorsque c’est adapté, un contrôle de version tel que If-Match aide à éviter un écrasement concurrent.

Questions fréquentes

Le driveItem ID et le listItem ID sont-ils identiques ?

Non. La mise à jour des champs utilise l’identifiant de l’élément de liste.

Pourquoi Graph renvoie-t-il 400 InvalidRequest ?

Vérifiez la ressource, les noms internes, le type de colonne et le détail de l’erreur renvoyée.

Peut-on mettre à jour seulement une colonne ?

Oui, le point de terminaison fields cible les champs transmis dans la requête.

DOCUMENTATION DE RÉFÉRENCE

Sources techniques utilisées pour ce guide

Ces sources documentent les concepts techniques évoqués. FazaSolutions les utilise comme références de conception, sans les présenter comme des recommandations commerciales.