簡介
使用 Oracle Integration Cloud (OIC) 定義整合時,有需要執行的設定任務。本教學課程涵蓋使用 HCM 資料載入器 (HDL) 維護 Oracle HCM Cloud 的整合所需的一般設定。
目標
在本教學中,您將:
- 建立角色與使用者帳戶以存取「HCM 資料載入器」功能。
- 建立 FTP 伺服器與 Oracle HCM Cloud 整合所需的 OIC 連線。
必要條件
若要完成本教學課程的步驟,您必須存取下列項目:
- Oracle Integration Cloud (OIC)。
- 安全主控台:建立自訂角色和使用者帳戶。
- HCM 資料載入器業務物件存取任務,可設定 HDL 使用者帳戶可大量載入資料的業務物件。
這些角色階層提供此存取權:
角色名稱 角色代碼 授予存取權時間 管理 HCM 資料載入器業務物件存取 HRC_MANAGE_HDL_BO_ACCESS_PRIV HCM 資料載入器業務物件存取任務 功能設定使用者 ORA_ASM_FUNCTIONAL_SETUPS_USER_ABSTRACT 設定和維護
附註:
本教學課程假設您已啟用 HDL 的角色型業務物件。請參閱設定 HCM 資料載入器 (HDL) 的存取和瞭解 HDL 安全選項教學課程中的工作 1 ,以啟用此功能。若要加密 OIC 中的檔案,您應該完成設定 HCM 資料載入器 (HDL) 和瞭解 HDL 安全性選項教學課程的任務 5 中的步驟,以產生 fusion-key PGP 憑證並擷取公開金鑰。
警示:
建議您先加密所有檔案,再將它們上傳至 Oracle WebCenter。任何有權存取 hcm$/dataloader$/import$ 帳戶的使用者都可以下載放置在該處的任何檔案。任務 1:定義 HCM 資料載入器使用者帳戶
使用 HCM 資料載入器建立 OIC 整合時,需要考量三個使用者帳戶。
- 測試 HDL 檔案資源配置並產生對應檔的開發帳戶。
- 您 Oracle WebCenter Content 連線的使用者帳戶,僅具有 HCM 資料載入器匯入帳戶的存取權。
- 您 HCM 資料載入器 REST 連線的使用者帳戶,僅具有 HDL REST API 的存取權,且設定為僅上傳整合所維護之業務物件的資料。
此工作將描述如何建立這些帳戶。
秘訣:
請參閱設定 HCM 資料載入器 (HDL) 的存取和瞭解 HDL 安全性選項教學課程,以取得建立 HDL 角色和指派業務物件存取的更詳細指導。發展帳戶
您將使用此帳戶來起始「HCM 資料載入器」以測試您的檔案型態並產生 OIC 對應檔案。
附註:
只有在您設定並測試整合的開發環境中,才需要此帳戶。- 新增這些角色階層:
- 使用設定與維護中的 HCM 資料載入器業務物件存取任務來授予您開發使用者需要存取之業務物件的存取權。這可以是「所有」業務物件。
| 角色名稱 | 角色代碼 | 授予存取權對象 |
|---|---|---|
| HCM 資料載入 | ORA_HRC_HCM_DATA_LOAD_DUTY | 「資料交換」工作區中的 HCM 資料載入器任務。 |
| 上傳人力資本管理檔案式匯入的資料 | HCM_DATALOADER_IMPORT_RWD | Oracle WebCenter Content 伺服器上的 hcm/dataloader/import 目錄。 |
| 從人力資本管理檔案式匯出中下載資料 | HCM_DATALOADER_EXPORT_RWD | Oracle WebCenter Content 伺服器上的 hcm/dataloader/export 目錄。匯出錯誤檔所需。 |
Oracle WebCenter Content HDL 帳戶
此帳戶只能存取 Oracle WebCenter Content Server 上的 hcm$/dataloader$/import$ 帳戶。此帳戶將用來定義 Oracle WebCenter HDL 連線,可供您所有的「HCM 資料載入器」整合使用。您將會在任務 4 中建立此連線。
- 使用下列角色階層建立職務角色:
- 建立使用者帳戶 (例如 HDL_UPLOAD_FILE),並授予此工作角色的存取權。
| 角色名稱 | 角色代碼 | 授予存取權對象 |
|---|---|---|
| 上傳人力資本管理檔案式匯入的資料 | HCM_DATALOADER_IMPORT_RWD | Oracle WebCenter Content 伺服器上的 hcm/dataloader/import 目錄。 |
HDL REST 帳戶
建議您為每個「HCM 資料載入器」整合建立個別帳戶,以確保使用者帳戶只能存取需要維護的業務物件。建立可存取下列項目的帳戶:
- HCM 資料載入器 REST API。
- HCM 資料載入器 REST API 上的 createFileDataSet 自訂動作。
- 讀取送出進行上傳之檔案所需的 Oracle WebCenter hcm$/dataloader$/import$ 帳戶。
- 整合特定的業務物件。
請執行下列步驟:
- 依照設定 HCM 資料載入器 (HDL) 與瞭解 HDL 安全性選項教學課程任務二中 REST 存取標題底下的步驟,建立具備 HDL REST 存取權的角色。
- 使用設定與維護中的 HCM 資料載入器業務物件存取任務,以授予您整合負責維護之業務物件的存取權。
秘訣:
如果使用 Redwood,此使用者介面現在可從「資料交換」工作區取得。 - 建立為您的整合命名的使用者帳戶,並授予此工作角色的存取權。
您將使用此帳戶在本教學課程的任務 5 中建立 HCM 資料載入器 REST 連線。
工作 2:將加密金鑰匯入 OIC
HCM 資料載入器使用 fusion-key PGP 憑證的私密金鑰來解密送出進行匯入的加密檔案。
附註:
建議您先加密所有檔案,再將它們上傳至 Oracle WebCenter。任何有權存取 hcm$/dataloader$/import$ 帳戶的使用者都可以下載放置在該處的任何檔案。此步驟會將 fusion-key PGP 憑證的公開金鑰匯入 OIC 中,以便加密 HDL 可處理的已轉換檔案。
- 登入 OIC。
- 瀏覽至設定值 > 憑證。
- 按一下上傳。隨即顯示上傳憑證頁面。
- 指定名稱 (例如 fusion-key-pub),並選擇性地提供憑證的描述。
- 指定 PGP (加密與解密) 的類型。
- 使用瀏覽按鈕,選取您從「安全主控台」下載的公用 Fusion 金鑰檔案。
- 指定剩餘問題的值。
- 按一下上傳
秘訣:
現在當您在 OIC 中執行加密檔案暫存檔案動作時,就會列出此憑證。工作 3:定義讀取來源檔案的 FTP 連線
在這項任務中,您將在 OIC 中定義 FTP 連線,以用於讀取和解密來自外部 FTP 伺服器的來源檔案。
秘訣:
這些步驟描述使用 PGP 私密金鑰進行解密來源檔案的 FTP 連線。提供其他加密選項。- 登入 OIC,然後瀏覽至設計 > 連線。
- 按一下建立。
- 搜尋並選取建立連線頁面中的 FTP 。
- 指定名稱及選擇性地提供說明。按一下建立。
- 指定 FTP 伺服器主機位址,並將 FTP 的 FTP 伺服器連接埠設為 21 。
- 定義安全原則,並提供使用者名稱和帳戶存取資訊。
- 如果您的來源檔案是 PGP 加密,就必須指定私密金鑰以進行檔案解密。
- 展開可選安全性區段。
- 按一下 PGP 私密金鑰欄位右邊的上傳圖示。
- 選取您的私密金鑰檔案,然後按一下上傳。
- 在 PGP 私密金鑰密碼欄位中指定您的私密金鑰密碼。
- 按一下測試。
- 儲存連線。
工作 4:定義 Oracle WebCenter 連線
所有 HDL 整合都可以使用此連線,將 HDL 檔案上傳至 Oracle WebCenter Content 伺服器,供 HDL 處理。
建立此連線之前,請確定您擁有可存取 HCM 資料載入器檔案匯入帳戶 hcm$/dataloader$/import$ 的使用者帳戶。工作 1 中會提供建立此使用者的步驟。
- 登入 OIC,然後瀏覽至設計 > 連線。
- 按一下建立。
- 搜尋 HCM 並選取 Oracle HCM Cloud 轉接器。
- 指定 Oracle WebCenter HDL 匯入的名稱。將自動產生識別碼。
- 將角色設為呼叫,並選擇性地指定描述。
- 按一下建立。
- 使用您環境的 URL 指定 HCM Cloud 主機。
- 指定您 Oracle WebCenter 使用者帳戶的使用者名稱和密碼。
- 按一下測試和儲存。
任務 5:定義 HCM 資料載入器 REST 連線
此步驟會建立用於起始 HCM 資料載入器之 HCM 資料載入器 REST API 的連接器。
建議您為每個 HDL 整合建立個別的連線,此連線受到使用者帳戶保護,該使用者帳戶只能存取整合所維護之業務物件的大量載入資料。
建立此連線之前,請確定您已設定此使用者帳戶。工作 1 中會提供建立這類帳戶的步驟。
- 登入 OIC,然後瀏覽至設計 > 連線。
- 按一下建立。
- 搜尋 REST 並選取 REST 轉接器。
- 指定您整合的特定名稱,例如 HDL - 新僱用員工。將自動產生識別碼。
- 將角色設為呼叫,並選擇性地指定描述。
- 按一下建立。
- 指定 REST API 基礎 URL 的連線類型。
- 指定連線 URL ,其中:
https://{host}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets - 指定您整合使用者帳戶的使用者名稱和密碼。
附註:
將 {host} 取代為您的主機詳細資訊。
接下來的步驟
請依照本教學課程中的步驟,產生 OIC 用來將您的來源資料產生至 HCM 資料載入器業務物件檔案形狀的對應檔案。
相關連結
提供其他資源的連結。此區段為可選;如有需要請刪除。
- 設定檔案傳輸加密
- 教學課程:設定 HCM 資料載入器的存取
- 教學課程:使用 HCM 資料載入器 REST API
其他學習資源
在 docs.oracle.com/learn 上探索其他實驗室,或在 Oracle Learning YouTube 頻道上存取更多免費學習內容。此外,請造訪 education.oracle.com/learning-explorer 以成為 Oracle Learning Explorer。
如需產品文件,請造訪 Oracle Help Center 。
Oracle Integration Cloud (OIC) 中 HCM 資料載入器 (HDL) 整合的設定作業
G35358-02
2025 年10 月