Il connettore Microsoft SharePoint per Gemini Enterprise fornisce l'accesso ai tuoi dati Microsoft SharePoint Online, consentendoti di interagire con documenti, elenchi e siti.
Versioni di Microsoft SharePoint supportate
Il connettore Microsoft SharePoint supporta l'ultima versione cloud di Microsoft SharePoint Online.
Azioni supportate
Quando il connettore Microsoft SharePoint è attivato, gli utenti finali possono utilizzare i comandi in linguaggio naturale in Gemini Enterprise per eseguire le seguenti azioni.
| Azione | Descrizione |
|---|---|
| Crea cartella | Crea una nuova cartella in un percorso specificato. |
| Aggiungi elenco | Crea un nuovo elenco di dati strutturati (ad es. attività, contatti) nel sito SharePoint. |
Autorizzazioni obbligatorie
Per consentire a Gemini Enterprise di eseguire la ricerca e l'importazione dati utilizzando il datastore Microsoft SharePoint, devi disporre delle seguenti autorizzazioni:
Autorizzazioni API Microsoft Graph
La tabella seguente descrive le autorizzazioni richieste per ogni modalità di connessione.
Nota:la tabella seguente illustra le autorizzazioni richieste per ogni modalità di connessione. Se attivi Azioni per la modalità di connessione Ricerca federata o Importazione dati, seleziona anche le autorizzazioni elencate nella riga Azioni.
| Modalità di connessione | Ambito | Purpose |
|---|---|---|
| Ricerca federata | N/D | Non sono richieste autorizzazioni API Graph. |
| Importazione dati | GroupMember.Read.All |
(Credenziali federate e token di aggiornamento OAuth 2.0) Consente al connettore di leggere le iscrizioni e le proprietà di base dei gruppi per tutti i gruppi senza un utente che ha eseguito l'accesso. |
User.Read |
(Credenziali federate e token di aggiornamento OAuth 2.0) Consente al connettore di leggere il profilo degli utenti che hanno eseguito l'accesso. Consente inoltre al connettore di leggere le informazioni di base sull'azienda degli utenti che hanno eseguito l'accesso. | |
User.Read.All |
(Solo token di aggiornamento OAuth 2.0) Consente al connettore di leggere i profili utente. | |
Sites.FullControl.All (Opzione 1)Sites.Selected (Opzione 2) |
(Credenziali federate e token di aggiornamento OAuth 2.0) L'opzione 1 consente al connettore di avere il controllo completo di tutte le raccolte di siti. L'opzione 2 consente al connettore di accedere a un sottoinsieme di raccolte di siti. Le raccolte di siti specifiche e le autorizzazioni concesse possono essere configurate in SharePoint Online. | |
User.Read.All (Opzione 1)User.ReadBasic.All (Opzione 2) |
(Solo credenziali federate) L'opzione 1 consente al connettore di leggere i profili utente. L'opzione 2 consente al connettore di leggere un insieme di base di proprietà del profilo di altri utenti dell'organizzazione. | |
| Azioni | Sites.ReadWrite.All |
(Ricerca federata e importazione dati) Consente al connettore di modificare o eliminare documenti ed elementi di elenco in tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso. |
Files.ReadWrite |
Consente al connettore di leggere, creare, aggiornare ed eliminare i file dell'utente che ha eseguito l'accesso. | |
Files.ReadWrite.All |
Consente al connettore di leggere, creare, aggiornare ed eliminare tutti i file a cui l'utente che ha eseguito l'accesso può accedere. | |
Sites.Manage.All |
Consente al connettore di creare o eliminare librerie di documenti ed elenchi in tutte le raccolte di siti per conto dell'utente. |
Autorizzazioni API Microsoft SharePoint
La tabella seguente descrive le autorizzazioni richieste per ogni modalità di connessione.
| Modalità di connessione | Ambito | Purpose |
|---|---|---|
| Ricerca federata | Sites.Search.All (delegato) |
Consente al connettore di eseguire query di ricerca e di leggere le informazioni di base del sito per conto dell'utente attualmente connesso. I risultati di ricerca si basano sulle autorizzazioni dell'utente anziché su quelle dell'app. |
AllSites.Read (opzione 1, delegata) |
Consente al connettore di leggere documenti ed elementi di elenco in tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso. | |
Sites.Selected (opzione 2, delegata) |
Consente al connettore di accedere a un sottoinsieme di raccolte di siti con un utente che ha eseguito l'accesso. Le raccolte di siti specifiche e le autorizzazioni concesse possono essere configurate in SharePoint Online. | |
| Importazione dati (credenziali federate) | Sites.FullControl.All (opzione 1, applicazione) |
Consente al connettore di avere il controllo completo di tutte le raccolte di siti. |
Sites.Selected (opzione 2, applicazione) |
Consente al connettore di accedere a un sottoinsieme di raccolte di siti con un utente che ha eseguito l'accesso. Le raccolte di siti specifiche e le autorizzazioni concesse possono essere configurate in SharePoint Online. | |
| Importazione dei dati (token di aggiornamento OAuth 2.0) | AllSites.FullControl (opzione 1, delegata) |
Consente al connettore di avere il controllo completo di tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso. |
Sites.Selected (opzione 2, delegata) |
Consente al connettore di accedere a un sottoinsieme di raccolte di siti con un utente che ha eseguito l'accesso. Le raccolte di siti specifiche e le autorizzazioni concesse possono essere configurate in SharePoint Online. | |
| Azioni | AllSites.Write (delegato) |
Consente al connettore di creare, leggere, aggiornare ed eliminare documenti ed elementi di elenco in tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso. |
Per informazioni su come aggiungere le autorizzazioni per Microsoft SharePoint, vedi Configurare Microsoft SharePoint e impostare le autorizzazioni necessarie.
Limitazioni
Questa sezione descrive i problemi noti e le limitazioni che potrebbero influire sull'utilizzo del connettore Microsoft SharePoint.
L'applicazione di un perimetro di Controlli di servizio VPC ai datastore Microsoft SharePoint esistenti non è supportata. Per applicare i Controlli di servizio VPC, devi eliminare e ricreare i datastore. Per saperne di più sui Controlli di servizio VPC e su come utilizzare le azioni dopo averli attivati, consulta Proteggere l'app con i Controlli di servizio VPC.
L'datastore Microsoft SharePoint è supportato solo nelle località globali, US ed EU.
Quando crei una nuova applicazione o aggiungi un datastore a un'applicazione esistente, ti consigliamo di aggiungere un datastore con azioni appartenenti a un singolo tipo di connettore. Ad esempio, non associare due datastore Microsoft SharePoint con azioni attivate alla stessa applicazione.
Di seguito sono riportate le limitazioni per il connettore federato Microsoft SharePoint:
- Limitazioni della ricerca: i risultati di ricerca possono variare e non sono sempre esaustivi per tutti i tipi di file. I contenuti nelle cartelle archiviate o criptate potrebbero non essere accessibili per la ricerca. La ricerca federata non supporta la ricerca all'interno degli allegati.
- Accesso delegato:l'accesso a siti o librerie condivisi potrebbe richiedere autorizzazioni specifiche non coperte dall'autorizzazione utente standard.
Passaggi successivi
- Per creare e configurare un connettore con Microsoft SharePoint, vedi Configurare un datastore Microsoft SharePoint.