Box

Crawl documentos que são armazenados em uma fonte de dados da Caixa.

IBM Cloud IBM Cloud somente

Essas informações se aplicam apenas a implementações gerenciadas. Para obter mais informações sobre conexão com o Box a partir de uma implementação instalada, consulte Caixa.

Quais documentos estão engatinados

Durante o crawl inicial do conteúdo, documentos de todas as pastas que podem ser acessados do aplicativo da sua Caixa são engatinados e adicionados à sua coleção. As notas do Box são armazenadas no formato JSON, portanto, o Discovery também ingere todas as notas do Box nas pastas especificadas.

A tabela a seguir ilustra os objetos que Discovery podem engatinhar.

Suporte para rastreamento de fontes de dados
Origem de dados Suporta atualizações de documentos programados? Objetos que são rastejados
Caixa (Acesso ao App) Não Arquivos, pastas compartilhadas explicitamente
Box (acesso corporativo ) Sim (Apenas documentos novos e modificados) Arquivos, pastas

Ao configurar o Box somente com acesso ao App, deve-se criar Usuários do App e compartilhar os arquivos dos quais você deseja efetuar crawl com esses usuários Não é possível efetuar crawl em arquivos do Box que são compartilhados apenas por conta de serviço

Para obter mais informações sobre acesso, consulte estes tópicos da ajuda da documentação do Box:

Os documentos que são excluídos da Caixa não são excluídos da coleção.

Todos os conectores de origem de dados Discovery são de leitura. Independentemente das permissões que são concedidas à conta de crawl, Discovery nunca grava, atualiza ou exclui qualquer conteúdo na origem de dados original.

Requisitos da origem de dados

Além dos requisitos de origem de dados para todas as implementações gerenciadas, sua origem de dados da Caixa deve atender ao seguinte requisito:

Você deve obter quaisquer licenças de serviço necessárias para a fonte de dados com a qual você deseja se conectar. Para obter mais informações sobre licenças, entre em contato com o administrador do sistema da fonte de dados.

Etapa de pré-requisito

Você deve criar um aplicativo personalizado em Box antes de se conectar a Box a partir de Discovery.

  1. Em Box, crie um app personalizado que use Autenticação do Servidor com JWT como seu método de autenticação.

    Para obter etapas detalhadas, consulte Configuração com JWT na documentação do Box Developer.

Siga estas diretrizes ao criar o app:

  • Durante o procedimento de setup, escolha usar o método Autenticação do Servidor com JWT para verificar a identidade do aplicativo com um par de chaves.

  • Ao configurar o app personalizado, você pode optar por utilizar um dos níveis de acesso do aplicativo:

    • Apenas acesso ao app
    • Acesso do app mais acesso Corporativo

    A atualização de documentos em um planejamento é suportada apenas quando você escolhe o acesso App mais o acesso Corporativo.

    Se você configurar a conexão com o Acesso ao aplicativo, deverá criar Usuários do aplicativo e compartilhar os arquivos dos quais deseja efetuar crawl com os Usuários do aplicativo definidos. Com essa configuração, os documentos novos e modificados não são submetidos a crawl durante uma atualização

    • Se você for um administrador, configure o acesso App mais o acesso Corporativo. Caso contrário, você pode configurar o app para ter o acesso App. No entanto, você deve obter aprovação de aplicativo a partir de um administrador da Caixa.

    • Para ambos os níveis de acesso ao aplicativo, especifique as configurações a seguir:

    • Escolha os seguintes escopos:

      • Ler todas as pastas armazenadas no Box
      • Gravar todas as pastas armazenadas no Box
      • Gerenciar usuários

      Para apps com o acesso Enterprise apenas: inclua este escopo extra:

      • Gerenciar propriedades da empresa

    • Ative os seguintes recursos avançados:

      • Fazer chamadas de API usando o cabeçalho as-user
      • Gerar tokens de acesso do usuário

  • Obtenha o app personalizado autorizado por um administrador.

    Para obter mais informações, consulte Aprovação do aplicativo no Box Developer Documentation.

  • Depois que o app é criado, autorizado e a autenticação é configurada, faça o download das configurações do app como um arquivo JSON do console dev.

    Você fornece as seguintes informações a partir deste arquivo quando for solicitado posteriormente:

    • client_id
    • enterprise_id
    • client_secret
    • public_key_id
    • private_key
    • passphrase

Como conectar à fonte de dados da Caixa

Em seu projeto Discovery, conclua as seguintes etapas:

  1. A partir da pane de navegação, escolha Gerenciar coleções.

  2. Clique em New collection (Nova coleção ).

  3. Clique no link próximo a Necessidade de se conectar a uma origem de dados? clique em Caixa e, em seguida, clique em Avançar.

  4. Consulte os valores do arquivo JSON de configurações do app da Caixa que você baixou durante o procedimento anterior para completar os campos a seguir:

    ID do cliente
    A chave privada que você especifica ao configurar o aplicativo Box.
    Segredo do cliente
    O segredo do cliente que você especifica ao configurar o aplicativo Box.
    ID da Empresa
    O ID corporativo da conta Box.
    ID de chave pública
    O ID de chave pública que Box gera.
    Chave privada
    Uma parte do par de chaves que é gerada para interagir com o site da Box.
    Passphrase
    A frase secreta que é necessária para descriptografar a chave privada se a chave privada for um arquivo criptografado.

  5. Clique em Próximo.

  6. Nomeia a coleção.

  7. Se a linguagem dos documentos em Box não for o inglês, selecione a linguagem apropriada.

    Para obter uma lista de idiomas suportados, consulte Suporte ao idioma.

  8. Opcional: Alterar o cronograma de sincronização.

    Para obter mais informações, consulte Opções de planejamento de Crawl.

  9. Escolha as pastas que você deseja rastrear.

  10. Se você deseja limitar os tipos de arquivos a serem incluídos na coleção, é possível listar as extensões de arquivo para os tipos de arquivo a serem incluídos ou excluídos

    Ao escolher listar extensões para tipos de arquivo a serem excluídos, deve-se incluir pelo menos uma extensão de arquivo.

    Para obter uma lista de tipos de arquivos suportados, consulte Tipos de Arquivos Suportados

  11. Se você deseja que o web rasteje para extrair texto a partir de imagens no site, expanda Mais configurações de processamentoe configure Aplicar reconhecimento de caracteres ópticos (OCR) a On.

    Quando o OCR é ativado e seus documentos contêm imagens, o processamento demora mais. Para obter mais informações, consulte Reconhecimento de caracteres Ópticos.

  12. Clique em Finish.

A coleção é criada rapidamente. É preciso mais tempo para que os dados sejam processados conforme ele é adicionado à coleção.

Se você quiser verificar o progresso, acesse a página Atividade. A partir da pane de navegação, clique em Gerenciar coleções e, em seguida, clique para abrir a coleção.

Atualmente, nem todos os documentos são atualizados durante as reoperações planejadas. Para obter mais informações, consulte a nota sobre a liberação