在 HCM 电子表格数据加载程序模板中包括弹性域段

简介

通过在 HCM 电子表格数据加载程序 (HSDL) 模板中包括预配置的弹性域段和自定义弹性域段，扩展成批加载电子表格功能。

目标

在本教程里，您将：

为自定义弹性域段生成属性映射。
创建包括说明性弹性域段的维护部门模板。
扩展模板以添加两个上下文中的可扩展弹性域段。

先决条件

要完成本教程，您需要：

访问查看业务对象任务。
对具有角色的电子表格模板任务的访问权限，该角色具有为组织业务对象创建模板的访问权限。

提示：

配置对设计和维护 HCM 电子表格数据加载程序 (HSDL) 模板的访问权限教程说明了如何配置电子表格模板访问权限。

您应该已经熟悉了创建电子表格模板。如果您之前未使用 Spreadsheet Templates（电子表格模板）任务，请按照创建 HCM 电子表格数据加载程序模板教程熟悉导航和术语。

任务 1：生成属性映射

HCM 数据加载程序 (HDL) 使用属性映射来了解它支持的业务对象的配置。在配置和部署弹性域更改时，还需要刷新属性映射，以便 HDL 和 HSDL 都能查看可用于将数据加载到弹性域段中的属性。

在此任务中，您将刷新“组织”业务对象的属性映射，因为您将此对象用于以下任务。但是，这些步骤适用于所有 HDL 业务对象。

注意：

刷新属性映射之前，请确保已配置并部署自定义弹性域上下文。

在 Oracle HCM 应用程序中，导航到我的客户组 > 数据交换 > 查看业务对象。
搜索并选择组织业务对象或您已为其配置弹性域段的对象。
单击表工具栏中的刷新对象，然后在确认窗口中单击确定。

刷新表内容并查看上次刷新日期。

提示：

这显示当天刷新完成的日期后，您就可以在“业务对象详细信息”页面和“电子表格模板”用户界面中查看自定义弹性域段的属性。

单击业务对象名称以定位至业务对象详细信息页。
选择要检查的层次结构中的组件。例如，组织并单击弹性域属性选项卡。

注意：

说明性弹性域 (DFF) 段扩展基本记录，因此位于对象层次结构中的同一组件上。

使用选项列表选择正确的弹性域上下文。请注意选项列表右侧提供的弹性域代码，然后单击“搜索”以复核上下文中可用的属性。

提示：
弹性域上下文代码并不总是与代码类似。稍后将弹性域段添加到模板时，您将使用弹性域上下文代码和属性名称。
单击层次结构中的组织附加信息组件。这是可扩展弹性域 (EFF) 的示例。除了弹性域上下文之外，EFF 还具有弹性域类别。将弹性域类别设置为部门。
请复核这些弹性域并记下以下上下文的上下文代码和属性名称：
- 组织经理信息
- 工作日信息

提示：

了解 HCM 数据加载程序 (HDL) 业务对象教程更详细地介绍了查看业务对象任务。

任务 2：说明性弹性域段

您可以搜索和编辑要向其中添加自定义弹性段的模板，也可以按照以下步骤创建新模板以维护部门。在任务 3 中，您将扩展此模板以包括来自多个 EFF 上下文的段。

定义模板

导航到我的客户组 > 数据交换 > 电子表格模板。
创建一个名为维护部门的新模板。将组织指定为业务对象，然后单击确定。

定位至设计标签。
从可用属性面板中选择分类名称，然后将其添加到所选属性面板。
当提示要使用哪个关键字时，选择组织、分类名称用户关键字。

注意：

选择“分类名称”时，“组织”和“有效开始日期”属性将自动添加到选定的属性面板中。

选中 Selected Attributes（所选属性）面板上的 Show excluded attributes（显示排除的属性）复选框。

有效结束日期属性也已添加到选定属性列表中，但默认情况下隐藏，由“有效结束日期”行右边的图标指示。

编辑分类名称属性并配置部门的默认常数值，然后取消选中可见复选框以从此模板生成的电子表格中隐藏此属性。

添加组织分类属性

从可用属性标题中选择组织分类以查看组织分类属性。

将以下属性添加到模板：
- 状态
- 设置代码
注意：
用于标识父记录的属性会自动添加到模板中：组织名称、分类名称、有效开始日期和有效结束日期。
这些属性的值默认为提供给父（组织）记录的值，并且从电子表格中隐藏这些属性。
编辑 Set Code 属性以指定常量默认值 COMMON 。

编辑 Status 属性以指定常量默认值 A 并取消选中 Visible 复选框。
验证并保存模板。

添加说明性弹性域段

DFF 段与基本属性在同一记录上定义，因此不能为同一电子表格行具有多个 DFF 上下文。因此，除了全局数据要素上下文中的段之外，您只能包括一个弹性域上下文中的段。

显示组织组件的可用属性。
从要使用的 DFF 上下文中选择属性并将其添加到模板，以及所需的任何全局数据元素上下文属性。

提示：

将自动选择上下文值属性。

编辑上下文值，为添加的说明性弹性域段定义弹性域上下文代码的常量默认值。此属性可以隐藏。

提示：

查看业务对象用户界面的弹性域属性选项卡上提供了弹性域上下文代码。

任务 3：可扩展弹性域段

可扩展弹性域保存在子记录中，允许为同一父记录提供多个上下文。

在此任务中，您将将两个上下文中的 EFF 段添加到模板。

添加可扩展弹性域段

使用可用属性标题筛选器将上下文更改为组织附加信息。
搜索报告名称。

使用附加到属性名称的弹性域上下文信息，确保从模板的组织管理器信息上下文中选择报表名称。
将此属性添加到模板中。

选择第一个弹性域段时将自动添加必需属性。用于标识父记录的属性将自动默认为父记录值并隐藏。可扩展弹性域的其他必需属性包括：

组织附加信息的必备 EFF 属性
属性	说明	默认类型	默认值
上下文代码	指定所选弹性域段的弹性域上下文代码。此属性由 HCM 数据加载程序为所有弹性域记录类型生成。	常量	PER_ORG_MANAGER_INFO
EFF_CATEGORY_CODE	指定可扩展弹性域类别代码。	常量	部门
序列号	指定弹性域上下文记录的顺序。	常量	1
OrgInformationContext	指定所选弹性域段的弹性域上下文代码。此属性由业务对象定义，可以默认为与上下文代码相同的值。	现有的选定属性	上下文值 \| 组织附加信息 \|~

编辑这四个属性以定义上表中指定的默认值并隐藏它们。

从同一弹性域上下文添加所需的任何其他弹性域段属性。

提示：

只有组织附加信息组件上的弹性域段属性才会显示为此模板生成的电子表格中的列。所有其他属性都配置了默认值，并且会隐藏这些属性以简化最终用户的数据输入。

复制可扩展弹性域记录

在 Selected Attributes（所选属性）面板中，确保显示隐藏属性。
单击所选属性面板中的任何组织附加信息属性，然后单击复制。

在提示要创建的实例数时，指定 1 。

单击确定。这将创建您为组织附加信息组件选择的每个属性的副本。

提示：

新属性的名称后面将附加一个数字，以标识它们所属的新实例。

编辑属性 Reporting Name | 1 以隐藏它。
组织附加信息的此重复项适用于不同的弹性域上下文，因此您必须隐藏在原始组织附加信息记录中定义的弹性域段的所有属性。

为其他上下文添加段

在工作日信息上下文中搜索可用属性。
将以下属性从工作日信息上下文添加到模板：
- 标准工作小时数
- 标准工时频率
- 上班时间
- 下班时间
注意：
有时候有两个属性具有相同的名称。一个接受查找代码或 ID，另一个接受含义或值。从属性名称中识别这一点并不总是容易的。如果有疑问，请添加两者。
查看添加到所选属性面板的属性。

每个新弹性域段属性将出现两次。向复制的组件添加属性时，这些属性将添加到每个实例。

验证并保存模板。取消选中显示排除的属性复选框，然后单击所选属性工具栏上的高级属性定义选项。

现在，您需要从 EFF 组件的原始匹配项中隐藏新的弹性域段属性。

展开 Column Heading（列标题）和 Attribute Key（属性键）列。属性关键字唯一标识电子表格模板中的每个属性。
从原始组织附加信息记录中取消选中特定于新 EFF 上下文的每个弹性域段属性的包括在电子表格中复选框。

提示：
对象标识符和内部属性名称之间的属性关键字中不是数字的那些项。
对于接受 ID 而不是值的新事件，取消选中包含在电子表格中的标准工作小时数频率属性。

注意：
如果属性同时具有 ID 或代码属性，则接受值或含义的属性在属性关键字中将具有 _Display。

现在，在电子表格中只能有一个“标准工作小时数频率”属性，即弹性域记录第一个副本中的“显示”属性。

保存更改并退出高级选项页面。

最后，编辑重复记录上的这些属性，以指定正确的弹性域上下文和顺序：

组织附加信息的可扩展弹性域必备属性
属性	说明	默认类型	值
上下文代码 \| 1	指定第二个弹性域上下文的弹性域上下文代码。	常量	PER_WORK_DAY_INFO
序号 \| 1	指定弹性域上下文记录的顺序。	常量	2
OrgInformationContext \| 1	将默认值更新为上下文代码 \| 1 属性。	现有的选定属性	上下文值 \| 组织附加信息 \|1

提示：

您需要选中显示排除的属性复选框，才能在“选定属性”面板中找到这些属性。

您现在可以激活并使用此模板来维护部门，同时填充多个弹性域上下文。

致谢

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

简介

目标