Ir para o conteúdo

Conector de Box para Jitterbit Integration Studio

Resumo

O conector Box estabelece acesso a Box.

O conector Box fornece uma interface para criar uma conexão Box, a base usada para gerar instâncias de atividades Box. Essas atividades, uma vez configuradas, interagem com o Box por meio da conexão.

O conector Box é acessado na aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão Box. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades que devem ser usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Juntos, uma conexão específica do Box e suas atividades são chamadas de endpoint do Box:

Tipos de atividade de Box

Essas atividades podem ser usadas com qualquer Box API objeto:

  • Pesquisar: Pesquisa conteúdo correspondente no Box e deve ser usado como fonte em uma operação.

  • Consulta: Consulta dados de objeto do Box e deve ser usado como fonte em uma operação.

  • Criar: Cria dados de objeto no Box e se destina a ser usado como um alvo em uma operação.

  • Excluir: Exclui dados de objeto do Box e deve ser usado como um alvo em uma operação.

  • Copiar: Copia um arquivo ou pasta no Box e deve ser usado como alvo em uma operação.

  • Atualizar: Atualiza dados de objeto no Box e deve ser usado como um alvo em uma operação.

Essas atividades podem ser usadas somente com objetos File:

  • Baixar arquivo: Faz o download de um arquivo do Box e se destina a ser usado como fonte em uma operação.

  • Carregar arquivo: Carrega um arquivo no Box e deve ser usado como alvo em uma operação.

  • Atualizar arquivo: Atualiza um arquivo no Box e deve ser usado como alvo em uma operação.

  • Excluir arquivo: Exclui um arquivo do Box e deve ser usado como alvo em uma operação.

Nota

Este conector é um Connector SDK, que pode ser consultado pelo Jitterbit ao comunicar alterações feitas em conectores criados com o Connector SDK.

Pré-requisitos e versões de API suportadas

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

O conector Box usa o Box Java SDK v2.28.1 e API de Box. Consulte a documentação para obter informações sobre os nós e campos do esquema.

Para usar o conector Box, você precisa do seguinte, conforme descrito em Pré-requisitos do Box:

  • Um aplicativo personalizado Box autorizado com autenticação JWT.
  • O clientID, clientSecret, publicKeyID, privateKey, e passphrase do arquivo JSON baixado automaticamente durante a criação do aplicativo.
  • O ID do usuário associado ao aplicativo.

Solução de problemas

Se você tiver problemas com o conector Box, estas etapas de solução de problemas são recomendadas:

  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 para o agente (a menos que esteja usando a Desativar atualização automática do conector política da organização).

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

  3. Habilite o registro de depurar da operação (para agentes de nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode habilitar registro detalhado do conector para este conector adicionando esta entrada de configuração do registrador ao do seu agente privado logback.xml arquivo:

    <logger name="org.jitterbit.connector.verbose.logging.box" level="DEBUG"/>
    

    Para obter mais informações sobre o registro detalhado de conectores, consulte Registro detalhado para conectores que usam agentes privados Jitterbit.

  5. Se estiver usando agentes privados, você pode verificar os registros do agente para obter mais informações.

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