Condividi tramite

Connettore Microsoft Graph CSV

  • Articolo

Il connettore Csv Microsoft Graph consente all'organizzazione di inserire contenuto da file CSV archiviati in raccolte e Azure Data Lake Storage di SharePoint (ADLS). Dopo aver configurato il connettore e il contenuto dell'indice da queste origini, gli utenti finali possono trovare file CSV in Microsoft Search e Microsoft 365 Copilot.

Questo articolo è destinato a tutti gli utenti che configurano, eseguono e monitorano un connettore Microsoft Graph CSV. Integra il processo di configurazione generale e mostra le istruzioni che si applicano solo a questo connettore.

Nozioni preliminari

  • Assicurarsi che non siano presenti spazi vuoti nelle intestazioni CSV

  • Per un'origine dati di SharePoint, è possibile eseguire l'autenticazione usando uno dei due provider OAuth: Microsoft Entra ID (presto disponibile) o provider di SharePoint (ritiro presto).

    • Per eseguire l'autenticazione con Microsoft Entra ID è necessario creare e registrare un'app in Microsoft Entra ID.
    • Per l'autenticazione con il provider di SharePoint è necessario creare un'app SharePoint con configurazione OAuth.

Consiglio

Sarà possibile passare dal provider OAuth per la connessione pubblicata da SharePoint a Microsoft Entra ID, una volta disponibile

  • Per un'origine dati ADLS, è necessario creare un account di archiviazione ADLS.

Origine dati di SharePoint

Caricare i file CSV

Verificare che i file .csv da indicizzare siano stati caricati in una raccolta documenti di SharePoint. È possibile usare un sito di SharePoint esistente o crearne uno nuovo.

Creare un'app in Microsoft Entra ID

  1. Passare alla portale di Azure e accedere con le credenziali di amministratore per il tenant.

  2. Passare a Microsoft Entra ID ->Manage ->Registrazioni app dal riquadro di spostamento e selezionare Nuova registrazione.

  3. Specificare un nome per l'app e selezionare Registra.

  4. Prendere nota dell'ID applicazione (client).

  5. Aprire autorizzazioni API dal riquadro di spostamento e selezionare Aggiungi un'autorizzazione.

  6. Selezionare SharePoint e quindi Autorizzazioni delegate.

  7. Cercare le autorizzazioni seguenti e selezionare Aggiungi autorizzazioni.
    a. AllSites.Read
    b. User.Read.All

  8. Selezionare Concedi consenso amministratore per [TenantName] e confermare selezionando Sì.

  9. Verificare che le autorizzazioni siano nello stato "concesso".

  10. Aprire Autenticazione dal riquadro di spostamento e aggiungere quanto segue in URI di reindirizzamento (URI di callback dell'autorizzazione):

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

Configurazione del segreto client per l'autenticazione

  1. Passare alla portale di Azure e accedere con le credenziali di amministratore per il tenant.

  2. Aprire Registrazione app dal riquadro di spostamento e passare all'app appropriata. In Gestisci selezionare Certificati e segreti.

  3. Selezionare Nuovo segreto client e selezionare un periodo di scadenza per il segreto. Copiare il segreto generato e salvarlo perché non viene visualizzato di nuovo.

  4. Usare questo segreto client e l'ID applicazione per configurare il connettore.

Creare un'app SharePoint con configurazione OAuth

  1. Vai a https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.aspx.
  2. Nei campi ID client e Segreto client selezionare Genera.
  3. In Titolo immettere un nome di app.
  4. Nel campo Dominio app immettere www.gcs.com.
  5. Nel campo URL di reindirizzamento immettere https://www.gcs.com.
  6. Selezionare Crea.
  7. Copiare le informazioni di configurazione dell'app, inclusi l'ID client e il segreto client. Sarà necessario quando si configura il connettore CSV.

Abilitare le autorizzazioni dell'app per consentire customAppAuthentication

In PowerShell (SharePoint Online Management Shell) eseguire questi comandi in modalità amministrativa. Usare l'indirizzo di posta elettronica dell'amministratore che configura il connettore e il nome dell'organizzazione. Quando viene visualizzata la password, l'amministratore deve immettere la password.

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

Nota

Se si usa PowerShell 7, usare prima questo comando Import-Module microsoft.online.sharepoint.powershell -UseWindowsPowerShell

Nota

Se si usa l'autenticazione a più fattori, usare Connect-SPOService -Url https://$orgName-admin.sharepoint.com.

Completare la configurazione dell'app

  1. Vai a https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appinv.aspx.
  2. Nel campo ID app incollare l'ID client dell'app SharePoint e selezionare Ricerca.
  3. Nel campo Request XML dell'autorizzazione incollare questo codice e selezionare Crea.
<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>
  1. Selezionare Considera attendibile.

Origine dati ADLS

Creare un account di archiviazione ADLS

Per istruzioni dettagliate, vedere Creare un account di archiviazione. Per consentire le funzionalità di archiviazione file, nella scheda Avanzate selezionare Abilita spazio dei nomi gerarchico e Crea un contenitore per questo sito.

Quando si configura il connettore Microsoft Graph CSV, è necessario fornire un stringa di connessione di archiviazione primario. Per trovarlo, aprire l'account di archiviazione creato e selezionare Chiavi di accesso. Selezionare Mostra chiavi e copiare il stringa di connessione per Key1.

Passaggio 1: Aggiungere un connettore Microsoft Graph nel interfaccia di amministrazione di Microsoft 365

Aggiungere il connettore Microsoft Graph CSV

Seguire le istruzioni di configurazione generali.

Passaggio 2: Assegnare un nome alla connessione

Seguire le istruzioni di configurazione generali.

Passaggio 3: Configurare le impostazioni di connessione

Le impostazioni dell'origine dati sono diverse per SharePoint e ADLS.

Nota

Assicurarsi che il file CSV non contenga formattazione o spazi (' ') presenti nelle righe di intestazione.

Per un'origine SharePoint

  1. Nelle impostazioni origine dati selezionare SharePoint come origine dati.

  2. Nel sito di SharePoint immettere, ad esempio, https://Org-Name.sharepoint.com/Site-Namel'URL del sito.

  3. In Raccolta documenti immettere il nome della raccolta in cui sono archiviati i file .csv.

  4. Nel provider OAuth è possibile selezionare Provider SharePoint (ritiro presto) o Microsoft Entra ID

    a. Per Microsoft Entra ID (presto disponibile):
    1. Tipo di autenticazione, selezionare Oauth2.0(codice di autorizzazione).1.
    2. Immettere l'ID client e il segreto client copiati durante la creazione dell'app Microsoft Entra ID.
    3. Selezionare Accedi. Dovrebbe essere visualizzato un messaggio connessione riuscita .

    b. Per SharePoint Provider (ritiro presto):
    1. In Tipo di autenticazione selezionare Oauth2.0(credenziali client).1.
    2. Immettere l'ID client e il segreto client copiati durante la creazione dell'app SharePoint.
    3. Selezionare Test connessione. Dovrebbe essere visualizzato un messaggio connessione riuscita .

Per controllare l'accesso a livello di file, immettere Microsoft Entra utenti o gruppi.

Elenco di controllo di accesso con l'utente e il gruppo inclusi.

Per un'origine ADLS

  1. Nelle impostazioni origine dati selezionare Azure Data Lake Storage (ADLS) come origine dati.
  2. In Archiviazione primaria stringa di connessione immettere il stringa di connessione copiato.
  3. Immettere il nome del contenitore e il nome file.
  4. Selezionare Test connessione. Si dovrebbe ottenere un messaggio La connessione ha esito positivo .

Connettore CSV con impostazioni origine dati per un'origine Azure Data Lake Storage.

Nota

Se l'origine dati contiene più file .csv con le stesse intestazioni, selezionare Includi tutti i file CSV nel percorso.

Per controllare l'accesso a livello di file, immettere Microsoft Entra utenti o gruppi.

Elenco di controllo di accesso con l'utente e il gruppo inclusi.

Passaggio 4: Delimitatore di più elementi (facoltativo)

Se le colonne di origine possono accettare più valori, immettere un delimitatore a più elementi, un punto e virgola (;) ad esempio.

Passaggio 5: Impostazioni delle proprietà analizzate

Questa pagina restituisce la prima riga del file .csv come Proprietà origine. Per modificare il tipo di dati, nell'elenco Identificatore univoco selezionare almeno un'opzione.

Per controllare l'accesso a livello di elemento, selezionare le colonne mappate agli utenti consentiti e ai gruppi consentiti. È necessario includere due colonne, AllowedUsers e AllowedGroups, nel file .csv. Ogni riga deve contenere gli ID Microsoft Entra.

Impostazioni di controllo di accesso a livello di elemento.

Nota

Il connettore CSV Microsoft Graph supporta il controllo di accesso a livello di file o di elemento. Se entrambi sono abilitati, viene applicato solo il controllo di accesso a livello di file.

Passaggio 6: Assegnare etichette di proprietà

Seguire le istruzioni di configurazione generali.

Nota

L'etichetta IconURL viene popolata per impostazione predefinita e il mapping non può essere modificato.

Passaggio 7: Gestire lo schema

Seguire le istruzioni di configurazione generali.

Passaggio 8: Gestire le autorizzazioni di ricerca

  • Per il controllo di accesso a livello di file o di elemento selezionare Solo le persone con accesso a questa origine dati.
  • La selezione di Tutti consente a tutti gli utenti dell'organizzazione di visualizzare i risultati della ricerca da questa origine dati.

Cercare le impostazioni di autorizzazione con solo gli utenti con l'accesso a questa origine dati selezionata.

Passaggio 9: Scegliere le impostazioni di aggiornamento

Seguire le istruzioni di configurazione generali.

Passaggio 10: Esaminare la connessione

Seguire le istruzioni di configurazione generali.

Limitazioni

Di seguito sono riportate le limitazioni note del connettore Microsoft Graph CSV:

  • Al momento gli scenari di arricchimento del profilo non sono supportati.

Risoluzione dei problemi

Dopo aver pubblicato la connessione, è possibile esaminare lo stato nella scheda Origini datinell'interfaccia di amministrazione. Per informazioni su come eseguire aggiornamenti ed eliminazioni, vedere Gestire il connettore.

È possibile trovare i passaggi per la risoluzione dei problemi più comuni qui.

In caso di problemi o se si desidera fornire commenti e suggerimenti, contattare [Microsoft Graph | Supporto (https://developer.microsoft.com/en-us/graph/support).