Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # SharePoint Integrazione con Microsoft Usa l' SharePoint integrazione con Microsoft per eseguire azioni su SharePoint elenchi, elementi e file o per creare knowledge base dai SharePoint contenuti per ricerche e domande e risposte basate sull'intelligenza artificiale. ## Cosa puoi fare **Connettore Action** Gestisci SharePoint elenchi, elementi, file e cartelle di lavoro di Excel tramite chiamate all'API Microsoft Graph. **Base di conoscenza** Indicizza raccolte di SharePoint documenti, siti e pagine. Gli agenti di Amazon Quick possono quindi cercare e rispondere a domande sul contenuto. # SharePoint Integrazione con Microsoft Action Usa il Microsoft SharePoint Action Connector per gestire elenchi, elementi, file e cartelle di lavoro Excel direttamente in Amazon Quick tramite linguaggio naturale. La configurazione di questa integrazione prevede due passaggi. Innanzitutto, si registra un'applicazione in Microsoft Entra e si configurano le relative autorizzazioni. Quindi, crei l'integrazione in Amazon Quick e la connetti alla tua app Entra. Per informazioni sui metodi di autenticazione supportati da Amazon Quick, consulta[Metodi di autenticazione](quick-action-auth.md). ## Prima di iniziare Assicurati di disporre di quanto segue prima di configurare l'integrazione. + Un account Microsoft 365 con SharePoint accesso. + Accesso all'interfaccia di [amministrazione di Microsoft Entra](https://entra.microsoft.com/) con almeno le autorizzazioni di Application Developer. + Per i requisiti di abbonamento, consulta[Configura le integrazioni nella console](integration-console-setup-process.md). ## Configurare Microsoft Entra Prima di configurare Amazon Quick, crea una registrazione dell'app in Microsoft Entra. Completa tutti i seguenti passaggi in Entra prima di passare alla console Amazon Quick. Per ulteriori informazioni sulle registrazioni delle app, vedi [Registrare un'applicazione con la piattaforma di identità Microsoft](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app) nella documentazione Microsoft. ### Registrare l'applicazione 1. Apri l'interfaccia di [amministrazione di Microsoft Entra](https://entra.microsoft.com/). 1. Nella barra di navigazione a sinistra, scegli **Entra ID**, quindi scegli **Registrazioni app**. 1. Scegli **Nuova registrazione**. 1. In **Nome**, inserisci un nome descrittivo per la tua integrazione. 1. Per i **tipi di account supportati**, scegli **Account solo in questa directory organizzativa**. 1. Per **Redirect URI**, selezionate **Web** e immettete`https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`. Sostituisci *\$1region\$1* con la AWS regione in cui è distribuita l'istanza Amazon Quick. 1. Scegli **Registrati**. 1. Nella pagina di panoramica, copia l'ID dell'**applicazione (client) e l'ID** della **directory (tenant)**. Questi valori sono necessari per la configurazione di Amazon Quick. ### Crea un segreto per il cliente Amazon Quick necessita di un client secret per l'autenticazione con Microsoft Entra. Questo segreto funge da password per la registrazione dell'app. 1. Dalla registrazione dell'app, scegli **Certificati e segreti**. 1. Scegli **Nuovo segreto del cliente**. 1. Inserisci una descrizione e scegli un periodo di scadenza. 1. Scegliere **Aggiungi**. 1. Copia immediatamente il **valore**. Questo valore viene visualizzato solo una volta. **Importante** Copia il **valore** segreto, non l'ID segreto. Il valore è la stringa più lunga utilizzata per l'autenticazione. ### Configura le autorizzazioni API Microsoft Graph supporta due tipi di autorizzazione per questa integrazione. Le autorizzazioni delegate consentono all'app di agire per conto di un utente che ha effettuato l'accesso. Le autorizzazioni dell'applicazione consentono all'app di agire senza un utente registrato. Per ulteriori informazioni, vedere [Panoramica delle autorizzazioni di Microsoft Graph](https://learn.microsoft.com/en-us/graph/permissions-overview) nella documentazione Microsoft. 1. Dalla registrazione dell'app, scegli **Autorizzazioni API**. 1. Scegli **Aggiungi un'autorizzazione**, quindi scegli **Microsoft Graph**. 1. Scegli **Autorizzazioni delegate o Autorizzazioni** per **applicazioni** in base al metodo di autenticazione utilizzato e aggiungi le autorizzazioni dalla tabella appropriata riportata di seguito. 1. Scegli **Concedi il consenso dell'amministratore per [il nome dell'inquilino]** per approvare le autorizzazioni. **Per l'autenticazione degli utenti (autorizzazioni delegate):** Aggiungi quanto segue come autorizzazioni delegate nella registrazione dell'app Entra. Per il riferimento completo alle autorizzazioni, vedere il riferimento alle [autorizzazioni di Microsoft Graph](https://learn.microsoft.com/en-us/graph/permissions-reference) nella documentazione Microsoft. **SharePoint integrazione delle azioni: autorizzazioni delegate** | Autorizzazione | Description | | --- | --- | | Files.ReadWrite | Consente all'app di leggere, creare, aggiornare ed eliminare i file dell'utente che ha effettuato l'accesso. | | Sites.ReadWrite.All | Consente all'applicazione di modificare o eliminare documenti ed elenchi in tutte le raccolte del sito per conto dell'utente che ha effettuato l'accesso. | | offline\$1access | Consente all'app di aggiornare i token di accesso senza richiedere all'utente di effettuare nuovamente l'accesso. Ciò riduce la frequenza con cui gli utenti devono autenticarsi nuovamente. | **Per l'autenticazione del servizio (autorizzazioni dell'applicazione):** Aggiungi quanto segue come autorizzazioni dell'applicazione nella registrazione dell'app Entra. **SharePoint integrazione delle azioni: autorizzazioni dell'applicazione** | Autorizzazione | Description | | --- | --- | | Sites.ReadWrite.All | Consente all'app di creare, leggere, aggiornare ed eliminare documenti e voci di elenchi in tutte le raccolte del sito senza un utente connesso. | **Importante** Con l'autenticazione del servizio, tutte le azioni vengono eseguite come account di servizio. Qualsiasi utente con accesso a questa integrazione può eseguire azioni su tutte le raccolte di siti a cui l'account del servizio può accedere. Definisci l'ambito delle autorizzazioni dell'applicazione in modo appropriato per i requisiti di sicurezza dell'organizzazione. ### Registra le tue credenziali Prima di uscire dall'interfaccia di amministrazione di Microsoft Entra, verifica di avere i seguenti valori. Ne hai bisogno per la configurazione di Amazon Quick. **Credenziali richieste da Microsoft Entra** | Valore | Dove trovarlo | | --- | --- | | ID dell’applicazione (client) | Pagina di panoramica sulla registrazione dell'app | | ID della directory (tenant) | Pagina di panoramica sulla registrazione dell'app | | Valore segreto del cliente | Pagina dei certificati e dei segreti | ## Configura l'integrazione in Amazon Quick Dopo aver completato la configurazione Entra, crea l'integrazione in Amazon Quick. 1. Nella console Amazon Quick, scegli **Integrazioni.** 1. Scegli **Microsoft SharePoint** e scegli il pulsante Aggiungi (più «\$1»). 1. Scegli la scheda **Azioni**. 1. Scegli **Esegui azioni in Microsoft SharePoint**. 1. Inserisci i dettagli dell'integrazione: + **Nome: nome** descrittivo per l' SharePointintegrazione. + **Descrizione** (facoltativa): scopo dell'integrazione. 1. Scegli il tipo di connessione e compila le impostazioni di connessione: 1. Per **l'autenticazione utente (OAuth)**, configura i seguenti campi: + **URL di base**: `https://graph.microsoft.com/v1.0` + **ID cliente: ID** dell'applicazione (client) ottenuto dalla registrazione dell'app Entra. + **Client Secret**: valore segreto del cliente derivante dalla registrazione dell'app Entra. + **URL del token**: `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token` + **URL di autenticazione** — `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize` + **URL di reindirizzamento** — `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback` 1. Per **l'autenticazione del servizio**, configura i seguenti campi: + **ID client: ID** dell'applicazione (client) ottenuto dalla registrazione dell'app Entra. + **Client Secret**: valore segreto del cliente derivante dalla registrazione dell'app Entra. + **URL del token**: `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token` + **Ambito**: `.default` 1. Scegli **Crea e continua**. 1. Scegli gli utenti con cui condividere l'integrazione. 1. Scegli **Next (Successivo)**. ## Operazioni disponibili Dopo aver configurato l'integrazione, sono disponibili le seguenti azioni. **Azioni SharePoint disponibili in Microsoft** | Categoria | Azione | Description | | --- | --- | --- | | Elenchi ed elementi | Visualizza articoli | Ottieni la raccolta di elementi in un elenco. | | Elenchi e articoli | Get Item | Restituisce i metadati per un elemento in un elenco. | | Elenchi ed elementi | Ottieni elenco | Restituisce i metadati per un elenco. | | Elenchi ed elementi | Update Item | Aggiorna le proprietà di un elemento dell'elenco. | | Elenchi ed elementi | Delete Item | Rimuove un elemento da un elenco. | | File | Carica file | Carica un nuovo file o aggiorna un file esistente. Supporta file fino a 250 MB. | | File | Cerca elementi di Site Drive | Cerca nella gerarchia degli elementi corrispondenti a una query. | | Cartelle di lavoro di Excel | Fogli di elenco | Recupera un elenco di oggetti del foglio di lavoro. | | Cartelle di lavoro Excel | Aggiungi foglio | Aggiungi un nuovo foglio di lavoro alla cartella di lavoro. | | Cartelle di lavoro Excel | Leggi il foglio | Recupera le proprietà di un oggetto del foglio di lavoro. | | Cartelle di lavoro di Excel | Foglio di aggiornamento | Aggiorna le proprietà di un oggetto del foglio di lavoro. | | Cartelle di lavoro Excel | Elimina foglio | Elimina il foglio di lavoro dalla cartella di lavoro. | | Cartelle di lavoro di Excel | Leggi Cell | Ottieni il valore di una singola cella per numero di riga e colonna. | | Cartelle di lavoro Excel | Scrivi cella | Imposta il valore di una singola cella per numero di riga e colonna. | | Cartelle di lavoro Excel | Intervallo di lettura | Ottieni i valori di un intervallo. | | Cartelle di lavoro Excel | Intervallo di scrittura | Aggiorna i valori di un intervallo. | | Cartelle di lavoro Excel | Intervallo chiaro | Cancella i valori dell'intervallo, il formato, il riempimento e il bordo. | | Cartelle di lavoro Excel | Elimina intervallo | Elimina le celle associate all'intervallo. | | Cartelle di lavoro Excel | Get Used Range | Ottieni l'intervallo più piccolo che comprende le celle con un valore o una formattazione. | ## Gestisci e risolvi i problemi Per modificare, condividere o eliminare la tua integrazione, consulta. [Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations) ### Problemi di autenticazione + **Registrazione errata dell'app**: verifica che la registrazione dell'app in Microsoft Entra includa le autorizzazioni API richieste e che sia stato concesso il consenso dell'amministratore. + **Segreto client scaduto**: controlla se il segreto del client è scaduto in **Certificati e segreti e** generane uno nuovo, se necessario. + URI di **reindirizzamento errato: verifica che l'URI** di reindirizzamento in Microsoft Entra corrisponda. `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback` ### Messaggi di errore comuni + **`Access denied. You do not have permission to perform this action`**— L'utente autenticato non dispone delle autorizzazioni richieste. Contatta l'amministratore per verificare e concedere le autorizzazioni appropriate. + **`AADSTS50020: User account from identity provider does not exist in tenant`**— L'account utente non è configurato nel tenant Microsoft Entra corretto. Verifica che nel tenant esista un account utente che corrisponda all'ID di Directory (tenant) indicato nella registrazione dell'app. # Integrazione con SharePoint la Knowledge Base di Microsoft Utilizza l'integrazione della SharePoint Knowledge Base di Microsoft per indicizzare SharePoint i contenuti in modo che gli agenti di Amazon Quick possano cercare e rispondere a domande al riguardo. Amazon Quick utilizza un'applicazione multi-tenant preregistrata a cui connettersi SharePoint per le knowledge base. Non è necessario creare una registrazione all'app. Quando un utente si connette per la prima volta, Microsoft presenta una finestra di dialogo per il consenso. Un amministratore può concedere il consenso per conto dell'intera organizzazione oppure i singoli utenti possono acconsentire autonomamente. ## Prima di iniziare Assicurati di disporre di quanto segue prima di configurare l'integrazione. + Un account Microsoft 365 con SharePoint accesso. + Per i requisiti di abbonamento, vedi[Configura le integrazioni nella console](integration-console-setup-process.md). + L'amministratore Microsoft potrebbe dover concedere il consenso dell'organizzazione prima che gli utenti possano creare una SharePoint knowledge base. Gli amministratori possono concedere il consenso a livello di organizzazione effettuando l'accesso e scegliendo **Consenso per conto dell'organizzazione durante il flusso di** creazione dell'integrazione. **Nota** Quando un amministratore concede il consenso dell'organizzazione, Microsoft Entra crea automaticamente un'applicazione Enterprise (service principal) nel tenant. È possibile disabilitare o eliminare questo servizio principale in qualsiasi momento dalle **applicazioni Enterprise** nell'interfaccia di amministrazione di Microsoft Entra, che revoca immediatamente tutti gli accessi. ## Autorizzazioni concesse durante il consenso **SharePoint base di conoscenza: autorizzazioni** | Autorizzazione | "Hello, World\$1" | Description | | --- | --- | --- | | Files.Read.All | Microsoft Graph | Consente all'app di leggere tutti i file a cui l'utente può accedere. | | Notes.Read.All | Microsoft Graph | Consente all'app di leggere tutti i OneNote taccuini a cui l'utente può accedere. | | User.Read | Microsoft Graph | Consente agli utenti di accedere e consente all'app di leggere il profilo dell'utente che ha effettuato l'accesso. | | Sites.Read.All | Microsoft Graph | Consente all'app di leggere documenti ed elencare elementi in tutte le raccolte del sito. | | offline\$1access | Microsoft Graph | Consente all'app di mantenere l'accesso quando l'utente non ha effettuato l'accesso attivo. | | AllSites.Read | Office 365 SharePoint online | Consente all'app di leggere gli elementi in tutte le raccolte del sito. | ## Configura l'integrazione della knowledge base 1. Nella console Amazon Quick, scegli **Integrazioni.** 1. Scegli **Microsoft SharePoint** e scegli il pulsante Aggiungi (più «\$1»). 1. Nella finestra di dialogo **Crea SharePoint knowledge base**, in **Account connesso**, scegli **Accedi a SharePoint** e completa il flusso di accesso e consenso di Microsoft. 1. In **Crea knowledge base**, inserisci un nome e una descrizione opzionale per la tua knowledge base. 1. Nella sezione **Contenuto**, scegli **Aggiungi contenuto** e seleziona le SharePoint pagine, i file o le cartelle che desideri indicizzare. 1. Scegli **Create** (Crea). ## Tipologie di contenuto supportate + **Librerie di documenti:** Word, Excel PowerPoint, PDF, OneNote (.one) + **File multimediali:** MP3, MOV MP4, WMV + **Pagine del sito e pagine wiki** ## Controlli sugli accessi **Importante** Quando Amazon Quick indicizza i SharePoint contenuti, non sincronizza gli elenchi di controllo degli accessi (ACLs) da. SharePoint Tutti i contenuti indicizzati sono accessibili a qualsiasi utente che abbia accesso alla knowledge base di Amazon Quick, indipendentemente dalle autorizzazioni in possesso. SharePoint Verifica quali contenuti includi durante la creazione di una knowledge base. ## Gestisci e risolvi i problemi Per modificare, condividere o eliminare la tua integrazione, consulta. [Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations) Per la risoluzione generale della Knowledge Base, inclusi problemi di sincronizzazione e documenti mancanti, consulta[Knowledge base per la risoluzione](troubleshooting-knowledge-bases.md). ### SharePoint-problemi specifici + **È richiesto il consenso dell'amministratore**: alcune organizzazioni richiedono che un amministratore conceda il consenso prima che i singoli utenti possano connettersi. Un amministratore deve accedere e scegliere **Consenso per conto dell'organizzazione** durante il flusso di consenso. + **Applicazione Enterprise disabilitata**: se l'entità del servizio era stata precedentemente disabilitata nelle **applicazioni Enterprise** nell'interfaccia di amministrazione di Microsoft Entra, riattivala per ripristinare l'accesso. + **SharePoint limitazione**: SharePoint può limitare le richieste durante i periodi di utilizzo elevato. Riprova la sincronizzazione durante le ore non di punta.