1 Package hr_change_start_date_api as
2 /* $Header: pehirapi.pkh 120.1.12010000.1 2008/07/28 04:48:12 appldev ship $ */
3 /*#
4 * This package contains the API for changing the start date of an employee or
5 * a contingent worker.
6 * @rep:scope public
7 * @rep:product per
8 * @rep:displayname Change Start Date
9 */
10 --
11 -- ----------------------------------------------------------------------------
12 -- |----------------------------< update_start_date >-------------------------|
13 -- ----------------------------------------------------------------------------
14 --
15 -- {Start Of Comments}
16 /*#
17 * This API changes the start date of the employee or contingent worker.
18 *
19 *
20 * <p><b>Licensing</b><br>
21 * This API is licensed for use with Human Resources.
22 *
23 * <p><b>Prerequisites</b><br>
24 * The person must exist as of the old start date supplied, and must be an
25 * employee or a contingent worker.
26 *
27 * <p><b>Post Success</b><br>
28 * The start date of the employee or contingent worker person record, the
29 * period of service or placement, the assignments that coincide with the start
30 * date, and the child records are changed to start as of the new start date.
31 *
32 * <p><b>Post Failure</b><br>
33 * An error is raised and the start date is not changed.
34 * @param p_validate If true, then validation alone will be performed and the
35 * database will remain unchanged. If false and all validation checks pass,
36 * then the database will be modified.
37 * @param p_person_id Identifies the person record for which the change of
38 * start date is to be processed.
39 * @param p_old_start_date The hire date or start of placement
40 * @param p_new_start_date The start date that you want to change to.
41 * @param p_update_type Specifies whether this update refers to an employee or
42 * a contingent worker. Valid values are the same as those used for assignment
43 * type. 'E' for employees, 'C' for contingent workers.
44 * @param p_applicant_number Applicant number, if specified will cause appl
45 * records to be moved also.
46 * @param p_warn_ee For employees, set to 'Y' if recurring element entries were
47 * changed.
48 * @rep:displayname Update Start Date
49 * @rep:category BUSINESS_ENTITY PER_EMPLOYEE
50 * @rep:category BUSINESS_ENTITY PER_CWK
51 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
52 * @rep:scope public
53 * @rep:lifecycle active
54 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
55 */
56 --
57 -- {End Of Comments}
58 --
59 procedure update_start_date
60 (p_validate in boolean default false
61 ,p_person_id in number
62 ,p_old_start_date in date
63 ,p_new_start_date in date
64 ,p_update_type in varchar2
65 ,p_applicant_number in varchar2 default null
66 ,p_warn_ee out nocopy varchar2
67 );
68 --
69 end hr_change_start_date_api;