イントロダクション

HCMデータ・ローダー(HDL)を使用して、付加フレックスフィールド・セグメントおよび拡張可能フレックスフィールド・セグメントにデータをバルク・ロードし、それをサポートするHDLオブジェクトの添付およびイメージをアップロードできます。

ノート:

HCMデータ・ローダーを使用してファイルを作成およびアップロードする方法を理解している必要があります。HDLを初めて使用する場合は、最初に「前提条件」セクションにリストされているチュートリアルを完了する必要があります。

目的

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

  • 付加フレックスフィールド・セグメントのデータの提供方法を理解します。
  • 拡張可能フレックスフィールド・セグメントにデータをロードします。
  • イメージおよび添付の提供方法の理解。
  • 就業者オブジェクトを使用して個人イメージをロードします。

前提条件

このチュートリアルを完了するには、次のものが必要です。

このチュートリアルを試す前に、次のチュートリアルを完了することをお薦めします。


タスク1: フレックスフィールド属性名の検索

このステップでは、構成したフレックスフィールド・セグメントのHDL属性名を検索する方法を学習します。フレックスフィールドの構成が完了し、変更がデプロイされていることを前提としています。

  1. HCMデータ・ローダー・アクセス権を持つユーザーでアプリケーションにログインします。
  2. 「データ交換」→「ビジネス・オブジェクトの表示」にナビゲートします。
  3. 「例による問合せ」フィールドを使用して、「ジョブ」ビジネス・オブジェクトを検索します。
  4. ビジネス・オブジェクトを選択し、「オブジェクトのリフレッシュ」をクリックします。
    5. 「オブジェクトのリフレッシュ」をクリックします。

  5. リクエストのスケジュール ページで [送信]をクリックします。
  6. ページ・ヘッダーの「プロセス結果の表示」をクリックします。
  7. オブジェクトのリフレッシュ・プロセスが完了するまで表をリフレッシュし、「ビジネス・オブジェクトの表示」ページに戻ります。

    8. ヒント :

    オブジェクトをリフレッシュする必要があるのは、新しいフレックスフィールド・セグメントを構成した場合のみです。このプロセスでは、オブジェクトの使用可能な属性のリストが更新されます。
  8. 「ジョブ」ビジネス・オブジェクト名をクリックして、「ビジネス・オブジェクト詳細」ページにナビゲートします。
  9. 左側にオブジェクト階層が表示され、階層内のフレックスフィールド属性情報を検索するコンポーネントをクリックします。
  10. 「フレックスフィールド属性」タブをクリックします。
  11. 「コンテキスト」を属性を検索するコンテキストに変更し、「検索」をクリックします。
    フレックスフィールド属性タブ

  12. HCMデータ・ローダー・ファイルで使用する属性名のリストが表示されます。
    13. フレックスフィールド属性

タスク2: フレックスフィールド・データのロード

このステップでは、METADATA行とMERGE行を指定して、データをフレックスフィールド・セグメントにアップロードする方法を学習します。

フレックスフィールド・コンテキスト

フレックスフィールド・セグメントをロードする場合、HDLはロードされるフレックスフィールド・データのコンテキストを理解する必要があります。付加フレックスフィールドの場合、グローバル・セグメントをコンテキスト固有のセグメントとともに移入できますが、MERGE明細では1つのコンテキストについてのみデータをロードできます。

  1. 付加フレックスフィールドと拡張可能フレックスフィールドの両方について、コンテキストは属性を使用して定義されます。
    2. FLEX:{flexfield code}

    例: FLEX:PER_JOBS_DFFおよびFLEX:PER_JOBS_LEG_EFF

  2. フレックスフィールド・セグメントを指定する場合、属性名にフレックスフィールド・コードおよびコンテキストを指定するヒントが含まれます。
    3. {flexfield attribute name}({flexfield code}={context code})

    たとえば、clearanceLevel(PER_JOBS_DFF=US_JOB_REQ)です。この形式は、クリアランス・レベル・セグメントがUS_JOB_REQコンテキスト内のPER_JOBS_DFFフレックスフィールドに属することをHDLに指示します。


付加フレックスフィールド・セグメントのロード中

付加フレックスフィールドにより、ビジネス・オブジェクト・コンポーネントが拡張されます。ビジネス・オブジェクト・コンポーネントのコア属性と同じMERGE行に、付加フレックスフィールドの属性を指定できます。METADATA行には、データをロードするフレックスフィールド・コードと付加フレックスフィールド属性の両方を含めることができます。

付加フレックスフィールド・セグメントは事前構成されていないため、アップロードできる例を提供できません。次のステップを使用して、付加フレックスフィールド・データのロード方法を理解しますが、属性名と値は構成に関連するデータに置き換える必要があります。

  1. 新しいファイルを作成し、コア属性を定義するMETADATA行と、データを含める付加フレックスフィールド属性を指定します。たとえば次のようにします。
    2. METADATA|Job|SourceSystemOwner|SourceSystemId|EffectiveStartDate|SetCode|JobCode|Name|FLEX:PER_JOBS_DFF|clearanceLevel(PER_JOBS_DFF=US_JOB_REQ)
  2. ファイルにMERGE行を追加して、コア属性値、フレックスフィールド・コンテキストおよびフレックスフィールド・セグメント値を指定します。次に例を示します。
    3. MERGE|Job|VISION|SMGR|2000/01/01|COMMON|SNR_MGR|Senior Manager|US_JOB_REQ|HIGH

    これにより、HIGHの値が、US_JOB_REQフレックスフィールド・コンテキスト内に存在する「クリアランス・レベル」付加フレックスフィールド・セグメントにロードされます。


拡張可能フレックスフィールド・セグメントのロード

フレックスフィールド・コードおよびコンテキストに加えて、拡張可能フレックスフィールドにはカテゴリ・コードもあり、EFF_CATEGORY_CODE属性に指定する必要があります。

  1. 新しいファイルを作成し、次のMETADATA行を追加します。
    2. METADATA|JobLegislative|SourceSystemOwner|SourceSystemId|JobId(SourceSystemId)|EffectiveStartDate|LegislationCode|InformationCategory|FLEX:PER_JOBS_LEG_EFF|EFF_CATEGORY_CODE|_EEO1_CATEGORY(PER_JOBS_LEG_EFF=HRX_US_JOBS)|_FLSA_STATUS(PER_JOBS_LEG_EFF=HRX_US_JOBS)
  2. 次のMERGE行をファイルに追加します。
    3. MERGE|JobLegislative|VISION|MGR_JOB_LEG|MGR|2000/01/01|US|HRX_US_JOBS|HRX_US_JOBS|JOB_LEG|PROFESSIONAL|NONEXEMPT

    この表は、このファイルに指定されているフレックスフィールド属性について説明しています。

    属性名 Value 説明
    フレックス:PER_JOBS_LEG_EFF HRX_US_JOBS フレックスフィールドのコンテキスト・コード。
    EFF_CATEGORY_CODE JOB_LEG フレックスフィールドのカテゴリ・コード。
    _EEO1_CATEGORY(PER_JOBS_LEG_EFF=HRX_US_JOBS) 専門家 PER_JOBS_LEG_EFFフレックスフィールドのHRX_US_JOBSコンテキストのEEO1カテゴリ・セグメント。
    _FLSA_STATUS(PER_JOBS_LEG_EFF=HRX_US_JOBS) 非免除 PER_JOBS_LEG_EFFフレックスフィールドのHRX_US_JOBSコンテキストのFLSAステータス・セグメント。

    ヒント :

    これらのフレックスフィールド・セグメントは参照検証済です。参照コードが指定されますが、フレックスフィールド属性に意味を指定する必要がある場合は、_EEO1_CATEGORY_Display(PER_JOBS_LEG_EFF=HRX_US_JOBS)などの_Displayを属性名に追加します。

  3. ファイルを保存し、Job.datという名前を付けます。
  4. Job.datファイルを任意のファイル名に圧縮(zip)します。
  5. 「データのインポートおよびロード」タスクを使用して、ジョブ・フレックスフィールド・データをインポートおよびロードします。

タスク3: イメージおよび添付のロード

このステップでは、個人イメージをアップロードするファイルを作成します。添付は同じ方法でロードされます。

「HCMデータ・ローダー(HDL)を使用した新規採用の作成およびロード」チュートリアルで作成した新規採用の例を拡張します。

  1. 新規ファイルを作成し、次のものを追加します。
    2. METADATA|PersonImage|SourceSystemOwner|SourceSystemId|PersonId(SourceSystemId)|ImageName|Image|PrimaryFlag
MERGE|PersonImage|EMP|HDL001_IMG|HDL001|Chris Wells Profile|chris_wells.png|Y
MERGE|PersonImage|EMP|HDL002_IMG|HDL002|Lorraine Hugh Profile|lorraine_hugh.jpg|Y

    PersonImageコンポーネントは、従業員のイメージをアップロードするために使用されます。

    • 各PersonImageレコードは、ソース・キーによって識別されます。たとえば、EMP、HDL001_IMGです。
    • 親レコードは、PersonId属性を使用して識別されます。ソース・システムIDを使用して親レコードを識別するため、属性には(SourceSystemId)ヒントがあります。
    • ImageName属性は、イメージの名前を指定するために使用されます。
    • 「イメージ」属性を使用して、アップロードするファイルの名前を指定します。
  2. ファイルを保存し、Worker.datという名前を付けます。

    3. ヒント :

    ファイルにはPersonImageレコードのみがありますが、PersonImageコンポーネントが属するオブジェクト階層の名前を指定する必要があります。
  3. Worker.datファイルと同じディレクトリに、サブディレクトリを作成してBlobFilesという名前を付けます。

    4. ヒント :

    イメージおよび添付ファイルは、BLOBまたはCLOBデータ型を持つ属性にロードされます。使用する属性のデータ型に指定したディレクトリに、イメージ・ファイルおよび添付ファイルを指定する必要があります。たとえば、BlobFilesまたはClobFilesです。
  4. 指定されたファイルを、Worker.datファイル内の Image属性の BlobFilesディレクトリに追加します。たとえば、chris_wells.pngおよびlorraine_hugh.jpgです。

    5. ヒント :

    独自のファイルを使用することも、chris_wells.pngおよび lorraine_hugh.jpgをダウンロードすることもできます。
  5. Worker.datファイルと BlobFilesサブディレクトリを任意のファイル名に圧縮(zip)するか、Person Images.zipファイルをダウンロードして編集できます。
  6. HCMデータ・ローダーを使用してファイルをアップロードできるようになりました。

次のステップ

次のチュートリアルでは、HCMデータ・ローダーに関する知識をさらに深めます。

HDLおよびHSDLの最新のチュートリアルは、Cloud Customer Connectのこのトピックで公開されています。

詳細は、次のヘルプ・トピックを参照してください。

謝辞

  • 著者 - Ema Johnson (シニア・プリンシパル・プロダクト・マネージャー)

その他の学習リソース

docs.oracle.com/learnで他のラボを確認するか、Oracle Learning YouTubeチャネルで無料のラーニング・コンテンツにアクセスしてください。また、education.oracle.com/learning-explorerにアクセスして、Oracle Learning Explorerになります。

製品ドキュメントについては、Oracle Help Centerを参照してください。