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à. # Integrazione con Airtable Con il connettore di azione Airtable, puoi accedere alla piattaforma Airtable direttamente in Amazon Quick tramite linguaggio naturale. Puoi creare e aggiornare record, gestire basi e tabelle, filtrare le viste ed eseguire operazioni relazionali sui dati senza uscire da Amazon Quick. Amazon Quick supporta diversi metodi di autenticazione per Airtable. Scegli il metodo più adatto ai requisiti di sicurezza della tua organizzazione. + App **OAuth predefinita: utilizza un'applicazione** OAuth AWS gestita. Non sono necessarie credenziali aggiuntive. Gli utenti si autenticano direttamente con il proprio account Airtable. + App **OAuth personalizzata: utilizza un'applicazione** OAuth gestita dal cliente registrata in Airtable. Questa opzione offre alla tua organizzazione il pieno controllo sulla configurazione OAuth. + **Chiave API**: utilizza un token di accesso personale Airtable per l'autenticazione. Adatto per uso individuale o test. Per ulteriori 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 Airtable attivo con accesso alle basi e ai dati che desideri utilizzare. + Per l'**app OAuth personalizzata**: accesso all'[Airtable Builder Hub sul sito Web di Airtable](https://airtable.com/create/oauth) per registrare un'integrazione OAuth. + Per **API Key**: un token di accesso personale dall'Airtable Builder Hub sul sito Web di [Airtable](https://airtable.com/create/tokens). + Per i requisiti di abbonamento ad Amazon Quick, consulta[Configura le integrazioni nella console](integration-console-setup-process.md). ## Configurazione di Airtable Se utilizzi l'autenticazione **predefinita dell'app OAuth**, salta questa sezione e procedi con. [Configurazione del connettore in Amazon Quick](#airtable-quicksuite-setup) Per l'autenticazione personalizzata dell'app OAuth o della chiave API, completa i passaggi applicabili in Airtable prima di configurare Amazon Quick. ### Registra un'integrazione OAuth (app OAuth personalizzata) Crea un'integrazione OAuth nell'Airtable Builder Hub per ottenere le credenziali client di cui hai bisogno per Amazon Quick. 1. **Accedi all'[Airtable Builder Hub sul sito Web di Airtable e scegli le integrazioni](https://airtable.com/create/oauth) OAuth.** 1. **Scegli Registra una nuova integrazione OAuth.** 1. Inserisci un **nome** per la tua integrazione. 1. Per gli URL di **reindirizzamento OAuth, inserisci l'URL** di reindirizzamento da Amazon Quick: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` 1. **Scegli l'**integrazione con Register. 1. Dopo la registrazione, genera un segreto del cliente selezionando **Rigenera il segreto del cliente**. 1. Registra i seguenti valori. Ne hai bisogno quando configuri Amazon Quick. + **ID cliente** + **Client secret** 1. In **Scopes**, seleziona le autorizzazioni richieste dalla tua integrazione. Per l'elenco completo degli ambiti consigliati, consulta. [Ambiti consigliati](#airtable-oauth-scopes) ### Crea un token di accesso personale (chiave API) Crea un token di accesso personale nell'Airtable Builder Hub per l'autenticazione con chiave API. 1. **Accedi all'[Airtable Builder Hub](https://airtable.com/create/tokens) sul sito Web di Airtable e scegli Token di accesso personali.** 1. **Scegli Crea token.** 1. Configura il nome del token, gli ambiti e l'accesso di base secondo necessità per il tuo caso d'uso. 1. Copia e archivia in modo sicuro il token generato. Ne hai bisogno quando configuri Amazon Quick. ### Ambiti consigliati Quando registri un'integrazione OAuth o crei un token di accesso personale, configura i seguenti ambiti in base alle azioni che desideri utilizzare. **Ambiti consigliati da Airtable** | Scope | Description | | --- | --- | | data.records:read | Leggi i dati nei record. | | data.records:write | Crea, modifica ed elimina i record. | | data.recordComments:read | Leggi i commenti nei record. | | data.recordComments:write | Crea, modifica ed elimina i commenti dei record. | | schema.bases:read | Leggi la struttura delle basi, inclusi i nomi delle tabelle e i tipi di campo. | | schema.bases:write | Modifica la struttura delle basi, inclusi i nomi delle tabelle e i tipi di campo. | | user.email:read | Leggi l'indirizzo email dell'utente autenticato. | ## Configurazione del connettore in Amazon Quick ### Connect dalla scheda Available Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda **Disponibile** senza configurazioni aggiuntive. 1. Nella console Amazon Quick, scegli **Connettori**. 1. Nella scheda **Disponibile**, trova **Airtable** e scegli **Connect**. 1. Completa il flusso di accesso ad Airtable e concedi le autorizzazioni richieste. Per configurare invece un connettore con l'app OAuth personalizzata o la chiave API, usa la scheda **Crea per il tuo team** come descritto di seguito. ### Crea dalla scheda Crea per il tuo team Dopo aver completato la configurazione Airtable richiesta, crea il connettore in Amazon Quick. 1. Nella console Amazon Quick, scegli **Connettori**. 1. Scegli la scheda **Crea per il tuo team**. 1. Trova e scegli **Airtable.** **Nota** Se esiste già un connettore Airtable, viene visualizzata una finestra di dialogo con i connettori esistenti. Per usare un connettore esistente, sceglilo. Per crearne uno nuovo, scegli **No, crea nuovo**. 1. Inserisci un **nome** per il connettore. Facoltativamente, scegli **\+ Aggiungi descrizione** per aggiungere una descrizione. 1. Per **Tipo di connessione**, scegli **Rete pubblica**. 1. Per la **configurazione OAuth**, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti. 1. Per l'app **OAuth predefinita:** Non sono necessarie credenziali aggiuntive. Seleziona **Successivo** per continuare. 1. Per l'**app OAuth personalizzata**, configura i seguenti campi: + **URL di base** (opzionale): l'URL di base dell'API Airtable. Ad esempio: `https://api.airtable.com` + **ID cliente**: l'ID client dell'integrazione con Airtable OAuth. + **Segreto del cliente: il segreto** del client derivante dall'integrazione con Airtable OAuth. + **Token URL: l'endpoint** del token. Ad esempio: `https://airtable.com/oauth2/v1/token` + **URL di autorizzazione: l'**endpoint di autorizzazione. Ad esempio: `https://airtable.com/oauth2/v1/authorize` + URL **di reindirizzamento: Pre-filled con l'URL** di callback di Amazon Quick. 1. Per **API Key**, configura i seguenti campi: + **URL di base** (opzionale): l'URL di base dell'API Airtable. Ad esempio: `https://api.airtable.com` + **Chiave API**: il tuo token di accesso personale Airtable. + **Email** (opzionale): l'indirizzo email associato al tuo account Airtable. 1. Scegli **Next (Successivo)**. 1. Se scegli l'app **OAuth predefinita o l'app OAuth** **personalizzata, si apre una finestra di autorizzazione** Airtable. **Controlla le autorizzazioni richieste, scegli le basi e le aree di lavoro a cui concedere l'accesso e scegli Concedi l'accesso.** 1. Nella pagina **Revisione**, esamina le azioni disponibili per il connettore. Scegli **Next (Successivo)**. 1. Nella pagina **Pubblica**, scegli chi può accedere al connettore. Puoi abilitare l'accesso per tutti i membri dell'organizzazione o cercare team o gruppi specifici. 1. Seleziona **Pubblica**. ## Operazioni disponibili Dopo aver configurato il connettore, sono disponibili le seguenti azioni. **Azioni disponibili di Airtable** | Categoria | Azione | Description | | --- | --- | --- | | Registri | Elenca i record | Elenca i record in una tabella con filtri e ordinamenti opzionali. | | Registri | Ottieni record | Recupera un record specifico per ID. | | Registri | Registrazione di creazione in batch | Crea uno o più nuovi record in una tabella. | | Registri | Aggiorna record | Aggiorna i campi di un record esistente. | | Registri | Record di aggiornamento in batch | Aggiorna più record in un'unica operazione utilizzando PATCH. | | Registri | Registrazione Batch Put | Converte più record in un'unica operazione utilizzando PUT. | | Commenti | Elenca commenti | Elenca i commenti su un record. | | Commenti | Crea commento | Aggiunge un commento a un record. | | Commenti | Aggiorna commento | Modifica un commento esistente su un record. | | Schema | Elenca basi | Elenca tutte le basi accessibili all'utente autenticato. | | Schema | Ottieni lo schema di base | Recupera lo schema di una base, comprese le tabelle e le definizioni dei campi. | | Schema | Create Table | Crea una nuova tabella in una base. | | Schema | Update Table | Aggiorna le proprietà della tabella come il nome o la descrizione. | | Schema | Crea campo | Aggiunge un nuovo campo a una tabella. | | Schema | Aggiorna campo | Aggiorna le proprietà dei campi come il nome o il tipo. | | Allegati | Crea allegato | Carica un allegato a un record. | | Utenti | Ottieni informazioni sull'utente | Recupera informazioni sull'utente autenticato. | **Nota** Le azioni che è possibile utilizzare dipendono dalle basi e dagli spazi di lavoro accessibili all'utente autenticato. ## Gestione e risoluzione dei problemi Per modificare, condividere o eliminare il connettore, consulta[Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations). ### Problemi di autenticazione + **Sign-in fallisce (app OAuth predefinita o app OAuth personalizzata)**: verifica che il tuo account Airtable sia attivo e che tu possa accedere direttamente a [airtable.com sul sito Web Airtable](https://airtable.com). Per l'app Custom OAuth, verifica che l'URL di reindirizzamento nella tua integrazione Airtable OAuth corrisponda all'URL di callback di Amazon Quick. + **Credenziali client non valide (app OAuth personalizzata)**: verifica che l'ID client e il segreto del client corrispondano ai valori dell'integrazione con Airtable OAuth. Se hai rigenerato il segreto del client, aggiorna il valore in Amazon Quick. + **Chiave API rifiutata**: verifica che il tuo token di accesso personale sia attivo e abbia gli ambiti richiesti. I token possono essere revocati o scaduti nell'Airtable Builder Hub. + **Autorizzazioni insufficienti**: verifica che gli ambiti configurati per il tuo metodo di autenticazione includano le autorizzazioni necessarie per le azioni che desideri utilizzare. Per informazioni, consulta [Ambiti consigliati](#airtable-oauth-scopes).