简介

Oracle HCM Cloud 业务对象可能很复杂，通常分层，从而允许一个业务对象存在多个子记录。业务对象层次结构中的每个组件都提供了多个属性，其中一些是对其他对象的引用，一些是经过查找验证的，大多数是可选的，而一些对于新记录是必需的，而另一些则始终是必需的。

查看业务对象任务描述层次结构配置，并为 HCM 数据加载程序和 HCM 电子表格数据加载程序批量加载支持的每个业务对象提供属性信息。

目标

在本教程里，您将：

  • 查看可用对象、它们允许的操作及其提供的属性。
  • 生成 METADATA 模板文件。
  • 下载业务对象概览电子表格。

先决条件

要完成本教程，您需要：

任务 1：查看支持的对象

在此步骤中，您将浏览查看业务对象页并刷新它显示的对象配置。

  1. 使用有权访问查看业务对象任务的用户登录到应用程序。
  2. 导航到我的客户组 > 数据交换。
  3. 单击查看业务对象。
    4. “查看业务对象”表，其中列出所有支持的对象

    查看业务对象表显示 HCM 数据加载程序支持的所有业务对象。

    • 产品区域列可用于筛选要查看的业务对象。
    • 文件名列显示使用 HCM 数据加载程序加载该业务对象的数据时要使用的文件名。
    • “加载顺序”列指明加载业务对象数据的顺序。

      • 提示：

      您可以在单个 .zip 文件中包括多个业务对象数据文件，HCM 数据加载程序将按正确的顺序加载这些文件，但如果要单独加载对象，请按照加载顺序确保先加载可由其他对象引用的数据。
  4. 使用“按实例查询”字段可以搜索启动作业的业务对象。

    5. 查看以“Job（职务）”一词开头的所有对象。

    您可以看到有多个对象具有该开头的“作业”，业务对象、说明和产品区域将有助于确定其中哪些对象用于加载作业。


刷新对象配置

如果您已配置弹性域属性，或者您的对象的上次刷新日期已过时，建议您刷新对象，以查看最新配置和属性。

刷新对象配置还会生成对象的模板文件和概览电子表格。本教程中的以下任务将说明这些任务是什么以及如何访问它们。

在此步骤中，您将刷新单个对象，然后刷新特定产品区域中的所有对象。

  1. 选择任务业务对象记录，然后单击刷新对象。
    2. 刷新作业业务对象

  2. 单击计划请求页上的提交。
    3. 提交进程以刷新对象。

  3. 在提交确认上单击确定，您将返回到查看业务对象表。
  4. 单击刷新，直到上次刷新日期为当天日期。

刷新多个对象

要刷新特定产品区域内所有对象的对象配置，请执行以下操作：

  1. 单击刷新所有对象
    2. 提交流程以刷新产品区域的所有对象。

  2. 使用选项列表选择全局 HR - 工作结构产品区域。
    3. 选择产品区域。

    提示：

    选择全部以刷新所有受支持的业务对象，但这可能需要几分钟时间才能刷新大约 350 个对象层次结构。

  3. 单击提交。
  4. 单击查看流程结果。
    5. 单击“查看处理结果”按钮。

  5. 查找全局 HR - 工作结构产品区域的条目。
    6. 复查已提交的流程。

  6. 单击刷新，直到过程完成。

    7. 状态指明流程完成的时间，但您也可以使用“查看业务对象”表中的上次刷新时间列来查看上次刷新对象的时间。

任务 2：了解业务对象层次结构

在成功加载对象的数据之前，您需要了解对象的分层配置，并确定要为其加载数据的对象层次结构中的哪些组件。

  1. 使用查看业务对象页可以搜索任务业务对象。
  2. 单击任务业务对象名称以定位至业务对象详细信息页。
    3. 单击“作业”业务对象名称。

  3. 在左侧，您将看到任务业务对象层次结构中的组件。
    4. 复核业务对象层次结构中的组件

    作业对象层次结构是一个简单的两级层次结构。某些业务对象（如 Worker）在多个级别中具有更多组件。

  4. 右侧有三个选项卡：
    5. 组件信息选项卡

    提示：

    任务组件支持弹性域段。对于不支持弹性域段的组件，看不到弹性域属性选项卡。
  5. 查看“职务”组件的组件详细信息选项卡中的信息：
    6. 检查职务组件详细信息

    • 使用说明确认您具有正确的对象。说明通常也提供了有关如何为组件加载数据的指导。
    • 支持的操作告诉您可以执行哪些操作。并非所有对象都支持删除。
    • 必需值指明在创建新对象时，此组件的记录是始终必需还是必需。
    • 使用集成关键字来标识记录时，集成对象名称非常有用。提取集成关键字值时，您需要知道这一点。
    • 除了页面左侧对象层次结构的分层表示形式外，父组件还显示父项的转换名称。此项对于层次结构中的顶层组件为空。
    • 如果对象支持正在转换的属性值，则转换对象将命名用于加载转换的业务对象。单击翻译对象名称将打开翻译对象的“业务对象详细信息”页面。
    • 某些对象要求您获得附加函数安全权限，以便能够为其加载数据。对于数据加载受限属性，这些与安全相关的对象的值为“是”。
    • 日期有效性类型指定组件使用的日期类型。对于日期有效记录，后面的复选框指示您可以调整现有有效开始日期还是结束日期。例如，“职务”是日期有效的，但不能调整有效结束日期，并且始终是时间结束。要“结束”作业的可用性，应改为使作业无效。
    • 文件名指定必须为此组件提供数据的文件的名称。
    • 文件鉴别器指定必须放置在 METADATA、MERGE 以及受支持的 DELETE 行上的鉴别器，以标识文件行对应的组件。
    • 支持的集成密钥指明是否可以提供源密钥或 GUID 来标识此类型的记录。
    • 电子表格加载支持指明哪些用户可以使用 HCM 电子表格数据加载程序批量加载此对象的数据。
  6. 单击对象层次结构中的职务有效薪资级别组件。

    7. 现在显示职务有效薪资级别详细信息。

    查看职务有效薪资级别组件详细信息

    由于这是子组件，因此您现在可以看到已指定父组件。

任务 3：复查可用属性

在此步骤中，您将学习解释为属性提供的信息。

  1. 单击作业对象的业务对象详细信息页的属性选项卡。
    2. 查看属性详细信息

    此时将显示作业组件上可用的所有属性：

    • 每个属性都有一个标签和说明，以会话语言显示。
    • 属性名称是上载数据时必须包括在文件内的 METADATA 行中的值。
  2. 向下滚动到 ActiveStatus 属性。
    • 必需状态显示创建新记录时必须提供此属性。
    • 查找列将指定用于验证此属性的查找类型。

      • 提示：

      使用管理公用查找任务可查看属性的有效值列表。

      注意：

      为查找验证的属性提供值时，您可以提供查找代码或含义。建议您提供查找代码，因为未转换此代码。在提供转换值（例如查找含义）时，您需要以基本语言为环境（通常为美国）提供这些值，因为这是用于加载数据的提升用户，而不是会话用户。

任务 4：唯一标识记录

  1. 单击对象层次结构中的职务有效薪资级别组件。
  2. 搜索关键字类型为代理 ID 的属性。
    3. 查看属性详细信息

    代理 ID 属性唯一标识记录，与组件或对象层次结构无关。跨列查看，了解支持哪些其他键类型：

    • 支持的集成密钥列确认支持集成密钥，因此您可以提供源密钥或 Fusion GUID 以标识有效等级。
    • 用户关键字列指示有两个用户关键字可用，因此您可以使用其中一个关键字来唯一标识有效薪资级别。

      • 提示：

      必需列值 Yes 指示需要代理 ID 或任何其他支持的关键字类型来标识每个记录。如果使用集成关键字类型（来源关键字或 Fusion GUID），或者使用用户关键字，则 HCM 数据加载程序会将它转换回代理 ID 属性。

      注意：

      使用 HCM 数据加载程序 (HDL) 创建和加载新聘人员教程说明了如何使用源关键字和用户关键字创建文件。
  3. 单击 User Key（用户密钥）列中的 2 个用户密钥链接可显示用户密钥详细信息：
    4. 查看用户密钥详细信息

    此时将显示用户关键字属性组合。这告诉我们，要使用用户关键字唯一标识职务有效薪资级别，您可以提供以下任一属性组合：

    • JobCode、SetCode、GradeCode 和 GradeSetCode
    • JobCode、SetCode 和 GradeCode

    提示：

    仅支持一个用户关键字组合时，它会直接显示在用户关键字列中。
  4. 搜索关键字类型为父代代理 ID 的属性。
    5. 查看父代代理 ID

    父代代理 ID 属性唯一地标识对象层次结构中子组件的父记录。对于此组件，父代代理 ID 属性为 JobId 。

    JobId 属性还支持集成关键字，用户关键字列列出了构成用户关键字的属性。

    提示：

    必需列值是表示必须提供代理 ID、集成关键字或用户关键字来标识父作业。

    提示：

    支持的集成关键字列具有更多信息字形。单击此项可检查为两种集成关键字类型提供的属性。
  5. 搜索关键字类型为外部对象参考的属性。
    6. 检查外国代理 ID

    GradeId 属性提供对 Grade 对象的引用。这由说明确认。

    • 此属性还支持集成关键字，并提供两个用户关键字以唯一标识薪资级别。
    • 必需列指明在创建新记录时必须提供对薪资级别的参考，但可以使用代理 ID、集成关键字或用户关键字。
  6. 搜索关键字类型为用户关键字的属性。
    7. 查看用户关键字属性

    这些属性包含在代理 ID、父代代理 ID 和外部代理 ID 属性的用户关键字中。

    提示：

    对于大多数用户关键字，必需列值可能为否，因为您可以提供另一种关键字类型来标识所引用的记录，例如来源关键字或代理 ID 值。

任务 5：复核弹性域属性

在此步骤中，您将学习如何解释为弹性域属性提供的信息。

提示：

只有在对象层次结构中选择的组件支持弹性域段时，才会显示“弹性域属性”选项卡。
  1. 在业务对象详细信息页面中，选择对象层次结构中的职务法规附加信息组件。
  2. 单击弹性域属性选项卡。
    3. 查看用户关键字属性

    将显示指定类别和上下文的属性。

  3. 选择职务法规数据的类别和美国职务信息的上下文。单击搜索。
  4. 搜索启动 FLEX 的属性。
    复核弹性域上下文属性

    为任何弹性域段提供数据时，始终需要 FLEX:{flexfield code} 属性。

    • 属性名称告知 HDL 正在为其提供数据的弹性域代码。例如，PER_JOBS_LEG_EFF 。
    • 对于包含弹性域段的每个数据行，您可以为此属性提供行上提供数据的弹性域上下文代码。

      提示：

      要使用的值显示在“上下文”选项列表的右侧，例如 HRX_US_JOBS 。
  5. 搜索启动 EFF 的属性。
    6. 复核弹性域类别属性

    为可扩展弹性域段提供数据时，始终需要 EFF_CATEGORY_CODE 属性。您可以为此属性提供可扩展弹性域类别代码，例如 JOB_LEG 。

    提示：

    说明性弹性域没有类别，因此此字段不可用于说明性弹性域。
  6. 查看列出的其他属性：
    7. 复核弹性域段属性

    弹性域属性名称始终具有提示，格式为： 

    {flexfield attribute name}({flexfield code}={context code})

    例如，_EEO1_CATEGORY(PER_JOBS_LEG_EFF=HRX_US_JOBS) 。此格式告诉 HDL EEO1 类别段属于 HRX_US_JOBS 上下文中的 PER_JOBS_LEG_EFF 弹性域。

    某些弹性域段提供两个属性，一个接受代码，另一个接受含义或显示值。接受显示值的属性将始终具有以下格式： 

    {flexfield attribute name}_Display({flexfield code}={context code})

    例如，_EEO1_CATEGORY_Display(PER_JOBS_LEG_EFF=HRX_US_JOBS) 。

    提示：

    对于查找验证的弹性域段，建议您向基本属性提供代码值，以避免转换问题。使用管理值集任务可复核用于验证弹性域段的值集并标识有效值。


任务 6：了解来源参考属性

HCM 数据加载程序加载的数据保存在通用中转表中，为业务对象提供的值不会始终存储在同一数据库列中。

警告:

不应尝试直接从 HDL 中转表读取数据。而是向来源参考属性提供要报告、合计或调节的属性值。

来源参考属性显示在导入和加载数据用户界面的对象状态页中，并且可以使用 HCM 提取和 OTBI 报告进行提取。

  1. 在业务对象详细信息页上，单击属性选项卡。
  2. 搜索具有起始参考标签的属性。
    3. 复核来源参考属性

    有 10 个引用属性和一个引用上下文属性。

    提示：

    这些属性在 HCM 数据加载程序支持的所有业务对象组件中公用。

    在 METADATA 行中，可以使用以下格式指定每个源引用列的提示： 

    SourceRefTableName={context value}|SourceRef001={source-column-001}|SourceRef002={source-column-002}|SourceRef003={source-column-003}

    例如： 

    METADATA|ElementEntry|...|SourceRefTableName=ElementEntry|SourceRef001=PersonNumber|SourceRef002=ElementName|SourceRef003=Amount
MERGE|ElementEntry|...||892334|Travel Allowance|200

    不要为 SourceRefTableName 属性提供值，此属性仅允许您为 METADATA 行中的参考属性提供上下文。

任务 7：下载 METADATA 模板文件

当使用 HCM 数据加载程序提供要成批加载的数据时，您的文件必须使用为业务对象定义的名称，并且必须包括 METADATA 行以用于提供数据的组件和属性。

您可以下载包含业务对象层次结构的所有 METADATA 行的模板文件，而不是手动生成此文件。

  1. 在查看业务对象页上，选择作业业务对象，然后单击模板文件列中的文件下载图标。
    2. 下载 METADATA 模板文件

    将下载为业务对象指定的文件，在本例中为 Job.dat 。

  2. 打开下载的文件，它将看起来像这样：
    3. COMMENT Data for Business Object: Job Version: V2 Created on: 16-08-2024
METADATA|Job|FLEX:PER_JOBS_DFF|FBLJG(PER_JOBS_DFF=Global Data Elements)|_ATT1_UK_001_SIMPLE(PER_JOBS_DFF=Global Data Elements)|_job_global(PER_JOBS_DFF=Global Data Elements)|dffCol1(PER_JOBS_DFF=Global Data Elements)|ghrJobBpad87211(PER_JOBS_DFF=Global Data Elements)|ghrJobBpad87212(PER_JOBS_DFF=Global Data Elements)|incrDffCol2(PER_JOBS_DFF=Global Data Elements)|jobAttr1(PER_JOBS_DFF=Global Data Elements)|jobglobal(PER_JOBS_DFF=Global Data Elements)|FBLJL(PER_JOBS_DFF=JobContext1)|joblocal(PER_JOBS_DFF=JobContext1)|zperJobSegment(PER_JOBS_DFF=ZPER_JOB_CONTEXT)|JobId|JobCode|JobFamilyId|ActiveStatus|FullPartTime|JobFunctionCode|ManagerLevel|MedicalCheckupRequired|StandardWorkingHours|StandardWorkingFrequency|StandardAnnualWorkingDuration|AnnualWorkingDurationUnits|RegularTemporary|BenchmarkJobFlag|BenchmarkJobId|ProgressionJobId|SetId|EffectiveStartDate|EffectiveEndDate|Name|ApprovalAuthority|SchedulingGroup|SetCode|BenchmarkJobCode|ProgressionJobCode|JobFamilyName|JobFamilyCode|ActionReasonCode|SourceSystemOwner|SourceSystemId|GUID|CategoryCode|GradeLadderId|GradeLadderName|RequisitionTemplateId|RequisitionNumber|SourceRefTableName=|SourceRef001=|SourceRef002=|SourceRef003=|SourceRef004=|SourceRef005=|SourceRef006=|SourceRef007=|SourceRef008=|SourceRef009=|SourceRef010=
METADATA|JobEvaluation|FLEX:PER_EVALUATION_CRITERIA_DFF|_EVC(PER_EVALUATION_CRITERIA_DFF=Global Data Elements)|JobId|DateEvaluated|Knowhow|Accountability|EvaluationSystem|JobEvaluationId|MeasuredIn|ProblemSolving|WorkingConditions|JobCode|SetCode|SourceSystemOwner|SourceSystemId|GUID|SourceRefTableName=|SourceRef001=|SourceRef002=|SourceRef003=|SourceRef004=|SourceRef005=|SourceRef006=|SourceRef007=|SourceRef008=|SourceRef009=|SourceRef010=
METADATA|JobGrade|GradeId|JobId|EffectiveStartDate|EffectiveEndDate|ValidGradeId|GradeCode|SetCode|JobCode|SourceSystemOwner|SourceSystemId|GUID|GradeSetCode|SourceRefTableName=|SourceRef001=|SourceRef002=|SourceRef003=|SourceRef004=|SourceRef005=|SourceRef006=|SourceRef007=|SourceRef008=|SourceRef009=|SourceRef010=
METADATA|JobExtraInfo|FLEX:PER_JOBS_EIT_EFF|EFF_CATEGORY_CODE|jobEffSegment1(PER_JOBS_EIT_EFF=job-eff-context)|EffectiveEndDate|EffectiveStartDate|InformationType|JeiInformationCategory|JobExtraInfoId|JobId|LegislationCode|SequenceNumber|SourceSystemOwner|SourceSystemId|GUID|JobCode|SetCode|SetId|SourceRefTableName=|SourceRef001=|SourceRef002=|SourceRef003=|SourceRef004=|SourceRef005=|SourceRef006=|SourceRef007=|SourceRef008=|SourceRef009=|SourceRef010=
METADATA|JobLegislative|FLEX:PER_JOBS_LEG_EFF|EFF_CATEGORY_CODE|_EEOG(PER_JOBS_LEG_EFF=CA)|_EEOG_Display(PER_JOBS_LEG_EFF=CA)|_NOC_CODE(PER_JOBS_LEG_EFF=CA)|_NOC_CODE_Display(PER_JOBS_LEG_EFF=CA)|employmentEquityEligible(PER_JOBS_LEG_EFF=CA)|employmentEquityEligible_Display(PER_JOBS_LEG_EFF=CA)|_POSITION_TYPE(PER_JOBS_LEG_EFF=CH)|_POSITION_TYPE_Display(PER_JOBS_LEG_EFF=CH)|seg1(PER_JOBS_LEG_EFF=Context1)|seg2(PER_JOBS_LEG_EFF=Context2)|_ECAP_JOB(PER_JOBS_LEG_EFF=FR)|_ECAP_JOB_Display(PER_JOBS_LEG_EFF=FR)|_INSEE_PCS_CODE(PER_JOBS_LEG_EFF=FR)|_INSEE_PCS_CODE_Display(PER_JOBS_LEG_EFF=FR)|_INSEE_PCS_EXT_CODE(PER_JOBS_LEG_EFF=FR)|_INSEE_PCS_EXT_CODE_Display(PER_JOBS_LEG_EFF=FR)|_EEO1_CATEGORY(PER_JOBS_LEG_EFF=HRX_US_JOBS)|_EEO1_CATEGORY_Display(PER_JOBS_LEG_EFF=HRX_US_JOBS)|_FLSA_STATUS(PER_JOBS_LEG_EFF=HRX_US_JOBS)|_FLSA_STATUS_Display(PER_JOBS_LEG_EFF=HRX_US_JOBS)|_JOB_GROUP(PER_JOBS_LEG_EFF=HRX_US_JOBS)|_JOB_GROUP_Display(PER_JOBS_LEG_EFF=HRX_US_JOBS)|_LINE_OF_PROGRESSION(PER_JOBS_LEG_EFF=HRX_US_JOBS)|eeo4Category(PER_JOBS_LEG_EFF=HRX_US_JOBS)|eeo4Category_Display(PER_JOBS_LEG_EFF=HRX_US_JOBS)|eeo4Function(PER_JOBS_LEG_EFF=HRX_US_JOBS)|eeo4Function_Display(PER_JOBS_LEG_EFF=HRX_US_JOBS)|standardOccupationalClassifica(PER_JOBS_LEG_EFF=HRX_US_JOBS)|_ORA_HRX_BR_JOBS_CBO(PER_JOBS_LEG_EFF=ORA_HRX_BR_JOBS)|_ORA_HRX_BR_JOBS_CBO_Display(PER_JOBS_LEG_EFF=ORA_HRX_BR_JOBS)|oraHrxCaWcJobClUnit(PER_JOBS_LEG_EFF=ORA_HRX_CA_WC_JOBS)|oraHrxCaWcJobClUnit_Display(PER_JOBS_LEG_EFF=ORA_HRX_CA_WC_JOBS)|oraHrxCaWcJobProv(PER_JOBS_LEG_EFF=ORA_HRX_CA_WC_JOBS)|oraHrxCaWcJobProv_Display(PER_JOBS_LEG_EFF=ORA_HRX_CA_WC_JOBS)|oraHrxCaWcJobPsu(PER_JOBS_LEG_EFF=ORA_HRX_CA_WC_JOBS)|oraHrxCaWcJobPsu_Display(PER_JOBS_LEG_EFF=ORA_HRX_CA_WC_JOBS)|oraHrxCaWcJobUniqueSeg(PER_JOBS_LEG_EFF=ORA_HRX_CA_WC_JOBS)|_ORA_HRX_MX_SI_SALARY_TYPE(PER_JOBS_LEG_EFF=ORA_HRX_MX_JOBS)|_ORA_HRX_MX_SI_SALARY_TYPE_Display(PER_JOBS_LEG_EFF=ORA_HRX_MX_JOBS)|perjobmrnuk(PER_JOBS_LEG_EFF=PER_JOB_TEST_MR)|perjobmruk(PER_JOBS_LEG_EFF=PER_JOB_TEST_MR)|JobId|JobLegId|EffectiveStartDate|EffectiveEndDate|InformationCategory|LegislationCode|SourceSystemOwner|SourceSystemId|GUID|JobCode|SetCode|SetId|SequenceNumber|SourceRefTableName=|SourceRef001=|SourceRef002=|SourceRef003=|SourceRef004=|SourceRef005=|SourceRef006=|SourceRef007=|SourceRef008=|SourceRef009=|SourceRef010=

    注意：

    您应删除文件中没有包含的组件的 METADATA 行，并从未为其提供值的剩余 METADATA 行中删除属性。


任务 8：生成对象层次结构概览电子表格

概览电子表格提供的信息与查看业务对象用户界面相同，但采用电子表格格式。这对于脱机查看业务对象配置非常有用，并允许您跨组件搜索属性。

  1. 在查看业务对象页上，选择任务业务对象，然后单击概览列中的文件下载图标。
    2. 下载概览电子表格

    将下载名为 GenericBusObjectDetails.xlsx 的文件。

    提示：

    如果您的 Downloads 文件夹中已存在具有此名称的文件，该名称将附加一个数字以使其唯一。
  2. 打开下载的文件，系统会询问您是否要连接：
    是否要连接

  3. 选择是。
  4. 使用您的应用程序用户名登录。
  5. 查看层次详细信息工作表上的信息：
    6. 复核层次结构详细信息工作表

  6. 单击属性工作表。将下载对象层次结构中所有组件的支持属性列表。
    7. 查看属性详细信息工作表

  7. 单击弹性域属性工作表。如果对象层次结构支持加载到弹性域段，则将下载属性列表。
    8. 复核弹性域属性工作表

提示：

您可以编辑并本地保存此电子表格。不过，要保留编辑，下次打开电子表格时请不要登录。

后续步骤

以下教程将进一步扩展您的 HCM 数据加载程序知识：

有关 HDL 和 HSDL 的最新教程发布在 Cloud Customer Connect 的以下主题中：

有关详细信息，请参阅此帮助主题：

致谢

  • 作者 — Ema Johnson（高级首席产品经理）

更多学习资源

通过 docs.oracle.com/learn 浏览其他实验室，或者通过 Oracle Learning YouTube 频道访问更多免费学习内容。此外，请访问 education.oracle.com/learning-explorer 以成为 Oracle Learning Explorer。

有关产品文档，请访问 Oracle 帮助中心。