SharePoint

Synchronisez des listes ou bibliothèques SharePoint via Microsoft Graph.

Prérequis

• Application Azure AD (peut être la même que pour Teams) avec :
  • Sites.Read.All
  • Files.Read.All
• Secret client valide.
• ID du site SharePoint et de la liste/bibliothèque à synchroniser.

Récupérer les IDs

1. Ouvrez SharePoint et naviguez vers le site cible.
2. Utilisez le script suivant dans la console navigateur pour récupérer les IDs :

fetch('/_api/site?$select=Id,SiteId,WebId').then(r => r.json()).then(console.log)

ou via Microsoft Graph :

GET https://graph.microsoft.com/v1.0/sites/{hostname}:/sites/{site-name}

3. Pour la liste :

GET https://graph.microsoft.com/v1.0/sites/{site-id}/lists

Notez id et, pour les documents, driveId.

Configuration dans Hestyna

1. Catalogue → Intégrations → Microsoft Teams / SharePoint.
2. Renseignez :
   • Client ID,
   • Client secret,
   • Tenant ID,
   • Endpoint Graph spécifique si besoin.
3. Testez la connexion.

Créer un index SharePoint

1. Connaissance → Indexes → sélectionnez l’intégration.
2. Fournissez :
   • endpoint Graph (https://graph.microsoft.com/v1.0/sites/.../lists/.../items?expand=fields),
   • items_path (value),
   • title_field (fields.Title),
   • body_field (fields.Description ou autre colonne).
3. Lancez la synchronisation.

Bonnes pratiques

• Créez une vue SharePoint dédiée avec uniquement les colonnes utiles.
• Utilisez fields.Language pour taguer les documents multilingues.
• Limitez la taille des pièces jointes (préférez les liens aux fichiers lourds).

Maintenance

• Renouvelez le secret client avant son expiration.
• Surveillez les rate limits Graph (429) et ajustez la cadence.
• Activez les alertes d’échec via Observabilité.

Dépannage

Problème	Piste
403 Forbidden	Permissions Graph manquantes ou consentement non accordé.
Champs vides	Vérifiez les noms des colonnes (fields.Description).
Timeout	Réduisez le périmètre (filtre ?filter=) ou augmentez l’intervalle des syncs.

Voir aussi : Teams pour la configuration Azure partagée.