Airtable-Integration

Mit dem Airtable Action Connector können Sie in natürlicher Sprache direkt in Amazon Quick auf die Airtable-Plattform zugreifen. Sie können Datensätze erstellen und aktualisieren, Datenbanken und Tabellen verwalten, Ansichten filtern und relationale Datenoperationen durchführen, ohne Amazon Quick verlassen zu müssen.

Amazon Quick unterstützt mehrere Authentifizierungsmethoden für Airtable. Wählen Sie die Methode, die den Sicherheitsanforderungen Ihres Unternehmens am besten entspricht.

• Standard-OAuth-Anwendung — Verwendet eine AWS-verwaltete OAuth-Anwendung. Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Benutzer authentifizieren sich direkt mit ihrem Airtable-Konto.

• Benutzerdefinierte OAuth-App — Verwendet eine vom Kunden verwaltete OAuth-Anwendung, die in Airtable registriert ist. Diese Option gibt Ihrem Unternehmen die volle Kontrolle über die OAuth-Konfiguration.

• API-Schlüssel — Verwendet ein persönliches Zugriffstoken von Airtable zur Authentifizierung. Geeignet für den individuellen Gebrauch oder zum Testen.

Weitere Informationen zu den von Amazon Quick unterstützten Authentifizierungsmethoden finden Sie unterAuthentifizierungsmethoden.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie die Integration einrichten.

• Ein aktives Airtable-Konto mit Zugriff auf die Datenbanken und Daten, die Sie verwenden möchten.

• Für die benutzerdefinierte OAuth-App: Zugriff auf den Airtable Builder Hub auf der Airtable-Website, um eine OAuth-Integration zu registrieren.

• Für API-Schlüssel: Ein persönliches Zugriffstoken vom Airtable Builder Hub auf der Airtable-Website.

• Informationen zu den Amazon Quick-Abonnementanforderungen finden Sie unterIntegrationen in der Konsole einrichten.

Airtable konfigurieren

Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden, überspringen Sie diesen Abschnitt und fahren Sie fort mit. Den Connector in Amazon Quick einrichten

Führen Sie für die benutzerdefinierte OAuth-App- oder API-Schlüsselauthentifizierung die entsprechenden Schritte in Airtable aus, bevor Sie Amazon Quick konfigurieren.

Registrieren Sie eine OAuth-Integration (benutzerdefinierte OAuth-App)

Erstellen Sie eine OAuth-Integration im Airtable Builder Hub, um die Client-Anmeldeinformationen zu erhalten, die Sie für Amazon Quick benötigen.

1. Melden Sie sich auf der Airtable-Website beim Airtable Builder Hub an und wählen Sie OAuth-Integrationen aus.

2. Wählen Sie Neue OAuth-Integration registrieren.

3. Geben Sie einen Namen für Ihre Integration ein.

4. Geben Sie für OAuth-Weiterleitungs-URLs die Weiterleitungs-URL von Amazon Quick ein: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

5. Wählen Sie Integration registrieren.

6. Generieren Sie nach der Registrierung einen geheimen Clientschlüssel, indem Sie die Option Kundengeheimnis neu generieren wählen.

7. Notieren Sie sich die folgenden Werte. Sie benötigen sie, wenn Sie Amazon Quick konfigurieren.

   • Kunden-ID

   • Clientschlüssel

8. Wählen Sie unter Bereiche die Berechtigungen aus, die für Ihre Integration erforderlich sind. Die vollständige Liste der empfohlenen Bereiche finden Sie unter. Empfohlene Bereiche

Erstellen Sie ein persönliches Zugriffstoken (API-Schlüssel)

Erstellen Sie im Airtable Builder Hub ein persönliches Zugriffstoken für die API-Schlüsselauthentifizierung.

1. Melden Sie sich auf der Airtable-Website beim Airtable Builder Hub an und wählen Sie Persönliche Zugriffstoken aus.

2. Wählen Sie „Token erstellen“.

3. Konfigurieren Sie den Token-Namen, die Bereiche und den Basiszugriff nach Bedarf für Ihren Anwendungsfall.

4. Kopieren Sie das generierte Token und speichern Sie es sicher. Sie benötigen es, wenn Sie Amazon Quick konfigurieren.

Empfohlene Bereiche

Wenn Sie eine OAuth-Integration registrieren oder ein persönliches Zugriffstoken erstellen, konfigurieren Sie die folgenden Bereiche auf der Grundlage der Aktionen, die Sie verwenden möchten.

Von Airtable empfohlene Bereiche

Scope	Description
data.records:read	Daten in Datensätzen lesen.
data.records:write	Datensätze erstellen, bearbeiten und löschen.
data.recordComments:read	Kommentare in Datensätzen lesen.
data.recordComments:write	Datensatzkommentare erstellen, bearbeiten und löschen.
schema.bases:read	Lesen Sie die Struktur der Datenbanken, einschließlich Tabellennamen und Feldtypen.
schema.bases:write	Bearbeiten Sie die Struktur von Datenbanken, einschließlich Tabellennamen und Feldtypen.
user.email:read	Lesen Sie die E-Mail-Adresse des authentifizierten Benutzers.

Den Connector in Amazon Quick einrichten

Über den Tab „Verfügbar“ eine Connect

Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden möchten, können Sie ohne zusätzliche Konfiguration direkt über den Tab Verfügbar eine Verbindung herstellen.

1. Wählen Sie in der Amazon Quick-Konsole Connectors aus.

2. Suchen Sie auf der Registerkarte Verfügbar nach Airtable und wählen Sie Connect.

3. Schließen Sie den Airtable-Anmeldevorgang ab und erteilen Sie die angeforderten Berechtigungen.

Um stattdessen einen Connector mit einer benutzerdefinierten OAuth-App oder einem API-Schlüssel zu konfigurieren, verwenden Sie die Registerkarte „Für Ihr Team erstellen“ wie unten beschrieben.

Erstellen Sie auf der Registerkarte „Für Ihr Team erstellen“

Nachdem Sie alle erforderlichen Airtable-Konfigurationen abgeschlossen haben, erstellen Sie den Connector in Amazon Quick.

1. Wählen Sie in der Amazon Quick-Konsole Connectors aus.

2. Wählen Sie den Tab „Für Ihr Team erstellen“.

3. Suchen und wählen Sie Airtable.

   Anmerkung

   Wenn bereits ein Airtable-Anschluss vorhanden ist, wird ein Dialogfeld mit Ihren vorhandenen Anschlüssen angezeigt. Um einen vorhandenen Anschluss zu verwenden, wählen Sie ihn aus. Um einen neuen zu erstellen, wählen Sie Nein, neu erstellen.

4. Geben Sie einen Namen für Ihren Connector ein. Wählen Sie optional + Beschreibung hinzufügen, um eine Beschreibung hinzuzufügen.

5. Wählen Sie als Verbindungstyp die Option Öffentliches Netzwerk aus.

6. Wählen Sie für die OAuth-Konfiguration eine der folgenden Authentifizierungsmethoden und konfigurieren Sie die erforderlichen Felder.

   1. Für die Standard-OAuth-App:

      Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Wählen Sie Next (Weiter), um fortzufahren.

   2. Konfigurieren Sie für die benutzerdefinierte OAuth-App die folgenden Felder:

      • Basis-URL (optional) — Die Airtable-API-Basis-URL. Beispiel: https://api.airtable.com

      • Client-ID — Die Client-ID aus Ihrer Airtable OAuth-Integration.

      • Geheimer Client-Schlüssel — Der geheime Client-Schlüssel aus Ihrer Airtable OAuth-Integration.

      • Token-URL — Der Token-Endpunkt. Beispiel: https://airtable.com/oauth2/v1/token

      • Autorisierungs-URL — Der Autorisierungsendpunkt. Beispiel: https://airtable.com/oauth2/v1/authorize

      • Weiterleitungs-URL — Pre-filled mit der Amazon Quick Callback-URL.

   3. Konfigurieren Sie für den API-Schlüssel die folgenden Felder:

      • Basis-URL (optional) — Die Airtable-API-Basis-URL. Beispiel: https://api.airtable.com

      • API-Schlüssel — Ihr persönlicher Airtable-Zugriffstoken.

      • E-Mail (optional) — Die mit Ihrem Airtable-Konto verknüpfte E-Mail-Adresse.

7. Wählen Sie Weiter aus.

8. Wenn Sie die Standard-OAuth-App oder die benutzerdefinierte OAuth-App ausgewählt haben, wird ein Airtable-Autorisierungsfenster geöffnet. Überprüfen Sie die angeforderten Berechtigungen, wählen Sie die Datenbanken und Arbeitsbereiche aus, für die Sie Zugriff gewähren möchten, und wählen Sie Zugriff gewähren aus.

9. Überprüfen Sie auf der Seite Überprüfen die verfügbaren Aktionen für den Connector. Wählen Sie Weiter aus.

10. Wählen Sie auf der Seite „Veröffentlichen“ aus, wer auf den Connector zugreifen kann. Sie können den Zugriff für alle in Ihrer Organisation aktivieren oder nach bestimmten Teams oder Gruppen suchen.

11. Wählen Sie Publish.

Verfügbare Aktionen

Nachdem Sie den Connector eingerichtet haben, sind die folgenden Aktionen verfügbar.

Verfügbare Airtable-Aktionen

Kategorie	Action	Description
Datensätze	Datensätze auflisten	Listet Datensätze in einer Tabelle mit optionaler Filterung und Sortierung auf.
Datensätze	Datensatz abrufen	Ruft einen bestimmten Datensatz anhand der ID ab.
Datensätze	Datensatz Batch erstellen	Erstellt einen oder mehrere neue Datensätze in einer Tabelle.
Datensätze	Datensatz aktualisieren	Aktualisiert Felder in einem vorhandenen Datensatz.
Datensätze	Datensatz für Batch-Aktualisierung	Aktualisiert mehrere Datensätze in einem einzigen Vorgang mit PATCH.
Datensätze	Batch-Put-Rekord	Löscht mehrere Datensätze in einem einzigen Vorgang mithilfe von PUT.
Kommentare	Kommentare auflisten	Listet Kommentare zu einem Datensatz auf.
Kommentare	Kommentar erstellen	Fügt einem Datensatz einen Kommentar hinzu.
Kommentare	Kommentar aktualisieren	Bearbeitet einen vorhandenen Kommentar zu einem Datensatz.
Schema	Datenbanken auflisten	Listet alle Datenbanken auf, auf die der authentifizierte Benutzer zugreifen kann.
Schema	Basisschema abrufen	Ruft das Schema einer Basis ab, einschließlich Tabellen und Felddefinitionen.
Schema	Tabelle erstellen	Erstellt eine neue Tabelle in einer Base.
Schema	Tabelle aktualisieren	Aktualisiert Tabelleneigenschaften wie Name oder Beschreibung.
Schema	Feld erstellen	Fügt einer Tabelle ein neues Feld hinzu.
Schema	Feld aktualisieren	Aktualisiert Feldeigenschaften wie Name oder Typ.
Anlagen	Anlage erstellen	Lädt einen Anhang zu einem Datensatz hoch.
Benutzer	Benutzerinformationen abrufen	Ruft Informationen über den authentifizierten Benutzer ab.

Anmerkung

Die Aktionen, die Sie verwenden können, hängen von den Datenbanken und Workspaces ab, auf die der authentifizierte Benutzer zugreifen kann.

Verwaltung und Problembehebung

Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unterVerwaltung vorhandener Integrationen.

Probleme bei der Authentifizierung

• Sign-in schlägt fehl (Standard-OAuth-App oder benutzerdefinierte OAuth-App) — Stellen Sie sicher, dass Ihr Airtable-Konto aktiv ist und dass Sie sich direkt auf der Airtable-Website bei airtable.com anmelden können. Stellen Sie für die benutzerdefinierte OAuth-App sicher, dass die Weiterleitungs-URL in Ihrer Airtable OAuth-Integration mit der Amazon Quick Callback-URL übereinstimmt.

• Ungültige Kundenanmeldedaten (benutzerdefinierte OAuth-App) — Stellen Sie sicher, dass die Client-ID und der geheime Client-Schlüssel mit den Werten in Ihrer Airtable OAuth-Integration übereinstimmen. Wenn Sie das Client-Geheimnis neu generiert haben, aktualisieren Sie den Wert in Amazon Quick.

• API-Schlüssel abgelehnt — Stellen Sie sicher, dass Ihr persönlicher Zugriffstoken aktiv ist und die erforderlichen Gültigkeitsbereiche hat. Token können im Airtable Builder Hub gesperrt oder abgelaufen werden.

• Unzureichende Berechtigungen — Stellen Sie sicher, dass die für Ihre Authentifizierungsmethode konfigurierten Bereiche die Berechtigungen enthalten, die für die Aktionen erforderlich sind, die Sie verwenden möchten. Siehe Empfohlene Bereiche.