Zum Inhalt springen

Airtable-Verbindung

Einführung

Eine Airtable Verbindung, erstellt mit dem Airtable-Connector, stellt den Zugriff auf Airtable her. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von Airtable-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Erstellen oder Bearbeiten einer Airtable-Verbindung

Eine neue Airtable-Verbindung wird mithilfe des Airtable Connectors von einem dieser Standorte aus erstellt:

Eine bestehende Airtable-Verbindung kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Airtable-Verbindung

Jedes Benutzeroberflächenelement des Airtable-Verbindungskonfigurationsbildschirms wird unten zusammen mit unserer empfohlenen Konfiguration beschrieben.

Airtable Verbindungskonfiguration

Tipp

Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Airtable-Verbindung eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:). Dieser Name wird auch verwendet, um den Airtable Endpoint zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

  • Authentifizierungsschema: Wählen Sie das Autorisierungsschema aus:

    • ApiKey: Wenn ausgewählt, werden die Felder API Schlüssel und Client-Geheimnis angezeigt:

      • API Schlüssel: Geben Sie Ihren API Schlüssel ein.

      • Client Secret: Geben Sie das Client Secret ein.

      Warnung

      API Schlüsselauthentifizierung wurde veraltet von Airtable am 31. Januar 2024.

    • PersonalAccessToken: Wenn ausgewählt, wird das Feld OAuth-Zugriffstoken angezeigt:

      • OAuth-Zugriffstoken: Geben Sie Ihren persönlichen Zugriffstoken ein, die Sie von der Token-Seite erhalten können (Anmeldung erforderlich) bei Airtable. Sie werden empfohlen, wenn Sie Integrationen für sich selbst, Ihren Kunden oder Ihr Unternehmen erstellen.

    • OAuthPKCE: (Empfohlen) Dies ist die von Jitterbit empfohlene Authentifizierungsmethode. Sie benötigen OAuth-Authentifizierung, wenn Sie eine Airtable Integration für viele verschiedene Benutzer erstellen, die im Namen dieser Benutzer auf die Airtable API zugreifen muss. Wenn diese Option ausgewählt ist, geben Sie Konfigurationseigenschaften in der Tabelle Erweiterte Konfigurationen weiter unten an, um OAuth zu konfigurieren.

  • Basis-ID: Geben Sie die ID der Airtable Basis ein, auf die Sie zugreifen möchten. Sie finden die ID in der Airtable URL, beginnend mit app.

  • Metadaten-API aktivieren: Wenn ausgewählt (Standard), wird damit angegeben, dass die Metadaten-API aktiviert werden soll.

  • Objekt-IDs anzeigen: Wenn ausgewählt, wird angegeben, dass Anzeigeobjekt-IDs verwendet werden sollen.

  • Einfache Namen verwenden: Wenn ausgewählt, wird die Verwendung einfacher Namen angegeben.

  • Proxy-Einstellungen verwenden: Wählen Sie diese Option aus, um private Agent-Proxy-Einstellungen zu verwenden.

  • Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Erweiterte Konfigurationseigenschaften angezeigt, die zum Hinzufügen zusätzlicher Konfigurationseigenschaften verwendet wird als Key-Value Paare. Klicken Sie auf das Symbol „Hinzufügen“ Symbol „Hinzufügen“, um der folgenden Tabelle eine Zeile hinzuzufügen und für jede Eigenschaft ein Key-Value Paar einzugeben.

    Erforderlich für alle Menüoptionen des Authentifizierungsschemas. Fügen Sie die folgenden Zeilen hinzu:

    Name Wert
    BaseId Nur erforderlich, wenn nicht in Basis-ID oben definiert. Fügen Sie die ID der Airtable Basis hinzu, auf die Sie zugreifen möchten. Sie finden die ID in der Airtable URL, beginnend mit app.
    TableNames Fügen Sie eine durch Kommas getrennte Liste aller Tabellennamen in der Airtable-Basis hinzu, auf die Sie zugreifen möchten. Sie finden die Namen in Ihren Airtable URLs, beginnend mit tbls.
    BaseName Fügen Sie den Namen der Airtable-Basis hinzu, auf die Sie zugreifen möchten.

    Wenn das ausgewählte AuthScheme OAuthPKCE ist, fügen Sie die folgenden Zeilen hinzu:

    Name Wert
    OAuthClientId Fügen Sie die Client-ID hinzu, die Sie von Airtable OAuth erhalten haben Seite (Anmeldung erforderlich).
    OAuthClientSecret Fügen Sie das Client-Geheimnis hinzu, das Sie von Airtable OAuth erhalten haben Seite (Anmeldung erforderlich).
    InitiateOAuth Stellen Sie dies entweder auf REFRESH (empfohlen) oder OFF.
    OAuthAccessToken Fügen Sie Ihren Zugriffstoken hinzu. Sie benötigen ein Drittpartei wie Postman, um dieses Token zu erhalten.
    OAuthRefreshToken (Nur erforderlich, wenn InitiateOAuth wurde eingestellt auf REFRESH.) Fügen Sie Ihr Aktualisierungstoken hinzu. Sie benötigen ein Drittpartei wie Postman, um dieses Token zu erhalten.
    Other Setze dies gleich OAuthSettingsLocation=, sowie einen Pfad zu einer Datei, die Ihr Agent hat Schreibzugriff auf.
    PathDelimiter (Optional, aber empfohlen.) Legen Sie hierfür ein Zeichen fest, das in keinem Spaltennamen in den betreffenden Tabellen verwendet wird, z. B. ein Unterstrich _.

    Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol Senden-Symbol in der Spalte ganz rechts.

    Um eine einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die Spalte ganz rechts und verwenden Sie das Bearbeitungssymbol Bearbeitungssymbol oder Löschsymbol Löschsymbol.

    Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.

    Wichtig

    Beachten Sie beim Konfigurieren der OAuth-Authentifizierung diese wichtigen Hinweise:

    • Die OAuth-Konfiguration funktioniert nur für Agentengruppen, die aus einem einzelnen Agenten bestehen.

    • Um die OAuth-Authentifizierung erfolgreich abzuschließen, sind möglicherweise zusätzliche IDs, Geheimnisse, Bereiche und andere Authentifizierungstoken erforderlich. Weitere Informationen zu den Anforderungen finden Sie in der Endpoint.

    • Felder in der Tabelle Erweiterte Konfigurationseigenschaften zeigen das variable Symbol nur im Bearbeitungsmodus. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein.

  • Test: Klicken Sie hier, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Airtable Konnektorverbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Ruft Datensätze aus einer Tabelle in Airtable ab und soll als Quelle in einer Operation verwendet werden.

  • Erstellen: Fügt einen Datensatz in eine Tabelle bei Airtable ein und soll als Ziel in einer Operation verwendet werden.

  • Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle in Airtable und soll als Ziel in einer Operation verwendet werden.

  • Löschen: Löscht einen Datensatz aus einer Tabelle in Airtable und ist als Ziel in einer Operation vorgesehen.

  • Ausführen: Führt eine Prozedur bei Airtable aus und soll als Ziel in einer Operation verwendet werden.