Airtable

Beispiele für Verbindungskonfigurationen

In diesem Abschnitt finden Sie Beispielwerte für die verschiedenen Felder, die Sie beim Erstellen der Verbindung konfigurieren.

Verbindungstyp „Persönliches Zugriffstoken“

Entitäten, Vorgänge und Aktionen

Alle Integration Connectors bieten eine Abstraktionsebene für die Objekte der verbundenen Anwendung. Sie können nur über diese Abstraktion auf die Objekte einer Anwendung zugreifen. Die Abstraktion wird Ihnen als Entitäten, Vorgänge und Aktionen zur Verfügung gestellt.

• Entität: Eine Entität kann als Objekt oder Sammlung von Attributen in der verbundenen Anwendung oder im verbundenen Dienst verstanden werden. Die Definition einer Entität unterscheidet sich von Connector zu Connector. Beispiel: In einem Datenbank-Connector sind Tabellen die Entitäten, in einem Dateiserver-Connector sind Ordner die Entitäten und in einem Nachrichtensystem-Connector sind Warteschlangen die Entitäten.

  Es ist jedoch möglich, dass ein Connector keine Entitäten unterstützt oder keine Entitäten enthält. In diesem Fall ist die Liste Entities leer.

• Vorgang: Ein Vorgang ist die Aktivität, die Sie für eine Entität ausführen können. Sie können einen der folgenden Vorgänge für eine Entität ausführen:
  • Liste
  • Abrufen
  • Erstellen
  • Aktualisieren
  • Löschen

  Durch Auswahl einer Entität aus der verfügbaren Liste wird eine Liste der Vorgänge generiert, die für die Entität verfügbar sind. Eine detaillierte Beschreibung der Vorgänge finden Sie in den Entitätsvorgängen der Connectors-Aufgabe. Wenn ein Connector jedoch keinen der Entitätsvorgänge unterstützt, werden diese nicht unterstützten Vorgänge nicht in der Liste Operations aufgeführt.

• Aktion: Eine Aktion ist eine Funktion erster Klasse, die über die Connector-Benutzeroberfläche für die Integration verfügbar gemacht wird. Mit einer Aktion können Sie Änderungen an einer oder mehreren Entitäten vornehmen, die von Connector zu Connector unterschiedlich sind. Normalerweise hat eine Aktion einige Eingabeparameter und einen Ausgabeparameter. Es ist jedoch möglich, dass ein Connector keine Aktionen unterstützt. In diesem Fall ist die Actions-Liste leer.

Beispiele für Entitätsvorgänge

In diesem Abschnitt wird beschrieben, wie Sie einige Entitätsvorgänge in diesem Connector ausführen.

Beispiel: Listenvorgang für die Entität „Kontaktdaten (Einträge)“

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option Contact Data aus.
3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
4. Im Bereich Aufgabeneingabe der Aufgabe Connectors können Sie die filterClause gemäß den Kundenanforderungen festlegen.

Geben Sie den Wert der Filterklausel immer in einfache Anführungszeichen (') ein.

Sie können Listenvorgänge auch auf die folgenden Entitäten ausführen:
Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List und Contacts Data_Collaborators

Beispiel: Datensatz für die Entität „Kontaktdaten (Datensätze)“ abrufen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option Contact Data aus.
3. Wählen Sie den Vorgang GET aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf „recg7qjPRMa7DBwIb“ fest, der zu übergebende Schlüssel. Klicken Sie zum Festlegen der Entitäts-ID im Bereich Datenübersetzer des Datenabgleichs auf Datenabgleichs-Editor öffnen und geben Sie dann "recg7qjPRMa7DBwIb" in das Feld Eingabewert ein. Wählen Sie dann „EntityId“ als lokale Variable aus.

   Hier ist „recg7qjPRMa7DBwIb“ der eindeutige Primärschlüsselwert und muss direkt übergeben werden.

Wenn die Entität einen zusammengesetzten Primärschlüssel hat, können Sie eine Filterklausel angeben.

Sie können den Abrufvorgang auch für die folgenden Entitäten ausführen: Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List und Contacts Data_Collaborators.

Beispiel: Datensatz der Entität „Kontaktdaten (Datensätze)“ löschen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option Contact Data aus.
3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf „recg7qjPRMa7DBwIb“ fest, der zu übergebende Schlüssel.Klicken Sie dazu im Bereich Datenabgleich des Datenabgleichs auf Datenabgleichseditor öffnen, geben Sie dann "recg7qjPRMa7DBwIb" in das Feld Eingabewert ein und wählen Sie „EntityId“ als lokale Variable aus.

Wenn die Entität einen zusammengesetzten Primärschlüssel hat, können Sie eine Filterklausel angeben.

Beispiel: Vorgang zum Erstellen der Entität „Kontaktdaten (Einträge)“

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option Contact Data aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload“ als lokale Variable aus.

   {
   "First Name": "Demo4",
   "Last Name": "Alex",
   "Email": "cloudysanfrancisco@gmail.com",
   "DOB": "2000-04-14",
   "Office": "Denver",
   "Phone Number": "1-175-432-1437",
   "Current Brand": "Mercedes"
   }
   

   Wenn die Integration erfolgreich war, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

   {
   "Internal_Id": "recg7qjPRMa7DBwIb"
   }
     
   <pre>
     function helloWorld() {
       alert('Hello, world! This sentence is so long that it wraps onto a second
         line.');
     }
     
     /n
     <h3>Example title</h3>
     </pre>
   

Beispiel: Aktualisierungsvorgang für die Entität „Kontaktdaten (Einträge)“

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option ContactData aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
   "Phone Number": "1-175-432-4312",
   "Current Brand": "Honda"
   }
   

   Anstelle der entityId können Sie auch die filterClause auf Internal_Id='reckqGnFusjDlnmvs' festlegen.

Wenn die Integration erfolgreich ist, gilt für die connectorOutputPayload-Ausgabevariable der Connector-Aufgabe Folgendes:

{
"Internal_Id": "reckqGnFusjDlnmvs"
}

Beispiel: Aktualisierungsvorgang für die Entität „Kontaktdaten (Anhang)“

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option Contact Data aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
   "Attachment": "[{\"url\":\"https://media.istockphoto.com/id/2086323995/photo/global-communication-east-asia.jpg?s=2048x2048&w=is&k=20&c=Z50lesspQQzxWug0m11QrPZMOUzMeTufgnLHh_3COy4=\",\"filename\":\"BMW\"}]"
   }
   

   Anstelle der entityId können Sie auch die filterClause auf Internal_Id='reckqGnFusjDlnmvs' festlegen.

   Wenn die Integration erfolgreich ist, gilt für die connectorOutputPayload-Ausgabevariable der Connector-Aufgabe Folgendes:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Beispiel: Aktualisierungsvorgang für das Entitätselement „Kontaktdaten (Kästchen)“

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option Contact Data aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
   "Checkbox": true
   }
   

   Anstelle der entityId können Sie auch die filterClause auf Internal_Id='reckqGnFusjDlnmvs' festlegen.

   Wenn die Integration erfolgreich ist, gilt für die connectorOutputPayload-Ausgabevariable der Connector-Aufgabe Folgendes:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Beispiel: Aktualisierungsvorgang für die Entität „Kontaktdaten (Nummer)“

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option ContactData aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
   "Number": 1001.0
   } 
   

   Anstelle der entityId können Sie auch die filterClause auf Internal_Id='reckqGnFusjDlnmvs' festlegen.

   Wenn die Integration erfolgreich ist, gilt für die connectorOutputPayload-Ausgabevariable der Connector-Aufgabe Folgendes:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   } 
   

Beispiel: Aktualisierungsvorgang für die Entität „Kontaktdaten (Datumsfeld)“

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option ContactData aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
   "DOB": "2000-04-14"
   } 
   

   Anstelle der entityId können Sie auch die filterClause auf Internal_Id='reckqGnFusjDlnmvs' festlegen.

   Wenn die Integration erfolgreich ist, gilt für die connectorOutputPayload-Ausgabevariable der Connector-Aufgabe Folgendes:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Beispiel: Aktualisierungsvorgang für die Entität „Kontaktdaten (Text)“

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option ContactData aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
   "Singlelinetext": "Airtable Application",
   "Long text": "Airtable is a cloud-based collaboration platform that combines the features of a spreadsheet with the capabilities of a database. "
   }
   

   Anstelle der entityId können Sie auch die filterClause auf Internal_Id='reckqGnFusjDlnmvs' festlegen.

   Wenn die Integration erfolgreich ist, gilt für die connectorOutputPayload-Ausgabevariable der Connector-Aufgabe Folgendes:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }