IBM Cloud Docs
Box

Box

Durchsuchen Sie Dokumente, die in einer Box-Datenquelle gespeichert sind.

IBM Cloud IBM Cloud nur

Diese Informationen gelten nur für verwaltete Implementierungen. Weitere Informationen zum Herstellen einer Verbindung zu Box über eine installierte Implementierung finden Sie unter Box.

Durchsuchte Dokumente

Beim ersten Durchsuchen des Inhalts werden Dokumente aus allen Ordnern, auf die über Ihre Box-Anwendung zugegriffen werden kann, durchsucht und Ihrer Objektgruppe hinzugefügt. Box-Notizen werden im JSON-Format gespeichert, sodass Discovery auch alle Box-Notizen in den angegebenen Ordnern aufnimmt.

Die folgende Tabelle zeigt die Objekte, die Discovery durchsuchen kann.

Unterstützung für das Crawling von Datenquellen
Datenquelle Unterstützt geplante Dokumentaktualisierungen? Objekte, die durchsucht werden
Box (App-Zugriff) Nein Dateien, Ordner, die Sie explizit teilen
Box (Unternehmenszugang ) Ja (nur neue und geänderte Dokumente) Dateien, Ordner

Wenn Sie Box nur mit App-Zugriff konfigurieren, müssen Sie App-Benutzer erstellen und die Dateien, die Sie durchsuchen wollen, mit diesen Benutzern teilen. Sie können keine Box-Dateien durchsuchen, die nur vom Servicekonto gemeinsam genutzt werden.

Weitere Informationen zum Zugriff finden Sie in den folgenden Hilfethemen zur Box-Dokumentation:

Aus Box gelöschte Dokumente werden nicht aus der Sammlung gelöscht.

Alle Discovery-Datenquellenconnectors sind schreibgeschützt. Unabhängig von den Berechtigungen, die dem Konto für die Crawlersuche erteilt wurden, schreibt, aktualisiert oder löscht Discovery keinen Inhalt in der ursprünglichen Datenquelle.

Datenquellenvoraussetzungen

Neben den Datenquellenanforderungen für alle verwalteten Implementierungen muss Ihre Box-Datenquelle die folgenden Anforderungen erfüllen:

Sie müssen alle erforderlichen Servicelizenzen für die Datenquelle anfordern, zu der Sie eine Verbindung herstellen möchten. Wenden Sie sich für weitere Informationen zu Lizenzen an den Systemadministrator der Datenquelle.

Vorausgesetzter Schritt

Sie müssen eine angepasste Anwendung in Box erstellen, bevor Sie über Discoveryeine Verbindung zu Box herstellen können.

  1. Erstellen Sie in Box eine angepasste App, die Serverauthentifizierung mit JWT als Authentifizierungsmethode verwendet.

    Ausführliche Schritte finden Sie unter Setup with JWT in der Dokumentation zu Box Developer.

Beachten Sie beim Erstellen der App die folgenden Richtlinien:

  • Wählen Sie während der Setup-Prozedur die Methode Serverauthentifizierung mit JWT aus, um die Anwendungsidentität mit einem Schlüsselpaar zu überprüfen.

  • Wenn Sie die angepasste App konfigurieren, können Sie eine der Anwendungszugriffsebenen verwenden:

    • Nur App-Zugriff
    • App-Zugriff plus Unternehmenszugriff

    Die Aktualisierung von Dokumenten nach einem Zeitplan wird nur unterstützt, wenn Sie App-Zugriff plus Unternehmenszugriff auswählen.

    Wenn Sie die Verbindung mit App-Zugriff einrichten, müssen Sie App-Benutzer erstellen und die Dateien, die Sie durchsuchen wollen, mit den App-Benutzern teilen, die Sie definieren. Bei dieser Konfiguration werden neue und geänderte Dokumente während einer Aktualisierung nicht durchsucht.

    • Wenn Sie ein Administrator sind, konfigurieren Sie App-Zugriff plus Unternehmenszugriff. Andernfalls können Sie die App für den App-Zugriff konfigurieren. Sie müssen jedoch die Anwendungsgenehmigung von einem Box-Administrator erhalten.

    • Geben Sie für beide Anwendungszugriffsebenen die folgenden Einstellungen an:

    • Wählen Sie die folgenden Bereiche aus:

      • Alle in Box gespeicherten Ordner lesen
      • Alle in Box gespeicherten Ordner schreiben
      • Benutzer verwalten

      Nur für Apps mit Unternehmenszugriff: Fügen Sie diesen zusätzlichen Bereich hinzu:

      • Verwaltung von Unternehmensimmobilien
    • Aktivieren Sie die folgenden erweiterten Funktionen:

      • API-Aufrufe mit dem "as-user"-Header durchführen
      • Erstellen Sie Benutzerzugriffstoken
  • Rufen Sie die von einem Administrator autorisierte angepasste App ab.

    Weitere Informationen finden Sie unter App-Genehmigung in der Dokumentation zu Box Developer.

  • Nachdem die App erstellt, berechtigt und die Authentifizierung konfiguriert wurde, laden Sie die App-Einstellungen als JSON-Datei von der Einheitenkonsole herunter.

    Sie geben die folgenden Informationen aus dieser Datei an, wenn sie später angefordert werden:

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

Verbindung zur Box-Datenquelle herstellen

Führen Sie die folgenden Schritte für Ihr Discovery-Projekt aus:

  1. Wählen Sie im Navigationsfenster Sammlungen verwalten aus.

  2. Klicken Sie auf "Neue Kollektion ".

  3. Klicken Sie auf den Link neben Sie müssen eine Verbindung zu einer Datenquelle herstellen? klicken Sie auf Feld und anschließend auf Weiter.

  4. Verwenden Sie die Werte aus der JSON-Datei mit den Box-App-Einstellungen, die Sie während der vorherigen Prozedur heruntergeladen haben, um die folgenden Felder auszufüllen:

    Client-ID
    Der private Schlüssel, den Sie bei der Konfiguration Ihrer Box-App angeben.
    Geheimer Clientschlüssel
    Das Kundengeheimnis, das Sie bei der Konfiguration Ihrer Box-App angeben.
    Unternehmens-ID
    Die Unternehmens-ID des Box-Kontos.
    ID für öffentlichen Schlüssel
    Die von Box generierte ID des öffentlichen Schlüssels.
    Privater Schlüssel
    Ein Teil des Schlüsselpaares, das für die Interaktion mit der Box-Website generiert wird.
    Kennphrase
    Die Passphrase, die zum Entschlüsseln des privaten Schlüssels erforderlich ist, wenn der private Schlüssel eine verschlüsselte Datei ist.
  5. Klicken Sie auf Weiter.

  6. Benennen Sie die Objektgruppe.

  7. Wenn die Sprache der Dokumente in Box nicht Englisch ist, wählen Sie die entsprechende Sprache aus.

    Eine Liste der unterstützten Sprachen finden Sie unter Sprachunterstützung.

  8. Optional: Ändern Sie den Synchronisationszeitplan.

    Weitere Informationen finden Sie unter Zeitplanoptionen für die Crawlersuche.

  9. Wählen Sie die Ordner aus, die durchsucht werden sollen.

  10. Wenn Sie die Dateitypen begrenzen wollen, die der Objektgruppe hinzugefügt werden sollen, können Sie die Dateierweiterungen für einzuschließende oder auszuschließende Dateitypen auflisten.

    Wenn Sie Erweiterungen für auszuschließende Dateitypen auflisten möchten, müssen Sie mindestens eine Dateierweiterung hinzufügen.

    Eine Liste der unterstützten Dateitypen finden Sie unter Unterstützte Dateitypen.

  11. Wenn die Web-Crawler-Suche Text aus Bildern auf der Site extrahieren soll, erweitern Sie Weitere Verarbeitungseinstellungenund legen Sie Optische Zeichenerkennung (OCR) anwenden auf On fest.

    Wenn OCR aktiviert ist und Ihre Dokumente Bilder enthalten, dauert die Verarbeitung länger. Weitere Informationen finden Sie unter Optische Zeichenerkennung.

  12. Klicken Sie auf Beenden.

Die Objektgruppe wird schnell erstellt. Es dauert länger, bis die Daten verarbeitet werden, wenn sie der Objektgruppe hinzugefügt werden.

Wenn Sie den Fortschritt überprüfen möchten, rufen Sie die Seite 'Aktivität' auf. Klicken Sie im Navigationsfenster auf Sammlungen verwalten und anschließend auf, um die Sammlung zu öffnen.

Derzeit werden nicht alle Dokumente während geplanter erneuter Rawls aktualisiert. Weitere Informationen finden Sie in der Releaseinformationen.