oracleHR人员信息导入API

oracleHR⼈员信息导⼊API
2011年7⽉2⽇Jack
本⽂讲述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 $创建员⼯信息，成功后也会在这三张表中⽣成记录。

⼀、基本必备信息
通过第⼀部分的⼿⼯录⼊数据，我们知道录⼊⼀个员⼯的信息时，界⾯上必须输⼊的字段有：
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.
员⼯⼯号在系统中已经存在，需要使⽤新的⼯号。