> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lighton.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Source de Données SharePoint et Teams

> Synchronisez le contenu de vos bibliothèques de documents MS SharePoint et Teams vers Paradigm.

<Tip>
  Cette page contient le guide de configuration et les informations de référence pour le connecteur source **Microsoft SharePoint**. [Tutoriel Vidéo](https://drive.google.com/file/d/1E8QM2oWB9r4fEzgTGJTwk_tg6WgTSGyr/view?t=565)
</Tip>

<Note>
  Le connecteur source Microsoft SharePoint extrait les données d'une bibliothèque de documents SharePoint et d'un dossier spécifiés. S'il est configuré avec l'option récursive, il inclura tous les sous-dossiers dans la synchronisation. Tous les fichiers du dossier spécifié et des sous-dossiers seront pris en compte.
</Note>

## Prérequis

* ID de Tenant - Identifiant du tenant Azure AD
* ID Client - Identifiant de l'application Azure AD
* Secret Client - Secret de l'application Azure AD
* Nom du Site - Nom du site SharePoint
* Chemin du Dossier - URL vers le dossier que vous souhaitez synchroniser

## Guide de Configuration

Le connecteur source Microsoft SharePoint prend en charge l'authentification via le flux d'identifiants client OAuth au niveau de l'application (équivalent Microsoft à l'approche de compte de service de Google).

### Étape 1 : Créer une Application Azure AD

1. Connectez-vous au [Portail Azure](https://portal.azure.com/)
2. Cliquez sur l'icône de menu en haut à gauche et sélectionnez **Azure Active Directory**
3. Sélectionnez **Inscriptions d'applications**
4. Cliquez sur **Nouvelle inscription**
5. Enregistrez une application :
   * Nom : Entrez un nom pour votre application
   * Types de comptes pris en charge : Sélectionnez **Comptes dans ce répertoire organisationnel uniquement**
   * Cliquez sur **Inscrire**
6. Enregistrez l'**ID d'application (client)** et l'**ID de répertoire (tenant)** qui seront utilisés pour l'authentification

### Étape 2 : Générer un Secret Client

1. Depuis la page de votre application enregistrée, sélectionnez **Certificats et secrets**
2. Cliquez sur **Nouveau secret client**
3. Fournissez une description et sélectionnez une période d'expiration (par exemple, 1 an)
4. Cliquez sur **Ajouter**
5. **IMPORTANT :** Copiez immédiatement la valeur du secret client généré - vous ne pourrez plus la voir par la suite

### Étape 3 : Attribuer les Permissions API

1. Depuis la page de votre application enregistrée, sélectionnez **Permissions API**
2. Cliquez sur **Ajouter une permission**
3. Sélectionnez **Microsoft Graph**
4. Sélectionnez **Permissions d'application**
5. Ajoutez les permissions suivantes :
   * **Sites.Read.All**
   * **Files.Read.All**
6. Cliquez sur **Ajouter des permissions**
7. Cliquez sur **Accorder le consentement administrateur pour \[votre organisation]** pour activer les permissions

### Étape 4 : Configurer le Connecteur SharePoint dans l'Admin Paradigm

1. Naviguez vers la section Datasource dans votre interface d'administration Paradigm
2. Créez une nouvelle source de données de type **SharePoint**
3. Ajoutez vos identifiants dans les champs requis :

   * **tenant\_id** : Votre identifiant de tenant Azure AD
   * **client\_id** : Votre identifiant d'application Azure AD
   * **client\_secret** : Votre secret d'application Azure AD
   * **site\_name** : Nom de votre site SharePoint

   Le nom du site est essentiellement le titre de votre site SharePoint
4. Cliquez sur **`Nouvel import`** pour configurer une nouvelle configuration d'import.
   1. Dans les **Critères de filtre**, spécifiez les éléments suivants :

      * **folder\_path** : Collez l'**URL** du dossier SharePoint que vous souhaitez synchroniser.

      ```
      // devrait ressembler à quelque chose comme ça :
      <https://mysharepointtenant.sharepoint.com/sites/CommunicationSiteParadigmTest/Shared%20Documents/Forms/AllItems.aspx?id=%2Fsites%2FCommunicationSiteParadigmTest%2FShared%20Documents%2F0%20%2D%20Folder%20level%200&viewid=4ac924c4%2D7e2f%2D58ce%2D8d2b%2D96aedd9a5e25>
      ```

      (Pour synchroniser une bibliothèque de documents entière, définissez "`root`" dans le folder\_path)

      * **recursive** : Activez ou désactivez la synchronisation des sous-dossiers (par défaut `True`)
   2. **Espace de travail** : Sélectionnez l'espace de travail où les fichiers seront synchronisés (attention, doit être de type `sync`)
   3. **Fréquence** : Définissez la fréquence de synchronisation
   4. **Priorité** : Définissez l'importance relative par rapport aux autres configurations d'import
5. Cliquez sur **`ENREGISTRER`** et attendez que les tests se terminent.

Vous êtes prêt ! ✅

## Fonctionnalités Clés du Connecteur SharePoint

### Synchronisation Incrémentale

Le connecteur utilise l'API delta de Microsoft pour synchroniser efficacement uniquement les fichiers modifiés entre les exécutions. Cette approche :

* Réduit les exigences de bande passante et de traitement
* Capture tous les changements de fichiers (créations, mises à jour, suppressions)
* Maintient l'état entre les exécutions de synchronisation via un jeton delta

### Authentification et Accès

* Utilise l'authentification au niveau de l'application (non spécifique à l'utilisateur)
* Capture les changements effectués par tous les utilisateurs dans le site SharePoint
* Gère automatiquement le renouvellement des jetons pour un fonctionnement continu

### Limites et Considérations

* Le connecteur respecte les limites de documents configurées (DATASOURCES\_MAX\_DOC\_PER\_IMPORT)
* Vérifie les limites de taille de fichier avant la connexion (MAX\_DOCUMENT\_SIZE)
* Filtre par types MIME pris en charge
* L'option récursive détermine si les sous-dossiers sont inclus (par défaut oui)

## Dépannage

Si vous rencontrez des problèmes de connexion :

1. Vérifiez que toutes les identifiants (tenant\_id, client\_id, client\_secret) sont corrects
2. Assurez-vous que l'application a reçu le consentement administrateur pour les permissions requises
3. Confirmez que le site\_name est correct et accessible à l'application
4. Vérifiez que le folder\_path existe dans le site spécifié
5. Pour des messages d'erreur spécifiques, consultez la `page de session d'import` pour des informations détaillées

Pour des problèmes persistants, veuillez contacter l'équipe de développement avec des messages d'erreur spécifiques et des horodatages.
