簡介

本教學課程說明使用「HCM 擷取」產生「HCM 資料載入器」(HDL) 與「HCM 試算表資料載入器」(HSDL) 格式資料檔的步驟，以及如何自動匯入與載入這些檔案。它假設您已經具備 HCM 擷取、HDL 和 HSDL 的經驗。

您可以使用「HCM 擷取」來擷取您要包含在 HDL 或 HSDL 檔案中的資料。若要將資料格式化為必要形狀，您可以建立具有 eText 範本版面配置的 BI Publisher 報表，並在擷取上定義的資料載入器介面傳遞選項中參考此報表。

執行擷取時，資料載入器介面傳遞選項會將產生的檔案放置在 Oracle WebCenter Content 伺服器上。遞送選項會定義允許「HCM 資料載入器」正確處理檔案的參數值。

單一擷取可包含多個交付選項，以進行 HDL 與 HSDL 處理。下圖描述單一 HCM 擷取，其中包含兩個產生兩個檔案的遞送選項。每個檔案都會由在相同 BI Publisher 報表上傳遞的個別 eText 範本格式化。

若要自動匯入與載入擷取執行的所有產生檔案，您可以建立下列薪資流程模式：

• 提交您的擷取以產生 HDL 與 / 或 HSDL 檔案。
• 起始執行 HCM 資料載入器任務以：
• 讀取每個傳遞選項組態。
• 從 Oracle WebCenter Content 伺服器讀取產生的檔案。
• 針對以試算表載入器檔案類型設定的每個遞送選項，啟動「HCM 試算表資料載入器」。
• 將所有資料載入器檔案類型傳遞選項產生的所有檔案壓縮成單一壓縮檔案。
• 為產生的壓縮檔起始 HCM 資料載入器。

附註：

執行 HCM 資料載入器任務會將 HCM 資料載入器提交為階段作業使用者，以便與啟用「HCM 資料載入器」的安全性功能搭配使用。如需詳細資訊，請參閱設定 HCM 資料載入器 (HDL) 的存取及瞭解 HDL 安全性選項教學課程。

目標

在本教學課程中，您將匯入簡單的 HCM Extract，建立 BI Publisher 報表和傳遞選項，以產生暫停使用者帳戶使用案例的 HDL 和 HSDL 檔案。接下來，您將建立薪資流程模式以提交您的擷取，並起始 HDL 與 HSDL 以處理產生的檔案。

必要條件

1. 預期您瞭解如何建立「HCM 擷取」，以及如何形成和載入「HCM 資料載入器」檔案。

需存取 Oracle HCM Cloud 中的下列功能：

• 擷取定義
• HCM 資料載入器
• HCM 試算表資料載入器
• 報表和分析
• 薪資流程模式
2. 下載並解壓縮暫停使用者帳戶 resources.zip 檔案。
3. HSDL 解決方案需要使用試算表範本來暫停使用者帳戶。

   在本教學課程中，您可以使用 Cloud Customer Connect 上預先設定的 HSDL 範本啟用 / 停用現有的使用者帳戶來暫停使用者帳戶。

   • 依照匯入 HCM 試算表資料載入器範本教學課程中的指示，匯入此範本，指定暫停使用者帳戶的名稱和 SUSPEND_USER_ACCOUNTS 的代碼。
   • 編輯匯入的範本，以將停用屬性的預設常數值設定為 Y 。
   • 請確定用於執行 HCM 擷取的角色已指派給試算表範本。

任務 1：建立您的 HCM 擷取

在此步驟中，您將匯入暫停使用者帳戶擷取。

警告：

此擷取純粹用於示範傳遞選項。基本上，只要從人員編號類似 '123%' 的 PER_EXT_SEC_PERSON_UE 使用者實體擷取所有記錄即可。

匯入範例擷取

若要匯入摘錄：

1. 瀏覽至我的從屬端群組 > 資料交換。
2. 按一下擷取定義。
3. 按一下匯入。
4. 將擷取名稱指定為暫停使用者帳戶擷取。

秘訣：

擷取名稱會在任務 5 中定義的薪資流程模式參數中參考。
5. 匯入您從暫停使用者帳戶 resources.zip 檔案下載的 XML 檔案，然後按一下確定。



6. 在「確認」訊息中按一下確定。您將返回擷取定義頁面。
7. 搜尋暫停使用者帳戶擷取匯入的擷取。
8. 按一下擷取名稱以編輯擷取定義。
9. 為您的擷取指定用戶，然後按一下儲存。

自動載入參數

建立「自動載入」參數，以讓「HCM 資料載入器」端對端流程正常運作。

1. 在定義頁面中，按一下參數表格工具列中的新增。





2. 指定下列參數定義：

欄	數值
名稱	自動負載
標記名稱	AUTO_LOAD
資料類型	文字
顯示	是



3. 按一下儲存。

複查擷取標記

用來建立 eText 範本的 RTF 檔案會參考 HCM 擷取中定義的標記，以分組與匯出資料。

若要尋找這些標記，請執行下列動作：

1. 編輯擷取定義，然後按一下設計頁籤。
2. 按一下物件名稱階層中的記錄名稱，以複查物件的標記名稱。





3. 按一下屬性頁籤，即可複查屬性清單。





4. 按一下屬性名稱即可複查每個屬性的標記。

工作 2：定義 BI Publisher 檔案版面配置

在此步驟中，您會先建立 rtf 檔案，以將擷取的資料輸出至「HCM 資料載入器」或「HCM 試算表資料載入器」檔案格式。

請參考 HCM 擷取文件，並使用 Word 範本建置器建立將擷取資料格式化為 HDL 檔案格式的 rtf 版面配置。

HCM 資料載入器

若要使用 HCM 資料載入器暫停使用者帳戶，您必須產生具有此結構的使用者檔案：

SET PURGE_FUTURE_CHANGES Y
METADATA|User|PersonNumber|Suspended
MERGE|User|{person_number}|Y

在本教學課程中，請檢閱您從暫停使用者帳戶 resources.zip 檔案下載的 SuspendUserAccounts.rtf 檔案。

• 首先會產生 SET PURGE_FUTURE_CHANGES Y 指令。
• METADATA 行會為 User 物件產生一次，指定 HDL 欄位名稱 PersonNumber 與 Suspended 。METADATA 指令、物件及屬性名稱是以 '|' 管線字元分隔。
• 針對 Person_Record HCM 擷取記錄中找到的每筆記錄，會產生 MERGE 明細行。
• External_Person_Number 標記用於從擷取輸出人員編號。「已暫停」值是從 rtf 中定義的常數所產生。

HCM 試算表資料載入器

您可以產生與 HDL 相同方式的 HSDL 檔案版面配置。資料欄標頭和屬性分界字元會有所不同。

在本教學課程中，請檢閱您從暫停使用者帳戶 resources.zip 檔案下載的 SuspendUserAccounts HSDL.rtf 檔案。

• 此 rtf 檔案只會產生一個標頭為 User_PersonNumber 的資料欄。
• External_Person_Number 標記是用來擷取要暫停之使用者的人員編號。
• HSDL 試算表中的「停用」欄不需要任何值，因為該值是由 HSDL 範本本身所預設。

秘訣：

將檔案匯入 HCM 試算表資料載入器試算表教學課程說明如何下載 CSV 範本，其中包含檔案標頭所需的屬性名稱。

作業 3：定義 BI Publisher 報表

在此步驟中，您將建立報表，以使用任務 2 中建立的 rtf 檔案來產生擷取的資料。

建立 BI Publisher 報表

1. 瀏覽至工具 > 報表與分析
2. 按一下瀏覽目錄。
3. 按一下建立 (Create) > 報表 (Report) 。





4. 在建立報表對話方塊中，選取使用資料模型。





5. 按一下搜尋圖示即可開啟「資料模型」瀏覽器。
6. 導覽至資料夾共用資料夾 > 人力資本管理 > 薪資 > 資料模型。
7. 選取 globalReportsDataModel ，然後按一下確定。





8. 選取使用報表編輯器以瞭解如何建立報表，然後按一下完成。





9. 將您的報表儲存至共用資料夾 > 自訂 > 人力資本管理 > HDL 資料夾，名稱為 SuspendUserAccounts 。

秘訣：

必須提供「HCM 擷取」遞送選項的報表名稱與路徑，以便記下它們。

附註：

HDL 子目錄可能不存在，因此您可能需要加以建立。

上傳報表版面配置

在此步驟中，您將上傳 rtf 檔案作為 BI Publisher 報表的版面配置。HDL 與 HSDL 的處理程序相同。

1. 按一下上傳或產生版面配置標頭底下的上傳。





2. 指定暫停使用者帳戶 HDL 的版面配置名稱。

秘訣：

您必須將版面配置名稱提供給您的「HCM 擷取」遞送選項，以便記下版面配置名稱。
3. 按一下選擇檔案以搜尋並選取您在「任務 2」中複查的 HCM 資料載入器 SuspendUserAccounts.rtf 檔案。
4. 指定 eText 範本的類型。
5. 指定語言環境。





6. 按一下上傳。

系統會自動儲存您的報表。

重複上傳報表版面配置步驟，以使用 SuspendUserAccounts HSDL.rtf 檔案建立暫停使用者帳戶 HSDL 版面配置。

任務 4：定義 HCM 擷取遞送選項

在此步驟中，您將在 HCM Extract 上建立傳遞選項，以使用 BI Publisher 報表格式化擷取輸出，並將該輸出張貼至 Oracle WebCenter Content 伺服器。

定義交貨選項

1. 瀏覽至我的從屬端群組 > 資料交換 > 擷取定義
2. 搜尋暫停使用者帳戶擷取擷取，然後按一下擷取名稱以進行編輯。
3. 按一下傳遞頁籤。
4. 按一下「擷取傳遞選項」表格工具列上的新增。





5. 將傳遞選項名稱指定為暫停使用者帳戶 HDL ，然後指定資料載入器介面的傳遞類型。





6. 按一下確定以定義傳遞選項。

   資料載入器介面傳遞選項提供您需要為 HDL 和 (或) HSDL 指定的參數，以處理傳遞選項所產生的檔案：

   欄位	描述
   輸出類型	「文字」
   報表	在任務 3 中建立之 BI Publisher 報表的路徑與檔案名稱。
   樣板名稱	BI Publisher 報表中以「報表」欄位命名的版面配置名稱。
   輸出名稱	要用於產生之檔案的名稱 (不含副檔名)。對於 HDL 檔案，這必須是業務物件特定檔案名稱。
   加密方式	所產生檔案的加密類型。指定 PGP - 未簽署 以加密檔案。 附註： 在開發整合時，請只將您的檔案保持在未加密的測試環境中。產生的檔案會張貼至 Oracle WebCenter，任何可以存取 hcm/dataloader/import 帳戶的人都可以下載和讀取這些檔案。建議您總是將在此張貼的檔案加密 。
   整合姓名	識別 Oracle WebCenter Content 伺服器上輸出檔案的值。它會與處理程序 ID 串連，以形成「內容 ID」。 為相同擷取中的每個遞送選項指定唯一值。
   檔案類型	輸出檔案的類型。
   壓縮的遞送群組	檔案類型：資料載入器 將壓縮所有「資料載入器」產生之檔案的壓縮檔名稱。您必須為相同擷取內的所有「資料載入器」遞送選項提供具有 .zip 副檔名的相同值。 檔案類型：試算表載入器 非必要欄位。
   壓縮	如果不想壓縮傳遞選項所產生的檔案，請指定否。 如果要壓縮傳遞選項所產生的檔案，請指定是 - 先壓縮，這對於較大的磁碟區檔案很有用。如果您也要加密檔案，將會先壓縮檔案，然後再加密。 附註： HCM 資料載入器不受此設定影響。執行 HCM 資料載入器處理會先解密加密的檔案、解壓縮壓縮的檔案，然後更改副檔名，再壓縮使用相同「壓縮傳遞群組」參數值產生的所有檔案。然後，壓縮的檔案會提交至 HDL。
   試算表範本代碼	要上傳資料的 HSDL 範本代碼。
   試算表檔案日期格式	用於日期資料類型之屬性的日期格式。預設格式為 YYYY/MM/DD。
   試算表檔案分隔符號	用來分隔檔案中值的字元。預設為逗號。
   試算表檔案跳脫指標	用於遁離屬性值內分界字元的字元。預設值為反斜線。
   包含試算表檔案表頭	指示標頭是否包含在來源檔案中，以命名檔案中包含的屬性。預設值為 Y。
   試算表新明細行指標	用來表示新明細行的字元。預設值為 n，開頭為逸出字元。

   秘訣：

   未使用修訂副檔名參數。

7. 指定這些 HDL 傳遞選項的參數值：

   輸出類型	文字
   報表	/Custom/Human 資本管理 /HDL/SuspendUserAccounts.xdo
   樣板名稱	暫停使用者帳戶 HDL
   輸出名稱	User
   加密方式	無。 秘訣： 確認產生的檔案資源配置正確後，您必須將此變更為 PGP - 未簽署。
   整合姓名	SUA
   檔案類型	資料載入器
   壓縮的遞送群組	User.zip
   壓縮	編號 秘訣： 確認產生的檔案資源配置正確後，請考慮將此變更為是 - 先壓縮。

   
   
8. 按一下確定。


9. 重複上述步驟以建立暫停使用者帳戶 HSDL 傳遞選項。

   針對 HCM 試算表資料載入器遞送選項，指定下列參數值：

   輸出類型	文字
   報表	/Custom/Human 資本管理 /HDL/SuspendUserAccounts.xdo
   樣板名稱	暫停使用者帳戶 HSDL
   輸出名稱	暫停使用者帳戶 HSDL
   加密方式	無。 秘訣： 確認產生的檔案資源配置正確後，您必須將此變更為 PGP - 未簽署。
   整合姓名	SUAHSDL
   檔案類型	試算表載入器
   壓縮的遞送群組
   壓縮	編號
   試算表範本代碼	SUSPEND_USER_ACCOUNTS

   
   
10. 按一下驗證以導覽至擷取執行樹狀目錄。
11. 按一下表格工具列上的驗證。






秘訣：

您可能需要重新整理表格。
12. 複查並解決任何驗證錯誤。

測試檔案產生

在此步驟中，您將確認檔案是以您需要的資源配置產生。

從擷取定義頁面：

1. 搜尋您的擷取，然後按一下提交擷取。





2. 指定擷取執行處理名稱，然後提供生效日期參數與今天的日期。





3. 按一下送出。這會將您導覽至檢視擷取結果頁面。
4. 按一下重新整理，直到擷取例項完成為止。
5. 按一下擷取流程實例的名稱，以顯示更多資訊。





6. 展開擷取傳遞選項區段。
7. 按一下輸出檔案的檔案下載圖示，然後複查輸出。






秘訣：

檔案名稱是從每個傳遞選項上定義的輸出名稱產生。
8. 對 BI Publisher 報表的 RTF 版面配置檔案進行任何必要的變更，直到產生的輸出檔案可以順利以 HCM 資料載入器載入為止。
9. 對檔案資源配置感到滿意之後，請記得更新傳遞選項，將加密模式設為 PGP - 未簽署。

秘訣：

加密後您將無法檢閱檔案內容。

任務 5：定義薪資流程模式

在此步驟中，您將定義薪資流程模式以提交您的「HCM 擷取」，並起始執行 HCM 資料載入器任務以處理擷取產生的檔案。

建立薪資流程模式

1. 導覽至我的客戶群組 > 薪資 > 薪資流程模式。
2. 建立新流程。
3. 選擇性地指定「法規資料群組」，然後按一下繼續。





4. 指定流程模式的暫停使用者帳戶名稱，視需要提供描述並設定 LDG 必要值。
5. 勾選要包含的活動值的 HCM 擷取與準備核取方塊。





6. 捲動並選取暫停使用者帳戶擷取與執行 HCM 資料載入器任務。





7. 按一下下一步，瀏覽至工作順序頁面。
8. 編輯後續任務值，確定任務的順序如下：

作業	後續任務
開始流程	暫停使用者帳戶擷取
暫停使用者帳戶擷取	執行 HCM 資料載入器
執行 HCM 資料載入器	結束流程

定義處理流程參數

1. 按一下下一步，即可瀏覽至參數頁面。建立下列參數：
有效日期

欄位	數值
流程參數	生效日
顯示	是
顯示格式	日期
順序	10
金鑰參數	處理日期


處理程序配置群組

欄位	數值
流程參數	處理組態群組的作業
顯示	是
顯示格式	智慧值清單
查詢	處理設定群組 |ActionParameterGroupPVO
順序	20


開始日期

欄位	數值
流程參數	開始日期
顯示	是
顯示格式	日期
順序	30


自動負載

欄位	數值
流程參數	自動負載
顯示	是
顯示格式	文字
順序	40
參數基準	常數繫結
基準值	Y


基準擷取名稱

欄位	數值
流程參數	基準擷取名稱
顯示	編號
顯示格式	文字
順序	50
參數基準	常數繫結
基準值	暫停使用者帳戶擷取


報表分類

欄位	數值
流程參數	報表分類
顯示	編號
顯示格式	智慧值清單
查詢	報表分類 |OverridingReportCategoryPVO
順序	60
參數基準	公告 SQL 繫結
基準值	從 pay_report_categories 中選取 to_char (report_category_id)，其中 base_category_name='Suspend User Accounts Extract'

設定作業參數

1. 按一下下一步，瀏覽至工作參數頁面。
2. 選取暫停使用者帳戶擷取 HCM 擷取記錄。





3. 更新生效日期參數，將基準值設為生效日期。此任務參數現在會接受來自薪資流程的「生效日期」參數值。





4. 更新自動載入參數，確定參數基準為連結至流程，並將基準值設為自動載入。此任務參數現在將接受來自薪資流程的「自動載入」參數值。





5. 更新處理組態群組參數，確定參數基準為連結至流程，並將基準值設為處理組態群組。此任務參數現在將接受來自薪資流程的「處理組態群組」參數值。





6. 更新開始日期參數，確定參數基準為連結至流程，並將基準值設為開始日期。此任務參數現在會接受來自薪資流程的「開始日期」參數值。





7. 選取「任務」表格中的執行 HCM 資料載入器任務。

附註：

您必須定義「擷取處理流程名稱」的基準值，但必須先儲存處理流程模式才能使用值清單。建立流程之後，您將編輯此參數。
8. 按一下下一步，瀏覽至複查頁面，然後按一下送出。

您將返回薪資流程模式頁面。

9. 搜尋新的薪資流程任務，然後按一下編輯。
10. 在「任務」面板中，按一下執行 HCM 資料載入器任務上的前往任務。





11. 編輯擷取處理流程名稱參數，確定參數基準為連結至流程任務，並將基準值設為暫停使用者帳戶擷取、提交、薪資處理。





12. 按一下送出。

任務 6：提交薪資流程

在此步驟中，您將提交流程並監視結果。

1. 瀏覽至我的從屬端群組 > 資料交換
2. 按一下送出流程。
3. 搜尋暫停使用者帳戶流程。





4. 按一下流程名稱以導覽至提交薪資流程頁面。
5. 指定薪資流程的名稱。這可以是任何唯一值。
6. 指定生效日期。





7. 按一下提交，該動作會將您導覽至薪資核對清單頁面。
8. 定期按一下重新整理，直到擷取與「執行 HCM 資料載入器」處理都完成為止。





9. 按一下執行 HCM 資料載入器任務名稱以導覽至匯入與載入資料任務，您可以在其中複查資料集狀態與產生的任何訊息。

秘訣：

預設的 HDL 行為是在擷取資料後，從 Oracle WebCenter 刪除來源檔案，這也是透過直接呼叫「任務 4」中所述的擷取來驗證檔案形狀的重要原因。

相關連結

HDL 和 HSDL 的最新教學課程發佈於 Cloud Customer Connect 的這個主題：

• HCM 資料載入器 Oracle by 範例教學課程

請參閱此說明主題以取得進一步資訊：

• 在 HCM 擷取中定義 BI Publisher 範本

其他學習資源

在 docs.oracle.com/learn 上探索其他實驗室，或在 Oracle Learning YouTube 頻道上存取更多免費學習內容。此外，請造訪 education.oracle.com/learning-explorer 以成為 Oracle Learning Explorer。

如需產品文件，請造訪 Oracle Help Center 。

---

標題與著作權資訊

起始 HCM 擷取產生檔案的 HCM 資料載入器

G34813-01

2025 年 5 月

Copyright ©2025,

Oracle 和 (或) 其關係企業。