转载记录-HR员工信息导入

HR员工导入界面操作步骤：http://oracleseeker.com/2008/09/26/hr-people-basic-info-import-breifing/

一、基本必备信息

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

员工的姓 LAST_NAME

身份证号 NATIONAL_IDENTIFIER

员工编号 EMPLOYEE_NUMBER

员工类型 PERSON_TYPE_ID

性别SEX

*移居国外者 (中国时需要) LOC_ITEM08

*户口类型 (中国时需要) LOC_ITEM04

*户口所在地 (中国时需要) LOC_ITEM05

二、APIs主要参数描述

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

p_validate 必填，该参数可选值TRUE或FALSE，当参数输入TRUE时该过程仅对所填数据进行校验，并给出信息反馈，即使通过校验也不提交到数据库；FALSE时对输入的参数进行校验，当验证通过时将导入信息存入数据库

p_hire_date 必填，雇佣日期，Oracle日期格式

p_business_group_id 必填，当前创建人员所在的业务组ID

p_last_name 必填，员工的姓

p_sex 必填，员工性别，可以填入”M“或”F“表示男性或女性，系统会使用”SEX”
HR快速编码中存在的值进行验证

p_person_type_id 必填，所创建的员工类别的ID

p_employee_number 必填，员工号，由当前业务组的员工编号生成方法来决定是输入值或得到值。当该生成方法设定为自动生成时，填入该参数的变量将会获得到一个由系统根据序列生成的员工编号。当业务组的生成方法设定为需要输入时，就需要给代入该参数的变量先赋值，然后传递给该参数，系统会校验该员工号是否有重复

p_per_information4 条件必填，户口类型，当使用中国HRMS管理时该字段将为必填选项，输入员工的户口类型。当判断到当前位中国时会调用per_cn_emp_leg_hook.check_int_employee进行校验，对应参数p_hukou_type

p_per_information5条件必填，户口所在地，当使用中国HRMS管理时该字段将为必填选项，输入员工的户口所在地。当判断到当前位中国时会调用per_cn_emp_leg_hook.check_int_employee进行校验，对应参数p_hukou_location

p_per_information8条件必填，是否出国标示，当使用中国HRMS管理时该字段将为必填选项。当判断到当前位中国时会调用per_cn_emp_leg_hook.check_int_employee进行校验，对应参数p_expatriate_indicator

p_original_date_of_hire 必填，原始雇佣日期

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.

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