使用 HCM 数据加载程序 (HDL) 加载弹性域段、图像和附件

简介

您可以使用 HCM 数据加载程序 (HDL) 将数据成批加载到说明性和可扩展的弹性域段中，以及上载支持它的 HDL 对象的附件和图像。

注意：

您需要了解如何使用 HCM 数据加载程序创建和上载文件。如果您刚接触 HDL，则应先完成“先决条件”部分中列出的教程。

目标

在本教程中，您将：

了解如何为说明性弹性域段提供数据。
将数据加载到可扩展弹性域段。
了解如何提供图像和附件。
使用 Worker 对象加载人员图像。

先决条件

要完成本教程，您需要：

使用 HCM 数据加载程序导入和加载数据的访问权限。

提示：
有关创建 HDL 访问和了解安全选项的步骤，请参阅配置对 HCM 数据加载程序 (HDL) 的访问并了解 HDL 安全选项教程。
用于创建文件的文本编辑器。
用于压缩业务对象数据文件的文件压缩程序。

建议您在尝试本教程之前先完成以下教程：

使用 HCM 数据加载程序 (HDL) 创建和维护数据
使用 HCM 数据加载程序 (HDL) 创建和加载新聘人员

注意：

上载人员图像的任务扩展了本教程创建的新聘人员。

任务 1：查找弹性域属性名称

在此步骤中，您将学习如何查找已配置的弹性域段的 HDL 属性名称。它假定弹性域配置已完成，并且已部署更改。

使用具有 HCM 数据加载程序访问权限的用户登录到应用程序。
导航到数据交换 > 查看业务对象。
使用“按示例查询”字段搜索任务业务对象。
选择业务对象，然后单击刷新对象。

单击“计划请求”页上的提交。
单击页面标题中的查看流程结果。
刷新表，直到刷新对象的过程完成，然后返回到查看业务对象页。

提示：

仅当配置了新弹性域段时，才需要刷新对象。此流程将更新对象的可用属性列表。

单击任务业务对象名称以定位至业务对象详细信息页。
您将在左侧看到对象层次结构，单击层次结构中要查找其弹性域属性信息的组件。
单击弹性域属性选项卡。
将上下文更改为要查找其属性的上下文，然后单击搜索。
将显示要在 HCM 数据加载程序文件中使用的属性名称列表：

任务 2：加载弹性域数据

在此步骤中，您将学习如何提供 METADATA 和 MERGE 行以将数据上载到弹性域段。

弹性域上下文

加载弹性域段时，HDL 需要了解要加载的弹性域数据的上下文。您只能为 MERGE 行上的一个上下文加载数据，但对于说明性弹性域，全局段可以与上下文特定的段一起填充。

对于说明性弹性域和可扩展弹性域，上下文是使用以下属性定义的：

FLEX:{flexfield code}

示例： FLEX:PER_JOBS_DFF 和 FLEX:PER_JOBS_LEG_EFF

提供弹性域段时，属性名称包含一个提示，用于命名弹性域代码和上下文：

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

例如，clearanceLevel(PER_JOBS_DFF=US_JOB_REQ) 。此格式告诉 HDL，安全许可级别段属于 US_JOB_REQ 上下文中的 PER_JOBS_DFF 弹性域。

加载说明性弹性域段

说明性弹性域扩展业务对象组件。您可以提供与业务对象组件的核心属性相同的 MERGE 行上的说明性弹性域的属性。在 METADATA 行上，必须包括要加载数据的弹性域代码和说明性弹性域属性。

由于未预配置说明性弹性域段，因此无法提供您可以上载的示例。使用以下步骤了解如何加载说明性弹性域数据，但是需要将属性名称和值替换为与您的配置相关的数据。

创建新文件并提供定义核心属性的 METADATA 行以及要包括其数据的说明性弹性域属性。例如：

METADATA|Job|SourceSystemOwner|SourceSystemId|EffectiveStartDate|SetCode|JobCode|Name|FLEX:PER_JOBS_DFF|clearanceLevel(PER_JOBS_DFF=US_JOB_REQ)

将 MERGE 行添加到文件中，以指定核心属性值、弹性域上下文和弹性域段值，例如：

MERGE|Job|VISION|SMGR|2000/01/01|COMMON|SNR_MGR|Senior Manager|US_JOB_REQ|HIGH

这将向 US_JOB_REQ 弹性域上下文中存在的许可级别说明性弹性域段加载值 HIGH 。

加载可扩展弹性域段

除了弹性域代码和上下文之外，可扩展弹性域还具有类别代码，必须将其提供给 EFF_CATEGORY_CODE 属性。

创建新文件并添加以下 METADATA 行：

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)

将以下 MERGE 行添加到文件中：

MERGE|JobLegislative|VISION|MGR_JOB_LEG|MGR|2000/01/01|US|HRX_US_JOBS|HRX_US_JOBS|JOB_LEG|PROFESSIONAL|NONEXEMPT

此表说明了此文件中提供的弹性域属性：

属性名称	值	说明
弹性域：每职务 _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 状态段。

提示：

这些弹性域段已验证查找。已提供查找代码，但如果需要为弹性域属性提供含义，则将 _Display 附加到属性名称，例如：_EEO1_CATEGORY _Display (PER_JOBS_LEG_EFF=HRX_US_JOBS)

保存文件，将其命名为 Job.dat 。
将 Job.dat 文件压缩 (zip) 为您选择的文件名。
使用导入和加载数据任务导入和加载作业弹性域数据。

任务 3：加载图像和附件

在此步骤中，您将创建一个文件来上载人员图像。附件以相同的方式加载。

您将扩展在使用 HCM 数据加载程序 (HDL) 创建和加载新聘人员教程中创建的“新聘人员”示例。

创建新文件并添加以下内容：

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 属性用于为映像提供名称。
Image 属性用于指定要上载的文件的名称。

保存文件，将其命名为 Worker.dat 。

提示：

尽管您的文件仅具有 PersonImage 记录，但仍必须以 PersonImage 组件所属的对象分层结构来命名该文件。

在与 Worker.dat 文件相同的目录中，创建一个子目录并将其命名为 BlobFiles 。

提示：

图像和附件文件加载到具有 BLOB 或 CLOB 数据类型的属性中。必须在以所用属性的数据类型命名的目录中提供图像和附件文件。例如，BlobFiles 或 ClobFiles 。

将指定的文件添加到 Worker.dat 文件中的 Image 属性，添加到 BlobFiles 目录中。例如，chris_wells.png 和 lorraine_hugh.jpg 。

提示：

您可以使用自己的文件，也可以下载 chris_wells.png 和 lorraine_hugh.jpg 。

将 Worker.dat 文件以及 BlobFiles 子目录压缩 (zip) 到您选择的文件名中，或者下载并编辑 Person Images.zip 文件。
现在，您可以使用 HCM 数据加载程序上载文件。

后续步骤

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

致谢

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

简介

目标