创建 HCM 电子表格数据加载 er 模板

简介

使用 HCM 电子表格数据加载程序 (HDSL) 为您的业务用户和入站集成提供批量数据加载功能。您可以为特定用例配置电子表格模板，并将对这些模板的访问权限仅分配给需要这些模板的角色。例如，您的招聘集成可以访问“新聘人员”电子表格，而“加班时数”电子表格将可供您的薪资管理员使用。

注意：

将 HSDL 用于集成的优势在于，您限制将数据上载到模板支持的用例。如果需要，还可以强制实施数据安全性。

目标

在本教程里，您将：

了解如何设计和配置 HSDL 模板。
创建可加载新雇用员工的工作模板。

Worker 业务对象很复杂，对象层次结构中大约有 30 个组件超过 5 个级别。本教程将介绍如何创建简单的工作新聘人员模板，同时说明用于定义电子表格模板的常见任务。然后，您可以将这些步骤应用于任何受支持的业务对象。

了解模板创建的基础知识后，您可以进一步扩展知识和模板，以包括弹性域属性、重复记录等。查看以下教程：

先决条件

要完成本教程，您需要：

安装了 Desktop integration（桌面集成）的 Windows 计算机，用于测试模板。
访问 Worker 业务对象的设计模板，并能够使用 HSDL 加载数据。

按照配置对设计和维护 HCM 电子表格数据加载程序 (HSDL) 模板的访问权限教程中的任务来创建此类角色。

任务 1：创建模板

在此步骤中，您将基于员工业务对象层次结构创建新模板。

使用具有可访问员工业务对象的 HSDL 模板设计者角色的用户登录应用程序。
导航到我的客户组 > 数据交换 > 电子表格模板。
单击创建以打开创建模板页。

指定模板名称和代码，将业务对象设置为员工，并根据需要提供说明。

单击确定。您将导航到定义选项卡。

任务 2：选择模板属性

在此步骤中，您将添加 Worker 对象层次结构中每个必需和建议的组件所需的基本属性。

您可以重复此处介绍的步骤，以从 Worker 业务对象中的其他组件添加属性。

注意：

使用查看业务对象任务可查看和了解对象层次结构和支持的属性。

提示：

最好从对象层次结构的顶部开始，然后在层次结构中包括子组件和子组件。模板设计器将自动为您构建父子关系。

Worker

对象层次结构的员工组件标识具有人员编号属性的员工，并获取出生日期。

单击设计。

在 Available Attributes（可用属性）面板中选择 Action Code（操作代码）属性，并将其添加到 Selected Attributes（所选属性）面板。

在模板中选择第一个属性时，设计者将询问您使用哪个键来唯一标识记录。

在 Select Key（选择密钥）对话框中选择 User Key（用户密钥），然后单击 OK（确定）。

提示：

某些对象具有多个用户关键字组合。您可以使用用户关键字选项列表为您的用例选择正确的用户关键字。您可能需要为用于维护现有记录的模板选择代理 ID 。代理 ID 属性提供可搜索的值列表。

始终需要的其他属性将自动添加到所选属性面板：

提示：

键图标用于为在电子表格中唯一标识记录的所有属性添加前缀。

单击页眉上的验证并保存按钮。

在确认对话框中单击确定。
单击可用属性面板工具栏上的显示。取消选中全部复选框并选中新记录需要。

在显示多选选项列表之外单击，以将可用属性列表筛选为符合指定标准的那些属性。

提示：

带复选标记的绿色圆圈表示已选择属性。

将开始日期添加到所选属性面板。
验证并保存模板。

个人姓名

“人员姓名”组件记录员工的姓名。

单击可用属性标题旁边的选项列表，然后选择人员姓名以显示属于“人员姓名”对象的属性。

单击 Available Attributes（可用属性）面板工具栏上的 Show（显示），然后取消选中 Conditionally required（有条件地需要）和 Optional（可选）复选框。

在显示多选选项列表之外单击，以将可用属性列表筛选为符合指定标准的那些属性。
单击全部添加按钮可将可用属性面板中显示的所有属性添加到所选属性面板。

某些新选定的属性不会显示在选定的属性面板中。子记录上的属性将自动默认自其父记录上的等效属性，并在电子表格中隐藏。对于标识父级的属性（如 PersonNumber）和有效开始日期属性，会发生这种情况。

“人员姓名”组件中的“有效开始日期”和“人员编号”属性在“选定属性”面板中不可见。

提示：

选中 Selected Attributes（选定属性）面板工具栏上的 Show excluded attributes（显示排除的属性）复选框，以查看模板定义中包括但不会在模板生成的电子表格中看到的属性。

在 Available Attributes（可用属性）面板上，更改 Show（显示）多选选项列表以显示 All（全部）属性。
在可用属性搜索框中输入第一个，然后单击搜索按钮。

将名字属性添加到所选属性列表中。
在模板中添加所需的任何其他可选人员姓名属性。
验证并保存模板。

人员法规数据

人员法规数据组件可获取员工的婚姻状况和性别。

筛选可用属性面板以显示人员法规数据属性。
使用显示筛选器可显示必需和新记录必需的属性。
单击全部添加可将可用属性面板中显示的所有属性添加到所选属性面板。

更改显示多选选项列表以显示全部属性。
搜索这些可选属性并将其添加到模板中：

Gender
婚姻状况

查看“选定属性”面板中现在显示的人员法规数据属性。

查看其他可用人员法规数据属性，并根据需要添加到模板。
验证并保存模板。

工作关系

“工作关系”组件指定员工的合法雇主。

将工作关系组件中的所有必需属性和新记录必需属性添加到模板。
更改显示多选选项列表以显示全部属性，并搜索 Primary Employment（主要雇用情况）属性并将其添加到模板。
查看其他可用的工作关系属性并根据需要添加到模板。

提示：

使用查看业务对象任务可查看所有可用属性及其说明。

验证并保存模板。

雇用条款

雇用条款在 Oracle HCM 中不再可见，但您仍需要提供骨架雇用条款记录来链接工作关系和分配记录。

从雇用条款对象添加所有必需和新记录必需属性。
验证并保存模板。

分配

“分配”记录类型用于指定员工的部门、地点、职位、职务等。

为分配对象添加所有必需和新记录必需属性。
更改显示多选选项列表以显示全部属性。
搜索并添加模板中所需的其他属性。以下是几点建议:

人员类型为
工作关系的主要分配
部门
业务单元
职务代码
职位代码
薪资级别代码

提示：

使用查看业务对象任务可查看所有可用属性及其说明。

验证并保存模板。

任务 3：配置属性默认值

在此任务中，您将学习如何配置模板属性的默认值。这简化了用户的数据输入，并可以限制最终用户可以执行的操作。

配置常量默认值

您可以将属性值配置为具有常数值。

在所选属性面板中，选择员工组件上的操作代码属性，然后单击面板工具栏上的编辑按钮。

通过选择值单选按钮、选择常数值类型以及指定值 HIRE ，为操作代码定义默认值。

单击确定。
编辑这些其他属性以为其配置常量值默认值：

属性	组件	常数值
名称类型	个人姓名	GLOBAL
有效序号	雇用条款	1
最近有效更改	雇用条款	是
分配状态类型	雇用条款	ACTIVE_PROCESS

注意：

为查找已验证属性指定默认值时，需要指定查找代码，而不是含义。

配置其他选定属性值的默认值

您可以将属性配置为默认来自其他选定属性的值。

提示：

您不会看到从电子表格中的来源属性自动填充的属性，在将电子表格数据上载到中转表时会发生默认设置。从其他选定属性默认属性值时，始终隐藏默认属性。

在所选属性面板中编辑 Worker 对象上的 Effective Start Date 属性。

选择“Effective Start Date（有效开始日期）”属性，然后单击“Edit（编辑）”

通过选择值单选按钮，选择现有选定属性类型，以及指定要从中复制值的开始日期 | 员工属性，为有效开始日期属性定义默认值。

提示：

管道前的值是属性名称，管道后的值是属性所属的层次结构中的组件。

注意：

创建新聘用时，员工记录的有效开始日期必须与员工的开始日期相同。

取消选中可见复选框以从电子表格中隐藏属性。

单击确定。

注意：

模板设计者已将其他对象上的“有效开始日期”属性默认为“员工有效开始日期”，因此无需手动执行此操作。

编辑工作关系、雇用条款和分配组件上的操作代码，以默认使用员工组件上的操作代码中的值，并从电子表格中隐藏属性。

编辑这些属性以配置现有选定属性中的默认值，并取消选中可见复选框：

属性	组件	现有的选定属性
开始日期	工作关系	开始日期 \| 员工 \| ~
法规代码	人员法规数据	法规代码 \| 人员姓名 \| ~
分配状态类型	分配	分配状态类型 \| 雇用条款 \| ~

验证并保存模板。

使用表达式配置默认值

可以使用 groovy 表达式定义属性的默认值。通过指定唯一标识模板中属性的属性关键字，这些关键字可以包括对其他选定属性的引用。

单击所选属性面板工具栏上的高级选项按钮。

查找“人员编号”属性的属性关键字。

提示：

属性关键字通常是组件名称 (Worker)，后跟基本属性名称 (PersonNumber)。您可以编辑这些内容，但它们在模板中必须是唯一的。

单击取消。
编辑雇用条款组件上的分配编号属性。
通过选择值单选按钮、选择使用表达式类型以及指定 "ET" + Worker_PersonNumber 作为值来定义默认值。

提示：

将 Worker_PersonNumber 替换为模板使用的属性关键字（如果不同）。

单击验证对表达式进行验证。
单击确定。
使用表达式 "E" + Worker_PersonNumber 为 Assignment 组件上的 Assignment Number 属性配置表达式默认值。
验证并保存您的更改。

提示：

配置其他属性的默认值以简化数据录入，例如法规代码、员工类型、业务单位和合法雇主。如果需要，您可以隐藏这些内容或将其留给最终用户进行覆盖。

提示：

建议在成功测试常量值或表达式后，不要隐藏默认属性。

任务 4：配置自动生成的人员编号

如果希望用户手动指定您的人员和分配编号，则可以跳过此步骤。

在 Selected Attributes（所选属性）面板的 Worker（员工）组件上选择 Person Number（人员编号）属性并单击 Edit（编辑）。
选中 Autogenerate（自动生成）复选框。

提示：

列标题和说明已更新。根据需要更改这些内容。

注意：

虽然成功上载员工时将生成人员编号，但电子表格的用户仍必须提供值以唯一地区分电子表格中的每个员工。提供的值将替换为自动生成的值。

单击确定。
编辑雇用条款对象上的分配编号属性，并勾选自动生成复选框。

取消选中 Visible（可见）复选框并单击 OK（确定）。
重复这些步骤以自动生成并隐藏分配组件上的分配编号。

注意：

“分配编号”属性默认自上一步骤中的“人员编号”。

验证并保存模板。

任务 5：验证并测试模板

在简化模板配置并配置对模板的访问权限之前，应对其进行测试。

验证并保存所有最近的更改。
单击预览可为配置的模板生成电子表格。根据您的 Web 浏览器，将下载 GenericHdlSpreasdheet.xlsx 文件。打开它。

出现登录提示时，单击是。

使用您的应用程序用户名和密码登录。生成电子表格时，所选属性面板中的每个可见属性都显示为电子表格中的列。
单击电子表格加载程序工具栏上的创建数据集。

注意：

必须在数据集中创建电子表格行。这是随后上载到 Oracle HCM Cloud 的数据集。

在对话框页面上单击 OK 。

使用预定义名称创建数据集；如果需要，您可以改写此设置。

双击列标题下第一行中的任何单元格以启动该行。

提示：

任何不带值的必需单元格都将突出显示红色大纲。配置有缺省常量值的任何属性都将显示缺省值。

为电子表格行中的每个空单元格输入有效数据。

提示：

如果已配置要自动生成的人员编号，请指定任何值。它在电子表格中提供的所有行中必须唯一。

此值仅在上载期间用于标识记录，但创建后，自动生成的值将用于人员编号和分配编号。

提示：

名称后带有 [..] 符号的列提供可搜索的值列表。双击要为其提供值的单元格以打开 LOV 窗口。

单击电子表格加载程序工具栏上的更多 > 上载。

在显示的任何对话框页面上单击确定。
定期单击刷新以刷新电子表格行状态。

上载进度将更改状态，直到处理完成且状态为“成功”或“错误”。

如果获得错误状态，请查看错误消息，并根据需要进行更正。单击上载以重新提交数据集中的更正的电子表格行。

定位至人员管理任务以确保可以看到您的新聘用。

提示：

在应用程序中看到您的员工可能会有短暂的延迟。

任务 6：配置电子表格属性

此任务说明如何隐藏不希望最终用户更改的默认属性、根据需要配置属性、更改列顺序以及更新标签和说明。

隐藏默认列

成功测试常量和表达式默认值后，隐藏不希望用户更改的默认属性。

编辑属性以隐藏生成的电子表格。
取消选中 Visible 复选框。

单击确定。

将属性设为必需

在此步骤中，您将根据需要编辑要在电子表格中突出显示的属性。

在 Selected Attributes（所选属性）面板中编辑 Last Name（姓氏）属性，并选中 Required（必需）复选框。

单击确定。

配置列标题和帮助文本

更改列标题和说明，以使用您的业务用户可以理解的术语。例如，如果您要自动生成人员编号，则可能需要重命名人员姓名 - 自动生成列标题和说明。

编辑所选属性面板中的人员编号属性。
将列标题更改为行标识符，以便在创建具有不同人员编号的人员时不会混淆用户。
将说明更改为数字，以唯一标识电子表格中的行。

提示：

将光标悬停在电子表格中的列标题上时，将显示说明。

单击确定。

对列重新排序

所选属性面板中的列显示顺序决定了这些列在电子表格中的显示顺序。

单击所选属性面板工具栏上的重新排序图标。

选择属性，然后使用按钮定义列在电子表格中的显示顺序。
单击确定接受您所做的更改并关闭窗口。

任务 7：配置模板参数

您可以通过改写参数默认值来改写默认电子表格数据加载行为。在此部分中，如果超过 10% 的电子表格行出错，您将确保数据加载停止，并且您将为增量更新启用加载事件。

单击设计选项卡。

单击 Spreadsheet Parameters 表上的“创建”图标。

单击搜索可查看模板可用的所有参数。

选择最大装入错误百分比参数，然后单击确定
将值更新为 10 。
单击创建图标并选择为增量更新启用加载事件参数，然后单击“确定”。
将“值”更新为是。
验证并保存模板。

任务 8：分配角色并激活模板

在生产环境中，您会将此模板分配给应当能够访问此模板的角色，因此在导出模板之前，您应评估分配的角色是否按预期使用模板。

要使业务用户能够使用此模板，必须为其角色分配对模板的数据集访问权限，并且必须激活模板。激活后，您将不再有权自动维护模板。

分配模板维护访问权限

模板处于活动状态后，您只能在您的角色配置为维护模板时维护模板。

以下步骤介绍了如何分配模板维护。

定位至模板的角色访问权限标签。
单击模板管理表上的添加。

单击“Permitted Data Set Operations（允许的数据集运算）”表上的“add（添加）”

搜索模板设计器或维护角色，例如 HSDL 模板设计器，并添加可以维护此模板的角色。

单击 Validate and save（验证并保存）。

分配角色数据集访问权限

配置可从此模板生成电子表格的角色及其具有的数据集访问权限。

定位至角色访问权限标签。
单击允许的数据集操作表中的添加。

搜索要为其分配模板访问权限的角色，例如人力资源专员。

检查要添加的角色，然后单击添加。

默认情况下，将为角色分配创建、保存和上载数据集的访问权限。

根据需要更改数据集访问权限。

数据集操作
操作	说明
创建	可以创建数据集。
保存	数据集数据可以保存到中转表中。
上传	可以上载数据集，并将有效行保存到应用程序。
回退	可以回退数据集，删除已成功加载但随后未更新的数据。回滚仅对几个业务对象可用。
查看全部	可以下载和复查模板的所有现有数据集，而不仅仅是用户创建的数据集。

提示：

您可能拥有一个模板，您需要一个角色才能创建数据并将其保存到分段表，但无权上载该数据；另一个角色无法创建新数据集，但可以复核其他用户创建的数据集并上载这些数据集。这可以实现一种审批形式。

验证和保存。

激活模板

只有活动模板在运行电子表格数据加载程序任务中可见，并且在使用 REST 启动 HSDL 时可以使用。对于状态为草稿的模板，请完成以下步骤。

单击定义选项卡。
将 Status 更新为 Active 。

单击 Validate and Save （验证并保存）。

该模板现在可供角色配置为对模板具有数据集访问权限的用户使用。

测试业务用户访问

现在，您应该以具有分配给模板访问权限的角色的用户身份登录，并确认模板在运行电子表格数据加载程序任务中可用，并且模板生成的电子表格可以根据需要工作。

导出模板

完全测试模板并准备将其移至生产环境时，您可以导出模板定义。

使用您的 HSDL 模板设计器角色登录到应用程序并导航到电子表格模板任务。
搜索模板。
单击操作按钮，然后选择导出操作。

模板定义将导出为 xml 文件，并且应该在 Downloads 目录中可用。

任务 9：在生产环境中导入和激活模板

在此任务中，您将模板导入生产环境，分配可以使用模板的角色并激活模板。

您需要在生产上具有 HSDL 模板维护角色，该角色配置为导入模板所基于的业务对象的模板。有关创建此类角色的步骤，请参阅配置对设计和维护 HCM 电子表格数据加载程序 (HSDL) 模板的访问权限教程。

导航到 Data Exchange 中的 Spreadsheet Templates（电子表格模板）任务。
单击导入。

在导入对话框窗口中，指定用于描述电子表格模板支持的用例的名称，例如新聘人员。

提示：

代码将根据指定的名称进行默认设置，但您可以覆盖此名称。它必须是独一无二的。

使用导入字段选择要导入的模板文件的 xml 文件。
提供说明，以便业务用户可以了解何时使用此模板。
如果模板特定于法规，请指定其适用的法规数据组。

单击确定。

您应收到模板导入时没有错误的确认。单击确定。

提示：

如果遇到错误，请下载日志文件以了解更多信息。

您将返回到电子表格模板页面。

搜索导入的模板，然后单击模板名称以编辑模板。
重复任务 8 中的步骤以分配模板维护角色、分配角色数据集访问权限并激活模板。
保存所做更改。

具有已分配角色的用户现在可以访问您的模板。

后续步骤

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

致谢

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

简介

目标