Ir para o conteúdo

Conexão com Airtable

Introdução

Uma conexão com o Airtable, criada usando o conector do Airtable, estabelece acesso ao Airtable. Uma vez que uma conexão é configurada, você pode 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 com o Airtable

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

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

Configurar uma conexão com o Airtable

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

Dica

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

  • Nome da Conexão: Insira um nome para identificar a conexão. O nome deve ser único para cada conexão do Airtable e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint do 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.

      Aviso

      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 criando 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 do Airtable para muitos usuários diferentes que precisam acessar a API do 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.

  • Habilitar 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 para exibição.

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

  • Usar Configurações de Proxy: Selecione para usar 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 Esquema de Autenticação selecionado for 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 como 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 pelo(s) agente(s) 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 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 no painel do projeto e na paleta de componentes de design. Para mais detalhes, veja Menus de ações em Conceitos básicos do conector.

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.