DBA Data[Home] [Help]

PACKAGE: APPS.HR_HU_APPLICANT_API

Source


1 Package hr_hu_applicant_api as
2 /* $Header: peapphui.pkh 120.1 2005/10/02 02:10:26 aroussel $ */
3 /*#
4  * This package contains Applicant APIs for Hungary.
5  * @rep:scope public
6  * @rep:product per
7  * @rep:displayname Applicant for Hungary
8 */
9 --
10 -- ----------------------------------------------------------------------------
11 -- |---------------------------< create_hu_applicant >------------------------|
12 -- ----------------------------------------------------------------------------
13 --
14 -- {Start Of Comments}
15 /*#
16  * This API creates a new applicant for Hungary.
17  *
18  * This API creates a new applicant regardless of the business group
19  * legislation code. It creates the person details, an application, a default
20  * applicant assignment and if required associated assignment budget values and
21  * a letter request. The applicant is added to the security lists so that
22  * secure users can see them. If a person_type_id is not specified the API will
23  * use the default 'APL' type for the business group.
24  *
25  * <p><b>Licensing</b><br>
26  * This API is licensed for use with Human Resources.
27  *
28  * <p><b>Prerequisites</b><br>
29  * A valid Hungarian business_group_id. A valid person_type_id, if specified,
30  * with a corresponding system type of 'APL', must be active and in the same
31  * business group as that of the applicant being created.
32  *
33  * <p><b>Post Success</b><br>
34  * The API creates an applicant successfully.
35  *
36  * <p><b>Post Failure</b><br>
37  * The API does not create the applicant and raises an error.
38  * @param p_validate If true, then validation alone will be performed and the
39  * database will remain unchanged. If false and all validation checks pass,
40  * then the database will be modified.
41  * @param p_date_received Date an application was received.
42  * @param p_business_group_id Business group of the person.
43  * @param p_last_name Last name.
44  * @param p_person_type_id Type of applicant being created.
45  * @param p_applicant_number The business group's applicant number generation
46  * method determines when the API derives and passes out an applicant number or
47  * when the calling program should pass in a value. When the API call completes
48  * if p_validate is true then will be set to the applicant number. If
49  * p_validate is true then will be set to the passed value.
50  * @param p_per_comments Person comment text
51  * @param p_date_employee_data_verified Date on which the applicant data was
52  * last verified.
53  * @param p_date_of_birth Date of birth.
54  * @param p_email_address Email address.
55  * @param p_expense_check_send_to_addres Mailing address.
56  * @param p_first_name Applicant's first name.
57  * @param p_preferred_name Alternative name.
58  * @param p_marital_status Marital status. Valid values are defined by the
59  * MAR_STATUS lookup type.
60  * @param p_middle_names Middle names.
61  * @param p_nationality Nationality. Valid values are defined by the
62  * NATIONALITY lookup type.
63  * @param p_ss_number National identifier
64  * @param p_maiden_name Applicant's previous last name
65  * @param p_registered_disabled_flag Flag indicating whether the person is
66  * classified as disabled.
67  * @param p_sex Legal gender. Valid values are defined by the SEX lookup type.
68  * @param p_title Title. Valid values are defined by the TITLE lookup type.
69  * @param p_work_telephone Obsolete parameter, do not use.
70  * @param p_attribute_category This context value determines which flexfield
71  * structure to use with the descriptive flexfield segments.
72  * @param p_attribute1 Descriptive flexfield segment.
73  * @param p_attribute2 Descriptive flexfield segment.
74  * @param p_attribute3 Descriptive flexfield segment.
75  * @param p_attribute4 Descriptive flexfield segment.
76  * @param p_attribute5 Descriptive flexfield segment.
77  * @param p_attribute6 Descriptive flexfield segment.
78  * @param p_attribute7 Descriptive flexfield segment.
79  * @param p_attribute8 Descriptive flexfield segment.
80  * @param p_attribute9 Descriptive flexfield segment.
81  * @param p_attribute10 Descriptive flexfield segment.
82  * @param p_attribute11 Descriptive flexfield segment.
83  * @param p_attribute12 Descriptive flexfield segment.
84  * @param p_attribute13 Descriptive flexfield segment.
85  * @param p_attribute14 Descriptive flexfield segment.
86  * @param p_attribute15 Descriptive flexfield segment.
87  * @param p_attribute16 Descriptive flexfield segment.
88  * @param p_attribute17 Descriptive flexfield segment.
89  * @param p_attribute18 Descriptive flexfield segment.
90  * @param p_attribute19 Descriptive flexfield segment.
91  * @param p_attribute20 Descriptive flexfield segment.
92  * @param p_attribute21 Descriptive flexfield segment.
93  * @param p_attribute22 Descriptive flexfield segment.
94  * @param p_attribute23 Descriptive flexfield segment.
95  * @param p_attribute24 Descriptive flexfield segment.
96  * @param p_attribute25 Descriptive flexfield segment.
97  * @param p_attribute26 Descriptive flexfield segment.
98  * @param p_attribute27 Descriptive flexfield segment.
99  * @param p_attribute28 Descriptive flexfield segment.
100  * @param p_attribute29 Descriptive flexfield segment.
101  * @param p_attribute30 Descriptive flexfield segment.
102  * @param p_per_information_category Obsolete parameter, do not use.
103  * @param p_mothers_maiden_name Mother's Maiden Name
104  * @param p_tax_identification_no Tax Identification Number
105  * @param p_personal_identity_no Personal Identity Number
106  * @param p_pensioner_registration_no Pensioner Registration Number
107  * @param p_contact_employers_name Name of the contact's employer
108  * @param p_per_information6 Developer descriptive flexfield segment.
109  * @param p_service_completed Military Service Completed. Valid values exist in
110  * the 'YES_NO' lookup type.
111  * @param p_reason_not_completed Reason military service not completed
112  * @param p_service_start_date Military Service Start Date
113  * @param p_service_end_date Military Service End Date
114  * @param p_mandate_code Mandate Code. Valid values exist in
115  * 'HR_HU_MILITARY_MANDATE_CODE' lookup type.
116  * @param p_mandate_date Mandate Date
117  * @param p_command_type Command Type. Valid values exist in
118  * 'HR_HU_MILITARY_COMMAND_TYPE' lookup type.
119  * @param p_command_color Command Color. Valid values exist in
120  * 'HR_HU_MILITARY_COMMAND_COLOR' lookup type.
121  * @param p_command_number Command Number
122  * @param p_rank Military Rank. Valid values exist in 'HR_HU_MILITARY_RANK'
123  * lookup type.
124  * @param p_position Civil defence position
125  * @param p_organization Civil Defence Organization. Valid values exist in
126  * 'HR_HU_CIVIL_DEFENCE_ORG' lookup type.
127  * @param p_local_department Local Department. Valid values exist in
128  * 'HR_HU_CIVIL_LOCAL_DEPT' lookup type.
129  * @param p_local_sub_department Local Sub-Department. Valid values exist in
130  * 'HR_HU_CIVIL_LOCAL_SUB_DEP' lookup type. T
131  * @param p_group Civil Defence Group. Valid values exist in
132  * 'HR_HU_CIVIL_GROUP' lookup type.
133  * @param p_sub_group Civil Defence Sub-Group. Valid values exist in
134  * 'HR_HU_CIVIL_SUB_GROUP' lookup type.
135  * @param p_ss_start_date Social Security Start Date
136  * @param p_ss_end_date Social Security End Date
137  * @param p_per_information25 Developer descriptive flexfield segment.
138  * @param p_per_information26 Developer descriptive flexfield segment.
139  * @param p_per_information27 Developer descriptive flexfield segment.
140  * @param p_per_information28 Developer descriptive flexfield segment.
141  * @param p_per_information29 Developer descriptive flexfield segment.
142  * @param p_per_information30 Developer descriptive flexfield segment.
143  * @param p_background_check_status Flag indicating whether the person's
144  * background has been checked.
145  * @param p_background_date_check Date on which the background check was
146  * performed.
147  * @param p_correspondence_language Preferred language for correspondence.
148  * @param p_fte_capacity Obsolete parameter, do not use.
149  * @param p_hold_applicant_date_until Date until when the applicant's
150  * information is to be maintained.
151  * @param p_honors Honors awarded.
152  * @param p_mailstop Internal mail location.
153  * @param p_office_number Office number.
154  * @param p_on_military_service Flag indicating whether the person is on
155  * military service.
156  * @param p_prefix Name prefix
157  * @param p_projected_start_date Obsolete parameter, do not use.
158  * @param p_resume_exists Flag indicating whether the person's resume is on
159  * file.
160  * @param p_resume_last_updated Date on which the resume was last updated.
161  * @param p_student_status If this applicant is a student, this field is used
162  * to capture their status. Valid values are defined by the STUDENT_STATUS
163  * lookup type.
164  * @param p_work_schedule Days on which this person will work.
165  * @param p_suffix Suffix after the person's last name e.g. Sr., Jr., III.
166  * @param p_date_of_death Date of death.
167  * @param p_benefit_group_id Benefit group to which this person will belong.
168  * @param p_receipt_of_death_cert_date Date death certificate was received.
169  * @param p_coord_ben_med_pln_no Secondary medical plan name. Column used for
170  * external processing.
171  * @param p_coord_ben_no_cvg_flag No secondary medical plan coverage. Column
172  * used for external processing.
173  * @param p_uses_tobacco_flag Flag indicating whether the person uses tobacco.
174  * @param p_dpdnt_adoption_date Date on which the dependent was adopted.
175  * @param p_dpdnt_vlntry_svce_flag Flag indicating whether the dependent is on
176  * voluntary service.
177  * @param p_original_date_of_hire Original date of hire.
178  * @param p_place_of_birth Place of Birth
179  * @param p_region_of_birth Geographical region of birth.
180  * @param p_country_of_birth Country of birth.
181  * @param p_global_person_id Obsolete parameter, do not use.
182  * @param p_party_id TCA party for whom you create the person record.
183  * @param p_person_id If p_validate is false, then this uniquely identifies the
184  * person created. If p_validate is true, then set to null
185  * @param p_assignment_id If p_validate is false, then this uniquely identifies
186  * the created assignment. If p_validate is true, then set to null.
187  * @param p_application_id If p_validate is false, then this uniquely
188  * identifies the application created. If p_validate is true, then set to null.
189  * @param p_per_object_version_number If p_validate is false, then set to the
190  * version number of the created person. If p_validate is true, then the value
191  * will be null.
192  * @param p_asg_object_version_number If p_validate is false, then this
193  * parameter is set to the version number of the assignment created. If
194  * p_validate is true, then this parameter is null.
195  * @param p_apl_object_version_number If p_validate is false, then set to the
196  * version number of the created application. If p_validate is true, then set
197  * to null.
198  * @param p_per_effective_start_date If p_validate is false, then set to the
199  * earliest effective start date for the created person. If p_validate is true,
200  * then set to null.
201  * @param p_per_effective_end_date If p_validate is false, then set to the
202  * effective end date for the created person. If p_validate is true, then set
203  * to null.
204  * @param p_full_name If p_validate is false, then set to the complete full
205  * name of the person. If p_validate is true, then set to null.
206  * @param p_per_comment_id If p_validate is false and comment text was
207  * provided, then will be set to the identifier of the created person comment
208  * record. If p_validate is true or no comment text was provided, then will be
209  * null.
210  * @param p_assignment_sequence If p_validate is false, then set to the
211  * sequence number of the default assignment. If p_validate is true, then set
212  * to null.
213  * @param p_name_combination_warning If set to true, then the combination of
214  * last name, first name and date of birth existed prior to calling this API.
215  * @param p_orig_hire_warning If set to true, an orginal date of hire exists
216  * for an applicant who has never been an employee.
217  * @rep:displayname Create Applicant for Hungary
218  * @rep:category BUSINESS_ENTITY PER_APPLICANT
219  * @rep:scope public
220  * @rep:lifecycle active
221  * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
222 */
223 --
224 -- {End Of Comments}
225 --
226 procedure create_hu_applicant
227   (p_validate                     in     boolean  default false
228   ,p_date_received                in     date
229   ,p_business_group_id            in     number
230   ,p_last_name                    in     varchar2
231   ,p_person_type_id               in     number   default null
232   ,p_applicant_number             in out nocopy varchar2
233   ,p_per_comments                 in     varchar2 default null
234   ,p_date_employee_data_verified  in     date     default null
235   ,p_date_of_birth                in     date     default null
236   ,p_email_address                in     varchar2 default null
237   ,p_expense_check_send_to_addres in     varchar2 default null
238   ,p_first_name                   in     varchar2 default null
239   ,p_preferred_name               in     varchar2 default null
240   ,p_marital_status               in     varchar2 default null
241   ,p_middle_names                 in     varchar2 default null
242   ,p_nationality                  in     varchar2 default null
243   ,p_ss_number                    in     varchar2 default null
244   ,p_maiden_name                  in     varchar2 default null
245   ,p_registered_disabled_flag     in     varchar2 default null
246   ,p_sex                          in     varchar2 default null
247   ,p_title                        in     varchar2 default null
248   ,p_work_telephone               in     varchar2 default null
249   ,p_attribute_category           in     varchar2 default null
250   ,p_attribute1                   in     varchar2 default null
251   ,p_attribute2                   in     varchar2 default null
252   ,p_attribute3                   in     varchar2 default null
253   ,p_attribute4                   in     varchar2 default null
254   ,p_attribute5                   in     varchar2 default null
255   ,p_attribute6                   in     varchar2 default null
256   ,p_attribute7                   in     varchar2 default null
257   ,p_attribute8                   in     varchar2 default null
258   ,p_attribute9                   in     varchar2 default null
259   ,p_attribute10                  in     varchar2 default null
260   ,p_attribute11                  in     varchar2 default null
264   ,p_attribute15                  in     varchar2 default null
261   ,p_attribute12                  in     varchar2 default null
262   ,p_attribute13                  in     varchar2 default null
263   ,p_attribute14                  in     varchar2 default null
265   ,p_attribute16                  in     varchar2 default null
266   ,p_attribute17                  in     varchar2 default null
267   ,p_attribute18                  in     varchar2 default null
268   ,p_attribute19                  in     varchar2 default null
269   ,p_attribute20                  in     varchar2 default null
270   ,p_attribute21                  in     varchar2 default null
271   ,p_attribute22                  in     varchar2 default null
272   ,p_attribute23                  in     varchar2 default null
273   ,p_attribute24                  in     varchar2 default null
274   ,p_attribute25                  in     varchar2 default null
275   ,p_attribute26                  in     varchar2 default null
276   ,p_attribute27                  in     varchar2 default null
277   ,p_attribute28                  in     varchar2 default null
278   ,p_attribute29                  in     varchar2 default null
279   ,p_attribute30                  in     varchar2 default null
280   ,p_per_information_category     in     varchar2 default null
281   ,p_mothers_maiden_name          in     varchar2 default null
282   ,p_tax_identification_no        in     varchar2 default null
283   ,p_personal_identity_no         in     varchar2 default null
284   ,p_pensioner_registration_no    in     varchar2 default null
285   ,p_contact_employers_name       in     varchar2 default null
286   ,p_per_information6             in     varchar2 default null
287   ,p_service_completed            in     varchar2 default null
288   ,p_reason_not_completed         in     varchar2 default null
289   ,p_service_start_date           in     varchar2 default null
290   ,p_service_end_date             in     varchar2 default null
291   ,p_mandate_code                 in     varchar2 default null
292   ,p_mandate_date                 in     varchar2 default null
293   ,p_command_type                 in     varchar2 default null
294   ,p_command_color                in     varchar2 default null
295   ,p_command_number               in     varchar2 default null
296   ,p_rank                         in     varchar2 default null
297   ,p_position                     in     varchar2 default null
298   ,p_organization                 in     varchar2 default null
299   ,p_local_department             in     varchar2 default null
300   ,p_local_sub_department         in     varchar2 default null
301   ,p_group                        in     varchar2 default null
302   ,p_sub_group                    in     varchar2 default null
303   ,p_ss_start_date                in     varchar2 default null
304   ,p_ss_end_date                  in     varchar2 default null
305   ,p_per_information25            in     varchar2 default null
306   ,p_per_information26            in     varchar2 default null
307   ,p_per_information27            in     varchar2 default null
308   ,p_per_information28            in     varchar2 default null
309   ,p_per_information29            in     varchar2 default null
310   ,p_per_information30            in     varchar2 default null
311   ,p_background_check_status      in     varchar2 default null
312   ,p_background_date_check        in     date     default null
313   ,p_correspondence_language      in     varchar2 default null
314   ,p_fte_capacity                 in     number   default null
315   ,p_hold_applicant_date_until    in     date     default null
316   ,p_honors                       in     varchar2 default null
317   ,p_mailstop                     in     varchar2 default null
318   ,p_office_number                in     varchar2 default null
319   ,p_on_military_service          in     varchar2 default null
320   ,p_prefix                       in     varchar2 default null
321   ,p_projected_start_date         in     date     default null
322   ,p_resume_exists                in     varchar2 default null
323   ,p_resume_last_updated          in     date     default null
324   ,p_student_status               in     varchar2 default null
325   ,p_work_schedule                in     varchar2 default null
326   ,p_suffix                       in     varchar2 default null
327   ,p_date_of_death                in     date     default null
328   ,p_benefit_group_id             in     number   default null
329   ,p_receipt_of_death_cert_date   in     date     default null
330   ,p_coord_ben_med_pln_no         in     varchar2 default null
331   ,p_coord_ben_no_cvg_flag        in     varchar2 default 'N'
332   ,p_uses_tobacco_flag            in     varchar2 default null
333   ,p_dpdnt_adoption_date          in     date     default null
334   ,p_dpdnt_vlntry_svce_flag       in     varchar2 default 'N'
335   ,p_original_date_of_hire        in     date     default null
336   ,p_place_of_birth               in      varchar2 default null
337   ,p_region_of_birth              in      varchar2 default null
338   ,p_country_of_birth             in      varchar2 default null
339   ,p_global_person_id             in      varchar2 default null
340   ,p_party_id                     in      number default null
341   ,p_person_id                       out nocopy number
342   ,p_assignment_id                   out nocopy number
343   ,p_application_id                  out nocopy number
344   ,p_per_object_version_number       out nocopy number
345   ,p_asg_object_version_number       out nocopy number
346   ,p_apl_object_version_number       out nocopy number
347   ,p_per_effective_start_date        out nocopy date
348   ,p_per_effective_end_date          out nocopy date
349   ,p_full_name                       out nocopy varchar2
353   ,p_orig_hire_warning               out nocopy boolean
350   ,p_per_comment_id                  out nocopy number
351   ,p_assignment_sequence             out nocopy number
352   ,p_name_combination_warning        out nocopy boolean
354   );
355 END hr_hu_applicant_api;