Ir para o conteúdo

Conexão Airtable

Introdução

Uma conexão Airtable, criada usando o conector Airtable, estabelece acesso ao Airtable. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Airtable associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Criar ou editar uma conexão Airtable

Uma nova conexão Airtable é criada usando o conector Airtable a partir de uma destas localizações:

Uma conexão Airtable existente pode ser editada a partir destas localizações:

Configurar uma conexão Airtable

Cada elemento da interface do usuário da tela de configuração da conexão Airtable é descrito abaixo, juntamente com nossa configuração recomendada.

Configuração da conexão Airtable

Tip

Campos com um ícone variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone da variável para exibir uma lista das variáveis existentes para escolher.

  • Nome da Conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão Airtable e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint Airtable, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Esquema de Autenticação: Selecione o esquema de autorização, um dos seguintes:

    • ApiKey: Quando selecionado, os campos Chave da API e Segredo do Cliente são exibidos:

      • Chave da API: Insira sua chave da API.

      • Segredo do Cliente: Insira o segredo do cliente.

      Warning

      A autenticação por chave da API foi descontinuada pelo Airtable em 31 de janeiro de 2024.

    • PersonalAccessToken: Quando selecionado, o campo Token de Acesso OAuth é exibido:

      • Token de Acesso OAuth: Insira seu token de acesso pessoal, que você pode obter na página de Tokens (login necessário) no Airtable. Eles são recomendados se você estiver construindo integrações para si mesmo, para seu cliente ou para sua empresa.

    • OAuthPKCE: (Recomendado) Este é o método de autenticação recomendado pela Jitterbit. Você precisa de autenticação OAuth se estiver construindo uma integração Airtable para muitos usuários diferentes que precisam acessar a API Airtable em nome desses usuários. Quando selecionado, você fornece propriedades de configuração na tabela Configurações Avançadas abaixo para configurar o OAuth.

  • ID da Base: Insira o ID da base do Airtable que você deseja acessar. Você pode encontrar o ID na URL do Airtable, começando com app.

  • Ativar API de Metadados: Quando selecionado (padrão), especifica o uso da API de metadados.

  • Exibir IDs de Objetos: Quando selecionado, especifica o uso de IDs de objetos exibidos.

  • Usar Nomes Simples: Quando selecionado, especifica o uso de nomes simples.

  • Usar Configurações de Proxy: Selecione para usar as configurações de proxy de agente privado.

  • Configurações Avançadas: Quando selecionado, exibe a tabela de Propriedades de Configurações Avançadas, que é usada para adicionar propriedades de configuração adicionais como pares chave-valor.

    • Adicionar: Adiciona uma linha à tabela. Insira um par chave-valor para cada propriedade.
    • Enviar: Salva o par chave-valor na tabela. Visível ao passar o mouse sobre uma linha no modo de edição.
    • Descartar: Descartar uma nova linha ou quaisquer edições feitas em uma linha existente. Visível ao passar o mouse sobre uma linha no modo de edição.
    • Editar: Permite editar um par chave-valor existente. Visível ao passar o mouse sobre uma linha existente.
    • Excluir: Exclui a linha da tabela. Visível ao passar o mouse sobre uma linha existente.
    • Limpar Tudo: Exclui todas as linhas da tabela.

    Necessário para todas as opções do menu Esquema de Autenticação, adicione as seguintes linhas:

    Nome Valor
    BaseId Necessário apenas se não definido em ID da Base acima. Adicione o ID da base do Airtable que você deseja acessar. Você pode encontrar o ID na URL do Airtable, começando com app.
    TableNames Adicione uma lista de nomes de todas as tabelas na base do Airtable que você deseja acessar, separada por vírgulas. Você pode encontrar os nomes nas suas URLs do Airtable, começando com tbls.
    BaseName Adicione o nome da base do Airtable que você deseja acessar.

Quando o AuthScheme selecionado é OAuthPKCE, adicione as seguintes linhas:

Nome Valor
OAuthClientId Adicione o ID do cliente obtido na página de OAuth do Airtable (login necessário).
OAuthClientSecret Adicione o segredo do cliente obtido na página de OAuth do Airtable (login necessário).
InitiateOAuth Defina isso como REFRESH (recomendado) ou OFF.
OAuthAccessToken Adicione seu token de acesso. Você precisará de uma ferramenta de terceiros, como o Postman, para obter esse token.
OAuthRefreshToken (Necessário apenas se InitiateOAuth foi definido como REFRESH.) Adicione seu token de atualização. Você precisará de uma ferramenta de terceiros, como o Postman, para obter esse token.
Other Defina isso igual a OAuthSettingsLocation=, mais um caminho para um arquivo ao qual seu agente tenha acesso de gravação.
PathDelimiter (Opcional, mas recomendado.) Defina isso como um caractere não utilizado em nenhum nome de coluna nas suas tabelas de interesse, como um sublinhado _.

Nota

Os nomes de colunas e tabelas do Airtable podem conter caracteres especiais não suportados por outros serviços. Adicione a propriedade de configuração UseSimpleNames e defina como true para impor um esquema de nomenclatura restrito a caracteres alfanuméricos e sublinhados para colunas e tabelas. Caracteres não alfanuméricos são convertidos em sublinhados quando ativados.

Importante

Ao configurar a autenticação OAuth, esteja ciente destas notas importantes:

  • A configuração do OAuth funciona apenas para grupos de agentes que consistem em um único agente.

  • IDs adicionais, segredos, escopos e outros tokens de autenticação podem ser necessários para completar com sucesso a autenticação OAuth. Verifique a documentação do endpoint para informações adicionais sobre seus requisitos.

  • Os campos na tabela Propriedades de Configurações Avançadas exibem o ícone de variável apenas no modo de edição. Para que os valores das variáveis desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.

  • Os campos na tabela Propriedades de Configurações Avançadas não suportam o uso de variáveis para passar JSON bruto. Se seu caso de uso não suportar a definição de JSON bruto nos campos diretamente, escape o conteúdo JSON antes de passá-lo com uma variável. Por exemplo, escapando {"success": "true"}; torna-se {\"success\": \"true\"};.

  • Testar: Clique para verificar a conexão usando a configuração especificada. Quando a conexão é testada, a versão mais recente do conector é baixada pelos agentes no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximas etapas

Após a criação de uma conexão com o conector do Airtable, você coloca um tipo de atividade na tela de design para criar instâncias de atividade que serão usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis a partir do painel do projeto e da paleta de componentes de design. Para mais detalhes, consulte os Menus de ações em Noções básicas sobre conectores.

Estes tipos de atividade estão disponíveis:

  • Consulta: Recupera registros de uma tabela no Airtable e é destinado a ser usado como uma fonte em uma operação.

  • Criar: Insere um registro em uma tabela no Airtable e é destinado a ser usado como um alvo em uma operação.

  • Atualizar: Atualiza um registro em uma tabela no Airtable e é destinado a ser usado como um alvo em uma operação.

  • Excluir: Exclui um registro de uma tabela no Airtable e é destinado a ser usado como um alvo em uma operação.

  • Executar: Executa um procedimento no Airtable e é destinado a ser usado como um alvo em uma operação.