イントロダクション

HCMスプレッドシート・データ・ローダー(HSDL)テンプレートに事前構成済およびカスタム・フレックスフィールド・セグメントを含めることで、一括ロードのスプレッドシート機能を拡張します。

目的

このチュートリアルでは、次のことを行います。

  • カスタム・フレックスフィールド・セグメントの属性マップを生成します。
  • 付加フレックスフィールド・セグメントを含む「部門保守」テンプレートを作成します。
  • テンプレートを拡張して、2つのコンテキストから拡張可能フレックスフィールド・セグメントを追加します。

前提条件

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

  • 「ビジネス・オブジェクトの表示」タスクへのアクセス。
  • 組織ビジネス・オブジェクトのテンプレートを作成するためのアクセス権が割り当てられたロールを持つスプレッドシート・テンプレート・タスクへのアクセス。

ヒント :

「HCMスプレッドシート・データ・ローダー(HSDL)テンプレートを設計および保守するためのアクセスの構成」チュートリアルでは、スプレッドシート・テンプレート・アクセスの構成方法について説明します。

スプレッドシート・テンプレートの作成に精通している必要があります。「スプレッドシート・テンプレート」タスクを使用していない場合は、「HCMスプレッドシート・データ・ローダー・テンプレートの作成」チュートリアルに従って、ナビゲーションと用語を理解します。

タスク1: 属性マップの生成

HCMデータ・ローダー(HDL)は、属性マップを使用して、サポートするビジネス・オブジェクトの形状を理解します。フレックスフィールドの変更を構成および配置する場合は、HDLとHSDLの両方がフレックスフィールド・セグメントにデータをロードするために使用可能な属性を表示できるように、属性マップもリフレッシュする必要があります。

このタスクでは、次のタスクでこのオブジェクトを使用するため、組織ビジネス・オブジェクトの属性マップをリフレッシュします。ただし、これらのステップはすべてのHDLビジネス・オブジェクトに適用されます。

ノート:

属性マップをリフレッシュする前に、カスタム・フレックスフィールド・コンテキストが構成およびデプロイされていることを確認してください。
  1. Oracle HCMアプリケーションで、「自分のクライアント・グループ」→「データ交換」→「ビジネス・オブジェクトの表示」にナビゲートします。
  2. 「組織」ビジネス・オブジェクトまたはフレックスフィールド・セグメントを構成したオブジェクトを検索して選択します。
  3. 表ツールバーの「オブジェクトのリフレッシュ」をクリックし、確認ウィンドウで「OK」をクリックします。
    4. 保守部門テンプレートの作成

  4. 表の内容をリフレッシュし、「最終リフレッシュ日」を確認します。

    5. ヒント :

    今日の日付が表示されたら、リフレッシュが完了し、「Business Object Details(ビジネス・オブジェクト詳細)」ページおよび「Spreadsheet Templates(スプレッドシート・テンプレート)」ユーザー・インタフェースでカスタム・フレックスフィールド・セグメントの属性を表示できます。
  5. ビジネス・オブジェクト名をクリックして、「ビジネス・オブジェクト詳細」ページにナビゲートします。
  6. 確認する階層内のコンポーネントを選択します。たとえば、「組織」で、「フレックスフィールド属性」タブをクリックします。

    7. ノート:

    付加フレックスフィールド(DFF)セグメントは、ベース・レコードを拡張し、オブジェクト階層の同じコンポーネント上にあります。
  7. 選択リストを使用して、正しいフレックスフィールド・コンテキストを選択します。選択リストの右側にあるフレックスフィールド・コードに注意し、「検索」をクリックしてコンテキストで使用可能な属性を確認します。

    ヒント :

    フレックスフィールド・コンテキスト・コードが常にコードのように見えるわけではありません。フレックスフィールド・コンテキスト・コードおよび属性名は、後でテンプレートにフレックスフィールド・セグメントを追加するときに使用します。
  8. 階層の「組織その他情報」コンポーネントをクリックします。これは、拡張可能フレックスフィールド(EFF)の例です。EFFには、フレックスフィールド・コンテキストに加えてフレックスフィールド・カテゴリがあります。「フレックスフィールド・カテゴリ」を「部門」に設定します。
  9. 次のフレックスフィールドをレビューし、次のコンテキストのコンテキスト・コードおよび属性名をノートにとります。
    • 組織マネージャ情報
    • 勤務日情報

ヒント :

「HCMデータ・ローダー(HDL)ビジネス・オブジェクトの理解」チュートリアルでは、「ビジネス・オブジェクトの表示」タスクの詳細を説明します。

タスク2: 付加フレックスフィールド・セグメント

カスタム・フレックス・セグメントを追加するテンプレートを検索および編集するか、次のステップに従って、部門を保守するための新しいテンプレートを作成できます。タスク3では、このテンプレートを拡張して、複数のEFFコンテキストのセグメントを含めます。

テンプレートの定義

  1. 「自分のクライアント・グループ」→「データ交換」→「スプレッドシート・テンプレート」にナビゲートします。
  2. 「部門の管理」という名前の新しいテンプレートを作成します。ビジネス・オブジェクトとして「組織」を指定し、「OK」をクリックします。
    3. 保守部門テンプレートの作成

  3. 「設計」タブにナビゲートします。
  4. 「使用可能な属性」パネルから「分類名」を選択し、「選択した属性」パネルに追加します。
  5. 使用するキーの入力を求められたら、「組織、分類名」ユーザー・キーを選択します。

    6. ノート:

    「分類名」を選択すると、「組織」および「有効開始日」属性が「選択した属性」パネルに自動的に追加されます。
  6. 「選択した属性」パネルの「除外された属性の表示」チェック・ボックスを選択します。

    7. 「有効終了日」属性は、「選択済属性」のリストにも追加されましたが、デフォルトでは非表示であり、「有効終了日」行の右側のアイコンで示されています。

    「除外属性の表示」チェック・ボックスを選択します。

  7. 「分類名」属性を編集し、「部門」のデフォルトの定数値を構成し、「表示可能」チェック・ボックスの選択を解除して、このテンプレートで生成されたスプレッドシートからこの属性を非表示にします。

組織分類属性の追加

  1. 「使用可能な属性」ヘッダーから「組織分類」を選択して、「組織分類」属性を表示します。
    2. 組織分類の選択

  2. テンプレートに次の属性を追加します。
    • ステータス
    • 設定コード

      • ヒント :

      部門を作成する場合は、「セット・コード」属性が必須です。

    ノート:

    親レコードの識別に使用される属性(組織名、分類名、有効開始日、有効終了日)がテンプレートに自動的に追加されます。

    これらの属性の値は、親(組織)レコードに指定された値にデフォルト設定され、属性はスプレッドシートから非表示になります。

    親識別属性が自動的に追加されます。

  3. 「セット・コード」属性を編集して、COMMONの定数のデフォルト値を指定します。
    4. COMMONのデフォルトを定義します。

  4. 「ステータス」属性を編集して定数のデフォルト値Aを指定し、「表示」チェック・ボックスの選択を解除します。
  5. テンプレートを検証して保存します。

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

DFFセグメントは、ベース属性と同じレコードに定義されるため、同じスプレッドシート行に複数のDFFコンテキストを含めることはできません。したがって、グローバル・データ要素コンテキストのセグメントに加えて、1つのフレックスフィールド・コンテキストのセグメントを含めることが制限されます。

  1. 「組織」コンポーネントの「使用可能な属性」を表示します。
  2. 使用するDFFコンテキストから属性を選択し、必要なグローバル・データ要素コンテキスト属性とともにテンプレートに追加します。

    3. ヒント :

    「コンテキスト値」属性が自動的に選択されます。
  3. 「コンテキスト値」を編集して、追加された付加フレックスフィールド・セグメントのフレックスフィールド・コンテキスト・コードの定数のデフォルト値を定義します。この属性は非表示にできます。

    4. ヒント :

    フレックスフィールド・コンテキスト・コードは、「ビジネス・オブジェクトの表示」ユーザー・インタフェースの「フレックスフィールド属性」タブで使用できます。


タスク3: 拡張可能フレックスフィールド・セグメント

拡張可能フレックスフィールドは子レコードに保持されるため、複数のコンテキストを同じ親に指定できます。

このタスクでは、2つのコンテキストのEFFセグメントをテンプレートに追加します。

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

  1. 「使用可能な属性」ヘッダー・フィルタを使用して、コンテキストを「組織その他情報」に変更します。
  2. 「レポート名」を検索します。
    属性の検索

    属性名に付加されたフレックスフィールド・コンテキスト情報を使用して、「組織マネージャ情報」コンテキストからテンプレートに「レポート名」を選択します。

  3. この属性をテンプレートに追加します。

    4. 必須属性は、最初のフレックスフィールド・セグメントの選択時に自動的に追加されます。親レコードを識別する属性は、親レコードの値に自動的にデフォルト設定され、非表示になります。拡張可能フレックスフィールドのその他の必須属性は次のとおりです。

    組織その他情報の必須EFF属性
    属性 説明 デフォルトのタイプ デフォルト値
    コンテキスト・コード 選択したフレックスフィールド・セグメントのフレックスフィールド・コンテキスト・コードを指定します。この属性は、すべてのフレックスフィールド・レコード・タイプについてHCMデータ・ローダーによって生成されます。 定数 PER_ORG_MANAGER_INFO
    EFF_CATEGORY_CODE 拡張可能フレックスフィールドのカテゴリ・コードを指定します。 定数 部門
    順序番号 フレックスフィールド・コンテキスト・レコードの順序を指定します。 定数 1
    OrgInformationContext 選択したフレックスフィールド・セグメントのフレックスフィールド・コンテキスト・コードを指定します。この属性はビジネス・オブジェクトによって定義され、コンテキスト・コードと同じ値にデフォルト設定できます。 既存の選択済属性 コンテキスト値|組織その他情報|~

  4. これらの4つの属性を編集して、上の表で指定したデフォルト値を定義し、非表示にします。

  5. 同じフレックスフィールド・コンテキストから、必要な他のフレックスフィールド・セグメント属性を追加します。

    6. ヒント :

    組織その他情報コンポーネントのフレックスフィールド・セグメント属性のみが、このテンプレートから生成されたスプレッドシートの列として表示されます。他のすべての属性にはデフォルトが構成されており、エンド・ユーザーのデータ入力を簡略化するために非表示になっています。

拡張可能フレックスフィールド・レコードの複製

  1. 「選択した属性」パネルで、非表示属性が表示されていることを確認します。
  2. 「選択した属性」パネルの「組織その他情報」属性のいずれかをクリックし、「複製」をクリックします。
    3. 「複製」をクリック

  3. 作成するインスタンス数の入力を求められたら、1を指定します。

  4. 「OK」をクリックします。これにより、組織その他情報コンポーネントに選択したすべての属性のコピーが作成されます。

    5. ヒント :

    新しい属性には、その属性に属する新しい出現を識別するために、名前に番号が付加されます。
  5. 属性「レポート名| 1」を編集して非表示にします。

    「組織その他情報」のこの複製は、異なるフレックスフィールド・コンテキスト用であるため、元の「組織その他情報」レコードに定義されているフレックスフィールド・セグメントのすべての属性を非表示にする必要があります。


別のコンテキストのセグメントの追加

  1. 「勤務日情報」コンテキストで使用可能な属性を検索します。
  2. 「勤務日情報」コンテキストからテンプレートに次の属性を追加します。
    • 標準勤務時間
    • 標準勤務時間周期
    • 作業開始時間
    • 作業終了時間

    ノート:

    同じ名前の属性が2つある場合があります。1つは参照コードまたはIDを受け入れ、もう1つは意味または値を受け入れます。これを属性名から識別するのは必ずしも容易ではありません。疑わしい場合は、両方を追加します。
  3. 「選択した属性」パネルに追加された属性を確認します。

    4. 新しいフレックスフィールド・セグメント属性には、それぞれ2つの出現があります。重複したコンポーネントに属性を追加すると、その属性がすべての出現箇所に追加されます。


  4. テンプレートを検証して保存します。「除外属性の表示」チェック・ボックスの選択を解除し、「選択した属性」ツールバーの「属性定義の拡張オプション」をクリックします。

    5. 新しいフレックスフィールド・セグメント属性を、EFFコンポーネントの元のオカレンスから非表示にする必要があります。

  5. 「列見出し」列および「属性キー」列を展開します。属性キーは、スプレッドシート・テンプレートの各属性を一意に識別します。
  6. 元の組織その他情報レコードの新規EFFコンテキストに固有のフレックスフィールド・セグメント属性ごとに、「スプレッドシートに含める」チェック・ボックスの選択を解除します。

    ヒント :

    オブジェクト識別子と内部属性名の間で、属性キー内の数値でないもの。

  7. 値ではなくIDを受け入れる新しいオカレンスの「標準勤務時間周期」属性の「スプレッドシートに含める」の選択を解除します。

    ノート:

    IDまたはコード属性もある場合に値または意味を受け入れる属性は、属性キーに_Displayを持ちます。

    8. スプレッドシートに「標準勤務時間周期」属性が1つのみ表示されるようになりました。フレックスフィールド・レコードの第1重複の「_Display」属性です。

  8. 変更内容を保存して、詳細オプション ページを終了します。
  9. 最後に、重複レコードのこれらの属性を編集して、正しいフレックスフィールド・コンテキストおよび順序を指定します。
    組織その他情報の拡張可能フレックスフィールド必須属性
    属性 説明 デフォルトのタイプ Value
    コンテキスト・コード| 1 2番目のフレックスフィールド・コンテキストのフレックスフィールド・コンテキスト・コードを指定します。 定数 PER_WORK_DAY_INFO
    シーケンス番号| 1 フレックスフィールド・コンテキスト・レコードの順序を指定します。 定数 2
    OrgInformationContext | 1 デフォルトをコンテキスト・コード| 1属性に更新します。 既存の選択済属性 コンテキスト値|組織その他情報|1

    ヒント :

    「除外された属性の表示」チェック・ボックスを選択して、「選択した属性」パネルでこれらを検索する必要があります。

    このテンプレートをアクティブ化して使用し、複数のフレックスフィールド・コンテキストの移入中に部門を保守できるようになりました。


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を参照してください。