Oracle Seeker, Oracle探索者

本文紧接 HR人员信息导入(1) 进行描述HR人员信息导入过程。

Oracle EBS 11.5.10.2

一、基本必备信息

通过第一部分的手工录入数据，我们知道录入一个员工的信息时，界面上必须输入的字段有：

1. 员工的姓 LAST_NAME
2. 身份证号 NATIONAL_IDENTIFIER
3. 员工编号 EMPLOYEE_NUMBER
4. 员工类型 PERSON_TYPE_ID
5. 性别SEX
6. *移居国外者 (中国时需要) LOC_ITEM08
7. *户口类型 (中国时需要) LOC_ITEM04
8. *户口所在地 (中国时需要) LOC_ITEM05

二、APIs主要参数描述

hr_employee_api.create_employee过程的参数非常丰富，包含了一个员工几乎所有涉及到的属性，除了上述几个介绍的必备字段外，另外还有一些重要字段，下面介绍该过程的部分重要参数：

1. p_validate 必填，该参数可选值TRUE或FALSE，当参数输入TRUE时该过程仅对所填数据进行校验，并给出信息反馈，即使通过校验也不提交到数据库；FALSE时对输入的参数进行校验，当验证通过时将导入信息存入数据库
2. p_hire_date 必填，雇佣日期，Oracle日期格式
3. p_business_group_id 必填，当前创建人员所在的业务组ID
4. p_last_name 必填，员工的姓
5. p_sex 必填，员工性别，可以填入”M“或”F“表示男性或女性，系统会使用”SEX” HR快速编码中存在的值进行验证
6. p_person_type_id 必填，所创建的员工类别的ID
7. p_employee_number 必填，员工号，由当前业务组的员工编号生成方法来决定是输入值或得到值。当该生成方法设定为自动生成时，填入该参数的变量将会获得到一个由系统根据序列生成的员工编号。当业务组的生成方法设定为需要输入时，就需要给代入该参数的变量先赋值，然后传递给该参数，系统会校验该员工号是否有重复
8. p_per_information4 条件必填，户口类型，当使用中国HRMS管理时该字段将为必填选项，输入员工的户口类型。当判断到当前位中国时会调用per_cn_emp_leg_hook.check_int_employee进行校验，对应参数p_hukou_type
9. p_per_information5条件必填，户口所在地，当使用中国HRMS管理时该字段将为必填选项，输入员工的户口所在地。当判断到当前位中国时会调用per_cn_emp_leg_hook.check_int_employee进行校验，对应参数p_hukou_location
10. p_per_information8条件必填，是否出国标示，当使用中国HRMS管理时该字段将为必填选项。当判断到当前位中国时会调用per_cn_emp_leg_hook.check_int_employee进行校验，对应参数p_expatriate_indicator
11. p_original_date_of_hire 必填，原始雇佣日期
12. p_date_of_birth 条件必填，当在该员工的分配信息中定义了工资单，就必须在员工信息界面输入该员工的出生日期

注：如果系统启用了描述性弹性域，而且其中包括了必填的字段，那也需要提供相关信息

三、常见APIs调用的错误及原因

a) ORA-20001: The mandatory argument XXXX value cannot be null

必填参数XXXX没有填写，注意当使用中国HRMS时p_per_information4/5/8均为必填项

b) ORA-20001: The value XXXX not valid for the XXXX field.

不同字段有其自己的验证规则，有些使用hr_lookups中的快速编码验证，有些根据Value Set中的值验证。

c) ORA-20001: You must enter the gender for an employee.

员工性别为填。

d) ORA-20001: Employee Number already exists.

员工工号在系统中已经存在，需要使用新的工号。

四、APIs调用实例

导入时的各变量定义及调用格式请参考附属脚本：hr_people_imp.tst

相关脚本下载：

-

Oracle EBS 11.5.10.2

本文讲述Oracle EBS HR项目实施时，通过开发导入的各种HR相关数据及API导入方法。这里描述HR人员基本信息导入的方法。

HR人事模块在上线前会导入大量人员基本信息。一般通过使用Oracle HR模块的标准API进行人员信息的导入， 一般导入步骤如下：

1. 通常在系统中会先建立客户化临时表
2. 将客户整理好的数据导入临时表中
3. 在临时表进行数据的校验，校验根据当前客户的需求和系统的实际情况来完成
4. 完成校验后的数据逐行调用API导入系统

利用标准界面创建员工

录入员工信息是在标准的员工的录入界面。

1. 完成了HR模块的基础模块设置后进入“中国HRMS管理员”或其他具有相关权限的职责

2. 打开标准Form，路径：中国HRMS管理员–>人员–>输入和维护；英文环境：China HRMS Manager–>People–>Enter and Maintain

3. 打开人员输入维护界面后如下图所示，会弹出查询窗口让用户新增数据或查找

4. 点击新建(New)按钮后就会进入人员的输入界面，这个时候我们可以看到主界面上有哪些是必输项，这些项都会以黄色标识。但实际在输入时会有一些项根据当前实际数据信息也动态变成必须

5. 首先我们在界面上输入当前所见的黄色区域，包括“姓”和“身份证号”，并切换一些Tab页面将其中的必输字段也填写完整后保存，回出现如下“在首次创建记录时，您必须选择活动类型的值”的提示信息

6. 在主界面右上方选择“操作(Action)”，选择创建雇佣后，就需要输入员工号并且自动带出右下方的起始日期。然后再保存的时候系统会提示必须设置员工性别，我们在使用下拉框“Gender”选择性别。完成上述选择后保存员工保存成功。(如果此时还有其他提示信息标识当前环境可能有部分不同的基础设置导致)

7. 员工信息建立后我们可以看到同时创建的信息包括1条默认主分配信息，从主界面下方点击Assignment按钮进入分配界面

8. 同时还创建了一条员工服务期记录，同国主界面点击“Others”选择“Person Type Usage”打开界面

9. 在第一节中我们描述了如何利用系统界面进行单条员工最少信息的录入。但是往往在项目实施阶段会有大批量的员工信息需要录入系统，通过手工录入或一些键盘指令软件如Dataload进行数据录入都是非常低效的，当涉及到上万条员工信息的时候需要消耗大量的时间。

因此我们使用Orocle标准的API，通过一些程序逻辑将数据进行导入。

当一条员工记录保存后通过第一节的内容，我们知道会同时生成3条数据包括1条员工基本信息，1条分配信息以及1条员工服务期记录。分别被保存在3张系统表中：

per_all_people_f
per_all_assignments_f
per_person_type_usages_f

10. 使用hr_employee_api.create_employee 过程，程序包版本$Header: peempapi.pkh 115.30 2006/03/03 05:38:37 lsilveir noship $ 创建员工信息，成功后也会在这三张表中生成记录。

后续将介绍如何使用hr_employee_api将人员信息导入系统