簡介

使用 HCM 試算表資料載入器 (HSDL) 為您的業務使用者和內送整合提供大量資料載入功能。您可以為特定使用案例設定試算表範本，並將這些範本的存取權僅指派給需要這些範本的角色。例如，您的招募整合可以存取「新聘雇員工」試算表，而「晉升」試算表則可供 HR 專員使用。這兩個範本都維護 Worker 業務物件，但僅限於指定的使用案例。

附註：

將 HSDL 用於整合的優點在於您正在限制上傳至範本所支援之特定使用案例的資料。若有需要，您也可以強制執行資料安全性。

目標

在本教學中，您將：

• 瞭解如何設計與設定 HSDL 範本。
• 建立可載入新僱用員工的工作範本。

Worker 業務物件相當複雜，在物件階層中有大約 30 個物件超過 5 個層次。本教學課程將說明如何建立簡單的工作新僱用員工範本，並說明定義試算表範本的一般任務。然後，您可以將這些步驟套用至任何支援的業務物件。

瞭解樣板建立的基本資訊之後，後續步驟段落會列出可擴展知識的教學課程。

必要條件

若要完成此教學課程，您需要：

• 已安裝桌面整合的 Windows 機器，可測試您的範本。
• 存取具有角色的試算表範本任務，該角色被指派建立職工業務物件範本的存取權。

請依照設定設計與維護 HCM 試算表資料載入器 (HSDL) 範本教學課程中的任務 2 與 3 來建立這類角色。

附註：

此教學課程假設您已啟用 Redwood。如果不是這樣，請依照本教學課程的發行版本 25C 取得導覽和螢幕擷取畫面。

教學課程作業

試算表範本 Redwood 任務使用引導式處理來建立與維護範本。此教學課程中的工作會根據引導式程序中的步驟命名。

作業 1：新增 - 輸入樣版資訊

在此步驟中，您將根據工作者業務物件階層來建立新範本。

1. 使用具有可存取工作者業務物件之 HSDL 範本設計者角色的使用者登入應用程式。
2. 請瀏覽至我的從屬端群組 > 資料交換 > 試算表樣板。
3. 按一下新增即可開始引導式處理作業。





4. 提供名稱、將業務物件設為工作者，以及選擇性提供描述。



範本代碼將根據範本名稱自動產生。您可以編輯此項目。

5. 檢視資料安全性。如果您要套用資料安全性，則上傳資料身分應設為階段作業使用者。

   

   附註：

   並非所有業務物件都支援以階段作業使用者載入資料。

   您需要額外的功能安全性權限，才能將存取權指派給將資料載入為提升使用者的範本。

6. 按一下繼續，即可進入選取屬性步驟。

作業 2：選取屬性

在此任務中，您將選取您希望試算表使用者植入新僱用的屬性。

秘訣：

選取屬性時，將焦點放在使用者需要在試算表中輸入或維護的值。您不需要手動新增階層中的每個識別碼或每個物件。

此表格總結列出您可能想要提供給簡單「新聘雇員工」的屬性。在下列步驟中，您將將這些屬性新增至範本，以及新記錄所需之這些物件的屬性：

物件	屬性
職工	出生日期
人員姓名	姓氏 名字 職稱
人員法規資料	性別 婚姻狀態
指派項目	人員型態 工作關係的主要指派 部門 工作代碼 職位碼 職等代碼

秘訣：

當您繼續前往引導式處理流程的下一個步驟時，範本設計人員會新增任何必要的物件，以保留範本中記錄之間的上下階關係。接著，您將指定要用來唯一識別每個物件的屬性，範本設計者會自動新增任何識別屬性，例如尚未儲存至範本的「人員編號」。

職工

Worker 物件是階層中的最上層物件，用來識別個別員工。其中包含人員的人員編號、出生日期及開始日期。

1. 將物件篩選條件設為 Worker 。





2. 按一下必要篩選條件，然後選取新記錄。

   

   秘訣：

   請記住，一律需要的屬性會自動新增。我們需要手動新增新記錄所需的屬性，因為範本設計者不知道您是要建立新記錄或更新現有記錄。
3. 按一下表格上方的核取方塊，即可選取所有顯示的屬性。





4. 按一下動作代碼屬性標籤上可用的連結。這會顯示屬性的詳細資訊。

   

   秘訣：

   有時屬性名稱可能不熟悉，或存在多個具有相似名稱的屬性。在選取屬性之前，您可以使用屬性詳細資訊面板來複查屬性。
5. 清除必要篩選條件並搜尋出生日期。
6. 檢查出生日期屬性。





7. 搜尋並選取人員編號屬性。

   附註：

   當人員編號屬性可唯一識別職工時，範本設計人員會自動新增此屬性 (如果您沒有的話)。現在新增不會讓範本設計者無法自動選取其他必要屬性。

人員姓名

人員名稱物件會記錄您員工的名稱。

1. 變更物件篩選以顯示「人員姓名」屬性。





2. 按一下必要篩選條件，然後選取新記錄。

   秘訣：

   別忘了移除搜尋面板中的任何搜尋準則。
3. 選取所有顯示的屬性。
4. 清除必要篩選條件。
5. 搜尋並選取名字屬性。
6. 在範本中新增您想要的任何其他選擇性人員名稱屬性，例如標題。

人員法規資料

人員法規資料物件會擷取您員工的婚姻狀態與性別。

1. 將物件篩選條件變更為人員法規資料。
2. 篩選屬性清單至新記錄所需的屬性。



秘訣：

「人員法規資料」物件上沒有新記錄所需的任何屬性。
3. 清除必要篩選條件，搜尋這些選擇性屬性並將其新增至您的範本：
• 性別
• 婚姻狀態
4. 複查其他可用的人員法規資料屬性，並視需要新增至您的範本。

指派項目

指派物件是您指定員工部門、地點、職位、職務等的地方。

1. 為指派物件新增新記錄所需的所有屬性。
2. 清除必要篩選條件。
3. 搜尋並新增範本中需要的其他屬性。以下是一些建議：
• 人員型態
• 工作關係的主要指派
• 部門
• 工作代碼
• 職位碼
• 職等代碼
4. 按一下繼續。

秘訣：

如果您在階層中跨多個物件選取屬性，則可能需要一些時間來進行下一個步驟。範本設計者正在驗證您從中選取屬性的物件，並新增任何必要的物件，以確保每筆記錄都具有完整的階層結構。

作業 3：選擇記錄識別碼

在此任務中，您將複查用來唯一識別範本中所含每筆記錄的屬性。HSDL 支援使用者關鍵碼與替代 ID。

1. 複查範本中所包含的物件清單。

   

   
   

   秘訣：

   雖然您並未從工作關係或僱用條款物件新增屬性，但範本設計人員瞭解將指派記錄連結至職工記錄時，需要這些物件的記錄。

   

2. 按一下編輯。

附註：

範本設計者會自動將範本設定為使用使用者索引鍵，因為這些是您的業務使用者在應用程式中看到的屬性。






秘訣：

當物件提供多個使用者關鍵碼時，「使用者關鍵碼」欄位會成為選擇清單，而您可複查並選取使用案例所需的使用者關鍵碼。
3. 將屬性類型欄位變更為替代索引鍵。



秘訣：

您可能會想要為用來維護現有記錄的範本選取替代索引鍵。「替代索引鍵」屬性提供可搜尋的值清單。
4. 請注意，變更用於識別範本中每個物件的屬性。

如果您使用替代索引鍵來識別記錄，則只需觀察行為並複查範本中所包含的屬性即可。





5. 按一下取消。由於此範本是要上傳新記錄，因此我們將使用「使用者金鑰」。「替代索引鍵」僅可用於參考現有記錄。
6. 按一下繼續。

   設定屬性步驟會顯示儲存至範本的所有屬性。



附註：

用來識別每筆記錄並形成記錄之間上下階關係的屬性會自動新增至範本。由於 Worker 是生效日期物件，因此也會自動新增生效日期。

按一下顯示隱藏屬性篩選，然後向下捲動。

您現在可以看到下階物件上的屬性 (對應至上階物件上的屬性) 已自動新增、預設及隱藏試算表。

任務 4：測試

您應該定期測試您的範本，方法是產生試算表並複查其執行方式、哪些變更會使使用變得更簡單，並減少資料錯誤。

雖然此任務僅提及一次，您應在剩餘的步驟期間重複執行此任務。

1. 儲存所有最近的變更。
2. 按一下資訊標幟中的產生試算表。

   

   秘訣：

   此資訊標幟可用於引導式處理作業的其餘步驟。
3. 開啟下載的 xlsx 檔案，然後在提示登入時按一下是。
4. 使用您的應用程式使用者名稱和密碼登入。產生試算表時，每個選取的屬性都會設定為顯示在試算表中。
5. 按一下試算表載入器工具列上的建立資料集。



秘訣：

如果您只是要複查欄標題、提示、預設值和值清單，則可以不建立資料集。您只需要一個資料集，即可使用試算表測試上傳資料。
6. 按一下對話方塊頁面上的確定。






系統會以預先定義的名稱建立資料集；您可以視需要覆寫此資料集。





7. 按兩下欄標題下第一列的任何儲存格，以起始列。



秘訣：

任何沒有值的必要儲存格都會以紅色大綱反白。以預設常數值設定的任何屬性都會顯示預設值。
8. 按兩下表頭在資料欄標題後包含 [..] 符號的儲存格。這會開啟可搜尋的值清單。

   

   
   
9. 請為試算表資料列中的每個空白儲存格輸入有效資料。

秘訣：

使用應用程式中的新人員任務來識別屬性的有效值。
10. 若要測試試算表是否載入有效資料，請按一下試算表載入器工具列上的其他 > 上傳。





11. 在任何顯示的對話方塊頁面上按一下確定。
12. 請定期按一下重新整理，以重新整理試算表資料列狀態。






上傳進度會變更狀態，直到處理完成時狀態為「成功」或「錯誤」。






如果您收到錯誤狀態，請複查錯誤訊息，並視需要進行更正。按一下上傳以重新提交資料集中的更正試算表資料列。

13. 瀏覽至人員管理任務，確保可看見您的新僱用員工。

秘訣：

在應用程式中查看您的員工可能會有短暫的延遲。

作業 5：設定屬性

在此任務中，您將瞭解如何設定範本屬性的預設值、隱藏不希望使用者更新的屬性、設定自動產生的人員編號，以及變更資料欄標題與提示。

設定屬性可簡化使用者的資料輸入，並可限制一般使用者可執行的動作。例如，您可以將動作代碼預設為 HIRE，然後在試算表中隱藏此屬性。從此範本產生的試算表只能執行 HIRE 動作。

預設值

您將在本教學課程中設定三種預設類型：

• 常數
• 其他選取的屬性
• 表示式

其他類型則視預設之屬性的資料類型而定。

設定常數預設值

設定這些屬性，將它們的值預設為常數值。

1. 按一下動作代碼屬性資料欄標題上的連結。





2. 使用編輯面板複查屬性的組態，以及您可以更新的欄位。



屬性的預設值已預先設定為無。

3. 將屬性預設值變更為常數值。常數值欄位便會顯示。





4. 指定 HIRE 值，然後按一下儲存。





5. 編輯這些其他屬性來設定它們的預設值：

屬性	物件	常數值
名稱 類型	人員姓名	GLOBAL
生效順序	僱用條款	1
有效的最新變更	僱用條款	Y
指派狀態類型	僱用條款	ACTIVE_PROCESS

附註：

當您指定查尋驗證屬性的預設值時，必須指定查尋代碼，而非意義。
6. 使用設定屬性表格中的預設資料欄複查設定的預設值。

設定其他屬性值的預設值

您可以設定屬性，以預設其在範本中已選取之其他屬性的值。

秘訣：

將試算表資料上傳至暫存表格時，會產生屬性值的副本，且不會在範本的試算表中看到。從其他選取的屬性預設屬性值時，一律隱藏預設屬性。

1. 編輯 Worker 物件上的 Effective Start Date 屬性。



附註：

建立新僱用員工時，職工記錄的生效日期必須與員工的開始日期相同。
2. 指定現有選取的屬性的預設。





3. 使用「屬性鍵值」欄位上的可搜尋值清單，從「職工」物件選取「開始日期」屬性。



秘訣：

值清單使用屬性鍵來唯一識別範本中的每個屬性。您可以在「設定屬性」表格的屬性索引鍵資料欄中找到每個屬性的屬性索引鍵。



4. 取消勾選顯示核取方塊，即可在試算表中隱藏屬性。





5. 按一下儲存。

附註：

範本設計工具會自動將下階層次物件上上上下階關係與生效日期欄位的使用者索引鍵屬性預設為上階屬性值，因此不需要手動執行此作業。
6. 編輯工作關係、僱用條款及指派物件上的動作代碼，以從工作者物件上的動作代碼預設值，並隱藏試算表中的屬性。





7. 按一下儲存。



因為這些屬性已隱藏，所以它們將會從「設定屬性」表格中消失。

8. 搜尋「動作」，然後按一下顯示隱藏的屬性篩選，以顯示所有出現的「動作代碼」屬性。

   

   
   
9. 編輯這些屬性以設定現有所選屬性的預設值，然後取消勾選顯示核取方塊：

屬性	物件	現有的選取屬性
開始日期	工作關係	Worker_StartDate
法規碼	人員法規資料	人員姓名 _ 法規代碼
指派狀態類型	指派項目	工作條款 _ 指派狀態類型代碼



10. 儲存所做的變更。

使用表示式設定預設值

您可以使用 Groovy 表示式來定義屬性的預設值。這些可以藉由指定可唯一識別範本中屬性的屬性索引鍵，來包含其他所選屬性的參考。

1. 尋找「人員編號」屬性的屬性索引鍵。



秘訣：

屬性索引鍵通常是物件名稱 (Worker)，後面接著基本屬性名稱 (PersonNumber)。
2. 編輯僱用條款物件上的指派編號屬性。
3. 指定使用表示式的預設，然後指定 ET + Worker_PersonNumber 的 Groovy 表示式。



4. 按一下儲存。
5. 使用 E + Worker_PersonNumber 表示式，設定指派物件上指派編號屬性的表示式預設值。



6. 儲存您的變更。

秘訣：

建議您在順利測試過常數值或表示式之前，不要隱藏預設為常數值或表示式的屬性。
7. 請考慮設定其他屬性的預設值以簡化資料輸入，例如法規代碼、職工類型、業務單位及法定雇主。您可以隱藏這些項目，或讓一般使用者視需要加以置換。

自動產生的人員編號

只有在您是自動產生人員號碼時，才需要完成此步驟。

1. 編輯工作程式物件上的人員編號屬性。
2. 勾選自動產生 (Autogenerate) 核取方塊。



附註：

雖然在順利上傳職工時會產生人員編號，但試算表的使用者仍必須提供值，才能在試算表中區分每位職工。提供的值將會由自動產生的值取代。
3. 按一下儲存。
4. 編輯僱用條款物件上的指派編號屬性，並勾選自動產生核取方塊。





5. 取消勾選顯示核取方塊，即可在從此範本產生的試算表中隱藏「指派編號」。

秘訣：

請勿移除先前任務中設定的指派編號預設值。這會根據「人員編號」來植入這些屬性的值。
6. 編輯指派物件上的指派編號，以自動產生其值，並將其從試算表中隱藏。
7. 儲存所做的變更。

隱藏欄

成功測試常數與運算式預設值之後，請隱藏您不希望使用者變更的預設屬性。

1. 編輯要從產生的試算表中隱藏的屬性。
2. 取消勾選顯示核取方塊。





3. 按一下儲存。
4. 針對您不希望使用者變更的其他預設屬性，例如「動作代碼」、「生效順序」、「生效最新變更」及「指派狀態類型」。

秘訣：

您可以透過複查「設定屬性」表格上的預設資料欄，輕鬆識別使用預設值設定的屬性。

必要的屬性

在此步驟中，您將編輯要在試算表中視需要反白顯示的屬性。

1. 編輯名字屬性，然後勾選必要核取方塊。





2. 按一下儲存。
3. 針對您希望使用者提供的任何其他預設非必要屬性重複此動作。

欄標題與提示

變更資料欄標題和提示，以使用業務使用者將瞭解的術語。例如，如果您要自動產生人員編號，您可能會想要重新命名人員編號資料欄標題與提示。

1. 編輯人員編號屬性。
2. 將資料欄標題變更為資料列識別碼，如此當以不同的人員編號建立人員時，使用者就不會被混淆。
3. 將欄提示變更為數字，以唯一識別試算表中的列。



秘訣：

當您將游標暫留在試算表的欄標題上時，便會顯示提示。
4. 按一下儲存。

重新排列資料欄

資料欄在表格中的顯示順序，會決定這些資料欄在試算表中的顯示順序。

1. 選取您要移動的屬性，避免按一下「資料欄標題」上的連結。將屬性資料列拖放至其新位置。



秘訣：

您必須先移除任何篩選條件並儲存變更，再嘗試重新排序資料欄。

最佳應用

請注意下列事項：

• 請明確指定要供應的值類型。

  如果屬性預期代碼，則在資料欄標題中包含「代碼」。例如，「國家代碼」，而非「國家」。若要進一步釐清，您可以定義最常用值的預設值，讓使用者知道提供資料的格式。

• 儘可能設定值清單。
• 請考量資料欄的順序。

  如果您已定義相依的值清單，請確定在具有參考值清單的屬性之前，輸入清單所相依的值。

作業 6：修訂參數

您可以置換參數預設值，以置換預設的試算表資料載入行為。在本節中，如果超過 10% 的試算表資料列發生錯誤，您將確保資料載入停止，並啟用增量更新的載入事件。

1. 導覽至覆寫參數步驟 (按一下引導式處理列中的步驟)，或按一下設定屬性步驟中的繼續按鈕。





2. 按一下新增參數，範本參數側邊功能表便會開啟。





3. 選取載入錯誤的百分比上限參數，然後按一下新增。





4. 按一下編輯動作，然後將值更新為 10 。
5. 新增啟用增量更新的載入事件參數，並將其值更新為是。





6. 按一下繼續。

作業 7：新增指示

(選擇性) 在試算表中新增指示，讓使用者瞭解如何使用從此範本產生的試算表。

1. 按一下新增。





2. 指定標題與指示。





3. 按一下新增。

   秘訣：

   如果您有多個指示，請將指示列向上或向下拖曳表格，以變更其顯示順序。
4. 按一下繼續。

作業 8：設定存取

啟用 HSDL 範本前，需要設定兩種角色存取權：

• 資料集作業

  若要讓業務使用者能夠使用此範本，其角色必須被指派範本的資料集存取權，且必須啟用範本。

• 範本維護

  啟用後，您便無法再自動存取以維護範本。您應設定哪個角色具有維護範本的權限。

資料集操作

設定可從此範本產生試算表的角色，以及其擁有的資料集存取權。

附註：

資料安全性區段會指出上傳試算表資料的使用者類型。如果此選項設為相關使用者，您可能會被限制而無法將資料集作業指派給任何角色。指派角色給範本欄位會確認您是否可以。

1. 按一下資料集作業標題下方的新增。





2. 搜尋並選取要指派範本存取權的角色，例如人力資源專員。





3. 按一下新增。

依照預設，將會指派建立、儲存及上傳資料集的存取權給角色。





4. 視需要變更資料集存取權。

資料集作業

操作	描述
建立	可以建立資料集。
儲存	資料集資料可儲存至階段表。
Upload	您可以上傳資料集，並將有效的資料列儲存至應用程式。
回復	資料集可以倒回，刪除已成功載入且後續未更新的資料。還原僅適用於少數業務物件。
全部檢視	範本的所有現有資料集都可以下載與複查，而不只是使用者所建立的資料集。




秘訣：

您可能擁有一個範本，需要一個角色才能建立並儲存資料至階段表，但無法上傳該資料的存取權，另一個角色則無法建立新資料集，但可以複查其他使用者建立的資料集並上傳這些資料集。這可以實現一種核准形式。

樣板維護

範本啟用後，您只能在角色設定為維護範本時加以維護。

這些步驟描述如何指派範本維護。

1. 按一下樣板維護標題底下的新增。





2. 搜尋範本設計工具或維護角色，例如 HSDL 範本設計工具，並新增可維護此範本的角色。





3. 按一下新增。

任務 9：複查並啟動

只有作用中的範本才會顯示在執行試算表資料載入器任務中，且可供 REST 服務使用。對於狀態為草稿的範本，請完成這些步驟。

在複查並啟用步驟中，您可以複查從範本產生的試算表中將看到的資料欄清單，以及其顯示的順序。您也可以複查屬於範本定義但未顯示在試算表中的屬性。

複查

1. 複查試算表屬性清單，檢查資料欄標題與提示中的拼字錯誤，並確認驗證類型、必要狀態、預設值及資料欄順序正確。





2. 按一下隱藏屬性頁籤，即可複查屬於範本定義但未顯示在試算表中的屬性。

   

   
   

驗證並啟用

1. 按一下驗證。

如果樣板有效，您會看到一個對話方塊，詢問是否要啟用樣板？






附註：

如果範本有警告或錯誤，您可以在「驗證訊息」頁籤上複查這些警告或錯誤。





2. 按一下啟用。

   執行試算表資料載入器任務現在可為具有範本資料集存取權之角色的使用者使用您的範本，並且可供 REST 在提供要上傳的 CSV 檔案時使用。

測試業務使用者存取

您現在應該以具有指派給範本存取權之角色的使用者身分登入，並確認範本可在執行試算表資料載入器任務中取得，以及視需要從範本工作產生的試算表。

任務 10：匯出與匯入

在此任務中，您將匯出範本定義，並瞭解如何將範本匯入生產。

您在生產上需要一個 HSDL 範本維護角色，設定成匯入範本所根據業務物件的範本。請參考設定設計與維護 HCM 試算表資料載入器 (HSDL) 範本的存取權教學課程，以取得建立這類角色的步驟。

匯出

當您的樣板經過完整測試且可移至生產環境時，您可以匯出樣板定義。

1. 使用您的「HSDL 範本設計工具」角色登入應用程式，並導覽至試算表範本任務。
2. 搜尋您的範本。
3. 按一下動作按鈕，然後選取匯出動作。






您的範本定義會匯出為 XML 檔案，且應該可在您的「下載」目錄中使用。

匯入

1. 導覽至資料交換中的試算表範本任務。
2. 按一下匯入。





3. 在匯入試算表範本面板上，指定描述試算表範本支援之使用案例的名稱，例如新僱用員工。
4. 如果範本是特定法規，請指定其適用的「法規資料群組」。
5. 選取要匯入的範本 XML 定義檔案。
6. 提供描述，讓業務使用者瞭解何時使用此範本。



秘訣：

系統會根據指定的名稱預設代碼，但您可以置換此代碼。它必須是唯一的。
7. 按一下匯入。

   您將會返回試算表範本頁面，頁面層級橫幅將會確認範本是否已順利匯入或是否發現問題。



秘訣：

如果發生錯誤，請下載日誌檔以瞭解詳細資訊。
8. 搜尋您匯入的範本，然後按一下範本名稱以編輯範本。
9. 重複任務 8 中的步驟，以設定存取權並指派範本維護角色。
10. 依照任務 9 中的範本驗證與啟用步驟進行。

    具有指派角色的使用者現在可以在執行試算表資料載入器任務中存取您的範本。

接下來的步驟

下列教學課程將進一步擴展您的 HCM 試算表資料載入器知識：

• 定義 HSDL 範本以在試算表列中建立多個子記錄
• 在 HCM 試算表資料載入器範本中包含彈性欄位節段

相關連結

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

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

致謝

• 作者 - Ema Johnson (HCM 資料載入器與 AI 首席產品經理)

其他學習資源

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

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

---

標題與著作權資訊

建立 HCM 試算表資料載入器範本以大量載入新僱用員工

G34844-03

2026 年 5 月

Copyright ©2026,

Oracle 和 (或) 其關係企業。