建立全域連線

全域連線可讓 Oracle Fusion Cloud Enterprise Data Management 與外部系統整合。部分全域連線類型用來與外部應用程式共用資料,而其他類型則用來將資料傳送至外部服務以進行驗證與確認。

支援下列連線類型:

  • 外部驗證:透過 REST API 呼叫,將要求資訊傳送至外部系統,並接收傳回的驗證資訊。
  • Microsoft Azure Blob Storage:將資料傳送至 Microsoft Azure Blob Storage 檔案容器。
  • Oracle 地址、電子郵件和電話驗證:透過連線至外部驗證服務,驗證要求中的地址。
  • Oracle Cloud EPM:將資料傳送至 Enterprise Performance Management 收件匣,供中繼資料匯入程序使用。
  • Oracle Cloud ERP:將資料傳送至 Universal Content Management (UCM) 文件帳戶,供「檔案型資料匯入 (FBDI)」程序使用。
  • Oracle Object Storage:作為技術配接器,供用途較為一般的外部系統使用。

使用案例

資料共用

  • Microsoft Azure Blob Storage 的全域連線,可用來將擷取與擷取套件的輸出,傳輸至 Microsoft Azure Blob Storage 檔案容器。
  • Oracle Cloud ERP 的全域連線可用來傳輸資料 (例如科目組合、對應集及相關值集) 以匯入至 Financials Cloud。
  • Oracle Cloud EPM 的全域連線可透過下列方式使用:
    • 管理科目調節業務流程的通用應用程式,可以使用全域連線,將設定檔傳送至應用程式收件匣。
    • 某些通用應用程式會負責管理獲利與成本管理業務流程的維度,這些應用程式可以使用全域連線,將中繼資料檔案傳送到獲利收件匣。
    • 若要將對應檔案傳送至「資料管理」收件匣

驗證與確認

您可以限定只有 Cloud EDM 中的特定應用程式才能使用連線類型。Oracle 地址、電子郵件和電話驗證服務的全域連線適用於所有應用程式。

建立全域連線

註:

您必須是「服務管理員」才能建立全域連線。

注意事項

  • 在您建立全域連線之後,可以在擷取中使用它。您可以在多個擷取中使用全域連線,但每個擷取只能使用一個全域連線。

    註:

    您無法在擷取中使用 Oracle 地址、電子郵件和電話驗證連線類型。
  • 您無法在建立全域連線之後變更連線類型。
  • 應用程式匯入和匯出不使用全域連線。而是使用您在登錄應用程式時指定的應用程式連線資訊。

  • 您所指定的全域連線參數是由連線類型所決定。
  • Oracle Cloud EPM 和 Oracle Cloud ERP 應用程式的全域連線支援基本和 OAuth2 驗證。您必須為每個全域連線登錄一個 OAuth2 用戶端。請參閱將 OAuth2 用於應用程式與全域連線。
  • Oracle Object Storage 的全域連線支援基本驗證和 API 簽署金鑰驗證。
  • Oracle 地址、電子郵件和電話驗證的全域連線僅支援 OAuth2 驗證。
  • 外部驗證的全域連線僅支援基本驗證。

若要建立全域連線,請執行下列動作:

  1. 從連線叢集中,按一下建立。
  2. 選取連線類型:
    • 外部驗證
    • Microsoft Azure Blob Storage
    • Oracle 地址、電子郵件和電話驗證

      註:

      您只能為 Oracle 地址、電子郵件和電話驗證建立一個全域連線。
    • Oracle Cloud EPM
    • Oracle Cloud ERP
    • Oracle Object Storage
  3. 輸入連線的名稱,以及選擇性地輸入描述,然後按一下建立。

    全域連線會顯示在連線檢查程式中。

  4. 按一下編輯,然後指定連線的參數。您指定的參數,會因連線類型的差異而有所不同:
    • 外部驗證參數:
      欄位 描述
      位置 外部驗證 REST 端點的 URL。執行 GET 作業測試連線,執行 POST 作業執行驗證。

      範例: https://externalhostname.example.com/api/rest/externalValidation

      使用者名稱/密碼 基本驗證的證明資料。
      批次大小上限 外部系統在單一批次中應驗證的最大節點數,上限為 10,000 個。預設值為 1,000。
      並行程序上限 外部系統應執行的最大並行驗證程序數,上限為 3 個。預設值為 1。
    • Microsoft Azure Blob Storage 參數:
      欄位 描述
      位置 Microsoft Azure Blob Storage 帳戶的 URL。例如:https://myblobstorageaccount.blob.core.windows.net

      備註:該 URL 必須包含您 Azure Blob Storage 帳戶的名稱 (在上述範例中為 myblobstorageaccount)。此帳戶必須在 Azure 中獲派儲存體 Blob 資料提供者角色。

      租用戶 ID Microsoft Azure 租用戶中應用程式登錄的租用戶 ID。
      用戶端 ID Microsoft Azure 租用戶中服務主體的應用程式 (用戶端) ID。
      用戶端密碼 Microsoft Azure 租用戶中用戶端密碼的值。
      預設容器名稱 Microsoft Azure 租用戶中,用來寫入資料的資料儲存容器。該容器必須存在於 Azure 租用戶中。
      預設子資料夾 選擇性:容器內的子資料夾,用來將資料寫入 Microsoft Azure 租用戶。

      注意:如果您指定的子資料夾不存在,會在執行擷取或擷取套件至此連線時建立。您可以使用正斜線 (/) 字元指定其他子資料夾 (例如,Application/Extract Data)。

    • Oracle 地址、電子郵件和電話驗證參數:
      欄位 描述
      位置 Oracle 地址、電子郵件和電話驗證服務的 URL。例如:https://mydataservice-myidentitydomain.data.us2.oraclecloud.com

      注意:

      如果您是從瀏覽器貼上位址,請勿在 URL 中包含相關內容 (例如,/data/ui)。
      用戶端 ID 連線至地址驗證服務時所使用的 OAuth 用戶端 ID。

      備註:您必須為 Oracle 地址、電子郵件和電話驗證服務建立 OAuth 用戶端證明資料。請參閱使用 Oracle 地址、電子郵件和電話驗證中的如何開始使用地址、電子郵件和電話驗證。

      用戶端密碼 連線至地址驗證服務時所使用的 OAuth 用戶端密碼。
    • Oracle Cloud EPM 參數:
      欄位 描述
      位置 EPM 收件匣的 URL。例如:https://acme-test-epmidm.epm.us-phoenix-1.ocs.oraclecloud.com

      注意:

      如果您是從瀏覽器貼上位址,請勿在 URL 中包含相關內容 (例如,/epmcloud)。
      驗證類型 選取一個選項:
      • 基本:使用提供的使用者認證進行驗證。
      • OAuth:使用 OAuth2 ID 和憑證進行驗證。(僅適用於 Oracle Cloud Infrastructure (OCI)/Gen 2 架構的環境。) 將 OAuth2 用於應用程式與全域連線

      預設資料夾 (選擇性)

      在 Cloud EPM 環境中將擷取檔案傳送至預設資料夾:
      • Planning、FreeForm、Financial Consolidation and Close、Enterprise Profitability and Cost Management 預設應用程式收件匣
      • 資料管理資料夾 (例如,收件匣/儲存庫)
      • Profitability and Cost Management 收件匣 (例如,profitinbox)
      基本驗證參數:
      使用者名稱/密碼 需要基本驗證認證

      識別網域 (選擇性)

      授權時附加在使用者名稱前面的識別網域。
      OAuth 驗證參數:
      用戶端 ID 您為全域連線所建立之用戶端的用戶端 ID。
      存取憑證 您為全域連線所建立之用戶端的存取憑證。
      重新整理憑證 您為全域連線所建立之用戶端的重新整理憑證。
    • Oracle Cloud ERP 參數:
      欄位 描述
      位置 EPM 伺服器的 URL。例如:https://erp.mycloud.com
      驗證類型 選取一個選項:
      • 基本:使用提供的使用者認證進行驗證。
      • OAuth:使用 OAuth2 ID 和憑證進行驗證。(僅適用於 Oracle Cloud Infrastructure (OCI)/Gen 2 架構的環境。) 將 OAuth2 用於應用程式與全域連線

      預設文件帳戶

      放置所擷取檔案的 Oracle Cloud ERP 資料夾。例如,fin/generalLedger/import。
      基本驗證參數:
      使用者名稱/密碼 需要基本驗證認證

      識別網域 (選擇性)

      授權時附加在使用者名稱前面的識別網域。
      OAuth 驗證參數:
      IDCS 憑證 URL 提供者驗證伺服器。用來將授權碼交換為存取憑證。
      用戶端 ID 您為全域連線所建立之用戶端的用戶端 ID。
      範圍 提供一種方法,用來控管授權給 JSON Web Token (JWT) 的存取權限範圍。
      憑證別名 您將憑證匯入 Cloud ERP 時所指定的別名。
      私密金鑰上傳 您匯入 Cloud ERP 的憑證檔案。按一下上傳檔案位置以上傳檔案。檔案必須具有 .PEM 副檔名。
    • Oracle Object Storage 參數:
      欄位 描述
      位置 Oracle Object Storage Cloud 儲存設定的 Swift URL。URL 的格式:https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace,其中:
      • host name (使用 Swift API 類型),例如 swiftobjectstorage。
      • region_identifier 是主控 Oracle Cloud Infrastructure (OCI),例如 us-phoenix-1。請參閱區域與可用性網域。
      • namespace 是所有分組與物件的頂層容器。每個 Oracle Cloud 基礎架構租用戶都會在帳戶建立時,被指派唯一的系統產生且不可變的 Object Storage 命名空間名稱。

      提示:

      Oracle Object Store 的 Swift URL 必須包含版本及命名空間。請勿在「位置」參數中,包含後置的正斜線。
      驗證類型 選取基本或 API 簽署金鑰驗證方法。
      基本
      使用者名稱/密碼 驗證所需的認證如下:
      1. 產生授權憑證 (請參閱 Oracle Cloud Infrastructure 文件中的建立授權憑證)。
      2. 對於使用者名稱,輸入產生其授權憑證的 OCI 使用者名稱。
      3. 對於密碼,輸入產生的授權憑證。此參數區分大小寫。
      API 簽署金鑰
      • 租用戶 OCID
      • 使用者 OCID
      • 公開金鑰指紋
      • 私密金鑰上傳

      API 簽署金鑰所需的證明資料如下:

      1. 在 Oracle Cloud 主控台中,產生 API 簽署金鑰。請參閱 Oracle Cloud Infrastructure 開發人員手冊中的如何產生 API 簽署金鑰。
      2. 從主控台中,下載私密金鑰並將其儲存至您的 .oci 目錄,然後按一下新增。

        簽署金鑰的參數會顯示在主控台中。

      3. 從主控台複製下列參數並在 Cloud EDM 貼上:
        • 在租用戶 OCID 中,貼上主控台中的租用戶值。
        • 在使用者 OCID 中,貼上主控台中的使用者值。
        • 在公開金鑰指紋 中,貼上主控台中的指紋值。
      4. 在私密金鑰上傳中,按一下上傳,然後上傳您在步驟 b 中下載的私密金鑰檔案。
      預設儲存設定 (選擇性)

      備註:測試連線需要輸入此欄位。

      儲存物件儲存命名空間中所擷取檔案的容器。此參數區分大小寫。
      預設子資料夾 (選擇性) 要將擷取檔案寫入之預設儲存設定下的子資料夾。如果您指定的子資料夾不存在,則會建立該子資料夾。此參數區分大小寫。
  5. (選擇性):在支援的應用程式中,按一下指定,然後選取可使用此全域連線的應用程式。
  6. 按一下測試連線以驗證連線詳細資料。

    註:

    您必須輸入「預設儲存設定」才能測試 Oracle Object Storage 連線。
  7. 按一下儲存。

    註:

    您必須先更正所有連線中的所有問題,才能儲存連線。如果有任何連線的連線詳細資料中缺少任何必要的欄位,系統會在該連線上顯示指標,並顯示錯誤,指出有一或多個連線出現必須修正的問題。

若要刪除全域連線,請從「動作」欄中按一下動作,然後按一刪除。您無法刪除由擷取使用的全域連線。如果「地址」特性正在使用 Oracle 地址、電子郵件和電話驗證全域連線,則無法刪除該連線。