Ir para o conteúdo

Conector Box para Jitterbit Integration Studio

Resumo

O conector Box estabelece acesso ao Box.

O conector Box fornece uma interface para criar uma conexão Box, a base utilizada 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 do painel de componentes de design (veja Painel de componentes de design).

Visão geral do conector

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

Juntos, uma conexão Box específica e suas atividades são referidos como um endpoint Box:

Tipos de atividades Box

Essas atividades podem ser usadas com qualquer objeto da API Box:

  • Pesquisar: Pesquisa por conteúdo correspondente no Box e é destinada a ser usada como uma fonte em uma operação.

  • Consultar: Consulta dados de objetos do Box e é destinada a ser usada como uma fonte em uma operação.

  • Criar: Cria dados de objetos no Box e é destinada a ser usada como um alvo em uma operação.

  • Excluir: Exclui dados de objetos do Box e é destinada a ser usada como um alvo em uma operação.

  • Copiar: Copia um arquivo ou pasta no Box e é destinada a ser usada como um alvo em uma operação.

  • Atualizar: Atualiza dados de objetos no Box e é destinada a ser usada como um alvo em uma operação.

Essas atividades podem ser usadas apenas com objetos de arquivo:

  • Baixar Arquivo: Baixa um arquivo do Box e é destinada a ser usada como uma fonte em uma operação.

  • Fazer Upload de Arquivo: Faz o upload de um arquivo no Box e é destinado a ser usado como um alvo em uma operação.

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

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

Nota

Este conector é um conector baseado no Connector SDK, que pode ser mencionado pela Jitterbit ao comunicar alterações feitas em conectores construídos com o Connector SDK.

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

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 de agente baixam automaticamente a versão mais recente do conector quando necessário.

O conector Box utiliza a Box API. 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 nos pré-requisitos do Box:

  • Um aplicativo personalizado autorizado do Box 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ê encontrar problemas com o conector Box, estas 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 para garantir que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política de organização Desabilitar Atualização Automática do Conector).

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

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

  4. Se estiver usando agentes privados, você pode ativar 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.box" level="DEBUG"/>
    

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

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

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