Quels documents sont explorés

Lors de l'exploration initiale du contenu, les documents de tous les dossiers accessibles à partir de votre application Box sont explorés et ajoutés à votre collection. Les notes de Box étant stockées au format JSON, Discovery ingère également toutes les notes de Box dans les dossiers spécifiés.

Le tableau suivant illustre les objets que Discovery peut explorer.

Lorsque vous configurez Box avec accès à l'application uniquement, vous devez créer des utilisateurs d'application et partager les fichiers que vous souhaitez explorer avec ces utilisateurs. Vous ne pouvez pas explorer les fichiers Box qui sont partagés uniquement par le compte de service.

Pour plus d'informations sur l'accès, voir les rubriques d'aide de la documentation Box suivantes:

• utilisateurs d'application
• Comptes de service

Les documents supprimés de Box ne sont pas supprimés de la collection.

Tous les connecteurs de source de données Discovery sont en lecture seule. Quels que soient les droits accordés au compte d'exploration, Discovery n'écrit, ne met à jour ou ne supprime jamais de contenu dans la source de données d'origine.

Configuration requise pour les sources de données

Outre les exigences de source de données pour tous les déploiements gérés, votre source de données Box doit répondre aux exigences suivantes:

Vous devez obtenir les licences de service requises pour la source de données à laquelle vous souhaitez vous connecter. Pour plus d'informations sur les licences, contactez l'administrateur système de la source de données.

Etape de prérequis

Vous devez créer une application personnalisée dans Box avant de pouvoir vous connecter à Box à partir de Discovery.

1. Dans Box, créez une application personnalisée qui utilise Server Authentication with JWT comme méthode d'authentification.

   Pour connaître les étapes détaillées, voir Configuration avec JWT dans la documentation de Box Developer.

Suivez ces instructions lorsque vous créez l'application:

• Au cours de la procédure de configuration, choisissez d'utiliser la méthode Server Authentication with JWT pour vérifier l'identité de l'application avec une paire de clés.

• Lorsque vous configurez l'application personnalisée, vous pouvez choisir d'utiliser l'un des niveaux d'accès à l'application:

  • Accès à l'application uniquement
  • Accès à l'application plus accès à l'entreprise

  L'actualisation des documents sur une planification est prise en charge uniquement lorsque vous sélectionnez Accès à l'application plus Accès à l'entreprise.

  Si vous configurez la connexion avec App access, vous devez créer des utilisateurs d'application et partager les fichiers que vous souhaitez explorer avec les utilisateurs d'application que vous définissez. Avec cette configuration, les documents nouveaux et modifiés ne sont pas explorés lors d'une actualisation.

  • Si vous êtes administrateur, configurez App access plus Enterprise access. Sinon, vous pouvez configurer l'application pour qu'elle dispose d'un accès à l'application. Toutefois, vous devez obtenir l'approbation de la demande auprès d'un administrateur Box.

  • Pour les deux niveaux d'accès à l'application, spécifiez les paramètres suivants:

  • Choisissez les portées suivantes:

    • Lire tous les dossiers stockés dans Box
    • Écrire tous les dossiers stockés dans Box
    • Gérer les utilisateurs

    Pour les applications avec accès Enterprise uniquement: ajoutez cette portée supplémentaire:

    • Gérer les propriétés de l'entreprise

  • Activer les fonctions avancées suivantes :

    • Effectuer des appels API en utilisant l'en-tête as-user
    • Générer des jetons d'accès utilisateur

• Obtenez l'application personnalisée autorisée par un administrateur.

  Pour plus d'informations, voir Approbation d'application dans la documentation Box Developer.

• Une fois l'application créée, autorisée et l'authentification configurée, téléchargez les paramètres de l'application sous forme de fichier JSON à partir de la console de développement.

  Vous fournissez les informations suivantes à partir de ce fichier lorsqu'il est demandé ultérieurement:

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

Connexion à la source de données Box

A partir de votre projet Discovery, effectuez les étapes suivantes :

1. Dans le panneau de navigation, sélectionnez Gestion des collections.

2. Cliquez sur Nouvelle collection.

3. Cliquez sur le lien en regard de Besoin de se connecter à une source de données? , cliquez sur Box, puis sur Next.

4. Reportez-vous aux valeurs du fichier JSON des paramètres d'application Box que vous avez téléchargé lors de la procédure précédente pour renseigner les zones suivantes:

   ID de client

   La clé privée que vous spécifiez lorsque vous configurez votre application Box.

   Valeur confidentielle du client

   Le secret client que vous spécifiez lorsque vous configurez votre application Box.

   ID d'entreprise

   L'identifiant d'entreprise du compte Box.

   ID de clé publique

   ID de clé publique généré par Box.

   Clé privée

   Partie de la paire de clés générée pour interagir avec le site web de la Box.

   Phrase passe

   Phrase de passe requise pour décrypter la clé privée si celle-ci est un fichier crypté.

5. Cliquez sur Suivant.

6. Attribuez un nom à la collection.

7. Si la langue des documents dans Box n'est pas l'anglais, sélectionnez la langue appropriée.

   Pour obtenir la liste des langues prises en charge, voir Langues prises en charge.

8. Facultatif: modifiez la planification de synchronisation.

   Pour plus d'informations, voir Options de planification d'exploration.

9. Choisissez les dossiers que vous souhaitez explorer.

10. Si vous souhaitez limiter les types de fichier à ajouter à la collection, vous pouvez répertorier les extensions de fichier pour les types de fichier à inclure ou à exclure.

    Lorsque vous choisissez de répertorier les extensions des types de fichier à exclure, vous devez ajouter au moins une extension de fichier.

    Pour obtenir la liste des types de fichier pris en charge, voir Types de fichier pris en charge.

11. Si vous souhaitez que l'exploration Web extraie du texte à partir des images du site, développez Plus de paramètres de traitementet définissez Appliquer la reconnaissance optique des caractères (OCR) sur On.

    Lorsque la reconnaissance optique des caractères est activée et que vos documents contiennent des images, le traitement prend plus de temps. Pour plus d'informations, voir Reconnaissance optique des caractères.

12. Cliquez sur Terminer.

La collection est créée rapidement. Le traitement des données à mesure qu'elles sont ajoutées à la collection prend plus de temps.

Si vous souhaitez vérifier la progression, accédez à la page Activité. Dans le panneau de navigation, cliquez sur Gérer les collections, puis cliquez pour ouvrir la collection.

Actuellement, tous les documents ne sont pas actualisés lors des réexplorations planifiées. Pour plus d'informations, voir la note sur l'édition.