Connecteur CSV

  • Article

Le connecteur CSV Graph permet à votre organisation d’ingérer du contenu à partir de fichiers CSV stockés dans des bibliothèques et des Azure Data Lake Storage SharePoint (ADLS). Après avoir configuré le connecteur et indexé le contenu à partir de ces sources, les utilisateurs finaux peuvent trouver des fichiers CSV dans Microsoft Recherche.

Remarque

Lisez l’article Configuration de votre connecteur Graph pour comprendre les instructions générales de configuration des connecteurs Graph.

Cet article s’adresse à toute personne qui configure, exécute et surveille un connecteur CSV. Il complète le processus de configuration générale et affiche des instructions qui s’appliquent uniquement à ce connecteur.

Avant de commencer

Vérifiez qu’il n’y a pas d’espace blanc dans les en-têtes CSV. Pour une source de données SharePoint, vous devez créer une application SharePoint avec la configuration Oauth. Pour une source de données ADLS, vous devez créer un compte de stockage ADLS.

Créer une application SharePoint avec la configuration Oauth

Vérifiez que les fichiers .csv que vous souhaitez indexer ont été chargés dans une bibliothèque de documents SharePoint. Vous pouvez utiliser un site SharePoint existant ou en créer un nouveau.

Créer une application SharePoint

  1. Accédez à https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.asp.
  2. Dans les champs Id client et Clé secrète client, sélectionnez Générer.
  3. Pour Titre, entrez un nom d’application.
  4. Dans le champ Domaine d’application, entrez www.gcs.com.
  5. Dans le champ URL de redirection, entrez https://www.gcs.com.
  6. Sélectionnez Créer.
  7. Copiez les informations de configuration de l’application, notamment l’ID client et la clé secrète client. Vous en aurez besoin lorsque vous configurerez le connecteur CSV.

Activer les autorisations d’application pour autoriser CustomAppAuthentication

Dans PowerShell, exécutez ces commandes en mode administratif. Utilisez l’adresse e-mail de l’administrateur qui configure le connecteur et le nom de votre organisation. Lorsque la fenêtre contextuelle de mot de passe s’affiche, l’administrateur doit entrer son mot de passe.

Install-Module -Name Microsoft.Online.SharePoint.PowerShell
$adminUPN=”<admin@contoso.onmicrosoft.com>”
$orgName=“<contoso>”
$userCredential = Get-Credential -UserName $adminUPN -Message "Enter your password."
Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential $userCredential
Set-spotenant –DisableCustomAppAuthentication $false

Remarque

Si vous utilisez PowerShell 7, utilisez d’abord cette commande Import-Module microsoft.online.sharepoint.powershell -UseWindowsPowerShell

Remarque

Si vous utilisez l’authentification multifacteur, utilisez Connect-SPOService -Url https://$orgName-admin.sharepoint.com.

Terminer la configuration de l’application

  1. Accédez à https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.asp.
  2. Dans le champ Id d’application, collez l’ID client de l’application SharePoint, puis sélectionnez Recherche.
  3. Dans le champ XML de demande d’autorisation, collez ce code et sélectionnez Créer.
<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>
  1. Sélectionnez Approuver.

Créer un compte de stockage ADLS

Pour obtenir des instructions pas à pas, consultez Créer un compte de stockage. Pour autoriser les fonctionnalités de stockage de fichiers, sous l’onglet Avancé, sélectionnez Activer l’espace de noms hiérarchique et Créer un conteneur pour ce site.

Lorsque vous configurez le connecteur CSV, vous devez fournir une chaîne de connexion de stockage principal. Pour le trouver, ouvrez le compte de stockage que vous avez créé et sélectionnez Clés d’accès. Sélectionnez Afficher les clés et copiez la chaîne de connexion pour Key1.

Étape 1 : Ajouter un connecteur Graph dans le Centre d'administration Microsoft 365

Suivez les instructions d’installation générales.

Étape 2 : Sélectionner des expériences

Actuellement, le connecteur CSV prend uniquement en charge les expériences de recherche.

Connecteur CSV avec Microsoft’expérience de recherche sélectionnée.

Étape 3 : nommer la connexion

Suivez les instructions d’installation générales.

Étape 4 : Configurer les paramètres de connexion

Les paramètres de source de données sont différents pour SharePoint et ADLS.

Pour une source SharePoint

  1. Dans les paramètres Source de données, sélectionnez SharePoint comme source de données.
  2. Dans le site SharePoint, entrez l’URL du site, https://Org-Name.sharepoint.com/Site-Namepar exemple.
  3. Dans Bibliothèque de documents, entrez le nom de la bibliothèque dans laquelle les fichiers .csv sont stockés.
  4. Dans Type d’authentification, sélectionnez Oauth2.0(informations d’identification du client).
  5. Entrez l’ID client et la clé secrète client que vous avez copiés lors de la création de l’application SharePoint.
  6. Sélectionnez Tester la connexion. Vous devez obtenir un message La connexion est réussie .

Connecteur CSV avec paramètres de source de données pour un site SharePoint.

Pour contrôler l’accès au niveau d’un fichier, entrez utilisateurs ou groupes Azure AD.

Liste de contrôle d’accès avec l’utilisateur et le groupe inclus.

Pour une source ADLS

  1. Dans les paramètres Source de données, sélectionnez Azure Data Lake Storage(ADLS) comme source de données.
  2. Dans Chaîne de connexion de stockage principal, entrez la chaîne de connexion que vous avez copiée.
  3. Entrez le nom du conteneur et le nom de fichier.
  4. Sélectionnez Tester la connexion. Vous devez obtenir un message La connexion est réussie .

Connecteur CSV avec paramètres de source de données pour une source Azure Data Lake Storage.

Remarque

Si votre source de données contient plusieurs fichiers .csv avec les mêmes en-têtes, sélectionnez Inclure tous les fichiers CSV à l’emplacement.

Pour contrôler l’accès au niveau d’un fichier, entrez utilisateurs ou groupes Azure AD.

Liste de contrôle d’accès avec l’utilisateur et le groupe inclus.

Étape 5 : Délimiteur à plusieurs éléments (facultatif)

Si vos colonnes sources peuvent prendre plusieurs valeurs, entrez un délimiteur à plusieurs éléments, un point-virgule (;) par exemple.

Étape 6 : Paramètres des propriétés analysées

Cette page renvoie la première ligne de votre fichier .csv en tant que Propriétés source. Pour modifier le type de données, dans la liste Identificateur unique , sélectionnez au moins une option.

Pour contrôler l’accès au niveau d’un élément, sélectionnez les colonnes mappées aux utilisateurs autorisés et aux groupes autorisés. Vous devez inclure deux colonnes, AllowedUsers et AllowedGroups, dans le fichier .csv. Chaque ligne doit contenir les ID Azure AD.

Paramètres de contrôle d’accès au niveau de l’élément.

Remarque

Le connecteur CSV prend en charge le contrôle d’accès au niveau du fichier ou de l’élément. Si les deux sont activés, seul le contrôle d’accès au niveau du fichier est appliqué.

Étape 7 : Attribuer des étiquettes de propriété

Suivez les instructions d’installation générales.

Étape 8 : Gérer le schéma

Suivez les instructions d’installation générales.

Étape 9 : Gérer les autorisations de recherche

  • Pour le contrôle d’accès au niveau du fichier ou de l’élément, sélectionnez Uniquement les personnes ayant accès à cette source de données.
  • La sélection de Tout le monde permet à tous les membres de votre organisation de voir les résultats de recherche de cette source de données.

Paramètres d’autorisation de recherche avec uniquement les personnes ayant accès à cette source de données sélectionnée.

Étape 10 : Choisir les paramètres d’actualisation

Suivez les instructions d’installation générales.

Étape 11 : Vérifier la connexion

Suivez les instructions d’installation générales.

Limites

Voici les limitations connues du connecteur CSV :

  • Les scénarios d’enrichissement de profil ne sont pas pris en charge pour l’instant.