Ir para o conteúdo

Conector Box no Jitterbit Studio

Resumo

O conector Box estabelece acesso ao 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 através da conexão.

Acessa-se o conector Box a partir da aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta do componente de design (consulte Design component palette).

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 destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

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

Tipos de atividade Box

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

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

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

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

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

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

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

Essas atividades podem ser usadas apenas com objetos File:

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

  • Upload File: Carrega um arquivo no Box e é destinada a ser usada como destino em uma operação.

  • Update File: Atualiza um arquivo no Box e é destinada a ser usada como destino em uma operação.

  • Delete File: Exclui um arquivo do Box e é destinada a ser usada como destino em uma operação.

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

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes na nuvem e 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 organizacional Disable Auto Connector Update.

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

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, recomenda-se seguir estas etapas de solução de problemas:

  1. Clique no botão Test 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 no agente (a menos que esteja usando a política organizacional Disable Auto Connector Update).

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

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

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

    Para mais informações sobre log detalhado do conector, consulte Log 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.