Airtable

Exemples de configuration de connexion

Cette section présente des exemples de valeurs pour les différents champs que vous configurez lorsque vous créez la connexion.

Type de connexion avec un jeton d'accès personnel

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connectés. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Voici les opérations possibles :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Effectuer une opération List sur l'entité Contact Data (Records)

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Contact Data dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause en fonction des exigences du client.

Indiquez toujours la valeur de la clause de filtre entre guillemets simples (').

Vous pouvez également effectuer des opérations List sur les entités suivantes :
Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List et Contacts Data_Collaborators.

Exemple : Récupérer un enregistrement pour l'entité Contact Data (Records)

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Contact Data dans la liste Entity.
3. Sélectionnez l'opération GET, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "recg7qjPRMa7DBwIb", qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez "recg7qjPRMa7DBwIb" dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

   Ici, l'ID d'entité "recg7qjPRMa7DBwIb" est la valeur de clé primaire unique. Elle doit être transmise directement.

Si l'entité possède une clé primaire composite, vous pouvez spécifier une clause de filtre.

Vous pouvez également effectuer l'opération Get sur les entités suivantes : Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List et Contacts Data_Collaborators.

Exemple : Supprimer un enregistrement de l'entité Contact Data (Records)

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Contact Data dans la liste Entity.
3. Sélectionnez l'opération Delete, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "recg7qjPRMa7DBwIb", qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez "recg7qjPRMa7DBwIb" dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

Si l'entité possède une clé primaire composite, vous pouvez spécifier une clause de filtre.

Exemple : Effectuer une opération Create sur l'entité Contact Data (Records)

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Contact Data dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.

   {
   "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"
   }
   

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
   "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>
   

Exemple : Effectuer une opération Update sur l'entité Contact Data (Records)

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez ContactData dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

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

   Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

Si l'intégration aboutit, la variable de sortie connectorOutputPayload de la tâche "Connecteurs" sera la suivante :

{
"Internal_Id": "reckqGnFusjDlnmvs"
}

Exemple : Effectuer une opération Update sur l'entité Contact Data (Attachment)

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Contact Data dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   {
   "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\"}]"
   }
   

   Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

   Si l'intégration aboutit, la variable de sortie connectorOutputPayload de la tâche "Connecteurs" sera la suivante :

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Exemple : Effectuer une opération Update sur l'entité Contact Data (Checkbox)

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Contact Data dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   {
   "Checkbox": true
   }
   

   Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

   Si l'intégration aboutit, la variable de sortie connectorOutputPayload de la tâche "Connecteurs" sera la suivante :

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Exemple : Effectuer une opération Update sur l'entité Contact Data (Number)

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez ContactData dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   {
   "Number": 1001.0
   } 
   

   Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

   Si l'intégration aboutit, la variable de sortie connectorOutputPayload de la tâche "Connecteurs" sera la suivante :

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   } 
   

Exemple : Effectuer une opération Update sur l'entité Contact Data (DateField)

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez ContactData dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

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

   Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

   Si l'intégration aboutit, la variable de sortie connectorOutputPayload de la tâche "Connecteurs" sera la suivante :

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Exemple : Effectuer une opération Update sur l'entité Contact Data (Text)

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez ContactData dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   {
   "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. "
   }
   

   Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

   Si l'intégration aboutit, la variable de sortie connectorOutputPayload de la tâche "Connecteurs" sera la suivante :

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }