4 * This package contains performance management plan APIs.
1 Package HR_PERF_MGMT_PLAN_API AUTHID CURRENT_USER as
2 /* $Header: pepmpapi.pkh 120.4 2010/01/27 15:18:38 rsykam ship $ */
3 /*#
5 * @rep:scope public
6 * @rep:product per
7 * @rep:displayname Performance Management Plan
8 */
9 --
10 -- ----------------------------------------------------------------------------
11 -- |-------------------------< create_perf_mgmt_plan >------------------------|
12 -- ----------------------------------------------------------------------------
13 --
14 -- {Start Of Comments}
15 /*#
16 * This API creates a performance management plan.
17 *
18 * The plan remains a draft until it is explicitly published.
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 plan administrator must already exist.
25 * The previous plan must already exist.
26 *
27 * <p><b>Post Success</b><br>
28 * The performance management plan is created.
29 *
30 * <p><b>Post Failure</b><br>
31 * The performance management plan is not created and an error is raised.
32 *
33 * @param p_validate If true, then validation alone will be performed and the
34 * database will remain unchanged. If false and all validation checks pass,
35 * then the database will be modified.
36 * @param p_effective_date Reference date for validating lookup values and
37 * other datetracked entities. This date does not determine when the changes
38 * take effect.
39 * @param p_plan_name {@rep:casecolumn PER_PERF_MGMT_PLANS.PLAN_NAME}
40 * @param p_administrator_person_id {@rep:casecolumn
41 * PER_PERF_MGMT_PLANS.ADMINISTRATOR_PERSON_ID}
42 * @param p_previous_plan_id {@rep:casecolumn
43 * PER_PERF_MGMT_PLANS.PREVIOUS_PLAN_ID}
44 * @param p_start_date {@rep:casecolumn PER_PERF_MGMT_PLANS.START_DATE}
45 * @param p_end_date {@rep:casecolumn PER_PERF_MGMT_PLANS.END_DATE}
46 * @param p_hierarchy_type_code {@rep:casecolumn
47 * PER_PERF_MGMT_PLANS.HIERARCHY_TYPE_CODE}
48 * @param p_supervisor_id {@rep:casecolumn PER_PERF_MGMT_PLANS.SUPERVISOR_ID}
49 * @param p_supervisor_assignment_id {@rep:casecolumn
50 * PER_PERF_MGMT_PLANS.SUPERVISOR_ASSIGNMENT_ID}
51 * @param p_organization_structure_id {@rep:casecolumn
52 * PER_PERF_MGMT_PLANS.ORGANIZATION_STRUCTURE_ID}
53 * @param p_org_structure_version_id {@rep:casecolumn
54 * PER_PERF_MGMT_PLANS.ORG_STRUCTURE_VERSION_ID}
55 * @param p_top_organization_id {@rep:casecolumn
56 * PER_PERF_MGMT_PLANS.TOP_ORGANIZATION_ID}
57 * @param p_position_structure_id {@rep:casecolumn
58 * PER_PERF_MGMT_PLANS.POSITION_STRUCTURE_ID}
59 * @param p_pos_structure_version_id {@rep:casecolumn
60 * PER_PERF_MGMT_PLANS.POS_STRUCTURE_VERSION_ID}
61 * @param p_top_position_id {@rep:casecolumn
62 * PER_PERF_MGMT_PLANS.TOP_POSITION_ID}
63 * @param p_hierarchy_levels {@rep:casecolumn
64 * PER_PERF_MGMT_PLANS.HIERARCHY_LEVELS}
65 * @param p_automatic_enrollment_flag {@rep:casecolumn
66 * PER_PERF_MGMT_PLANS.AUTOMATIC_ENROLLMENT_FLAG}
67 * @param p_assignment_types_code {@rep:casecolumn
68 * PER_PERF_MGMT_PLANS.ASSIGNMENT_TYPES_CODE}
69 * @param p_primary_asg_only_flag {@rep:casecolumn
70 * PER_PERF_MGMT_PLANS.PRIMARY_ASG_ONLY_FLAG}
71 * @param p_include_obj_setting_flag {@rep:casecolumn
72 * PER_PERF_MGMT_PLANS.INCLUDE_OBJ_SETTING_FLAG}
73 * @param p_obj_setting_start_date {@rep:casecolumn
74 * PER_PERF_MGMT_PLANS.OBJ_SETTING_START_DATE}
75 * @param p_obj_setting_deadline {@rep:casecolumn
76 * PER_PERF_MGMT_PLANS.OBJ_SETTING_DEADLINE}
77 * @param p_obj_set_outside_period_flag {@rep:casecolumn
78 * PER_PERF_MGMT_PLANS.SET_OUTSIDE_PERIOD_FLAG}
79 * @param p_method_code {@rep:casecolumn PER_PERF_MGMT_PLANS.METHOD_CODE}
80 * @param p_notify_population_flag {@rep:casecolumn
81 * PER_PERF_MGMT_PLANS.NOTIFY_POPULATION_FLAG}
82 * @param p_automatic_allocation_flag {@rep:casecolumn
83 * PER_PERF_MGMT_PLANS.AUTOMATIC_ALLOCATION_FLAG}
84 * @param p_copy_past_objectives_flag {@rep:casecolumn
85 * PER_PERF_MGMT_PLANS.COPY_PAST_OBJECTIVES_FLAG}
86 * @param p_sharing_alignment_task_flag {@rep:casecolumn
87 * PER_PERF_MGMT_PLANS.SHARING_ALIGNMENT_TASK_FLAG}
88 * @param p_include_appraisals_flag {@rep:casecolumn
89 * PER_PERF_MGMT_PLANS.INCLUDE_APPRAISALS_FLAG}
90 * @param p_change_sc_status_flag {@rep:casecolumn
91 * PER_PERF_MGMT_PLANS.CHANGE_SC_STATUS_FLAG}
95 * @param p_attribute2 Descriptive flexfield segment.
92 * @param p_attribute_category This context value determines which flexfield
93 * structure to use with the descriptive flexfield segments.
94 * @param p_attribute1 Descriptive flexfield segment.
96 * @param p_attribute3 Descriptive flexfield segment.
97 * @param p_attribute4 Descriptive flexfield segment.
98 * @param p_attribute5 Descriptive flexfield segment.
99 * @param p_attribute6 Descriptive flexfield segment.
100 * @param p_attribute7 Descriptive flexfield segment.
101 * @param p_attribute8 Descriptive flexfield segment.
102 * @param p_attribute9 Descriptive flexfield segment.
103 * @param p_attribute10 Descriptive flexfield segment.
104 * @param p_attribute11 Descriptive flexfield segment.
105 * @param p_attribute12 Descriptive flexfield segment.
106 * @param p_attribute13 Descriptive flexfield segment.
107 * @param p_attribute14 Descriptive flexfield segment.
108 * @param p_attribute15 Descriptive flexfield segment.
109 * @param p_attribute16 Descriptive flexfield segment.
110 * @param p_attribute17 Descriptive flexfield segment.
111 * @param p_attribute18 Descriptive flexfield segment.
112 * @param p_attribute19 Descriptive flexfield segment.
113 * @param p_attribute20 Descriptive flexfield segment.
114 * @param p_attribute21 Descriptive flexfield segment.
115 * @param p_attribute22 Descriptive flexfield segment.
116 * @param p_attribute23 Descriptive flexfield segment.
117 * @param p_attribute24 Descriptive flexfield segment.
118 * @param p_attribute25 Descriptive flexfield segment.
119 * @param p_attribute26 Descriptive flexfield segment.
120 * @param p_attribute27 Descriptive flexfield segment.
121 * @param p_attribute28 Descriptive flexfield segment.
122 * @param p_attribute29 Descriptive flexfield segment.
123 * @param p_attribute30 Descriptive flexfield segment.
124 * @param p_plan_id If p_validate is false, then this uniquely identifies the
125 * performance management plan created. If p_validate is true, then set to null.
126 * @param p_object_version_number If p_validate is false, then set to the
127 * version number of the created performance management plan. If p_validate is
128 * true, then the value will be null.
129 * @param p_status_code The status of the performance management plan, always
130 * 'DRAFT' when creating a plan.
131 * @param p_duplicate_name_warning Set to true if another performance management
132 * plan has the same name and overlapping dates.
133 * @param p_no_life_events_warning Set to true when there are no WPM life events
134 * enabled for the business groups to which the population belong.
135 * @rep:displayname Create Performance Management Plan
136 * @rep:category BUSINESS_ENTITY PER_PERF_MGMT_PLAN
137 * @rep:lifecycle active
138 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
139 * @rep:scope public
140 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
141 */
142 --
143 -- {End Of Comments}
144 --
145 --
146 procedure create_perf_mgmt_plan
147 (p_validate in boolean default false
148 ,p_effective_date in date
149 ,p_plan_name in varchar2
150 ,p_administrator_person_id in number
151 ,p_previous_plan_id in number default null
152 ,p_start_date in date
153 ,p_end_date in date
154 ,p_hierarchy_type_code in varchar2 default null
155 ,p_supervisor_id in number default null
156 ,p_supervisor_assignment_id in number default null
157 ,p_organization_structure_id in number default null
158 ,p_org_structure_version_id in number default null
159 ,p_top_organization_id in number default null
160 ,p_position_structure_id in number default null
161 ,p_pos_structure_version_id in number default null
162 ,p_top_position_id in number default null
163 ,p_hierarchy_levels in number default null
164 ,p_automatic_enrollment_flag in varchar2 default 'N'
165 ,p_assignment_types_code in varchar2 default 'E'
166 ,p_primary_asg_only_flag in varchar2 default 'Y'
167 ,p_include_obj_setting_flag in varchar2 default 'Y'
168 ,p_obj_setting_start_date in date default null
169 ,p_obj_setting_deadline in date default null
170 ,p_obj_set_outside_period_flag in varchar2 default 'N'
171 ,p_method_code in varchar2 default 'CAS'
172 ,p_notify_population_flag in varchar2 default 'Y'
173 ,p_automatic_allocation_flag in varchar2 default 'N'
174 ,p_copy_past_objectives_flag in varchar2 default 'N'
175 ,p_sharing_alignment_task_flag in varchar2 default 'Y'
176 ,p_include_appraisals_flag in varchar2 default 'Y'
177 ,p_change_sc_status_flag in varchar2 default 'N'
178 ,p_attribute_category in varchar2 default null
179 ,p_attribute1 in varchar2 default null
180 ,p_attribute2 in varchar2 default null
181 ,p_attribute3 in varchar2 default null
182 ,p_attribute4 in varchar2 default null
183 ,p_attribute5 in varchar2 default null
184 ,p_attribute6 in varchar2 default null
185 ,p_attribute7 in varchar2 default null
186 ,p_attribute8 in varchar2 default null
187 ,p_attribute9 in varchar2 default null
188 ,p_attribute10 in varchar2 default null
189 ,p_attribute11 in varchar2 default null
190 ,p_attribute12 in varchar2 default null
191 ,p_attribute13 in varchar2 default null
192 ,p_attribute14 in varchar2 default null
193 ,p_attribute15 in varchar2 default null
197 ,p_attribute19 in varchar2 default null
194 ,p_attribute16 in varchar2 default null
195 ,p_attribute17 in varchar2 default null
196 ,p_attribute18 in varchar2 default null
198 ,p_attribute20 in varchar2 default null
199 ,p_attribute21 in varchar2 default null
200 ,p_attribute22 in varchar2 default null
201 ,p_attribute23 in varchar2 default null
202 ,p_attribute24 in varchar2 default null
203 ,p_attribute25 in varchar2 default null
204 ,p_attribute26 in varchar2 default null
205 ,p_attribute27 in varchar2 default null
206 ,p_attribute28 in varchar2 default null
207 ,p_attribute29 in varchar2 default null
208 ,p_attribute30 in varchar2 default null
209 ,p_plan_id out nocopy number
210 ,p_object_version_number out nocopy number
211 ,p_status_code out nocopy varchar2
212 ,p_duplicate_name_warning out nocopy boolean
213 ,p_no_life_events_warning out nocopy boolean
214 ,p_update_library_objectives in varchar2 default null -- 8740021 bug fix
215 ,p_automatic_approval_flag in varchar2 default null
216 );
217 --
218 -- ----------------------------------------------------------------------------
219 -- |-------------------------< update_perf_mgmt_plan >------------------------|
220 -- ----------------------------------------------------------------------------
221 --
222 -- {Start Of Comments}
223 /*#
224 * This API updates a performance management plan.
225 *
226 * If the plan is currently published, using this API will update the plan's
227 * status to updated. If the plan's status is currently draft or updated, this
228 * API will not change its status. Using the Publish API to publish a draft
229 * or updated plan.
230 *
231 * <p><b>Licensing</b><br>
232 * This API is licensed for use with Human Resources.
233 *
234 * <p><b>Prerequisites</b><br>
235 * The performance management plan must exist.
236 *
237 * <p><b>Post Success</b><br>
238 * The performance management plan will have been updated.
239 *
240 * <p><b>Post Failure</b><br>
241 * The performance management plan will not have been updated and an error
242 * will be raised.
243 *
244 * @param p_validate If true, then validation alone will be performed and the
245 * database will remain unchanged. If false and all validation checks pass,
246 * then the database will be modified.
247 * @param p_effective_date Reference date for validating lookup values and
248 * other datetracked entities. This date does not determine when the changes
249 * take effect.
250 * @param p_plan_id Identifies the performance management plan to be modified.
251 * @param p_object_version_number Pass in the current version number of
252 * the performance management plan to be updated. When the API completes if
253 * p_validate is false, will be set to the new version number of the updated
254 * personal scorecard. If p_validate is true will be set to the same value which
255 * was passed in.
256 * @param p_plan_name {@rep:casecolumn PER_PERF_MGMT_PLANS.PLAN_NAME}
257 * @param p_administrator_person_id {@rep:casecolumn
258 * PER_PERF_MGMT_PLANS.ADMINISTRATOR_PERSON_ID}
259 * @param p_previous_plan_id {@rep:casecolumn
260 * PER_PERF_MGMT_PLANS.PREVIOUS_PLAN_ID}
261 * @param p_start_date {@rep:casecolumn PER_PERF_MGMT_PLANS.START_DATE}
262 * @param p_end_date {@rep:casecolumn PER_PERF_MGMT_PLANS.END_DATE}
263 * @param p_hierarchy_type_code {@rep:casecolumn
264 * PER_PERF_MGMT_PLANS.HIERARCHY_TYPE_CODE}
265 * @param p_supervisor_id {@rep:casecolumn PER_PERF_MGMT_PLANS.SUPERVISOR_ID}
266 * @param p_supervisor_assignment_id {@rep:casecolumn
267 * PER_PERF_MGMT_PLANS.SUPERVISOR_ASSIGNMENT_ID}
268 * @param p_organization_structure_id {@rep:casecolumn
269 * PER_PERF_MGMT_PLANS.ORGANIZATION_STRUCTURE_ID}
270 * @param p_org_structure_version_id {@rep:casecolumn
271 * PER_PERF_MGMT_PLANS.ORG_STRUCTURE_VERSION_ID}
272 * @param p_top_organization_id {@rep:casecolumn
273 * PER_PERF_MGMT_PLANS.TOP_ORGANIZATION_ID}
274 * @param p_position_structure_id {@rep:casecolumn
275 * PER_PERF_MGMT_PLANS.POSITION_STRUCTURE_ID}
276 * @param p_pos_structure_version_id {@rep:casecolumn
277 * PER_PERF_MGMT_PLANS.POS_STRUCTURE_VERSION_ID}
278 * @param p_top_position_id {@rep:casecolumn
279 * PER_PERF_MGMT_PLANS.TOP_POSITION_ID}
280 * @param p_hierarchy_levels {@rep:casecolumn
281 * PER_PERF_MGMT_PLANS.HIERARCHY_LEVELS}
282 * @param p_automatic_enrollment_flag {@rep:casecolumn
283 * PER_PERF_MGMT_PLANS.AUTOMATIC_ENROLLMENT_FLAG}
284 * @param p_assignment_types_code {@rep:casecolumn
285 * PER_PERF_MGMT_PLANS.ASSIGNMENT_TYPES_CODE}
286 * @param p_primary_asg_only_flag {@rep:casecolumn
287 * PER_PERF_MGMT_PLANS.PRIMARY_ASG_ONLY_FLAG}
288 * @param p_include_obj_setting_flag {@rep:casecolumn
289 * PER_PERF_MGMT_PLANS.INCLUDE_OBJ_SETTING_FLAG}
290 * @param p_obj_setting_start_date {@rep:casecolumn
291 * PER_PERF_MGMT_PLANS.OBJ_SETTING_START_DATE}
292 * @param p_obj_setting_deadline {@rep:casecolumn
293 * PER_PERF_MGMT_PLANS.OBJ_SETTING_DEADLINE}
294 * @param p_obj_set_outside_period_flag {@rep:casecolumn
295 * PER_PERF_MGMT_PLANS.SET_OUTSIDE_PERIOD_FLAG}
296 * @param p_method_code {@rep:casecolumn PER_PERF_MGMT_PLANS.METHOD_CODE}
297 * @param p_notify_population_flag {@rep:casecolumn
298 * PER_PERF_MGMT_PLANS.NOTIFY_POPULATION_FLAG}
299 * @param p_automatic_allocation_flag {@rep:casecolumn
300 * PER_PERF_MGMT_PLANS.AUTOMATIC_ALLOCATION_FLAG}
301 * @param p_copy_past_objectives_flag {@rep:casecolumn
305 * @param p_include_appraisals_flag {@rep:casecolumn
302 * PER_PERF_MGMT_PLANS.COPY_PAST_OBJECTIVES_FLAG}
303 * @param p_sharing_alignment_task_flag {@rep:casecolumn
304 * PER_PERF_MGMT_PLANS.SHARING_ALIGNMENT_TASK_FLAG}
306 * PER_PERF_MGMT_PLANS.INCLUDE_APPRAISALS_FLAG}
307 * @param p_change_sc_status_flag {@rep:casecolumn
308 * PER_PERF_MGMT_PLANS.CHANGE_SC_STATUS_FLAG}
309 * @param p_attribute_category This context value determines which flexfield
310 * structure to use with the descriptive flexfield segments.
311 * @param p_attribute1 Descriptive flexfield segment.
312 * @param p_attribute2 Descriptive flexfield segment.
313 * @param p_attribute3 Descriptive flexfield segment.
314 * @param p_attribute4 Descriptive flexfield segment.
315 * @param p_attribute5 Descriptive flexfield segment.
316 * @param p_attribute6 Descriptive flexfield segment.
317 * @param p_attribute7 Descriptive flexfield segment.
318 * @param p_attribute8 Descriptive flexfield segment.
319 * @param p_attribute9 Descriptive flexfield segment.
320 * @param p_attribute10 Descriptive flexfield segment.
321 * @param p_attribute11 Descriptive flexfield segment.
322 * @param p_attribute12 Descriptive flexfield segment.
323 * @param p_attribute13 Descriptive flexfield segment.
324 * @param p_attribute14 Descriptive flexfield segment.
325 * @param p_attribute15 Descriptive flexfield segment.
326 * @param p_attribute16 Descriptive flexfield segment.
327 * @param p_attribute17 Descriptive flexfield segment.
328 * @param p_attribute18 Descriptive flexfield segment.
329 * @param p_attribute19 Descriptive flexfield segment.
330 * @param p_attribute20 Descriptive flexfield segment.
331 * @param p_attribute21 Descriptive flexfield segment.
332 * @param p_attribute22 Descriptive flexfield segment.
333 * @param p_attribute23 Descriptive flexfield segment.
334 * @param p_attribute24 Descriptive flexfield segment.
335 * @param p_attribute25 Descriptive flexfield segment.
336 * @param p_attribute26 Descriptive flexfield segment.
337 * @param p_attribute27 Descriptive flexfield segment.
338 * @param p_attribute28 Descriptive flexfield segment.
339 * @param p_attribute29 Descriptive flexfield segment.
340 * @param p_attribute30 Descriptive flexfield segment.
341 * @param p_status_code The status of the performance management plan.
342 * @param p_duplicate_name_warning Set to true if another performance management
343 * plan has the same name and overlapping dates.
344 * @param p_no_life_events_warning Set to true when there are no WPM life events
345 * enabled for the business groups to which the population belong.
346 * @rep:displayname Update Performance Management Plan
347 * @rep:category BUSINESS_ENTITY PER_PERF_MGMT_PLAN
348 * @rep:lifecycle active
349 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
350 * @rep:scope public
351 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
352 */
353 --
354 -- {End Of Comments}
355 --
356 --
357 procedure update_perf_mgmt_plan
358 (p_validate in boolean default false
359 ,p_effective_date in date
360 ,p_plan_id in number
361 ,p_plan_name in varchar2 default hr_api.g_varchar2
362 ,p_administrator_person_id in number default hr_api.g_number
363 ,p_previous_plan_id in number default hr_api.g_number
364 ,p_start_date in date default hr_api.g_date
365 ,p_end_date in date default hr_api.g_date
366 ,p_hierarchy_type_code in varchar2 default hr_api.g_varchar2
367 ,p_supervisor_id in number default hr_api.g_number
368 ,p_supervisor_assignment_id in number default hr_api.g_number
369 ,p_organization_structure_id in number default hr_api.g_number
370 ,p_org_structure_version_id in number default hr_api.g_number
371 ,p_top_organization_id in number default hr_api.g_number
372 ,p_position_structure_id in number default hr_api.g_number
373 ,p_pos_structure_version_id in number default hr_api.g_number
374 ,p_top_position_id in number default hr_api.g_number
375 ,p_hierarchy_levels in number default hr_api.g_number
376 ,p_automatic_enrollment_flag in varchar2 default hr_api.g_varchar2
377 ,p_assignment_types_code in varchar2 default hr_api.g_varchar2
378 ,p_primary_asg_only_flag in varchar2 default hr_api.g_varchar2
379 ,p_include_obj_setting_flag in varchar2 default hr_api.g_varchar2
380 ,p_obj_setting_start_date in date default hr_api.g_date
381 ,p_obj_setting_deadline in date default hr_api.g_date
382 ,p_obj_set_outside_period_flag in varchar2 default hr_api.g_varchar2
383 ,p_method_code in varchar2 default hr_api.g_varchar2
384 ,p_notify_population_flag in varchar2 default hr_api.g_varchar2
385 ,p_automatic_allocation_flag in varchar2 default hr_api.g_varchar2
386 ,p_copy_past_objectives_flag in varchar2 default hr_api.g_varchar2
387 ,p_sharing_alignment_task_flag in varchar2 default hr_api.g_varchar2
388 ,p_include_appraisals_flag in varchar2 default hr_api.g_varchar2
389 ,p_change_sc_status_flag in varchar2 default hr_api.g_varchar2
390 ,p_attribute_category in varchar2 default hr_api.g_varchar2
391 ,p_attribute1 in varchar2 default hr_api.g_varchar2
392 ,p_attribute2 in varchar2 default hr_api.g_varchar2
393 ,p_attribute3 in varchar2 default hr_api.g_varchar2
394 ,p_attribute4 in varchar2 default hr_api.g_varchar2
395 ,p_attribute5 in varchar2 default hr_api.g_varchar2
396 ,p_attribute6 in varchar2 default hr_api.g_varchar2
400 ,p_attribute10 in varchar2 default hr_api.g_varchar2
397 ,p_attribute7 in varchar2 default hr_api.g_varchar2
398 ,p_attribute8 in varchar2 default hr_api.g_varchar2
399 ,p_attribute9 in varchar2 default hr_api.g_varchar2
401 ,p_attribute11 in varchar2 default hr_api.g_varchar2
402 ,p_attribute12 in varchar2 default hr_api.g_varchar2
403 ,p_attribute13 in varchar2 default hr_api.g_varchar2
404 ,p_attribute14 in varchar2 default hr_api.g_varchar2
405 ,p_attribute15 in varchar2 default hr_api.g_varchar2
406 ,p_attribute16 in varchar2 default hr_api.g_varchar2
407 ,p_attribute17 in varchar2 default hr_api.g_varchar2
408 ,p_attribute18 in varchar2 default hr_api.g_varchar2
409 ,p_attribute19 in varchar2 default hr_api.g_varchar2
410 ,p_attribute20 in varchar2 default hr_api.g_varchar2
411 ,p_attribute21 in varchar2 default hr_api.g_varchar2
412 ,p_attribute22 in varchar2 default hr_api.g_varchar2
413 ,p_attribute23 in varchar2 default hr_api.g_varchar2
414 ,p_attribute24 in varchar2 default hr_api.g_varchar2
415 ,p_attribute25 in varchar2 default hr_api.g_varchar2
416 ,p_attribute26 in varchar2 default hr_api.g_varchar2
417 ,p_attribute27 in varchar2 default hr_api.g_varchar2
418 ,p_attribute28 in varchar2 default hr_api.g_varchar2
419 ,p_attribute29 in varchar2 default hr_api.g_varchar2
420 ,p_attribute30 in varchar2 default hr_api.g_varchar2
421 ,p_object_version_number in out nocopy number
422 ,p_status_code out nocopy varchar2
423 ,p_duplicate_name_warning out nocopy boolean
424 ,p_no_life_events_warning out nocopy boolean
425 ,p_update_library_objectives in varchar2 default hr_api.g_varchar2 -- 8740021 bug fix
426 ,p_automatic_approval_flag in varchar2 default hr_api.g_varchar2
427 );
428 --
429 -- ----------------------------------------------------------------------------
430 -- |------------------------< delete_perf_mgmt_plan >-------------------------|
431 -- ----------------------------------------------------------------------------
432 --
433 -- {Start Of Comments}
434 /*#
435 * This API deletes a performance management plan.
436 *
437 * Plans that are published cannot be deleted.
438 *
439 * <p><b>Licensing</b><br>
440 * This API is licensed for use with Human Resources.
441 *
442 * <p><b>Prerequisites</b><br>
443 * The performance management plan must exist.
444 *
445 * <p><b>Post Success</b><br>
446 * The performance management plan will have been deleted.
447 *
448 * <p><b>Post Failure</b><br>
449 * The performance management plan will not be deleted and an error will be
450 * raised.
451 *
452 * @param p_validate If true, then validation alone will be performed and the
453 * database will remain unchanged. If false and all validation checks pass,
454 * then the database will be modified.
455 * @param p_plan_id Identifies the performance management plan to be deleted.
456 * @param p_object_version_number Current version number of the performance
457 * management plan to be deleted.
458 * @rep:displayname Delete Performance Management Plan
459 * @rep:category BUSINESS_ENTITY PER_PERF_MGMT_PLAN
460 * @rep:lifecycle active
461 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
462 * @rep:scope public
463 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
464 */
465 --
466 -- {End Of Comments}
467 --
468 --
469 procedure delete_perf_mgmt_plan
470 (p_validate in boolean default false
471 ,p_plan_id in number
472 ,p_object_version_number in number
473 );
474 --
475 -- ----------------------------------------------------------------------------
476 -- |--------------------------------< publish_plan >--------------------------|
477 -- ----------------------------------------------------------------------------
478 --
479 -- {Start Of Comments}
480 /*#
481 * This API publishes a performance management plan.
482 *
483 * Publishing a plan: creates or updates personal scorecards for the
484 * population; can automatically allocate objectives from the objectives
485 * library to eligible members of the plan population; notifies individuals
486 * who should start the objective-setting process.
487 *
488 * Note: this process performs many actions so the publish plan concurrent
489 * program can be used as an alternative to this API.
490 *
491 * Warning: this process can be difficult to reverse.
492 *
493 * <p><b>Licensing</b><br>
494 * This API is licensed for use with Human Resources.
495 *
496 * <p><b>Prerequisites</b><br>
497 * The performance management plan must exist, and must have a draft or
498 * updated status.
499 *
500 * <p><b>Post Success</b><br>
501 * The performance management plan will have been published.
502 *
503 * <p><b>Post Failure</b><br>
504 * The performance management plan will not be deleted and an error will be
505 * raised.
506 *
507 * @param p_validate If true, then validation alone will be performed and the
508 * database will remain unchanged. If false and all validation checks pass,
509 * then the database will be modified.
510 * @param p_effective_date This is used for: a) validating lookup values,
511 * b) determining the plan population and objective eligibility, and c)
512 * end-dating personal scorecards and objectives for members that are no
513 * longer part of the population. The lsat item only applies to publishing
514 * an updated plan.
515 * @param p_plan_id Identifies the performance management plan to be published.
516 * @param p_object_version_number Current version number of the performance
517 * management plan to be published.
518 * @rep:displayname Publish Performance Management Plan
519 * @rep:category BUSINESS_ENTITY PER_PERF_MGMT_PLAN
520 * @rep:lifecycle active
521 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
522 * @rep:scope public
523 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
524 */
525 --
526 -- {End Of Comments}
527 --
528 --
529 procedure publish_plan
530 (p_validate in boolean default false
531 ,p_effective_date in date
532 ,p_plan_id in number
533 ,p_object_version_number in out nocopy number
534 );
535 --
536 -- ----------------------------------------------------------------------------
537 -- |----------------------------< reverse_publish_plan >----------------------|
538 -- ----------------------------------------------------------------------------
539 --
540 -- {Start Of Comments}
541 /*#
542 * This API reverses the publication of a performance management plan.
543 *
544 * Warning: this API attempts to delete all personal scorecards, appraisals
545 * and objectives associated with the performance management plan. It does
546 * not end-date these objects it deletes them from the database. This
547 * should only be used when a plan has been published by error. When an
548 * objective has been given performance ratings, the objective cannot be
549 * deleted, which means that this API will fail.
550 *
551 * <p><b>Licensing</b><br>
552 * This API is licensed for use with Human Resources.
553 *
554 * <p><b>Prerequisites</b><br>
555 * The performance management plan must exist, and must have a published
556 * status.
557 *
558 * <p><b>Post Success</b><br>
559 * The publication of the performance management plan will have been reversed.
560 *
561 * <p><b>Post Failure</b><br>
562 * The publication of the performance management plan will not be reversed and
563 * an error will be raised.
564 *
565 * @param p_validate If true, then validation alone will be performed and the
566 * database will remain unchanged. If false and all validation checks pass,
567 * then the database will be modified.
568 * @param p_plan_id Identifies the performance management plan where
569 * publication should be reversed.
570 * @param p_object_version_number Current version number of the performance
571 * management plan to be reverse published.
572 * @rep:displayname Reverse Publish Performance Management Plan
573 * @rep:category BUSINESS_ENTITY PER_PERF_MGMT_PLAN
574 * @rep:lifecycle active
575 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
576 * @rep:scope public
577 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
578 */
579 --
580 -- {End Of Comments}
581 --
582 --
583 procedure reverse_publish_plan
584 (p_validate in boolean default false
585 ,p_plan_id in number
586 ,p_object_version_number in out nocopy number
587 );
588 --
589 end HR_PERF_MGMT_PLAN_API;