簡介

本教學課程說明產生和編輯業務物件特定對應檔案的步驟，然後將這些對應檔案匯入 Oracle Integration Cloud (OIC) 以將資料轉換成 HCM 資料載入器業務物件檔案資源配置。

目標

在本教學課程中，您將：

• 啟用產生對應檔案。
• 產生一般和自訂對應檔。
• 編輯產生的對應檔。

必要條件

若要完成本教學課程的步驟，您必須存取：

• 設定 HCM 資料載入器任務以啟用對應檔案產生。
• 檢視業務物件任務，以產生一般對應檔案。
• HCM 資料載入器可匯入測試檔案並產生自訂對應檔案。

請參閱設定 HCM 資料載入器 (HDL) 的存取和瞭解 HDL 安全性選項教學課程，瞭解設定此存取的步驟。

任務 1：啟用產生對應檔案

在此步驟中，您將啟用在 HCM 資料載入器中產生 OIC 對應檔案。

產生對應檔案的方法有兩種：

• 產生完整的一般業務物件檔案。

  使用檢視業務物件任務來產生與下載描述完整業務物件階層的對應檔案。

• 產生自訂業務物件檔案。

  匯入與載入測試檔案，以確認您的檔案形狀，同時以匯入檔案的形狀產生對應檔案。

若要啟用產生對應檔，請執行下列動作：

1. 登入 Oracle HCM Cloud 應用系統。
2. 導覽至我的企業 > 設定與維護。
3. 選取 HCM 資料載入器功能區域。
4. 按一下設定 HCM 資料載入器任務。





5. 搜尋產生業務物件對應檔案參數。





6. 將置換設為是。

啟用產生對應檔案時，有兩種「置換」選項可供使用：

覆寫值	描述
僅限自訂	啟用產生「HCM 資料載入器」上傳之業務物件資料檔案對應檔案的功能。
是	除了自訂檔案之外，還能從「檢視業務物件」任務產生一般對應檔案。



7. 按一下儲存。

秘訣：

如需更多資訊，請在 HCM 資料載入器組態參數主題中搜尋產生業務物件對應檔案。

作業 2：產生完整的映射檔案

在此步驟中，您將產生完整業務物件階層的對應檔案。

1. 登入 Oracle HCM Cloud 應用系統。
2. 瀏覽至我的從屬端群組 > 資料交換 > 檢視業務物件。
3. 搜尋並選取文件記錄業務物件，然後按一下重新整理物件。





4. 重新整理表格內容，直到整合對應檔案資料欄顯示文件記錄業務物件的下載檔案圖示為止。





5. 按一下檔案下載圖示，就會下載對應檔。

附註：

您將會在工作 4 中編輯此檔案。

工作 3：產生自訂對應檔案

這是產生 OIC 對應檔的建議方法。您必須先在 OIC 整合的資源配置中建立 HCM 資料載入器檔案，才能在其中產生檔案。這樣一來，您就能在建置整合之前，測試 HDL 檔案資源配置是否正確。

1. 定義 HDL 業務物件檔案。您可以下載工作對應 File.zip 檔案，以供本教學課程使用。
2. 登入 Oracle HCM Cloud 應用系統。
3. 瀏覽至我的從屬端群組 > 資料交換 > 匯入及載入資料。
4. 按一下匯入檔案。
5. 將下載的工作者對應 File.zip 拖曳至選擇檔案按鈕，然後按一下複查參數。





6. 勾選產生業務物件對應檔案核取方塊。





7. 按一下送出。
8. 按一下確定，即可關閉已送出確認視窗。
9. 重新整理資料集表格，直到看見您的測試檔案為止。
10. 偶爾會重新整理資料集的業務物件表格，直到匯入完成為止。
11. 按一下業務物件表格工具列上的下載對應檔案，以下載您的自訂對應檔案。

    匯入業務物件檔案之後，就會啟用此按鈕。

秘訣：

如果您有任何匯入錯誤，可能是檔案形狀不正確。複查並更正任何錯誤，並僅在您順利匯入測試檔案時下載對應檔案。

工作 4：編輯對應檔案

您可以編輯由「HCM 資料載入器」產生的對應檔案。在此任務中，您將編輯您在任務 2 中產生的「文件記錄」對應檔案。

瞭解檔案資源配置

1. 開啟您在任務 2 中產生的 DocumentsOfRecord.nxsd 檔案。
2. 複查檔案內容。所有對應檔案皆遵循相同的結構；有三種類型的元素群組：
   • ObjectFileData 群組

     檔案頂端將會有一個 ObjectFileData 群組。對於階層中的每個業務物件，此群組包含一個 ObjectLabel 元素和一個物件元素：

     • ObjectLabel 元素定義 METADATA 行。
     • 物件元素定義 MERGE (資料) 行。

     秘訣：

     也會定義行的格式。

   • ObjectLabel 群組

     物件階層中的每個業務物件都有一個 ObjectLabel 群組。ObjectLabel 群組包含用來定義業務物件可用屬性名稱的元素。當 OIC 使用此對應產生檔案時，屬性名稱 (和終止字元) 會附加至上述 ObjectFileData 群組中定義的 ObjectLabel 元素。

   • 物件群組

     物件階層中的每個業務物件都有一個物件群組。物件群組包含可對應業務物件可用屬性值的元素。當 OIC 使用此對應產生檔案時，屬性值 (和終止字元) 會附加至上述 ObjectFileData 群組中定義的物件元素。

3. 查閱 ObjectFileData 群組 DocumentOfRecordFileData 。

DocumentsOfRecord 商業物件階層有兩個物件：DocumentOfRecord 和 DocumentAttachment。為階層中的每個業務物件產生 ObjectLabel 元素和 Object 元素：





4. 查閱 ObjectLabel 群組 DocumentOfRecordsLabel 。

此群組包含用來定義 DocumentsOfRecord 業務物件可用之每個屬性名稱的元素，包含任何已部署的彈性欄位節段屬性。






附註：

完整的群組太大，無法顯示於此處。
5. 複查物件群組 DocumentOfRecord 。

此群組包含一個元素，可對應 DocumentsOfRecord 業務物件可用的每個屬性值。






秘訣：

ObjectLabel 與相同業務物件之物件群組中的屬性順序必須相符。
6. 查閱 ObjectLabel 群組 DocumentAttachmentLabel 。

此群組包含定義 DocumentAttachment 業務物件可用之每個屬性名稱的元素。





7. 複查物件群組 DocumentAttachment 。

此群組包含一個元素，可對應 DocumentAttachment 業務物件可用的每個屬性值。

編輯 DocumentOfRecord 資源配置

OIC 要求您提供對應檔案中元素所定義之每個屬性的值。如果您在產生的 HDL 檔案中不需要屬性，請從 ObjectLabel 和「物件」群組中移除該屬性的元素。

1. 針對所有屬性刪除 DocumentsOfRecordLabel 與 DocumentsOfRecord 群組中的元素，但下列除外：
   • DocumentName
   • DocumentCode
   • 人員編號
   • DocumentType
2. 重新排序這些群組中的元素，使它們以此屬性順序出現：
   • 人員編號
   • DocumentType
   • DocumentCode
   • DocumentName

   

   
   

   附註：

   群組中的最後一個元素有不同的 terminatedBy 值。大部分元素都由管字元終止，而最後一個元素則由行字元結束。編輯檔案時，請確保每個群組中的最後一個元素都有行結尾終止字元。

   秘訣：

   這些群組中的元素順序會決定屬性包含在 OIC 所產生之檔案中的順序。例如，此結構將產生此 METADATA 行：

   METADATA|DocumentsOfRecord|PersonNumber|DocumentType|DocumentCode|DocumentName

編輯 DocumentAttachment 資源配置

1. 針對所有屬性刪除 DocumentAttachmentLabel 與 DocumentAttachment 群組中的元素，但下列除外：
   • 職稱
   • File
   • DataTypeCode
   • DocumentCode
   • 人員編號
   • DocumentType
   • URLorTextorFileName
2. 重新排序這些群組中的元素，使它們以此屬性順序出現：
   • 人員編號
   • DocumentType
   • DocumentCode
   • DataTypeCode
   • URLorTextorFileName
   • 職稱
   • File

   

   
   

   這將會產生此 METADATA 行：

   METADATA|DocumentAttachment|PersonNumber|DocumentType|DocumentCode|DataTypeCode|URLorTextorFileName|Title|File

您現在可以將檔案匯入 OIC，以產生 HDL DocumentOfRecord.dat 檔案。

附註：

如果不需要提供整個業務物件定義的資料，您可以從產生的對應檔案中移除整個業務物件定義。若要這麼做，請確定除了從 ObjectFileData 群組移除 ObjectLabel 和物件元素之外，同時移除業務物件的 ObjectLabel 和物件群組。

新增 SET 指示至您的檔案資源配置

您可能需要在業務物件檔案中包含 SET 指示。最簡單的方法是編輯 nxsd，以建立可讓您在 OIC 對應中定義 SET 指示的元素。

在此步驟中，您將編輯您在「任務 3」中產生的 Worker.nxsd。

1. 在文字編輯器中開啟您在工作 3 中產生的 Worker.nxsd 檔案。

WorkerFileData 元素應該如下所示：





2. 編輯此元素以在 WorkerLabel 參照之前引入參照項目。新增：

<element ref="tns:SetInstructions" minOccurs="0" nxsd:startsWith="">

3. 立即在 WorkerFileData 元素下方建立新的 SetInstructions 元素：

<!-- SetInstructions -->
  <element name="SetInstructions">
      <complexType>
         <sequence>
            <element name="Instruction" type="string" nxsd:style="terminated" nxsd:terminatedBy="${eol}" />
         </sequence>
      </complexType>
   </element>

秘訣：

這支援一個 SET 指令 。如果您需要在要由 OIC 產生的檔案中定義多個 SET 指示，請建立其他元素，例如 Instruction1、Instruction2。

接下來的步驟

請依照下列教學課程中的步驟，產生 OIC 用來將您的來源資料產生至 HCM 資料載入器業務物件檔案形狀的對應檔案。

• Oracle Integration Cloud (OIC) 中 HCM 資料載入器 (HDL) 整合的設定作業
• Oracle Integration Cloud (OIC) 的加密 HCM 資料載入器 (HDL) 整合

致謝

• 作者 - Ema Johnson (資深首席產品經理)

其他學習資源

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

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

---

標題與著作權資訊

產生 HCM 資料載入器 (HDL) 對應檔案以用於 Oracle Integration Cloud (OIC)

G35331-01

2025 年 5 月

Copyright ©2025,

Oracle 和 (或) 其關係企業。