Zum Inhalt springen

Airtable-Verbindung

Einführung

Eine Airtable-Verbindung, die mit dem Airtable-Connector erstellt wurde, ermöglicht den Zugriff auf Airtable. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Airtable.

Erstellen oder Bearbeiten einer Airtable-Verbindung

Eine neue Airtable-Verbindung wird mit dem Airtable-Connector von einem dieser Standorte erstellt:

Eine vorhandene Airtable-Verbindung kann von diesen Standorten bearbeitet werden:

Konfigurieren einer Airtable-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Airtable-Verbindung wird im Folgenden beschrieben, zusammen mit unserer empfohlenen Konfiguration.

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Airtable-Verbindung einzigartig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den Airtable-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

  • Authentifizierungsschema: Wählen Sie das Authentifizierungsschema, entweder OAuthPKCE oder PersonalAccessToken.

    • Token: Wenn PersonalAccessToken ausgewählt ist, geben Sie das zugehörige Token ein.

  • Anzeigewert: Wählen Sie den Anzeigewert, entweder DisplayText oder FormattedValue.

  • Schema: Geben Sie das Schema ein.

  • Objekt-IDs anzeigen: Wenn ausgewählt, wird festgelegt, dass die Anzeigewerte der Objekt-IDs verwendet werden.

  • Einfache Namen verwenden: Wenn ausgewählt, wird festgelegt, dass einfache Namen verwendet werden.

  • Proxy-Einstellungen verwenden: Wählen Sie, um die Einstellungen für private Agentenproxies zu verwenden.

  • Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Erweiterte Konfigurationsparameter angezeigt, die verwendet wird, um zusätzliche Konfigurationsparameter als Schlüssel-Wert-Paare hinzuzufügen.

    • Hinzufügen: Fügt der Tabelle eine Zeile hinzu. Geben Sie ein Schlüssel-Wert-Paar für jede Eigenschaft ein.
    • Einreichen: Speichert das Schlüssel-Wert-Paar in der Tabelle. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
    • Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer bestehenden Zeile. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
    • Bearbeiten: Ermöglicht das Bearbeiten eines bestehenden Schlüssel-Wert-Paares. Sichtbar, wenn Sie mit der Maus über eine bestehende Zeile fahren.
    • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn Sie mit der Maus über eine bestehende Zeile fahren.
    • Alle löschen: Löscht alle Zeilen aus der Tabelle.

    Erforderlich für alle Optionen im Menü Authentifizierungsschema, fügen Sie die folgenden Zeilen hinzu:

    Name Wert
    BaseId Fügen Sie die ID der Airtable-Datenbank hinzu, auf die Sie zugreifen möchten. Sie finden die ID in der Airtable-URL, die mit app beginnt.
    TableNames Fügen Sie eine durch Kommas getrennte Liste aller Tabellennamen in der Airtable-Datenbank hinzu, auf die Sie zugreifen möchten. Sie finden die Namen in Ihren Airtable-URLs, die mit tbls beginnen.
    BaseName Fügen Sie den Namen der Airtable-Datenbank 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 von der Airtable OAuth Seite (Anmeldung erforderlich) erhalten wurde.
    OAuthClientSecret Fügen Sie das Client-Geheimnis hinzu, das von der Airtable OAuth Seite (Anmeldung erforderlich) erhalten wurde.
    InitiateOAuth Setzen Sie dies auf entweder REFRESH (empfohlen) oder OFF.
    OAuthAccessToken Fügen Sie Ihr Zugriffstoken hinzu. Sie benötigen ein Drittanbieter-Tool, wie Postman, um dieses Token zu erhalten.
    OAuthRefreshToken (Erforderlich nur, wenn InitiateOAuth auf REFRESH gesetzt wurde.) Fügen Sie Ihr Aktualisierungstoken hinzu. Sie benötigen ein Drittanbieter-Tool, wie Postman, um dieses Token zu erhalten.
    Other Setzen Sie dies gleich OAuthSettingsLocation=, plus einen Pfad zu einer Datei, auf die Ihr agent Schreibzugriff hat.
    PathDelimiter (Optional, aber empfohlen.) Setzen Sie dies auf ein Zeichen, das in den Spaltennamen Ihrer interessierenden Tabellen nicht verwendet wird, wie einen Unterstrich _.

    Hinweis

    Airtable-Spalten- und Tabellennamen können Sonderzeichen enthalten, die von anderen Diensten nicht unterstützt werden. Fügen Sie die Konfigurationseigenschaft UseSimpleNames hinzu und setzen Sie sie auf true, um ein Benennungsschema durchzusetzen, das auf alphanumerische und Unterstrichzeichen für Spalten und Tabellen beschränkt ist. Nicht-alphanumerische Zeichen werden bei Aktivierung in Unterstriche umgewandelt.

    Wichtig

    Bei der Konfiguration der OAuth-Authentifizierung sollten Sie diese wichtigen Hinweise beachten:

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

    • Zusätzliche IDs, Geheimnisse, Scopes und andere Authentifizierungstoken können erforderlich sein, um die OAuth-Authentifizierung erfolgreich abzuschließen. Überprüfen Sie die Dokumentation der Endpunkte für weitere Informationen zu deren Anforderungen.

    • Felder in der Tabelle Erweiterte Konfigurationsparameter zeigen das Variablen-Icon nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 sein.

    • Felder in der Tabelle Erweiterte Konfigurationsparameter unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird {"success": "true"}; zu {\"success\": \"true\"};.

  • Test: Klicken Sie, 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, die mit der aktuellen Umgebung verbunden ist, heruntergeladen. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Verbindung zum Airtable-Connector hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Ruft Datensätze aus einer Tabelle in Airtable ab und ist als Quelle in einem Vorgang vorgesehen.

  • Erstellen: Fügt einen Datensatz in eine Tabelle in Airtable ein und ist als Ziel in einem Vorgang vorgesehen.

  • Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle in Airtable und ist als Ziel in einem Vorgang vorgesehen.

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

  • Ausführen: Führt ein Verfahren in Airtable aus und ist als Ziel in einem Vorgang vorgesehen.