Ir para o conteúdo

Conector Microsoft Excel v2 para Jitterbit Studio

Resumo

O conector Microsoft Excel v2 estabelece acesso ao Microsoft Excel.

O conector Microsoft Excel v2 fornece uma interface para criar uma conexão Microsoft Excel v2, a base utilizada para gerar instâncias de atividades do Microsoft Excel v2. Essas atividades, uma vez configuradas, interagem com o Microsoft Excel através da conexão.

O conector Microsoft Excel v2 é acessado na aba Endpoints e conectores do projeto do painel de componentes de design (veja Painel de componentes de design).

AVISO: Embora o conector seja capaz de extrair dados de arquivos do Excel hospedados em uma variedade de armazenamentos de dados em nuvem usando sua atividade Consulta, as atividades Criar, Atualizar e Excluir não são suportadas fora de arquivos locais neste conector. Veja Estabelecendo uma conexão para mais detalhes.

Problema conhecido

Os conectores Excel e Excel v2 não são compatíveis com a versão 12.x do agente privado. Após a atualização para um agente 12.x, os testes de conexão e operações falham com o erro HttpErrorResponse: Este conector não foi encontrado no Agente Jitterbit. Por favor, tenha paciência enquanto o conector é baixado entre os agentes. Isso pode levar até vários minutos. Para recuperar, faça o downgrade para a versão 11.59 do agente privado ou anterior. Uma correção está planejada para uma futura versão. Para mais detalhes, veja Problemas conhecidos do agente privado.

Nota

Este conector pode ser usado apenas com agentes privados. Além disso, é um conector baseado no SDK de Conector, que pode ser mencionado pela Jitterbit ao comunicar alterações feitas em conectores construídos com o SDK de Conector.

Os endpoints criados com este conector estão incluídos na reportagem de uso de endpoints e contam para sua licença.

Documentação de Conexão

Além da conexão Microsoft Excel v2, consulte a página abrangente de detalhes da conexão Microsoft Excel v2. Detalhes de configuração como estes estão incluídos nessa página:

  • Introdução: Passos iniciais para estabelecer uma conexão.
  • Recursos Avançados: Visualizações definidas pelo usuário e configuração SSL.
  • Modelo de Dados: O modelo de dados que o conector usa para representar o endpoint.
  • Propriedades de Configurações Avançadas: Propriedades que podem ser definidas para configurar uma conexão para configurações básicas e avançadas.

Documentação de Atividade

Juntos, uma conexão específica do Microsoft Excel v2 e suas atividades são referidos como um endpoint do Microsoft Excel:

Tipos de atividades do Microsoft Excel V2

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

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

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

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

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

Pré-requisitos e versões de API suportadas

O conector do Microsoft Excel v2 requer o uso de uma versão do agente 10.1 ou posterior. Essas versões do agente baixam automaticamente a versão mais recente do conector quando necessário.

Este conector requer o uso de um agente privado.

Consulte a documentação do endpoint para obter informações sobre os nós e campos do esquema.

Autenticação OAuth

A autenticação OAuth é suportada conforme descrito em Configurar conexões OAuth.

Solução de problemas

Se você encontrar problemas com o conector do Microsoft Excel v2, as seguintes etapas de solução de problemas são recomendadas:

  1. Clique no botão Testar na configuração da conexão para garantir que a conexão seja bem-sucedida e que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política organizacional Desativar Atualização Automática do Conector).

  2. Certifique-se de que quaisquer registros de aplicativos do Microsoft Entra ID associados à conexão não estejam usando o Azure AD Graph obsoleto.

  3. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

  4. Ative o registro de depuração de operações para agentes privados para gerar arquivos de log e dados adicionais.

  5. Ative o registro detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

<logger name="org.jitterbit.connector.verbose.logging.Excel" level="TRACE"/>

Para mais informações sobre o registro detalhado do conector, consulte Registro detalhado para conectores usando agentes privados do Jitterbit.

  1. Verifique os logs do agente para mais informações.

  2. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.