[Home] [Help]
PACKAGE BODY: APPS.HR_CN_EMPLOYEE_API
Source
1 PACKAGE BODY hr_cn_employee_api AS
2 /* $Header: hrcnwree.pkb 115.2 2003/02/04 07:29:13 statkar noship $ */
3 --
4 g_package VARCHAR2(33) := 'hr_cn_employee_api.';
5
6 -- -----------------------------------------------------------------------------
7 -- |-----------------------< create_cn_employee >------------------------------|
8 -- -----------------------------------------------------------------------------
9 -- {Start of Comments}
10 --
11 -- Description:
12 -- Calls standard API to create an employee. Performs mapping of Developer
13 -- Descriptive Flexfield segments. No need to include validation for the
14 -- national identifier as this is now being included as a legislative hook,
15 -- so the appropriate formula will be called depending on legislation.
16 -- Ensures appropriate identification information has been entered ie.
17 -- national identifier.Maps the legislation specific columns to the core API.
18 --
19 -- Pre Conditions:
20 --
21 -- In Arguments:
22 --
23 -- Post Success:
24 --
25 -- Post Failure:
26 -- A failure can only occur under two circumstances:
27 -- 1) The value of reference field is not supported.
28 -- 2) If when the reference field value is NULL and not all
29 -- the information arguments are not NULL(i.e. information
30 -- arguments cannot be set without a corresponding reference
31 -- field value).
32 --
33 -- Developer Implementation Notes:
34 -- Developer defined.
35 --
36 -- Access Status:
37 -- Internal Development Use Only.
38 --
39 -- {End of Comments}
40 -- -----------------------------------------------------------------------------
41
42 PROCEDURE create_cn_employee
43 (p_validate in boolean default false
44 ,p_hire_date in date
45 ,p_business_group_id in number
46 ,p_family_or_last_name in varchar2
47 ,p_sex in varchar2
48 ,p_person_type_id in number default null
49 ,p_per_comments in varchar2 default null
50 ,p_date_employee_data_verified in date default null
51 ,p_date_of_birth in date default null
52 ,p_email_address in varchar2 default null
53 ,p_employee_number in out nocopy varchar2
54 ,p_expense_check_send_to_addres in varchar2 default null
55 ,p_given_or_first_name in varchar2 default null
56 ,p_known_as in varchar2 default null
57 ,p_marital_status in varchar2 default null
58 ,p_middle_names in varchar2 default null
59 ,p_nationality in varchar2 default null
60 ,p_citizen_identification_num in varchar2 default null
61 ,p_previous_last_name in varchar2 default null
62 ,p_registered_disabled_flag in varchar2 default null
63 ,p_title in varchar2 default null
64 ,p_vendor_id in number default null
65 ,p_work_telephone in varchar2 default null
66 ,p_attribute_category in varchar2 default null
67 ,p_attribute1 in varchar2 default null
68 ,p_attribute2 in varchar2 default null
69 ,p_attribute3 in varchar2 default null
70 ,p_attribute4 in varchar2 default null
71 ,p_attribute5 in varchar2 default null
72 ,p_attribute6 in varchar2 default null
73 ,p_attribute7 in varchar2 default null
74 ,p_attribute8 in varchar2 default null
75 ,p_attribute9 in varchar2 default null
76 ,p_attribute10 in varchar2 default null
77 ,p_attribute11 in varchar2 default null
78 ,p_attribute12 in varchar2 default null
79 ,p_attribute13 in varchar2 default null
80 ,p_attribute14 in varchar2 default null
81 ,p_attribute15 in varchar2 default null
82 ,p_attribute16 in varchar2 default null
83 ,p_attribute17 in varchar2 default null
84 ,p_attribute18 in varchar2 default null
85 ,p_attribute19 in varchar2 default null
86 ,p_attribute20 in varchar2 default null
87 ,p_attribute21 in varchar2 default null
88 ,p_attribute22 in varchar2 default null
89 ,p_attribute23 in varchar2 default null
90 ,p_attribute24 in varchar2 default null
91 ,p_attribute25 in varchar2 default null
92 ,p_attribute26 in varchar2 default null
93 ,p_attribute27 in varchar2 default null
94 ,p_attribute28 in varchar2 default null
95 ,p_attribute29 in varchar2 default null
96 ,p_attribute30 in varchar2 default null
97 ,p_hukou_type in varchar2
98 ,p_hukou_location in varchar2
99 ,p_highest_education_level in varchar2 default null
100 ,p_number_of_children in varchar2 default null
101 ,p_expatriate_indicator in varchar2 default 'N' -- Bug 2782045
102 ,p_health_status in varchar2 default null
103 ,p_tax_exemption_indicator in varchar2 default null
104 ,p_percentage in varchar2 default null
105 ,p_family_han_yu_pin_yin_name in varchar2 default null
106 ,p_given_han_yu_pin_yin_name in varchar2 default null
107 ,p_previous_name in varchar2 default null
108 ,p_race_ethnic_orgin in varchar2 default null
109 ,p_social_security_ic_number in varchar2 default null
110 ,p_date_of_death in date default null
111 ,p_background_check_status in varchar2 default null
112 ,p_background_date_check in date default null
113 ,p_blood_type in varchar2 default null
114 ,p_correspondence_language in varchar2 default null
115 ,p_fast_path_employee in varchar2 default null
116 ,p_fte_capacity in number default null
117 ,p_honors in varchar2 default null
118 ,p_internal_location in varchar2 default null
119 ,p_last_medical_test_by in varchar2 default null
120 ,p_last_medical_test_date in date default null
121 ,p_mailstop in varchar2 default null
122 ,p_office_number in varchar2 default null
123 ,p_on_military_service in varchar2 default null
124 ,p_pre_name_adjunct in varchar2 default null
125 ,p_projected_start_date in date default null
126 ,p_resume_exists in varchar2 default null
127 ,p_resume_last_updated in date default null
128 ,p_second_passport_exists in varchar2 default null
129 ,p_student_status in varchar2 default null
130 ,p_work_schedule in varchar2 default null
131 ,p_suffix in varchar2 default null
132 ,p_benefit_group_id in number default null
133 ,p_receipt_of_death_cert_date in date default null
134 ,p_coord_ben_med_pln_no in varchar2 default null
135 ,p_coord_ben_no_cvg_flag in varchar2 default 'N'
136 ,p_coord_ben_med_ext_er in varchar2 default null
137 ,p_coord_ben_med_pl_name in varchar2 default null
138 ,p_coord_ben_med_insr_crr_name in varchar2 default null
139 ,p_coord_ben_med_insr_crr_ident in varchar2 default null
140 ,p_coord_ben_med_cvg_strt_dt in date default null
141 ,p_coord_ben_med_cvg_end_dt in date default null
142 ,p_uses_tobacco_flag in varchar2 default null
143 ,p_dpdnt_adoption_date in date default null
144 ,p_dpdnt_vlntry_svce_flag in varchar2 default 'N'
145 ,p_original_date_of_hire in date default null
146 ,p_adjusted_svc_date in date default null
147 ,p_place_of_birth in varchar2 default null
148 ,p_original_hometown in varchar2 default null
149 ,p_country_of_birth in varchar2 default null
150 ,p_global_person_id in varchar2 default null
151 ,p_party_id in number default null
152 ,p_person_id out nocopy number
153 ,p_assignment_id out nocopy number
154 ,p_per_object_version_number out nocopy number
155 ,p_asg_object_version_number out nocopy number
156 ,p_per_effective_start_date out nocopy date
157 ,p_per_effective_end_date out nocopy date
158 ,p_full_name out nocopy varchar2
159 ,p_per_comment_id out nocopy number
160 ,p_assignment_sequence out nocopy number
161 ,p_assignment_number out nocopy varchar2
162 ,p_name_combination_warning out nocopy boolean
163 ,p_assign_payroll_warning out nocopy boolean
164 ,p_orig_hire_warning out nocopy boolean)
165 IS
166 -- Declare cursors and local variables
167 l_proc VARCHAR2(72) := g_package||'create_cn_employee';
168 --
169 BEGIN
170
171 hr_cn_api.set_location(g_trace, 'Entering:'|| l_proc, 10);
172
173 --
174 -- Validation IN addition to Row Handlers
175 --
176 -- Check that the specified business group is valid.
177 --
178 hr_cn_api.check_bus_grp (p_business_group_id, 'CN');
179
180 hr_cn_api.set_location(g_trace, l_proc, 20);
181 --
182 -- Call the person business process
183 --
184 hr_employee_api.create_employee
185 (p_validate => p_validate
186 ,p_hire_date => p_hire_date
187 ,p_business_group_id => p_business_group_id
188 ,p_last_name => p_family_or_last_name
189 ,p_sex => p_sex
190 ,p_person_type_id => p_person_type_id
191 ,p_per_comments => p_per_comments
192 ,p_date_employee_data_verified => p_date_employee_data_verified
193 ,p_date_of_birth => p_date_of_birth
194 ,p_email_address => p_email_address
195 ,p_employee_number => p_employee_number
196 ,p_expense_check_send_to_addres => p_expense_check_send_to_addres
197 ,p_first_name => p_given_or_first_name
198 ,p_known_as => p_known_as
199 ,p_marital_status => p_marital_status
200 ,p_middle_names => p_middle_names
201 ,p_nationality => p_nationality
202 ,p_national_identifier => p_citizen_identification_num
203 ,p_previous_last_name => p_previous_last_name
204 ,p_registered_disabled_flag => p_registered_disabled_flag
205 ,p_title => p_title
206 ,p_vendor_id => p_vendor_id
207 ,p_work_telephone => p_work_telephone
208 ,p_attribute_category => p_attribute_category
209 ,p_attribute1 => p_attribute1
210 ,p_attribute2 => p_attribute2
211 ,p_attribute3 => p_attribute3
212 ,p_attribute4 => p_attribute4
213 ,p_attribute5 => p_attribute5
214 ,p_attribute6 => p_attribute6
215 ,p_attribute7 => p_attribute7
216 ,p_attribute8 => p_attribute8
217 ,p_attribute9 => p_attribute9
218 ,p_attribute10 => p_attribute10
219 ,p_attribute11 => p_attribute11
220 ,p_attribute12 => p_attribute12
221 ,p_attribute13 => p_attribute13
222 ,p_attribute14 => p_attribute14
223 ,p_attribute15 => p_attribute15
224 ,p_attribute16 => p_attribute16
225 ,p_attribute17 => p_attribute17
226 ,p_attribute18 => p_attribute18
227 ,p_attribute19 => p_attribute19
228 ,p_attribute20 => p_attribute20
229 ,p_attribute21 => p_attribute21
230 ,p_attribute22 => p_attribute22
231 ,p_attribute23 => p_attribute23
232 ,p_attribute24 => p_attribute24
233 ,p_attribute25 => p_attribute25
234 ,p_attribute26 => p_attribute26
235 ,p_attribute27 => p_attribute27
236 ,p_attribute28 => p_attribute28
237 ,p_attribute29 => p_attribute29
238 ,p_attribute30 => p_attribute30
239 ,p_per_information_category => 'CN'
240 ,p_per_information4 => p_hukou_type
241 ,p_per_information5 => p_hukou_location
242 ,p_per_information6 => p_highest_education_level
243 ,p_per_information7 => p_number_of_children
244 ,p_per_information8 => p_expatriate_indicator
245 ,p_per_information10 => p_health_status
246 ,p_per_information11 => p_tax_exemption_indicator
247 ,p_per_information12 => p_percentage
248 ,p_per_information14 => p_family_han_yu_pin_yin_name
249 ,p_per_information15 => p_given_han_yu_pin_yin_name
250 ,p_per_information16 => p_previous_name
251 ,p_per_information17 => p_race_ethnic_orgin
252 ,p_per_information18 => p_social_security_ic_number
253 ,p_date_of_death => p_date_of_death
254 ,p_background_check_status => p_background_check_status
255 ,p_background_date_check => p_background_date_check
256 ,p_blood_type => p_blood_type
257 ,p_correspondence_language => p_correspondence_language
258 ,p_fast_path_employee => p_fast_path_employee
259 ,p_fte_capacity => p_fte_capacity
260 ,p_honors => p_honors
261 ,p_internal_location => p_internal_location
262 ,p_last_medical_test_by => p_last_medical_test_by
263 ,p_last_medical_test_date => p_last_medical_test_date
264 ,p_mailstop => p_mailstop
265 ,p_office_number => p_office_number
266 ,p_on_military_service => p_on_military_service
267 ,p_pre_name_adjunct => p_pre_name_adjunct
268 ,p_projected_start_date => p_projected_start_date
269 ,p_resume_exists => p_resume_exists
270 ,p_resume_last_updated => p_resume_last_updated
271 ,p_second_passport_exists => p_second_passport_exists
272 ,p_student_status => p_student_status
273 ,p_work_schedule => p_work_schedule
274 ,p_suffix => p_suffix
275 ,p_benefit_group_id => p_benefit_group_id
276 ,p_receipt_of_death_cert_date => p_receipt_of_death_cert_date
277 ,p_coord_ben_med_pln_no => p_coord_ben_med_pln_no
278 ,p_coord_ben_no_cvg_flag => p_coord_ben_no_cvg_flag
279 ,p_coord_ben_med_ext_er => p_coord_ben_med_ext_er
280 ,p_coord_ben_med_pl_name => p_coord_ben_med_pl_name
281 ,p_coord_ben_med_insr_crr_name => p_coord_ben_med_insr_crr_name
282 ,p_coord_ben_med_insr_crr_ident => p_coord_ben_med_insr_crr_ident
283 ,p_coord_ben_med_cvg_strt_dt => p_coord_ben_med_cvg_strt_dt
284 ,p_coord_ben_med_cvg_end_dt => p_coord_ben_med_cvg_end_dt
285 ,p_uses_tobacco_flag => p_uses_tobacco_flag
286 ,p_dpdnt_adoption_date => p_dpdnt_adoption_date
287 ,p_dpdnt_vlntry_svce_flag => p_dpdnt_vlntry_svce_flag
288 ,p_original_date_of_hire => p_original_date_of_hire
289 ,p_adjusted_svc_date => p_adjusted_svc_date
290 ,p_town_of_birth => p_place_of_birth
291 ,p_region_of_birth => p_original_hometown
292 ,p_country_of_birth => p_country_of_birth
293 ,p_global_person_id => p_global_person_id
294 ,p_party_id => p_party_id
295 --
296 ,p_person_id => p_person_id
297 ,p_assignment_id => p_assignment_id
298 ,p_per_object_version_number => p_per_object_version_number
299 ,p_asg_object_version_number => p_asg_object_version_number
300 ,p_per_effective_start_date => p_per_effective_start_date
301 ,p_per_effective_end_date => p_per_effective_end_date
302 ,p_full_name => p_full_name
303 ,p_per_comment_id => p_per_comment_id
304 ,p_assignment_sequence => p_assignment_sequence
305 ,p_assignment_number => p_assignment_number
306 ,p_name_combination_warning => p_name_combination_warning
307 ,p_assign_payroll_warning => p_assign_payroll_warning
308 ,p_orig_hire_warning => p_orig_hire_warning);
309 --
310
311 hr_cn_api.set_location(g_trace, 'Leaving:'|| l_proc, 30);
312
313 --
314 -- Set g_trace to its default value.
315 IF g_trace THEN
316 g_trace:=FALSE;
317 END IF;
318
319 END create_cn_employee;
320 --
321 --
322 END hr_cn_employee_api;