简介

本教程介绍了使用 HCM 提取生成 HCM 数据加载程序 (HDL) 和 HCM 电子表格数据加载程序 (HSDL) 格式的数据文件的步骤，以及如何自动导入和加载这些文件。它假定您已具有 HCM 提取、HDL 和 HSDL 的经验。

使用“HCM 提取”可以检索要包括在 HDL 或 HSDL 文件中的数据。要将数据格式化为所需的配置，可以使用 eText 模板布局创建 BI Publisher 报表，并在提取中定义的数据加载程序界面传送选项中引用此报表。

执行提取时，数据加载程序界面传送选项会将生成的文件放置在 Oracle WebCenter Content 服务器上。传送选项定义允许 HCM 数据加载程序正确处理文件的参数值。

单个提取可以包括用于 HDL 和 HSDL 处理的多个传送选项。下图介绍了单个 HCM 提取，其中包括两个用于生成两个文件的传送选项。每个文件都由在同一 BI Publisher 报告中提供的单独 eText 模板进行格式化。

要为提取运行自动导入和加载所有生成的文件，可以创建薪资流模式，其中：

• 提交提取以生成 HDL 和/或 HSDL 文件。
• 启动运行 HCM 数据加载程序任务以：
• 读取每个传送选项配置。
• 从 Oracle WebCenter Content 服务器读取生成的文件。
• 为配置有电子表格加载程序文件类型的每个传送选项启动 HCM 电子表格数据加载程序。
• 将所有 Data Loader 文件类型传送选项生成的所有文件压缩到单个 zip 文件中。
• 为生成的 zip 文件启动 HCM 数据加载程序。

注意：

运行 HCM 数据加载程序任务将以会话用户的身份提交 HCM 数据加载程序，以便它可以与启用 HCM 数据加载程序的安全功能一起使用。有关详细信息，请参阅教程配置对 HCM 数据加载程序 (HDL) 的访问并了解 HDL 安全选项。

目标

在本教程中，您将导入一个简单的 HCM 提取，创建 BI Publisher 报表和传送选项，以便为暂停用户账户用例生成 HDL 和 HSDL 文件。接下来，您将创建薪资流模式以提交提取并启动 HDL 和 HSDL 以处理生成的文件。

先决条件

1. 您需要了解如何创建 HCM 提取以及如何形成和加载 HCM 数据加载程序文件。

您需要访问 Oracle HCM Cloud 中的以下功能：

• 提取定义
• HCM Data Loader
• HCM 电子表格数据加载程序
• 报表和分析
• 薪资流模式
2. 下载并解压缩 Suspend User Accounts resources.zip 文件。
3. HSDL 解决方案需要使用电子表格模板来暂停用户帐户。

   在本教程中，您可以使用 Cloud Customer Connect 上提供的预配置的 HSDL 模板激活/停用现有用户账户暂停用户账户。

   • 按照导入 HCM 电子表格数据加载程序模板教程中的说明导入此模板，指定名称 Suspend User Accounts 和代码 SUSPEND_USER_ACCOUNTS 。
   • 编辑导入的模板，为 Deactivate 属性配置默认常量值 Y 。
   • 确保用于执行 HCM 提取的角色已分配给电子表格模板。

任务 1：创建 HCM 提取

在此步骤中，您将导入暂停用户帐户提取。

警告:

此提取物纯粹用于演示交付选项。这是基本的，只需从人员编号类似于 '123%' 的 PER_EXT_SEC_PERSON_UE 用户实体中检索所有记录即可。

导入示例提取

要导入提取，请执行以下操作：

1. 导航到我的客户组 > 数据交换。
2. 单击提取定义。
3. 单击导入。
4. 将提取名称指定为暂停用户帐户提取。

提示：

提取名称在任务 5 中定义的薪资流模式参数中引用。
5. 导入从 Suspend User Accounts resources.zip 文件下载的 XML 文件，然后单击 OK 。



6. 在确认消息上单击确定。您将导航回提取定义页。
7. 搜索暂停用户账户提取导入的提取。
8. 单击提取名称以编辑提取定义。
9. 为提取指定使用者，然后单击保存。

自动装入参数

创建“自动加载”参数，以便 HCM 数据加载程序端到端流正常工作。

1. 在定义页上，单击参数表工具栏中的添加。





2. 指定以下参数定义：

列	值
名称	自动加载
标记名称	AUTO_LOAD
数据类型	Text
显示	是



3. 单击保存。

复核提取标记

用于创建 eText 模板的 rtf 文件将引用 HCM 提取中定义的标记来分组和导出数据。

要查找以下标记：

1. 编辑提取定义，然后单击设计选项卡。
2. 单击对象名称层次结构中的记录名称以查看对象的标记名称。





3. 单击属性选项卡以查看属性列表。





4. 单击属性名称以查看每个属性的标记。

任务 2：定义 BI Publisher 文件布局

在此步骤中，您将首先创建 rtf 文件，以将提取的数据输出到 HCM 数据加载程序或 HCM 电子表格数据加载程序文件格式中。

请参阅 HCM 提取文档，并使用 Word 模板构建器创建 rtf 布局，将提取的数据格式化为 HDL 文件格式。

HCM Data Loader

要使用 HCM 数据加载程序暂停用户账户，您需要生成具有以下结构的用户文件：

SET PURGE_FUTURE_CHANGES Y
METADATA|User|PersonNumber|Suspended
MERGE|User|{person_number}|Y

在本教程中，请查看从 Suspend User Accounts resources.zip 文件下载的 SuspendUserAccounts.rtf 文件。

• 首先生成 SET PURGE_FUTURE_CHANGES Y 指令。
• 为 User 对象生成一次 METADATA 行，指定 HDL 字段名称 PersonNumber 和 Suspended 。METADATA 指令、对象和属性名称由 '|' 管道字符分隔。
• 对于 Person_Record “HCM 提取”记录中的每个记录，将生成 MERGE 行。
• External_Person_Number 标记用于从提取输出人员编号。挂起值是从 rtf 中定义的常量生成的。

HCM 电子表格数据加载程序

可以按与 HDL 相同的方式生成 HSDL 文件布局。但是，列标题和属性分隔符会有所不同。

在本教程中，请查看从 Suspend User Accounts resources.zip 文件下载的 SuspendUserAccounts HSDL.rtf 文件。

• 此 rtf 文件仅生成一列，标题为 User_PersonNumber。
• External_Person_Number 标记用于提取要暂停的用户的人员编号。
• HSDL 电子表格中的“停用”列不需要值，因为该值由 HSDL 模板本身默认。

提示：

将文件导入 HCM 电子表格数据加载程序电子表格教程说明如何下载 csv 模板，其中包括文件标题所需的属性名称。

任务 3：定义 BI Publisher 报表

在此步骤中，您将创建一个报表，以使用在任务 2 中创建的 rtf 文件生成提取的数据。

创建 BI Publisher 报表

1. 导航到工具 > 报表和分析
2. 单击浏览目录。
3. 单击创建 > 报表。





4. 在 Create Report（创建报表）对话框中，选择 Use Data Model（使用数据模型）。





5. 单击搜索图标以打开“数据模型”浏览器。
6. 导航到共享文件夹 > 人力资本管理 > 薪资 > 数据模型文件夹。
7. 选择 globalReportsDataModel ，然后单击确定。





8. 选择使用报表编辑器以了解如何创建报表，然后单击完成。





9. 将报表保存到共享文件夹 > 自定义 > 人力资本管理 > HDL 文件夹，名称为 SuspendUserAccounts 。

提示：

需要向 HCM 提取传送选项提供报表名称和路径，以便记下它们。

注意：

HDL 子目录可能不存在，因此您可能需要创建它。

上载报表布局

在此步骤中，您将上载 rtf 文件作为 BI Publisher 报表的布局。HDL 和 HSDL 的处理过程相同。

1. 单击上载或生成布局标题下的上载。





2. 指定 Suspend User Accounts HDL 的 Layout Name 。

提示：

需要将布局名称提供给 HCM 提取传送选项，以便记下它。
3. 单击选择文件以搜索并选择您在任务 2 中复查的 HCM 数据加载程序 SuspendUserAccounts.rtf 文件。
4. 指定 eText 模板的类型。
5. 指定 Locale 。





6. 单击上传。

您的报告会自动保存。

重复上载报表布局步骤以使用 SuspendUserAccounts HSDL.rtf 文件创建暂停用户帐户 HSDL 布局。

任务 4：定义 HCM 提取传送选项

在此步骤中，您将在 HCM 提取上创建传送选项，以使用 BI Publisher 报表格式化提取输出并将该输出发布到 Oracle WebCenter Content 服务器。

定义交货选项

1. 导航到我的客户组 > 数据交换 > 提取定义
2. 搜索 Suspend User Accounts Extract（暂停用户账户提取）提取并单击提取名称进行编辑。
3. 单击提供选项卡。
4. 单击“提取传送选项”表工具栏上的添加。





5. 将传送选项名称指定为暂停用户帐户 HDL ，并指定数据加载程序接口的传送类型。





6. 单击确定以定义传送选项。

   数据加载程序接口传送选项提供您需要指定的参数，以便 HDL 和/或 HSDL 能够处理由传送选项生成的文件：

   域	说明
   输出类型	‘文本’
   报表	在任务 3 中创建的 BI Publisher 报表的路径和文件名。
   模板名	由“报表”字段命名的 BI Publisher 报表中的布局名称。
   输出名称	要用于生成的文件的名称，不带文件扩展名。对于 HDL 文件，此文件必须是特定于业务对象的文件名。
   加密方式	所生成文件的加密类型。指定 PGP - Unsigned 以加密您的文件。 注意： 在开发集成时，请只在测试环境中保留未加密的文件。生成的文件将发布到 Oracle WebCenter，任何有权访问 hcm/dataloader/import 帐户的人都可以下载和读取这些文件。建议您始终加密发布在此处的文件。
   集成名	用于标识 Oracle WebCenter Content 服务器上的输出文件的值。它与进程 ID 连接以形成内容 ID。 为同一提取中的每个传送选项指定唯一值。
   文件类型	输出文件的类型。
   压缩传送组	文件类型：数据加载程序 所有数据加载程序生成的文件将压缩在一起的 zip 文件名。您必须为同一提取中的所有数据加载程序传送选项提供具有 .zip 扩展名的相同值。 文件类型：电子表格加载程序 非必填字段。
   压缩	如果不想压缩由传送选项生成的文件，请指定否。 如果希望压缩由传送选项生成的文件，请指定 Yes - Compress First ，这对于较大的卷文件非常有用。如果同时对文件进行加密，则会先对其进行压缩，然后再进行加密。 注意： HCM 数据加载程序不受此设置的影响。运行 HCM 数据加载程序流程将首先解密加密的文件，解压缩压缩压缩的文件，然后更改文件扩展名，然后再压缩使用相同的压缩交付组参数值生成的所有文件。然后将压缩文件提交到 HDL。
   电子表格模板代码	要上载数据的 HSDL 模板的代码。
   电子表格文件日期格式	用于日期数据类型的属性的日期格式。默认格式为 YYYY/MM/DD。
   电子表格文件分隔符	用于分隔文件中的值的字符。默认值为逗号。
   电子表格文件转义指示符	用于在属性值中转义分隔符的字符。缺省值为反斜杠。
   包括电子表格文件题头	指示源文件中是否包含标头以命名文件中包括的属性。默认值为 Y。
   电子表格新行指示符	用于指明新行的字符。默认值为 n，以转义符作为前缀。

   提示：

   不使用覆盖文件扩展名参数。

7. 为 HDL 传送选项指定以下参数值：

   输出类型	Text
   报表	/Custom/Human 资本管理/HDL/SuspendUserAccounts.xdo
   模板名	暂停用户帐户 HDL
   输出名称	User
   加密方式	无 提示： 确认生成的文件配置正确后，您需要将此配置更改为 PGP - Unsigned 。
   集成名	SUA
   文件类型	Data Loader (数据加载程序)
   压缩传送组	User.zip
   压缩	无 提示： 确认生成的文件配置正确后，请考虑将其更改为 Yes - Compress First 。

   
   
8. 单击确定。


9. 重复以上步骤以创建 Suspend User Accounts HSDL 传送选项。

   对于 HCM 电子表格数据加载程序传送选项，请指定以下参数值：

   输出类型	Text
   报表	/Custom/Human 资本管理/HDL/SuspendUserAccounts.xdo
   模板名	暂停用户帐户 HSDL
   输出名称	暂停用户帐户 HSDL
   加密方式	无 提示： 确认生成的文件配置正确后，您需要将此配置更改为 PGP - Unsigned 。
   集成名	SUAHSDL
   文件类型	电子表格加载程序
   压缩传送组
   压缩	无
   电子表格模板代码	SUSPEND_USER_ACCOUNTS

   
   
10. 单击验证以导航到提取执行树。
11. 单击表工具栏上的 Validate 。






提示：

您可能需要刷新该表。
12. 复核并解决任何验证错误。

测试文件生成

在此步骤中，您将确认文件是按所需的配置生成的。

从提取定义页中：

1. 搜索提取，然后单击提交提取。





2. 指定提取实例名称并提供具有当天日期的有效日期参数。





3. 单击提交。这将导航到查看提取结果页。
4. 单击刷新，直到提取实例完成。
5. 单击提取流实例的名称以显示详细信息。





6. 展开提取交货选项部分。
7. 针对输出文件单击文件下载图标并查看输出。






提示：

文件名是根据每个传送选项中定义的输出名称生成的。
8. 在使用 HCM 数据加载程序成功加载生成的输出文件之前，对 BI Publisher 报表的 rtf 布局文件进行任何必要的更改。
9. 对文件配置满意后，记得更新传送选项以将加密模式设置为 PGP - Unsigned 。

提示：

一旦加密，您将无法查看文件内容。

任务 5：定义薪资流模式

在此步骤中，您将定义薪资流模式以提交 HCM 提取，并启动运行 HCM 数据加载程序任务以处理提取生成的文件。

创建薪资流模式

1. 导航到我的客户组 > 薪资 > 薪资流模式。
2. 创建新流。
3. （可选）指定法规数据组并单击继续。





4. 指定 Flow Pattern 的 Suspend User Accounts 名称（可选）提供说明并设置 LDG Required 值。
5. 选中要包括的活动值的 HCM 提取和准备复选框。





6. 滚动并选择暂停用户账户提取和运行 HCM 数据加载程序任务。





7. 单击下一步以定位至任务序号页。
8. 编辑后续任务值以确保任务按以下顺序排列：

任务	下一项任务
开始流	暂停用户账户提取
暂停用户账户提取	运行 HCM 数据加载程序
运行 HCM 数据加载程序	结束流

定义流程流参数

1. 单击下一选项可导航到参数页。创建以下参数：
生效日期

域	值
流参数	生效日期
显示	是
显示格式	日期
序列	10
关键字参数	处理日期


Process Configuration Group（流程配置组）

域	值
流参数	流程配置组的配置
显示	是
显示格式	智能 LOV
查找	流程配置组的 |ActionParameterGroupPVO
序列	20


起始日期

域	值
流参数	开始日期
显示	是
显示格式	日期
序列	30


Auto Load（自动加载）

域	值
流参数	自动加载
显示	是
显示格式	Text
序列	40
参数基准	常数绑定
基准值	是


基本提取名称

域	值
流参数	基本提取名称
显示	无
显示格式	Text
序列	50
参数基准	常数绑定
基准值	暂停用户账户提取


报告类别

域	值
流参数	报告类别
显示	无
显示格式	智能 LOV
查找	报表类别 |OverridingReportCategoryPVO
序列	60
参数基准	后 SQL 绑定
基准值	从 pay_report_categories 中选择 to_char(report_category_id)，其中 base_category_name='Suspend User Accounts Extract'

配置任务参数

1. 单击下一步以导航至任务参数页。
2. 选择 Suspend User Accounts Extract（暂停用户账户提取）HCM 提取记录。





3. 更新有效日期参数，将基准值设置为有效日期。此任务参数现在将接受薪资流中“生效日期”参数的值。





4. 更新自动装入参数，确保参数基准为绑定到流，并将基准值设置为自动装入。此任务参数现在将接受薪资流中的“自动加载”参数的值。





5. 更新流程配置组参数，确保参数基准为绑定到流，并将基准值设置为流程配置组。此任务参数现在将接受薪资流中“流程配置组”参数的值。





6. 更新起始日期参数，确保参数基准为绑定到流，并将基准值设置为起始日期。此任务参数现在接受薪资流中“开始日期”参数的值。





7. 在“任务”表中选择运行 HCM 数据加载程序任务。

注意：

您需要为“提取流程流名称”定义基准值，但值列表在保存流程流模式之前不可用。您将在创建流后编辑此参数。
8. 单击下一步可导航到复查页，然后单击提交。

您将返回到薪资流模式页。

9. 搜索新的薪资流任务，然后单击编辑。
10. 在“任务”面板中，单击运行 HCM 数据加载程序任务上的转至任务。





11. 编辑提取流程流名称参数，确保参数基准为绑定到流任务，并将基准值设置为暂停用户账户提取、提交、薪资流程。





12. 单击提交。

任务 6：提交工资单流

在此步骤中，您将提交流并监视结果。

1. 导航到我的客户组 > 数据交换
2. 单击提交流。
3. 搜索 Suspend User Accounts 流。





4. 单击流名称以导航到提交薪资流页。
5. 指定薪资流的名称。这可以是任何唯一值。
6. 指定有效日期。





7. 单击提交可导航到薪资核对清单页面。
8. 定期单击刷新，直到提取和运行 HCM 数据加载程序流程都完成。





9. 单击运行 HCM 数据加载程序任务名称以定位至导入和加载数据任务，您可以在该任务中复查数据集状态和引发的任何消息。

提示：

默认 HDL 行为是在检索数据后从 Oracle WebCenter 中删除源文件，因此，通过直接调用提取来验证文件配置非常重要，如任务 4 中所述。

相关链接

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

• HCM 数据加载程序 Oracle by Example 教程

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

• 在 HCM 提取中定义 BI Publisher 模板

更多学习资源

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

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

---

标题和版权信息

为 HCM 提取生成的文件启动 HCM 数据加载程序

G34812-01

2025 年 5 月

Copyright ©2025,

Oracle 和/或其关联公司。