イントロダクション

このチュートリアルでは、ビジネス・オブジェクト固有のマッピング・ファイルを生成および編集するステップについて説明します。その後、Oracle Integration Cloud (OIC)にインポートして、データをHCMデータ・ローダーのビジネス・オブジェクト・ファイル形式に変換できます。

目的

このチュートリアルの内容:

• マッピング・ファイルの生成を有効にします。
• 汎用マッピング・ファイルとカスタム・マッピング・ファイルを生成します。
• 生成されたマッピング・ファイルを編集します。

前提条件

このチュートリアルのステップを完了するには、次のものにアクセスする必要があります。

• マッピング・ファイルの生成を有効にするための「HCMデータ・ローダーの構成」タスク。
• 汎用マッピング・ファイルを生成するための「ビジネス・オブジェクトの表示」タスク。
• HCMデータ・ローダー: テスト・ファイルをインポートし、カスタム・マッピング・ファイルを生成します。

このアクセスを構成するステップは、「HCMデータ・ローダー(HDL)へのアクセスの構成およびHDLセキュリティ・オプションの理解」チュートリアルを参照してください。

タスク1: マッピング・ファイル生成の有効化

このステップでは、HCMデータ・ローダー内でのOICマッピング・ファイルの生成を有効にします。

マッピング・ファイルを生成するには、次の2つの方法があります。

• 完全な汎用ビジネス・オブジェクト・ファイルを生成します。

  「ビジネス・オブジェクトの表示」タスクを使用して、完全なビジネス・オブジェクト階層を記述するマッピング・ファイルを生成およびダウンロードします。

• カスタム・ビジネス・オブジェクト・ファイルを生成します。

  インポートしたファイルのシェイプでマッピング・ファイルを生成している間、テスト・ファイルをインポートおよびロードしてファイル・シェイプを確認します。

マッピング・ファイルの生成を有効にするには:

1. Oracle HCM Cloudアプリケーションにログインします。
2. 「自分の企業」→「設定および保守」に移動します。
3. 「HCMデータ・ローダー」機能領域を選択します。
4. 「HCMデータ・ローダーの構成」タスクをクリックします。





5. 「ビジネス・オブジェクト・マッピング・ファイルの生成」パラメータを検索します。





6. 「上書き」を「はい」に設定します。

マッピング・ファイルの生成を有効にする場合は、次の2つの「オーバーライド」オプションを使用できます。

オーバーライド値	説明
カスタムのみ	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. 「Import File」をクリックします。
5. ダウンロードした「ワーカー・マッピング」File.zipを「ファイルの選択」ボタンにドラッグし、「パラメータの確認」をクリックします。





6. 「ビジネス・オブジェクト・マッピング・ファイルの生成」チェック・ボックスを選択します。





7. 「送信」をクリックします。
8. 「OK」をクリックして、「発行済」確認ウィンドウを終了します。
9. テスト・ファイルが表示されるまで、「データ・セット」表をリフレッシュします。
10. インポートが完了するまで、データ・セットの「ビジネス・オブジェクト」表をリフレッシュする場合があります。
11. 「ビジネス・オブジェクト」表のツールバーの「マッピング・ファイルのダウンロード」をクリックして、カスタム・マッピング・ファイルをダウンロードします。

    このボタンは、ビジネス・オブジェクト・ファイルがインポートされると有効になります。

ヒント :

インポート・エラーがある場合は、ファイルの形状が正しくない可能性があります。エラーをレビューして修正し、マッピング・ファイルをダウンロードするのは、テスト・ファイルを正常にインポートした場合のみです。

タスク4: マッピング・ファイルの編集

HCMデータ・ローダーによって生成されたマッピング・ファイルを編集できます。このタスクでは、タスク2で生成した文書レコード・マッピング・ファイルを編集します。

ファイル・シェイプの理解

1. タスク2で生成したDocumentsOfRecord.nxsdファイルを開きます。
2. ファイルの内容を確認します。すべてのマッピング・ファイルは同じ構造に従っています。次の3つのタイプの要素グループがあります。
   • ObjectFileDataグループ

     ファイルの上部には、1つのObjectFileDataグループがあります。階層内の各ビジネス・オブジェクトに対して、このグループにはObjectLabel要素とオブジェクト要素が含まれます。

     • ObjectLabel要素は、METADATA行を定義します。
     • Object要素は、MERGE (データ)行を定義します。

     ヒント :

     行の書式も定義されます。

   • ObjectLabelグループ

     オブジェクト階層内のすべてのビジネス・オブジェクトに対してObjectLabelグループがあります。ObjectLabel groupには、ビジネス・オブジェクトで使用可能な属性の名前を定義する要素が含まれます。このマッピングを使用してOICがファイルを生成すると、前述のObjectFileDataグループで定義されているObjectLabel要素に属性名(およびターミネータ)が追加されます。

   • 「オブジェクト」グループ

     オブジェクト階層内のすべてのビジネス・オブジェクトに対するオブジェクト・グループがあります。オブジェクトのグループには、ビジネス・オブジェクトで使用可能な属性の値をマップするための要素が含まれます。このマッピングを使用してOICがファイルを生成すると、属性値(および終了記号)が、前述のObjectFileDataグループで定義されているオブジェクト要素に追加されます。

3. ObjectFileDataグループDocumentOfRecordFileDataを確認します。

DocumentsOfRecordビジネス・オブジェクト階層には、DocumentOfRecordとDocumentAttachmentの2つのオブジェクトがあります。ObjectLabel要素とObject要素は、階層内の各ビジネス・オブジェクトに対して生成されます。





4. ObjectLabelグループDocumentOfRecordsLabelを確認します。

このグループには、配置済フレックスフィールド・セグメント属性など、DocumentsOfRecordビジネス・オブジェクトで使用可能な各属性の名前を定義する要素が含まれます。






ノート:

グループ全体が大きすぎてここに表示できません。
5. オブジェクト・グループDocumentOfRecordを確認します。

このグループには、DocumentsOfRecordビジネス・オブジェクトで使用可能な各属性の値をマップする要素が含まれます。






ヒント :

同じビジネス・オブジェクトのObjectLabelおよびオブジェクト・グループ内の属性の順序が一致する必要があります。
6. ObjectLabelグループDocumentAttachmentLabelを確認します。

このグループには、DocumentAttachmentビジネス・オブジェクトで使用可能な各属性の名前を定義する要素が含まれます。





7. オブジェクト・グループDocumentAttachmentを確認します。

このグループには、DocumentAttachmentビジネス・オブジェクトで使用可能な各属性の値をマップする要素が含まれます。

DocumentOfRecordシェイプの編集

OICでは、マッピング・ファイルの要素によって定義されたすべての属性に値を指定する必要があります。生成されたHDLファイルで属性が不要な場合は、ObjectLabelグループとオブジェクト・グループから属性の両方の要素を削除します。

1. 次のものを除くすべての属性について、DocumentsOfRecordLabelおよびDocumentsOfRecordグループから要素を削除します。
   • ドキュメント名
   • DocumentCode
   • PersonNumber
   • DocumentType
2. これらのグループ内の要素を、次の属性順に表示されるように順序変更します。
   • PersonNumber
   • DocumentType
   • DocumentCode
   • ドキュメント名

   

   
   

   ノート:

   グループ内の最後の要素のterminatedBy値は異なります。ほとんどの要素はパイプ文字で終了し、最後の要素は行末文字で終了します。ファイルを編集する際には、各グループの最後の要素の行末端文字があることを確認してください。

   ヒント :

   これらのグループ内の要素の順序によって、OICによって生成されるファイルに属性が含まれる順序が決まります。たとえば、この構造では次のMETADATA行が生成されます。

   METADATA|DocumentsOfRecord|PersonNumber|DocumentType|DocumentCode|DocumentName

DocumentAttachmentシェイプの編集

1. 次のものを除くすべての属性について、DocumentAttachmentLabelおよびDocumentAttachmentグループから要素を削除します。
   • 役職
   • File
   • DataTypeCode
   • DocumentCode
   • PersonNumber
   • DocumentType
   • URLorTextorFileName
2. これらのグループ内の要素を、次の属性順に表示されるように順序変更します。
   • PersonNumber
   • 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>

ヒント :

これは1つの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を参照してください。

---

タイトルおよび著作権情報

Oracle Integration Cloud (OIC)で使用するHCMデータ・ローダー(HDL)マッピング・ファイルの生成

G35327-01

2025年5月

Copyright ©2025,

Oracle and/or its affiliates.