Ir para o conteúdo

Conexão Airtable

Introdução

Uma conexão Airtable, criada usando o conector Airtable, estabelece acesso a Airtable. Depois que uma conexão é configurada, você pode criar instâncias de atividades do Airtable associadas a essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Crie Ou Edite uma Conexão Airtable

Uma nova conexão Airtable é criada usando o conector Airtable de um destes locais:

Uma conexão Airtable existente pode ser editada a partir destes locais:

Configurar uma Conexão Airtable

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

Configuração de conexão do Airtable

Dica

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

  • Nome da conexão: Insira um nome para usar 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 do Airtable, que se refere tanto a uma conexão específica quanto às suas atividades.

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

    • ApiKey: Quando selecionados, os campos API Key e Client Secret são exibidos:

      • Chave de API: Insira sua chave de API.

      • Segredo do cliente: Insira o segredo do cliente.

      Aviso

      Autenticação de chave de API foi descontinuada por Airtable em 31 de janeiro de 2024.

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

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

    • OAuthPKCE: (Recomendado) Este é o método de autenticação recomendado pelo Jitterbit. Você precisa de autenticação OAuth se você 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 Airtable que você deseja acessar. Você pode encontrar o ID no URL do Airtable, começando com app.

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

  • Exibir IDs de objeto: Quando selecionado, especifica o uso de IDs de objeto de 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 do agente privado.

  • Configurações avançadas: Quando selecionado, mostra a tabela Propriedades de configurações avançadas, que é usada para adicionar propriedades de configuração adicionais como pares chave-valor. Clique no ícone adicionar ícone adicionar para adicionar uma linha à tabela abaixo e inserir um par chave-valor para cada propriedade.

    Obrigatório para todas as opções de menu Esquema de autenticação, adicione as seguintes linhas:

    Nome Valor
    BaseId Obrigatório somente se não definido em ID base acima. Adicione o ID da base Airtable que você deseja acessar. Você pode encontrar o ID no URL do Airtable, começando com app.
    TableNames Adicione uma lista separada por vírgulas de todos os nomes de tabelas na base Airtable que você deseja acessar. Você pode encontrar os nomes em seus URLs Airtable, começando com tbls.
    BaseName Adicione o nome da base Airtable que você deseja acessar.

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

    Nome Valor
    OAuthClientId Adicione o ID do cliente obtido do Airtable OAuth página (é necessário fazer login).
    OAuthClientSecret Adicione o segredo do cliente obtido do Airtable OAuth página (é necessário fazer login).
    InitiateOAuth Defina isso para REFRESH(recomendado) ou OFF.
    OAuthAccessToken Adicione seu token de acesso. Você precisará de uma ferramenta de externo, como Postman, para obter este token.
    OAuthRefreshToken (Obrigatório somente se InitiateOAuth foi definido para REFRESH.) Adicione seu token de atualização. Você precisará de uma ferramenta de externo, como Postman, para obter este token.
    Other Defina isso igual a OAuthSettingsLocation=, além de um caminho para um arquivo que seu agente tem acesso de gravação.
    PathDelimiter (Opcional, mas recomendado.) Defina isso como um caractere não usado em nenhum nome de coluna em suas tabelas de interesse, como um sublinhado _.

    Para salvar a linha, clique no ícone de envio ícone de envio na coluna mais à direita.

    Para editar ou excluir uma única linha, passe o mouse sobre a coluna mais à direita e use o ícone de edição ícone de edição ou excluir ícone excluir ícone.

    Para excluir todas as linhas, clique em Limpar tudo.

    Importante

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

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

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

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

  • Teste: 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 a suspensão do download da versão mais recente do conector usando a Desabilitar atualização automática do conector política da organização.

  • Salvar alterações: Clique para salvar e fechar a configuração de 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 (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximos Passos

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

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

Esses tipos de atividade estão disponíveis:

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

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

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

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

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