イントロダクション

Workerビジネス・オブジェクトは、オブジェクト階層に約30個のコンポーネントがある複雑です。このチュートリアルでは、この複合オブジェクトの使用可能なすべてのコンポーネントについて説明するわけではありませんが、新規採用者のアップロード時に従う必要のあるルールに関するガイダンスを提供します。

新規採用を作成する場合は、就業者オブジェクト階層の次のコンポーネントのデータを指定する必要があります。

  • 作業員
  • PersonName
  • WorkRelationship
  • WorkTerm
  • 割当て

PersonLegislativeDataも指定することをお薦めします。指定しない場合、国別仕様データ・レコードは自動生成ソース・キーを使用して自動生成されます。

ノート:

ソース キーについて理解し、HCMデータ ローダー(HDL)を使用してファイルをアップロードする方法を理解しておく必要があります。HDLを初めて使用する場合は、まず「HCMデータ・ローダー(HDL)によるデータの作成と保守」チュートリアルを完了する必要があります。

目的

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

  • HCMデータ・ローダーのWorker.datファイルを作成してアップロードし、新規採用をロードします。
  • 新規採用者のロードに固有のルールを理解します。

前提条件

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

タスク1: ソース・システム所有者の作成

ソース・キーを使用するファイルをロードする前に、まずソース・システムの所有者値を登録する必要があります。

  1. アプリケーションで、ユーザー名をクリックし、「設定および保守」をクリックします。
    2. [ファイルのインポート]をクリックします。

  2. サイド・ドロワー・アイコンをクリックし、「検索」をクリックします。
    3. インポートファイルを選択

  3. 「共通参照の管理」タスクを検索して選択します。
  4. 「参照タイプ」HRC_SOURCE_SYSTEM_OWNERを検索します。
  5. 「参照コード」表で「追加」アイコンをクリックします。
    6. インポートファイルを選択

  6. 参照コードと意味でEMPを指定し、「開始日」に01/01/2000を指定します。
  7. 「保存」をクリックします。

タスク2: ワーカー・ファイルの作成

このステップでは、Workerオブジェクト階層の必須コンポーネントおよび推奨コンポーネントのレコードを含むWorker.datファイルを作成します。

このチュートリアルで作成されたワーカー・オブジェクト階層

作業員

「就業者」コンポーネントは、個人番号と生年月日を持つ就業者を識別します。

新しいファイルを作成し、次のファイル行を追加します。 

METADATA|Worker|SourceSystemOwner|SourceSystemId|EffectiveStartDate|PersonNumber|StartDate|DateOfBirth|ActionCode
MERGE|Worker|EMP|HDL001|2001/09/08|HDL-1001|2001/09/08|1952/05/21|HIRE
MERGE|Worker|EMP|HDL002|2005/02/08|HDL-1002|2005/02/08|1966/04/21|HIRE

この例では:

  • 各就業者レコードは、属性SourceSystemOwnerおよびSourceSystemIdを使用してソース・キーによって一意に識別されます。たとえば、EMPおよびHDL001、EMPおよびHDL002です。
  • PersonNumber属性はユーザー・キーでも指定されますが、個人番号を自動生成する場合は、指定する必要はありません。

    • ヒント :

    番号を自動生成する場合、ユーザー・キー属性PersonNumberとしてソース・キーの指定が必須になります。
  • 新規採用には、ActionCodeの HIREが必要です。
  • 新規採用を作成する場合、EffectiveStartDateの値はStartDateの値と一致する必要があります。

ユーザー名

PersonNameコンポーネントは、従業員の名前を記録します。

ファイルに次のファイル行を追加します。 

METADATA|PersonName|SourceSystemOwner|SourceSystemId|EffectiveStartDate|PersonId(SourceSystemId)|NameType|LegislationCode|Title|LastName|FirstName
MERGE|PersonName|EMP|HDL001_NME|2001/09/08|HDL001|GLOBAL|US|MR.|Wells|Christopher
MERGE|PersonName|EMP|HDL002_NME|2005/02/08|HDL002|GLOBAL|US|MRS.|Hugh|Lorraine

この例では:

  • 各PersonNameレコードは、属性SourceSystemOwnerおよびSourceSystemIdを使用してソース・キーによって一意に識別されます。たとえば、EMP、 HDL001_NMEです。
  • 各PersonNameを使用するワーカー・レコードを識別するために、ソース・システムIDが親サロゲートID属性PersonIdに(SourceSystemId)ヒントとともに指定されます。たとえば、HDL001、HDL002などです。

    • ヒント :

    ローカルPersonNameレコードと親ワーカー・レコードの両方が同じソース・システム所有者を使用するため、親ソース・システム所有者はローカルのSourceSystemOwner属性から値を継承できます。
  • LegislationCodeは「タイトル」属性の有効な値を決定するため、国別仕様コードを変更する場合は、「タイトル」属性の値を変更する必要がある場合があります。

    • ヒント :

    「ビジネス・オブジェクトの表示」タスクを使用して、参照検証済属性の検証に使用される参照タイプを検索します。
  • PersonNameレコードのEffectiveStartDateの値は、新規採用の就業者レコードのものと一致する必要があります。

個人国別仕様データ

PersonLegislativeDataコンポーネントは、従業員の婚姻区分および性別を取得する場所です。

ファイルに次のファイル行を追加します。 

METADATA|PersonLegislativeData|SourceSystemOwner|SourceSystemId|EffectiveStartDate|PersonId(SourceSystemId)|LegislationCode|Sex|MaritalStatus
MERGE|PersonLegislativeData|EMP|HDL001_LEG|2001/09/08|HDL001|US|M|M
MERGE|PersonLegislativeData|EMP|HDL002_LEG|2005/02/08|HDL002|US|F|S

この例では:

  • 各PersonLegislativeDataレコードは、ソース・キーによって一意に識別されます。たとえば、EMP、HDL001_LEGです。
  • 親レコードはWorkerであるため、PersonId(SourceSystemId)属性を使用して、PersonNameと同じ方法で親レコードを参照します。
  • LegislationCodeは、SexおよびMaritalStatus属性の有効な値を決定します。
  • PersonLegislativeDataレコードのEffectiveStartDateの値は、新規採用の就業者レコードのものと一致する必要があります。

雇用関係

WorkRelationshipコンポーネントは、従業員の雇用主を指定します。

ファイルに次のファイル行を追加します。 

METADATA|WorkRelationship|SourceSystemOwner|SourceSystemId|PersonId(SourceSystemId)|LegalEmployerName|DateStart|WorkerType|PrimaryFlag
MERGE|WorkRelationship|EMP|HDL001_POS|HDL001|Vision Corporation|2001/09/08|E|Y
MERGE|WorkRelationship|EMP|HDL002_POS|HDL002|Vision Corporation|2005/02/08|E|Y

この例では:

  • 各WorkRelationshipレコードは、ソース・キーによって一意に識別されます。たとえば、EMP、HDL001_POSです。
  • 親レコードは引き続き就業者レコードであるため、PersonId(SourceSystemId)属性を使用して親レコードを参照します。
  • DateStart属性値は、新規採用の親就業者レコードに指定されているStartDateと一致する必要があります。

ヒント :

データベースで使用可能な雇用主を使用して、Vision CorporationのLegalEmployerName値を変更する必要があります。

雇用条件

雇用条件はOracle HCMに表示されなくなりましたが、WorkRelationshipレコードおよびアサイメント・レコードをリンクするには、スケルトンWorkTermsレコードを指定する必要があります。

ファイルに次のファイル行を追加します。 

METADATA|WorkTerms|SourceSystemOwner|SourceSystemId|PeriodOfServiceId(SourceSystemId)|ActionCode|EffectiveStartDate|EffectiveSequence|EffectiveLatestChange|AssignmentName|AssignmentNumber|PrimaryWorkTermsFlag
MERGE|WorkTerms|EMP|HDL001_TRM|HDL001_POS|HIRE|2001/09/08|1|Y|ET-HDL001|ET-HDL001|Y
MERGE|WorkTerms|EMP|HDL002_TRM|HDL002_POS|HIRE|2005/02/08|1|Y|ET-HDL002|ET-HDL002|Y

この例では:

  • 各WorkTermsレコードは、ソース・キーによって一意に識別されます。たとえば、EMP、HDL001_TRMです。
  • WorkTermsの親はWorkRelationshipで、親レコードはPeriodOfServiceId属性で識別されます。SourceSystemIdヒントが追加されるため、親雇用関係を識別するためのソース・キーを指定できます。
  • 親雇用関係レコードとローカル雇用条件レコードの両方が同じソース・システム所有者を使用するため、両方の参照で同じSourceSystemOwner属性が使用されます。
  • EffectiveStartDate値は、WorkRelationshipレコードの値と一致する必要があります。

ノート:

必須属性を指定する必要があるのは、作業条件レコードをロードする場合のみです。等級、事業所、部門などは、アサイメント・コンポーネントにのみ移入されるようになりました。

割当て

[赴任]レコード タイプは、従業員の部門、勤務地、ポジション、職務などを指定する場所です。

ファイルに次のファイル行を追加します。 

METADATA|Assignment|SourceSystemOwner|SourceSystemId|ActionCode|EffectiveStartDate|EffectiveSequence|EffectiveLatestChange|WorkTermsAssignmentId(SourceSystemId)|AssignmentName|AssignmentNumber|AssignmentStatusTypeCode|PersonTypeCode|BusinessUnitShortCode|PrimaryAssignmentFlag|JobId(SourceSystemId)|JobId(SourceSystemOwner)
MERGE|Assignment|EMP|HDL001_ASG|HIRE|2001/09/08|1|Y|HDL001_TRM|HDL001|HDL001|ACTIVE_PROCESS|Employee|Vision Operations|Y|SCN|VISION
MERGE|Assignment|EMP|HDL002_ASG|HIRE|2005/02/08|1|Y|HDL002_TRM|HDL002|HDL002|ACTIVE_PROCESS|Employee|Vision Operations|Y|MGR|VISION

この例では:

  • 各割当レコードは、ソース・キーによって一意に識別されます。たとえば、EMP、HDL001_ASGです。
  • 割当の親はWorkTermsで、親レコードはWorkTermsAssignmentId属性で識別されます。SourceSystemIdヒントを使用すると、ソース・キーを使用して親WorkTermsレコードを識別できます。
  • ジョブはソース・キーでも参照されますが、ソース・システム所有者の値が異なるため、SourceSystemOwner属性に指定された値を使用できません。

    外部オブジェクト参照に別のソース・システム所有者を指定するには、外部オブジェクトを識別する属性(JobId(SourceSystemOwner))にSourceSystemOwnerヒントを追加します。

    • ヒント :

    この例で参照されるジョブは、HCMデータ・ローダー(HDL)を使用したデータの作成および保守チュートリアルによって作成されます。
  • EffectiveStartDate値は、WorkTermsレコードの値と一致する必要があります。

ヒント :

データベースで使用可能なビジネス・ユニットを使用して、Vision OperationsのBusinessUnitShortCode値を変更する必要があります。

ヒント :

これらのステップを使用して、このファイルを拡張し、PersonEmailなどのWorker階層の他のコンポーネントを含めることができます。

タスク3: ファイルの保存とアップロード

  1. ファイルを保存し、Worker.datという名前を付けます。または、Worker.datファイルをダウンロードして編集します。
  2. Worker.datを任意のファイル名に圧縮(zip)しますが、拡張子は.zipである必要があります。
  3. 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を参照してください。