Airtable

Exemples de configuration de connexion

Cette section présente des exemples de valeurs pour les différents champs que vous configurez lors de la création de 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 via 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é. 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, dans un connecteur de serveur de fichiers, les dossiers sont les entités et, dans un connecteur de système de messagerie, les files d'attente sont les entités.

  Toutefois, il est possible qu'un connecteur ne soit pas compatible 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é. Vous pouvez effectuer l'une des opérations suivantes sur une entité :
  • Liste
  • Obtenir
  • Créer
  • Mettre à jour
  • Supprimer

  La sélection d'une entité dans la liste disponible 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 de connecteur. Toutefois, si un connecteur n'est pas compatible avec l'une des opérations d'entité, ces opérations non compatibles ne sont pas listées dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration via 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 ne prenne en charge 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 : Opération de liste pour l'entité "Données de contact (enregistrements)"

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 Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), vous pouvez définir la filterClause conformément aux exigences du client.

Spécifiez toujours la valeur de la clause de filtre entre guillemets simples (').

Vous pouvez également effectuer des opérations de liste 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 : Obtenir un enregistrement pour l'entité "Données de contact (enregistrements)"

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 de l'entité sur "recg7qjPRMa7DBwIb", qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Data Mapper (Mappeur de données) de Data Mapping (Mappage de données), cliquez sur Open Data Mapping Editor (Ouvrir l'éditeur de mappage de données), puis saisissez "recg7qjPRMa7DBwIb" dans le champ Input Value (Valeur d'entrée) et choisissez EntityId comme variable locale.

   Ici, l'ID d'entité: "recg7qjPRMa7DBwIb" est la valeur de clé primaire unique et 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 de récupération 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é "Données de contact (enregistrements)"

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 de l'entité sur "recg7qjPRMa7DBwIb", qui est la clé à transmettre.Pour définir l'ID de l'entité, dans la section Data Mapper (Mappeur de données) de Data Mapping (Mappage de données), cliquez sur Open Data Mapping Editor (Ouvrir l'éditeur de mappage de données), puis saisissez "recg7qjPRMa7DBwIb" dans le champ Input Value (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 : Opération de création pour l'entité "Données de contact (enregistrements)"

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 (Mappeur de données) de la tâche Data Mapping (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 votre tâche de connecteur aura une valeur semblable à celle-ci:

   {
   "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 : Opération de mise à jour pour l'entité "Données de contact (enregistrements)"

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 (Mappeur de données) de la tâche Data Mapping (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"
   }
   

   Plutôt que de spécifier le entityId, vous pouvez également définir le filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

Si l'intégration réussit, la variable de sortie connectorOutputPayload de votre tâche de connecteur:

{
"Internal_Id": "reckqGnFusjDlnmvs"
}

Exemple : Opération de mise à jour de l'entité "Données de contact (pièce jointe)"

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 (Mappeur de données) de la tâche Data Mapping (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\"}]"
   }
   

   Plutôt que de spécifier le entityId, vous pouvez également définir le filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

   Si l'intégration réussit, la variable de sortie connectorOutputPayload de votre tâche de connecteur:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Exemple : Opération de mise à jour pour l'entité "Données de contact (case à cocher)"

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 (Mappeur de données) de la tâche Data Mapping (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
   }
   

   Plutôt que de spécifier le entityId, vous pouvez également définir le filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

   Si l'intégration réussit, la variable de sortie connectorOutputPayload de votre tâche de connecteur:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Exemple : Opération de mise à jour de l'entité "Données de contact (numéro)"

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 (Mappeur de données) de la tâche Data Mapping (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
   } 
   

   Plutôt que de spécifier le entityId, vous pouvez également définir le filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

   Si l'intégration réussit, la variable de sortie connectorOutputPayload de votre tâche de connecteur:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   } 
   

Exemple : Opération de mise à jour pour l'entité "Données de contact (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 (Mappeur de données) de la tâche Data Mapping (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"
   } 
   

   Plutôt que de spécifier le entityId, vous pouvez également définir le filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

   Si l'intégration réussit, la variable de sortie connectorOutputPayload de votre tâche de connecteur:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Exemple : Opération de mise à jour pour l'entité "Données de contact (texte)"

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 (Mappeur de données) de la tâche Data Mapping (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. "
   }
   

   Plutôt que de spécifier le entityId, vous pouvez également définir le filterClause sur Internal_Id='reckqGnFusjDlnmvs'.

   Si l'intégration réussit, la variable de sortie connectorOutputPayload de votre tâche de connecteur:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }