Freigeben über

CSV-Connector

  • Artikel

Mit dem CSV Graph-Connector können Organization Inhalte aus CSV-Dateien erfassen, die in SharePoint-Bibliotheken und Azure Data Lake Storage (ADLS) gespeichert sind. Nachdem Sie den Connector und den Indexinhalt aus diesen Quellen konfiguriert haben, können Endbenutzer CSV-Dateien in Microsoft Search finden.

Hinweis

Lesen Sie den Artikel Setup für Ihren Graph-Connector , um die allgemeinen Anweisungen zum Einrichten von Graph-Connectors zu verstehen.

Dieser Artikel richtet sich an alle Benutzer, die einen CSV-Connector konfigurieren, ausführen und überwachen. Es ergänzt den allgemeinen Einrichtungsprozess und zeigt Anweisungen, die nur für diesen Connector gelten.

Bevor Sie beginnen

Stellen Sie sicher, dass in den CSV-Headern keine Leerzeichen vorhanden sind. Für eine SharePoint-Datenquelle müssen Sie eine SharePoint-App mit Oauth-Konfiguration erstellen. Für eine ADLS-Datenquelle müssen Sie ein ADLS-Speicherkonto erstellen.

Erstellen einer SharePoint-App mit Oauth-Konfiguration

Vergewissern Sie sich, dass die .csv Dateien, die Sie indizieren möchten, in eine SharePoint-Dokumentbibliothek hochgeladen wurden. Sie können eine vorhandene SharePoint-Website verwenden oder eine neue erstellen.

Erstellen einer SharePoint-App

  1. Gehen Sie zu https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.aspx.
  2. Wählen Sie in den Feldern Client-ID und Geheimer Clientschlüssel die Option Generieren aus.
  3. Geben Sie unter Titel einen App-Namen ein.
  4. Geben Sie im Feld App-Domäne ein www.gcs.com.
  5. Geben Sie im Feld Umleitungs-URL ein https://www.gcs.com.
  6. Wählen Sie Erstellen aus.
  7. Kopieren Sie die Informationen zur App-Konfiguration, einschließlich der Client-ID und des geheimen Clientschlüssels. Sie benötigen ihn, wenn Sie den CSV-Connector einrichten.

Aktivieren von App-Berechtigungen zum Zulassen von CustomAppAuthentication

Führen Sie diese Befehle in PowerShell (SharePoint Online-Verwaltungsshell) im Verwaltungsmodus aus. Verwenden Sie die E-Mail-Adresse des Administrators, der den Connector konfiguriert, und ihren organization Namen. Wenn das Popupfenster "Kennwort" angezeigt wird, sollte der Administrator sein Kennwort eingeben.

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

Hinweis

Wenn Sie PowerShell 7 verwenden, verwenden Sie zuerst diesen Befehl. Import-Module microsoft.online.sharepoint.powershell -UseWindowsPowerShell

Hinweis

Wenn Sie die mehrstufige Authentifizierung verwenden, verwenden Sie Connect-SPOService -Url https://$orgName-admin.sharepoint.com.

Abschließen der App-Konfiguration

  1. Gehen Sie zu https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appinv.aspx.
  2. Fügen Sie im Feld App-ID die Client-ID der SharePoint-App ein, und wählen Sie Nachschlagen aus.
  3. Fügen Sie diesen Code in das Feld Berechtigungsanforderungs-XML ein, und wählen Sie Erstellen aus.
<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>
  1. Wählen Sie Vertrauen aus.

Erstellen eines ADLS-Speicherkontos

Eine schritt-für-Schritt-Anleitung finden Sie unter Erstellen eines Speicherkontos. Um Dateispeicherfunktionen zuzulassen, wählen Sie auf der Registerkarte Erweitert die Option Hierarchischen Namespace aktivieren und Container für diese Website erstellen aus.

Wenn Sie den CSV-Connector einrichten, müssen Sie einen primären Speicher Verbindungszeichenfolge bereitstellen. Um es zu finden, öffnen Sie das von Ihnen erstellte Speicherkonto, und wählen Sie Zugriffsschlüssel aus. Wählen Sie Schlüssel anzeigen aus, und kopieren Sie die Verbindungszeichenfolge für Key1.

Schritt 1: Hinzufügen eines Graph-Connectors im Microsoft 365 Admin Center

Hinzufügen eines CSV-Connectors

Befolgen Sie die allgemeinen Setupanweisungen.

Schritt 2: Auswählen von Erfahrungen

Derzeit unterstützt der CSV-Connector nur Suchfunktionen.

CSV-Connector mit ausgewählter Microsoft Search-Benutzeroberfläche.

Schritt 3: Benennen der Verbindung

Befolgen Sie die allgemeinen Setupanweisungen.

Schritt 4: Konfigurieren von Verbindungseinstellungen

Die Datenquelleneinstellungen unterscheiden sich für SharePoint und ADLS.

Hinweis

Stellen Sie sicher, dass ihre CSV-Datei keine Formatierung oder Leerzeichen (' ') in Kopfzeilen enthält.

Für eine SharePoint-Quelle

  1. Wählen Sie in den Datenquelleneinstellungen SharePoint als Datenquelle aus.
  2. Geben Sie auf der SharePoint-Website die Website-URL ein, https://Org-Name.sharepoint.com/Site-Namez. B. .
  3. Geben Sie unter Dokumentbibliothek den Namen der Bibliothek ein, in der die .csv Dateien gespeichert sind.
  4. Wählen Sie unter Authentifizierungstypdie Option Oauth2.0(Clientanmeldeinformationen) aus.
  5. Geben Sie die Client-ID und den geheimen Clientschlüssel ein, die Sie beim Erstellen der SharePoint-App kopiert haben.
  6. Wählen Sie Verbindung testen aus. Sie sollten die Meldung The connection is successful (Die Verbindung ist erfolgreich ) erhalten.

CSV-Connector mit Datenquelleneinstellungen für eine SharePoint-Website.

Um den Zugriff auf Dateiebene zu steuern, geben Sie Microsoft Entra Benutzer oder Gruppen ein.

Zugriffssteuerungsliste mit eingeschlossenem Benutzer und Gruppe.

Für eine ADLS-Quelle

  1. Wählen Sie in den Datenquelleneinstellungen Azure Data Lake Storage(ADLS) als Datenquelle aus.
  2. Geben Sie unter Primärer Speicher Verbindungszeichenfolge den kopierten Verbindungszeichenfolge ein.
  3. Geben Sie container name (Containername ) und Filename (Dateiname) ein.
  4. Wählen Sie Verbindung testen aus. Sie sollten die Meldung The connection is successful (Die Verbindung ist erfolgreich ) erhalten.

CSV-Connector mit Datenquelleneinstellungen für eine Azure Data Lake Storage Quelle.

Hinweis

Wenn Ihre Datenquelle mehrere .csv Dateien mit denselben Headern enthält, wählen Sie Alle CSV-Dateien am Speicherort einschließen aus.

Um den Zugriff auf Dateiebene zu steuern, geben Sie Microsoft Entra Benutzer oder Gruppen ein.

Zugriffssteuerungsliste mit eingeschlossenem Benutzer und Gruppe.

Schritt 5: Trennzeichen für mehrere Elemente (optional)

Wenn Ihre Quellspalten mehrere Werte annehmen können, geben Sie ein Trennzeichen mit mehreren Elementen ein, z. B. ein Semikolon (;).

Schritt 6: Einstellungen für analysierte Eigenschaften

Diese Seite gibt die erste Zeile aus Ihrer .csv Datei als Quelleigenschaften zurück. Wählen Sie zum Ändern des Datentyps in der Liste Eindeutiger Bezeichner mindestens eine Option aus.

Um den Zugriff auf Elementebene zu steuern, wählen Sie Spalten aus, die zulässigen Benutzern und zulässigen Gruppen zugeordnet sind. Sie sollten die beiden Spalten AllowedUsers und AllowedGroups in die .csv-Datei einschließen. Jede Zeile sollte die Microsoft Entra-IDs enthalten.

Zugriffssteuerungseinstellungen auf Elementebene.

Hinweis

Der CSV-Connector unterstützt die Zugriffssteuerung auf Datei- oder Elementebene. Wenn beides aktiviert ist, wird nur die Zugriffssteuerung auf Dateiebene angewendet.

Schritt 7: Zuweisen von Eigenschaftenbezeichnungen

Befolgen Sie die allgemeinen Setupanweisungen.

Hinweis

Die IconURL-Bezeichnung wird standardmäßig aufgefüllt, und die Zuordnung kann nicht geändert werden.

Schritt 8: Verwalten des Schemas

Befolgen Sie die allgemeinen Setupanweisungen.

Schritt 9: Verwalten von Suchberechtigungen

  • Wählen Sie für die Zugriffssteuerung auf Datei- oder Elementebene nur Personen mit Zugriff auf diese Datenquelle aus.
  • Wenn Sie Jeder auswählen, kann jeder in Ihrem organization Suchergebnisse aus dieser Datenquelle anzeigen.

Suchberechtigungseinstellungen, wobei nur Personen mit Zugriff auf diese Datenquelle ausgewählt sind.

Schritt 10: Auswählen der Aktualisierungseinstellungen

Befolgen Sie die allgemeinen Setupanweisungen.

Schritt 11: Überprüfen der Verbindung

Befolgen Sie die allgemeinen Setupanweisungen.

Begrenzungen

Im Folgenden sind die Einschränkungen des CSV-Connectors bekannt:

  • Profilanreicherungsszenarien werden derzeit nicht unterstützt.