Ir para o conteúdo

Conector Microsoft Excel no Jitterbit Studio

Resumo

O conector Microsoft Excel estabelece acesso ao Microsoft Excel.

Importante

Recomendamos usar o conector Microsoft Excel v2 para conectar ao Microsoft Excel, pois permite propriedades de configuração adicionais.

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

Acessa-se o conector Microsoft Excel a partir da aba Endpoints de projeto e conectores da paleta de componentes de design (consulte Paleta de componentes de design).

AVISO: Embora o conector seja capaz de extrair dados de arquivos Excel hospedados em uma variedade de armazenamentos de dados em nuvem usando sua atividade Query, as atividades Create, Update e Delete não são suportadas fora de arquivos locais neste conector. Consulte Estabelecendo uma conexão para 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 atualizar para um agente versão 12.x, testes de conexão e operações falham com o erro HttpErrorResponse: This connector was not found on the Jitterbit Agent. Please be patient with us while the connector is downloaded across the agents. This may take up to several minutes. Para recuperar, faça downgrade para a versão 11.59 do agente privado ou anterior. Uma correção está planejada para uma versão futura. Para detalhes, consulte Problemas conhecidos do agente privado.

Os endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.

Documentação de conexão

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

  • Primeiros passos: Etapas iniciais para estabelecer uma conexão.
  • Recursos avançados: Visualizações definidas pelo usuário e configuração de 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 atividades

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

Tipos de atividades do Microsoft Excel

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

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

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

  • Delete: 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 destino em uma operação.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado apenas com agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política de organização Desabilitar Atualização Automática de Conector.

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

Autenticação OAuth

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

Solução de problemas

Se você enfrentar problemas com o conector Microsoft Excel, recomenda-se seguir estas etapas de solução de problemas:

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

  2. Certifique-se de que qualquer registro de aplicativo do Microsoft Entra ID associado à conexão não esteja usando o Azure AD Graph descontinuado.

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

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

  5. Ative o log 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 obter mais informações sobre log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.

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

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