Freigeben über

CSV-Microsoft Graph-Connector

  • Artikel

Mit dem CSV-Microsoft 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 und Microsoft 365 Copilot finden.

Dieser Artikel richtet sich an alle Benutzer, die einen CSV-Microsoft Graph-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 können Sie sich mit einem der beiden OAuth-Anbieter authentifizieren: Microsoft Entra ID (in Kürze verfügbar) oder SharePoint-Anbieter (wird bald eingestellt).

    • Für die Authentifizierung mit Microsoft Entra ID müssen Sie eine App auf Microsoft Entra ID erstellen und registrieren.
    • Für die Authentifizierung mit dem SharePoint-Anbieter müssen Sie eine SharePoint-App mit OAuth-Konfiguration erstellen.

Tipp

Sie können den OAuth-Anbieter für Ihre veröffentlichte Verbindung von SharePoint zu Microsoft Entra ID wechseln, sobald sie verfügbar ist.

  • Für eine ADLS-Datenquelle müssen Sie ein ADLS-Speicherkonto erstellen.

SharePoint-Datenquelle

Hochladen Ihrer CSV-Dateien

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 App auf Microsoft Entra ID

  1. Wechseln Sie zum Azure-Portal, und melden Sie sich mit Administratoranmeldeinformationen für den Mandanten an.

  2. Navigieren Sie im Navigationsbereich zu Microsoft Entra ID ->Verwalten ->App-Registrierungen, und wählen Sie Neue Registrierung aus.

  3. Geben Sie einen Namen für die App an, und wählen Sie Registrieren aus.

  4. Notieren Sie sich die Anwendungs-ID (Client-ID).

  5. Öffnen Sie API-Berechtigungen im Navigationsbereich, und wählen Sie Berechtigung hinzufügen aus.

  6. Wählen Sie SharePoint und dann Delegierte Berechtigungen aus.

  7. Suchen Sie nach den folgenden Berechtigungen, und wählen Sie Berechtigungen hinzufügen aus.
    a. AllSites.Read
    b. User.Read.All

  8. Wählen Sie Administratoreinwilligung für [TenantName] erteilen aus, und bestätigen Sie, indem Sie Ja auswählen.

  9. Überprüfen Sie, ob sich die Berechtigungen im Status "Gewährt" befinden.

  10. Öffnen Sie die Authentifizierung im Navigationsbereich, und fügen Sie unter Umleitungs-URIs (Autorisierungsrückruf-URIs) Folgendes hinzu:

    • Für M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback](https://gcs.office.com/v1.0/admin/oauth/callback
    • Für M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback](https://gcsgcc.office.com/v1.0/admin/oauth/callback

Konfigurieren des geheimen Clientschlüssels für die Authentifizierung

  1. Wechseln Sie zum Azure-Portal, und melden Sie sich mit Administratoranmeldeinformationen für den Mandanten an.

  2. Öffnen Sie die App-Registrierung im Navigationsbereich, und wechseln Sie zur entsprechenden App. Wählen Sie unter Verwalten die Option Zertifikate und Geheimnisse aus.

  3. Wählen Sie Neuer geheimer Clientschlüssel und dann einen Ablaufzeitraum für das Geheimnis aus. Kopieren Sie das generierte Geheimnis, und speichern Sie es, da es nicht erneut angezeigt wird.

  4. Verwenden Sie diesen geheimen Clientschlüssel und die Anwendungs-ID, um den Connector zu konfigurieren.

Erstellen einer SharePoint-App mit OAuth-Konfiguration

  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.

ADLS-Datenquelle

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-Microsoft Graph-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 Microsoft Graph-Connectors im Microsoft 365 Admin Center

Hinzufügen eines CSV-Microsoft Graph-Connectors

Befolgen Sie die allgemeinen Setupanweisungen.

Schritt 2: Benennen der Verbindung

Befolgen Sie die allgemeinen Setupanweisungen.

Schritt 3: Konfigurieren der 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. Im OAuth-Anbieter können Sie entweder SharePoint-Anbieter (bald eingestellt) oder Microsoft Entra ID

    a. Für Microsoft Entra ID (in Kürze verfügbar):
    1. Authentifizierungstyp, wählen Sie Oauth2.0(Autorisierungscode) aus.
    2. Geben Sie die Client-ID und den geheimen Clientschlüssel ein, die Sie beim Erstellen der Microsoft Entra ID-App kopiert haben.
    3. Wählen Sie Anmelden aus. Sie sollten die Meldung Verbindung erfolgreich erhalten.

    b. Für SharePoint-Anbieter (in Kürze eingestellt):
    1. Wählen Sie unter Authentifizierungstypdie Option Oauth2.0(Clientanmeldeinformationen) aus.
    2. Geben Sie die Client-ID und den geheimen Clientschlüssel ein, die Sie beim Erstellen der SharePoint-App kopiert haben.
    3. Wählen Sie Verbindung testen aus. Sie sollten die Meldung Verbindung erfolgreich erhalten.

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 4: 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 5: 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-Microsoft Graph-Connector unterstützt die Zugriffssteuerung auf Datei- oder Elementebene. Wenn beides aktiviert ist, wird nur die Zugriffssteuerung auf Dateiebene angewendet.

Schritt 6: 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 7: Verwalten des Schemas

Befolgen Sie die allgemeinen Setupanweisungen.

Schritt 8: 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 9: Auswählen der Aktualisierungseinstellungen

Befolgen Sie die allgemeinen Setupanweisungen.

Schritt 10: Überprüfen der Verbindung

Befolgen Sie die allgemeinen Setupanweisungen.

Begrenzungen

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

  • Profilanreicherungsszenarien werden derzeit nicht unterstützt.

Problembehandlung

Nachdem Sie Ihre Verbindung veröffentlicht haben, können Sie die status auf der Registerkarte Datenquellen im Admin Center überprüfen. Informationen zum Durchführen von Updates und Löschungen finden Sie unter Verwalten ihres Connectors.

Schritte zur Problembehandlung für häufig auftretende Probleme finden Sie hier.

Wenn Sie Probleme haben oder Feedback geben möchten, wenden Sie sich an [Microsoft Graph | Support (https://developer.microsoft.com/en-us/graph/support).