Conector de Box¶

Resumo¶

O Harmony Box Connector 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 Conexões 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 atividades associados a essa conexão são então usados para criar instâncias de atividades que se destinam a serem usadas como origens (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

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

Essas atividades podem ser usadas com qualquer Box API objeto:

• Procurar: Pesquisa conteúdo correspondente no Box e destina-se a ser usado como fonte em uma operação.

• Consulta: Consulta dados de objetos do Box e se destina a ser usado como fonte em uma operação.

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

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

• Cópia de: Copia um arquivo ou pasta no Box e deve ser usado como destino em uma operação.

• Atualizar: Atualiza os dados do objeto no Box e destina-se a ser usado como alvo em uma operação.

Estas atividades podem ser usadas somente com objetos Arquivo:

• ⇬ Fazer download do arquivo: Baixa um arquivo do Box e se destina a ser usado como fonte em uma operação.

• Subir arquivo: Carrega um arquivo no Box e deve ser usado como destino 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.

Pré-requisitos e Versões de API Suportadas¶

O conector Box requer o uso de uma versão do agente 10.1 ou mais tarde. 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 da conexão para garantir que a conexão seja bem-sucedida e garantir que a versão mais recente do conector seja baixada para o agente (a menos que você use a Desativar atualização automática do conector política da organização).

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

3. Habilite o registro de depurar de 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 registro detalhado do conector para este conector usando esta entrada de configuração específica de nome e nível do criador de logs:

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

5. Se estiver usando Agentes Privados, você pode verificar os logs do agente Para maiores informações.