Tax Reporting 中設定 OCI 物件儲存

若要在 Tax Reporting 中設定用於任務管理程式補充資料管理程式附件的 OCI 物件儲存,請執行下列動作:

  1. 前往導覽器,然後按一下工具下的連線

    隨即會顯示「管理連線」頁面。

  2. 按一下建立以建立連線。

    隨即會顯示「選取提供者以建立連線」對話方塊。

  3. 按一下其他 Web 服務提供者

    隨即會顯示「輸入連線詳細資料」對話方塊。

  4. 指定下列詳細資料:
    • 連線名稱:「物件儲存」連線的名稱。
    • 描述:連線的相關簡短描述。
    • URL:「物件儲存」分組 URL。這是 Oracle Object Storage Cloud 分組的 URL。
    • 使用者密碼:您在 Oracle Cloud Infrastructure 中為 Tax Reporting 建立的使用者名稱和密碼。

      Note:

      如果已在聯合身分提供者中建立使用者,則使用者名稱的前面必須加上聯合身分提供者名稱。例如:oracleidentitycloudservice/username。對於密碼,您必須使用授權憑證作為密碼,而不是登入密碼。
  5. 按一下儲存並關閉以儲存「物件儲存」連線詳細資料。
  6. 前往首頁 > 應用程式 > 任務管理程式
  7. 按一下系統設定值頁籤。

    隨即會顯示「管理系統設定值」頁面。

  8. 按一下物件儲存,然後從連線下拉清單中,選取「物件儲存」連線。

    隨即會自動植入分組 URL

    URL 格式為:https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace/bucket_name,其中:
    • region_identifier 是主控 Oracle Cloud Infrastructure (OCI)
    • region.namespace 是所有分組與物件的頂層容器。每個 Oracle Cloud 基礎架構租用戶都會在帳戶建立時,被指派唯一的系統產生且不可變的 Object Storage 命名空間名稱。您租用戶的命名空間名稱 (例如axaxnpcrorw5) 在所有區域間都有效
    • bucket_name 是您儲存資料與檔案之邏輯容器的名稱。分組是在區間下組織並維護。

    範例 URL 為:https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/fccsAttachments

    如果您是在分組內建立資料夾,則 URL 格式為 https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/bucket_name/folder_name,其中 folder_name 是包含資料的資料夾名稱。

  9. 按一下驗證與儲存。系統會驗證以確定連線運作正常,然後建立並讀取測試檔案。

    隨即會顯示「物件儲存」確認對話方塊。

  10. 按一下繼續。批次工作會立即開始,此工作會將目前在資料庫中的附件移至指定的「物件儲存」位置。今後,所有附件都會儲存在「物件儲存」位置中,而不是儲存在資料庫中。附件一旦儲存在「物件儲存」位置中,您便無法回復成儲存在資料庫中。
  11. 統計資料顯示取決於您是現有客戶,還是第一次設定 OCI 物件儲存Tax Reporting 的新客戶:
    • 已移轉的附件數:移轉的附件數量。

    • 已移轉的附件大小 (MB):已移轉附件的大小。

    • 擱置中的附件數:仍待移轉的附件數。

    • 擱置中的附件大小 (MB):待移轉附件的大小。

    • 所有附件數:系統中的總附件數 (包含已移轉的附件加上待移轉附件加上剛新增的附件)。

    • 所有附件的大小 (MB):系統中所有附件的大小

    Note:

    從測試環境移轉至生產環境之後,如果您未更新連線詳細資料的手動步驟,則在應用程式內上傳和下載附件會產生錯誤。下載將會發生 0 位元組情況,而上傳則會產生驗證錯誤。
    • 如果您是現有客戶,就會看見與將附件從 Tax Reporting 資料庫移轉至 OCI 物件儲存 有關的統計資料。附件移轉時,您將看到統計遞增。

      Tax Reporting 會從資料庫取得附件,然後將檔案移至您已設定的 OCI 物件儲存分組中。執行此作業時會根據分組 URL,以及您在 Oracle Cloud Infrastructure 中為 Tax Reporting 建立的使用者名稱與密碼。系統會將附件從資料庫移至 OCI 物件儲存,然後將其從資料庫中移除。

      在第一次移轉之後,上傳和下載附件時,就會從 OCI 物件儲存儲存和擷取。

    • 如果您是 Tax Reporting 的新客戶,則許多顯示的統計資料都會顯示為零,因為您未將現有附件移至 OCI 物件儲存

    以下是統計資料的範例螢幕擷取畫面。

    統計資料

按一下重設會重設為上次有效的連線。

組態問題疑難排解

設定 OCI 物件儲存時,如果您看到下列錯誤,可能是分組 URL 或認證發生問題:

錯誤:無法使用指定的 URL 和認證連接到物件儲存服務。

使用任何 REST 用戶端 (例如 URL 或 Postman) 測試分組 URL 和認證。

URL 命令的格式如下:curl <bucket URL> -u "<username>:<password>"

下列為用來測試 URL 和認證之 URL 命令的範例。

curl https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/taskAttachments -u "username:password"