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à.
# OneDrive Integrazione con Microsoft Action
Usa il Microsoft OneDrive Action Connector per gestire OneDrive file, cartelle 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 OneDrive 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
Questa integrazione utilizza autorizzazioni delegate, che consentono all'app di agire per conto di un utente che ha effettuato l'accesso. 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** e aggiungi le autorizzazioni dalla tabella seguente.
1. Scegli **Concedi il consenso dell'amministratore per [il nome dell'inquilino]** per approvare le autorizzazioni.
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.
**OneDrive 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. |
| User.Read.All | Consente all'app di leggere il set completo di proprietà del profilo di tutti gli utenti dell'organizzazione 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. |
### 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 OneDrive** e scegli il pulsante Aggiungi (più «\$1»).
1. Scegli la scheda **Azioni**.
1. Scegli **Esegui azioni in Microsoft OneDrive**.
1. Inserisci i dettagli dell'integrazione:
+ **Nome: nome** descrittivo per l' OneDriveintegrazione.
+ **Descrizione** (facoltativa): scopo dell'integrazione.
1. Compila le impostazioni di connessione:
+ **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. 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 OneDrive disponibili in Microsoft**
| Categoria | Azione | Description |
| --- | --- | --- |
| Drive e articoli | Ottieni Drive | Recupera le proprietà e le relazioni di un'unità. |
| Unità e oggetti | Elemento dell'elenco | Recupera tutti gli oggetti contenuti nell'unità. |
| Unità e oggetti | Get Item | Procurati un oggetto contenuto nell'unità. |
| Unità e oggetti | Create Folder | Crea una nuova cartella nell'unità dell'utente. |
| Unità e oggetti | Update Item | Aggiorna i metadati per un file o una cartella. |
| Unità e oggetti | Delete Item | Eliminare un file o una cartella. Sposta l'articolo nel cestino. |
| Unità e oggetti | Elenca le cartelle secondarie | Restituisce una raccolta di elementi nei figli di una cartella. |
| Drive e oggetti | Copia articolo | Crea una copia di un file o di una cartella in un'altra posizione. |
| Unità e oggetti | Aggiungi autorizzazioni | Invia un invito alla condivisione di un file o di una cartella. |
| Drive e articoli | Carica file | Carica un nuovo file o aggiorna un file esistente. Supporta file fino a 250 MB. |
| Cartelle di lavoro 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.