Airtable

Exemplos de configuração de conexão

Esta seção lista os valores de exemplo para os vários campos que você configura ao criar a conexão.

Tipo de conexão do token de acesso pessoal

Entidades, operações e ações

Todos os Integration Connectors fornecem uma camada de abstração para os objetos do aplicativo conectado. Só é possível acessar os objetos de um aplicativo por esta abstração. A abstração é exposta a você como entidades, operações e ações.

• Entidade: uma entidade pode ser considerada um objeto ou um conjunto de propriedades no aplicativo ou serviço conectado. A definição de uma entidade difere de um conector para outro. Por exemplo, em um conector de banco de dados, as tabelas são as entidades, em um conector de servidor de arquivos, as pastas são as entidades e, em um conector de sistema de mensagens, as filas são as entidades.

  No entanto, é possível que um conector não aceite ou não tenha entidades. Nesse caso, a lista Entities estará vazia.

• Operação: uma operação é a atividade que pode ser realizada em uma entidade. É possível executar qualquer uma das seguintes operações em uma entidade:
  • Lista
  • Receber
  • Criar
  • Atualizar
  • Excluir

  Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para ela. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa "Conectores". No entanto, se um conector não oferecer suporte a nenhuma das operações de entidade, essas operações sem suporte não serão listadas na lista Operations.

• Ação: uma ação é uma função de primeira classe disponibilizada para a integração por meio da interface do conector. Uma ação permite fazer alterações em uma ou mais entidades e varia de um conector para outro. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que o conector não ofereça suporte a nenhuma ação. Nesse caso, a lista Actions estará vazia.

Exemplos de operação de entidade

Esta seção mostra como realizar algumas das operações de entidade neste conector.

Exemplo: operação de lista para a entidade "Dados de contato (registros)"

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Contact Data na lista Entity.
3. Selecione a operação List e clique em Concluído.
4. Na seção Entrada de tarefa da tarefa Conectores, é possível definir a filterClause de acordo com o requisito do cliente.

Sempre especifique o valor da cláusula de filtro entre aspas simples (").

Também é possível realizar operações de lista nas seguintes entidades:
Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List e Contacts Data_Collaborators

Exemplo: receber o registro da entidade "Dados de contato (registros)"

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Contact Data na lista Entity.
3. Selecione a operação GET e clique em Concluído.
4. Defina o ID da entidade como "recg7qjPRMa7DBwIb", que é a chave a ser transmitida. Para definir o ID da entidade, na seção Data Mapper do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e digite "recg7qjPRMa7DBwIb" no campo Valor de entrada e escolha o EntityId como variável local.

   Aqui, o ID da entidade: "recg7qjPRMa7DBwIb" é o valor exclusivo da chave primária e precisa ser transmitido diretamente.

Se a entidade tiver uma chave primária composta, será possível especificar uma cláusula de filtro.

Também é possível realizar a operação "get" nas seguintes entidades: Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List e Contacts Data_Collaborators.

Exemplo: excluir um registro da entidade "Dados de contato (registros)"

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Contact Data na lista Entity.
3. Selecione a operação Delete e clique em Concluído.
4. Defina o ID da entidade como "recg7qjPRMa7DBwIb", que é a chave a ser transmitida.Para definir o ID da entidade, na seção Data Mapper do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e insira "recg7qjPRMa7DBwIb" no campo Valor de entrada e escolha o EntityId como variável local.

Se a entidade tiver uma chave primária composta, será possível especificar uma cláusula de filtro.

Exemplo: criar uma operação para a entidade "Dados de contato (registros)"

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Contact Data na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

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

Exemplo: operação de atualização para a entidade "Dados de contato (registros)"

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione ContactData na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

   Em vez de especificar o entityId, você também pode definir a filterClause como Internal_Id='reckqGnFusjDlnmvs'.

Se a integração for bem-sucedida, a variável de saída connectorOutputPayload da tarefa do conector:

{
"Internal_Id": "reckqGnFusjDlnmvs"
}

Exemplo: operação de atualização para a entidade "Dados de contato (anexo)"

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Contact Data na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

   Em vez de especificar o entityId, você também pode definir a filterClause como Internal_Id='reckqGnFusjDlnmvs'.

   Se a integração for bem-sucedida, a variável de saída connectorOutputPayload da tarefa do conector:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Exemplo: operação de atualização para a entidade "Dados de contato (caixa de seleção)"

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Contact Data na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   {
   "Checkbox": true
   }
   

   Em vez de especificar o entityId, você também pode definir a filterClause como Internal_Id='reckqGnFusjDlnmvs'.

   Se a integração for bem-sucedida, a variável de saída connectorOutputPayload da tarefa do conector:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Exemplo: operação de atualização para a entidade "Dados de contato (número)"

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione ContactData na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

   {
   "Number": 1001.0
   } 
   

   Em vez de especificar o entityId, você também pode definir a filterClause como Internal_Id='reckqGnFusjDlnmvs'.

   Se a integração for bem-sucedida, a variável de saída connectorOutputPayload da tarefa do conector:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   } 
   

Exemplo: operação de atualização para a entidade "Dados de contato (DateField)"

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione ContactData na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

   Em vez de especificar o entityId, você também pode definir a filterClause como Internal_Id='reckqGnFusjDlnmvs'.

   Se a integração for bem-sucedida, a variável de saída connectorOutputPayload da tarefa do conector:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Exemplo: operação de atualização para a entidade "Dados de contato (texto)"

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione ContactData na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.

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

   Em vez de especificar o entityId, você também pode definir a filterClause como Internal_Id='reckqGnFusjDlnmvs'.

   Se a integração for bem-sucedida, a variável de saída connectorOutputPayload da tarefa do conector:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }