Box

搜索儲存在 Box 資料來源中的文件。

IBM Cloud Pak for Data IBM Software Hub

此資訊僅適用於已安裝的部署。 如需從受管理部署連接至 Box 的相關資訊，請參閱 Box。

搜索哪些文件

  • 只有您 Box 資料夾中 Discovery 支援的文件才會被抓取；其他文件都會被忽略。 如需相關資訊，請參閱 支援的檔案類型。
  • 只有配置為使用 App + Enterprise Access 作為 Box 應用程式應用程式存取層次的連接器才支援文件層次安全。 啟用此選項後，您的使用者可以抓取和查詢他們登入 Box 時可以存取的相同內容。 如需相關資訊，請參閱 支援文件層次安全。
  • 當重新抓取來源時，會新增文件，更新的文件會修改為目前的版本，而刪除的文件則會從集合的索引中刪除。
  • 所有 Discovery 資料來源連接器都是唯讀的。 不論授與搜索帳戶的許可權為何，Discovery 絕不會寫入、更新或刪除原始資料來源中的任何內容。
  • Box 筆記以 JSON 格式儲存，因此 Discovery 也會擷取指定資料夾中的任何 Box 筆記。

資料來源需求

除了所有已安裝部署的 資料來源需求 之外，您的 Box 資料來源還必須符合下列需求:

  • 您必須針對您要連接的資料來源取得任何必要的服務授權。 如需授權的相關資訊，請聯絡資料來源的系統管理者。

必要步驟

如果您想要啟用文件層次安全，則必須採取一些步驟來設定它。 如需相關資訊，請參閱關於文件層次安全。

您必須先在 Box 中建立自訂應用程式，然後才能從 Discovery連接至 Box。 任何人都可以建立自訂應用程式，但只有 Box 管理者才能授權。

若要建立自訂應用程式，請完成下列步驟：

  1. 請確定您有 Box 帳戶。 在此處理程序期間，您會取得配置檔及用戶端 ID。

  2. 接下來，建立使用 使用 JWT 進行伺服器鑑別 作為其鑑別方法的自訂應用程式。

    如需詳細步驟，請參閱 Box 開發人員文件中的 Setup with JWT。

    當您建立應用程式時，請遵循下列準則:

    1. 在設定程序期間，選擇使用 使用 JWT 進行伺服器鑑別 方法，以使用金鑰組來驗證應用程式身分。

    2. 為您要搜索的 Box 內容選擇適當的存取層次:

      • 與受管理使用者共用的 Box 檔案: 應用程式存取權加上企業存取權
      • 與服務帳戶共用的 Box 檔案: 僅限應用程式存取
      • 與服務帳戶及其應用程式使用者共用的 Box 檔案: 僅限應用程式存取

      4.6 版已新增對僅使用應用程式存取權來配置 Box 層次存取的支援。

    3. 遵循應用程式存取層次類型的適當步驟來配置存取層次:

      • 應用程式存取權加上企業存取權

        選擇下列應用程式範圍：

        • 讀取儲存於 Box 的所有資料夾
        • 寫入儲存於 Box 的所有資料夾
        • 管理使用者

        啟用下列進階功能：

        • 產生使用者存取代號

      • 僅限應用程式存取

        若要搜索僅與服務帳戶共用的檔案，請完成下列步驟:

        1. 選擇下列應用程式範圍：

          • 讀取儲存於 Box 的所有資料夾
          • 寫入儲存於 Box 的所有資料夾

        2. 完成下列步驟，與服務帳戶共用目標 Box 資料夾及檔案:

          1. 從「一般設定」頁面中，複製服務帳戶 ID 的電子郵件。
          2. 以受管理使用者身分登入時，共用您希望連接器能夠搜索的資料夾或檔案。
          3. 將服務帳戶 ID 電子郵件新增為要邀請共用檔案的人員。

          如需相關資訊，請參閱 Box 文件。

        若要搜索與服務帳戶及其應用程式使用者共用的檔案，請完成下列步驟:

        1. 選擇下列應用程式範圍：

          • 讀取儲存於 Box 的所有資料夾
          • 寫入儲存於 Box 的所有資料夾
          • 管理使用者

        2. 啟用下列進階功能：

          • 產生使用者存取代號

        3. 與適當的應用程式使用者共用目標 Box 資料夾及檔案。

          如需相關資訊，請參閱 Box 文件。

  3. 建立用於鑑別的金鑰。 請務必完成下列作業：

    1. 從「一般設定」頁面中，按一下 新增公開金鑰。
    2. 儲存針對私密金鑰產生的已下載配置檔。
    3. 按一下儲存變更。
    4. 從「配置」頁面中，複製 用戶端 ID 值。

  4. 接下來，您必須要求 Box 管理者授權應用程式。 在 Box 管理主控台中，完成下列作業：

    1. 在「應用程式> 自訂應用程式管理程式」頁面中，按一下 新增應用程式。

    2. 輸入用戶端 ID，然後按一下下一步。

      如需相關資訊，請參閱 自訂應用程式核准。

  5. Box 管理者步驟: 從 Box 管理主控台，檢查應用程式資訊是否正確，然後按一下 授權。

連接至 Box 資料來源

從 Discovery 專案中，完成下列步驟:

  1. 從導覽窗格中，選擇 管理集合。

  2. 按一下新增收藏集。

  3. 按一下方塊，然後按一下下一步。

  4. 命名集合。

  5. 如果 Box 中文件的語言不是英文，請選取適當的語言。

    如需受支援語言的清單，請參閱語言支援。

  6. 選用。 變更同步化排程。

    如需相關資訊，請參閱 搜索排程選項。

  7. 在 輸入認證 區段中，按一下 選取檔案，然後瀏覽以尋找在必要步驟中新增公開金鑰時所產生及下載的配置檔。

    您可以從 Box Developer 網站上的配置頁面重新下載配置檔。

  8. 選用。 在 指定您要搜索的內容 區段中，選擇特定使用者的內容或具有您要搜索之內容的特定資料夾。 如果您沒有指定任何內容，服務會搜索自訂應用程式可用的所有內容。

    • 若要搜索整個企業，請輸入 box://app.box.com/。

    • 若要抓取特定資料夾，請輸入 box://app.box.com/user/USER'S_ACCOUNT_ID/folder/FOLDER_ID/FolderName。

      例如： box://example.app.box.com/user/460250779/folder/158001591642/My Folder

    • 若要抓取特定使用者，請輸入 box://app.box.com/user/USER'S_ACCOUNT_ID/。

  9. 選用: 如果您使用 Proxy 伺服器來存取資料來源伺服器，則在 Proxy 設定 區段中，將 啟用 Proxy 設定 參數設為 On。 將值新增至下列欄位:

    使用者名稱
    選用。 如果代理伺服器需要驗證，您用來驗證的使用者名稱。 如果不知道您的使用者名稱，則可以自 Proxy 伺服器的管理者取得該名稱。
    密碼
    選用。 如果代理伺服器需要驗證，您用來驗證的密碼。 如果不知道您的密碼，則可以自 Proxy 伺服器的管理者取得該密碼。
    代理伺服器主機名稱或 IP 位址
    代理伺服器的主機名稱或 IP 位址。
    Proxy 伺服器埠號
    您要在代理伺服器上連線的網路連接埠。

  10. 選用。 如果您要啟動文件層次安全，請在 安全 區段中，將 啟用文件層次安全 開關設為 On。

    啟用此選項後，您的使用者可以抓取和查詢他們登入 Box 時可以存取的相同內容。 如需相關資訊，請參閱 支援文件層次安全。

  11. 如果您想要搜索器從網站上的影像擷取文字，請展開 其他處理設定，並將 套用光學字元辨識 (OCR) 設為 On。

    當啟用 OCR 且您的文件包含影像時，處理需要較長的時間。 如需相關資訊，請參閱 光學字元辨識。

  12. 按一下完成。

會快速建立集合。 將資料新增至集合時，需要花費更多時間來處理資料。

如果您要檢查進度，請跳至「活動」頁面。 從導覽窗格中，按一下 管理集合，然後按一下以開啟集合。