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, consultaMetodi di autenticazione.
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
per registrare un'integrazione OAuth. -
Per API Key: un token di accesso personale dall'Airtable Builder Hub sul sito Web di Airtable
. -
Per i requisiti di abbonamento ad Amazon Quick, consultaConfigura le integrazioni nella console.
Configurazione di Airtable
Se utilizzi l'autenticazione predefinita dell'app OAuth, salta questa sezione e procedi con. Configurazione del connettore in Amazon Quick
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.
-
Accedi all'Airtable Builder Hub sul sito Web di Airtable e scegli le integrazioni
OAuth. -
Scegli Registra una nuova integrazione OAuth.
-
Inserisci un nome per la tua integrazione.
-
Per gli URL di reindirizzamento OAuth, inserisci l'URL di reindirizzamento da Amazon Quick:
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback -
Scegli l'integrazione con Register.
-
Dopo la registrazione, genera un segreto del cliente selezionando Rigenera il segreto del cliente.
-
Registra i seguenti valori. Ne hai bisogno quando configuri Amazon Quick.
-
ID cliente
-
Client secret
-
-
In Scopes, seleziona le autorizzazioni richieste dalla tua integrazione. Per l'elenco completo degli ambiti consigliati, consulta. Ambiti consigliati
Crea un token di accesso personale (chiave API)
Crea un token di accesso personale nell'Airtable Builder Hub per l'autenticazione con chiave API.
-
Accedi all'Airtable Builder Hub
sul sito Web di Airtable e scegli Token di accesso personali. -
Scegli Crea token.
-
Configura il nome del token, gli ambiti e l'accesso di base secondo necessità per il tuo caso d'uso.
-
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.
| 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.
-
Nella console Amazon Quick, scegli Connettori.
-
Nella scheda Disponibile, trova Airtable e scegli Connect.
-
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.
-
Nella console Amazon Quick, scegli Connettori.
-
Scegli la scheda Crea per il tuo team.
-
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.
-
Inserisci un nome per il connettore. Facoltativamente, scegli + Aggiungi descrizione per aggiungere una descrizione.
-
Per Tipo di connessione, scegli Rete pubblica.
-
Per la configurazione OAuth, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.
-
Per l'app OAuth predefinita:
Non sono necessarie credenziali aggiuntive. Seleziona Successivo per continuare.
-
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.
-
-
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.
-
-
-
Scegli Next (Successivo).
-
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.
-
Nella pagina Revisione, esamina le azioni disponibili per il connettore. Scegli Next (Successivo).
-
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.
-
Seleziona Pubblica.
Operazioni disponibili
Dopo aver configurato il connettore, sono disponibili le seguenti azioni.
| 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, consultaGestione delle integrazioni esistenti.
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
. 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.
