1 Package HR_PERF_MGMT_PLAN_API as
2 /* $Header: pepmpapi.pkh 120.2 2006/08/11 06:28:49 tpapired noship $ */
3 /*#
4 * This package contains performance management plan APIs.
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}
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.
95 * @param p_attribute2 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
194 ,p_attribute16 in varchar2 default null
195 ,p_attribute17 in varchar2 default null
196 ,p_attribute18 in varchar2 default null
197 ,p_attribute19 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 );
215 --
216 -- ----------------------------------------------------------------------------
217 -- |-------------------------< update_perf_mgmt_plan >------------------------|
218 -- ----------------------------------------------------------------------------
219 --
220 -- {Start Of Comments}
221 /*#
222 * This API updates a performance management plan.
223 *
224 * If the plan is currently published, using this API will update the plan's
225 * status to updated. If the plan's status is currently draft or updated, this
226 * API will not change its status. Using the Publish API to publish a draft
227 * or updated plan.
228 *
229 * <p><b>Licensing</b><br>
230 * This API is licensed for use with Human Resources.
231 *
232 * <p><b>Prerequisites</b><br>
233 * The performance management plan must exist.
234 *
235 * <p><b>Post Success</b><br>
236 * The performance management plan will have been updated.
237 *
238 * <p><b>Post Failure</b><br>
239 * The performance management plan will not have been updated and an error
240 * will be raised.
241 *
242 * @param p_validate If true, then validation alone will be performed and the
243 * database will remain unchanged. If false and all validation checks pass,
244 * then the database will be modified.
245 * @param p_effective_date Reference date for validating lookup values and
246 * other datetracked entities. This date does not determine when the changes
247 * take effect.
248 * @param p_plan_id Identifies the performance management plan to be modified.
249 * @param p_object_version_number Pass in the current version number of
250 * the performance management plan to be updated. When the API completes if
251 * p_validate is false, will be set to the new version number of the updated
252 * personal scorecard. If p_validate is true will be set to the same value which
253 * was passed in.
254 * @param p_plan_name {@rep:casecolumn PER_PERF_MGMT_PLANS.PLAN_NAME}
255 * @param p_administrator_person_id {@rep:casecolumn
256 * PER_PERF_MGMT_PLANS.ADMINISTRATOR_PERSON_ID}
257 * @param p_previous_plan_id {@rep:casecolumn
258 * PER_PERF_MGMT_PLANS.PREVIOUS_PLAN_ID}
259 * @param p_start_date {@rep:casecolumn PER_PERF_MGMT_PLANS.START_DATE}
260 * @param p_end_date {@rep:casecolumn PER_PERF_MGMT_PLANS.END_DATE}
261 * @param p_hierarchy_type_code {@rep:casecolumn
262 * PER_PERF_MGMT_PLANS.HIERARCHY_TYPE_CODE}
263 * @param p_supervisor_id {@rep:casecolumn PER_PERF_MGMT_PLANS.SUPERVISOR_ID}
264 * @param p_supervisor_assignment_id {@rep:casecolumn
265 * PER_PERF_MGMT_PLANS.SUPERVISOR_ASSIGNMENT_ID}
266 * @param p_organization_structure_id {@rep:casecolumn
267 * PER_PERF_MGMT_PLANS.ORGANIZATION_STRUCTURE_ID}
268 * @param p_org_structure_version_id {@rep:casecolumn
269 * PER_PERF_MGMT_PLANS.ORG_STRUCTURE_VERSION_ID}
270 * @param p_top_organization_id {@rep:casecolumn
271 * PER_PERF_MGMT_PLANS.TOP_ORGANIZATION_ID}
272 * @param p_position_structure_id {@rep:casecolumn
273 * PER_PERF_MGMT_PLANS.POSITION_STRUCTURE_ID}
274 * @param p_pos_structure_version_id {@rep:casecolumn
275 * PER_PERF_MGMT_PLANS.POS_STRUCTURE_VERSION_ID}
276 * @param p_top_position_id {@rep:casecolumn
277 * PER_PERF_MGMT_PLANS.TOP_POSITION_ID}
278 * @param p_hierarchy_levels {@rep:casecolumn
279 * PER_PERF_MGMT_PLANS.HIERARCHY_LEVELS}
280 * @param p_automatic_enrollment_flag {@rep:casecolumn
281 * PER_PERF_MGMT_PLANS.AUTOMATIC_ENROLLMENT_FLAG}
282 * @param p_assignment_types_code {@rep:casecolumn
283 * PER_PERF_MGMT_PLANS.ASSIGNMENT_TYPES_CODE}
284 * @param p_primary_asg_only_flag {@rep:casecolumn
285 * PER_PERF_MGMT_PLANS.PRIMARY_ASG_ONLY_FLAG}
286 * @param p_include_obj_setting_flag {@rep:casecolumn
287 * PER_PERF_MGMT_PLANS.INCLUDE_OBJ_SETTING_FLAG}
288 * @param p_obj_setting_start_date {@rep:casecolumn
289 * PER_PERF_MGMT_PLANS.OBJ_SETTING_START_DATE}
290 * @param p_obj_setting_deadline {@rep:casecolumn
291 * PER_PERF_MGMT_PLANS.OBJ_SETTING_DEADLINE}
292 * @param p_obj_set_outside_period_flag {@rep:casecolumn
293 * PER_PERF_MGMT_PLANS.SET_OUTSIDE_PERIOD_FLAG}
294 * @param p_method_code {@rep:casecolumn PER_PERF_MGMT_PLANS.METHOD_CODE}
295 * @param p_notify_population_flag {@rep:casecolumn
296 * PER_PERF_MGMT_PLANS.NOTIFY_POPULATION_FLAG}
297 * @param p_automatic_allocation_flag {@rep:casecolumn
298 * PER_PERF_MGMT_PLANS.AUTOMATIC_ALLOCATION_FLAG}
299 * @param p_copy_past_objectives_flag {@rep:casecolumn
300 * PER_PERF_MGMT_PLANS.COPY_PAST_OBJECTIVES_FLAG}
301 * @param p_sharing_alignment_task_flag {@rep:casecolumn
302 * PER_PERF_MGMT_PLANS.SHARING_ALIGNMENT_TASK_FLAG}
303 * @param p_include_appraisals_flag {@rep:casecolumn
304 * PER_PERF_MGMT_PLANS.INCLUDE_APPRAISALS_FLAG}
305 * @param p_change_sc_status_flag {@rep:casecolumn
306 * PER_PERF_MGMT_PLANS.CHANGE_SC_STATUS_FLAG}
307 * @param p_attribute_category This context value determines which flexfield
308 * structure to use with the descriptive flexfield segments.
309 * @param p_attribute1 Descriptive flexfield segment.
310 * @param p_attribute2 Descriptive flexfield segment.
311 * @param p_attribute3 Descriptive flexfield segment.
312 * @param p_attribute4 Descriptive flexfield segment.
313 * @param p_attribute5 Descriptive flexfield segment.
314 * @param p_attribute6 Descriptive flexfield segment.
315 * @param p_attribute7 Descriptive flexfield segment.
316 * @param p_attribute8 Descriptive flexfield segment.
317 * @param p_attribute9 Descriptive flexfield segment.
318 * @param p_attribute10 Descriptive flexfield segment.
319 * @param p_attribute11 Descriptive flexfield segment.
320 * @param p_attribute12 Descriptive flexfield segment.
321 * @param p_attribute13 Descriptive flexfield segment.
322 * @param p_attribute14 Descriptive flexfield segment.
323 * @param p_attribute15 Descriptive flexfield segment.
324 * @param p_attribute16 Descriptive flexfield segment.
325 * @param p_attribute17 Descriptive flexfield segment.
326 * @param p_attribute18 Descriptive flexfield segment.
327 * @param p_attribute19 Descriptive flexfield segment.
328 * @param p_attribute20 Descriptive flexfield segment.
329 * @param p_attribute21 Descriptive flexfield segment.
330 * @param p_attribute22 Descriptive flexfield segment.
331 * @param p_attribute23 Descriptive flexfield segment.
332 * @param p_attribute24 Descriptive flexfield segment.
333 * @param p_attribute25 Descriptive flexfield segment.
334 * @param p_attribute26 Descriptive flexfield segment.
335 * @param p_attribute27 Descriptive flexfield segment.
336 * @param p_attribute28 Descriptive flexfield segment.
337 * @param p_attribute29 Descriptive flexfield segment.
338 * @param p_attribute30 Descriptive flexfield segment.
339 * @param p_status_code The status of the performance management plan.
340 * @param p_duplicate_name_warning Set to true if another performance management
341 * plan has the same name and overlapping dates.
342 * @param p_no_life_events_warning Set to true when there are no WPM life events
343 * enabled for the business groups to which the population belong.
344 * @rep:displayname Update Performance Management Plan
345 * @rep:category BUSINESS_ENTITY PER_PERF_MGMT_PLAN
346 * @rep:lifecycle active
347 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
348 * @rep:scope public
349 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
350 */
351 --
352 -- {End Of Comments}
353 --
354 --
355 procedure update_perf_mgmt_plan
356 (p_validate in boolean default false
357 ,p_effective_date in date
358 ,p_plan_id in number
359 ,p_plan_name in varchar2 default hr_api.g_varchar2
360 ,p_administrator_person_id in number default hr_api.g_number
361 ,p_previous_plan_id in number default hr_api.g_number
362 ,p_start_date in date default hr_api.g_date
363 ,p_end_date in date default hr_api.g_date
364 ,p_hierarchy_type_code in varchar2 default hr_api.g_varchar2
365 ,p_supervisor_id in number default hr_api.g_number
366 ,p_supervisor_assignment_id in number default hr_api.g_number
367 ,p_organization_structure_id in number default hr_api.g_number
368 ,p_org_structure_version_id in number default hr_api.g_number
369 ,p_top_organization_id in number default hr_api.g_number
370 ,p_position_structure_id in number default hr_api.g_number
371 ,p_pos_structure_version_id in number default hr_api.g_number
372 ,p_top_position_id in number default hr_api.g_number
373 ,p_hierarchy_levels in number default hr_api.g_number
374 ,p_automatic_enrollment_flag in varchar2 default hr_api.g_varchar2
375 ,p_assignment_types_code in varchar2 default hr_api.g_varchar2
376 ,p_primary_asg_only_flag in varchar2 default hr_api.g_varchar2
377 ,p_include_obj_setting_flag in varchar2 default hr_api.g_varchar2
378 ,p_obj_setting_start_date in date default hr_api.g_date
379 ,p_obj_setting_deadline in date default hr_api.g_date
380 ,p_obj_set_outside_period_flag in varchar2 default hr_api.g_varchar2
381 ,p_method_code in varchar2 default hr_api.g_varchar2
382 ,p_notify_population_flag in varchar2 default hr_api.g_varchar2
383 ,p_automatic_allocation_flag in varchar2 default hr_api.g_varchar2
384 ,p_copy_past_objectives_flag in varchar2 default hr_api.g_varchar2
385 ,p_sharing_alignment_task_flag in varchar2 default hr_api.g_varchar2
386 ,p_include_appraisals_flag in varchar2 default hr_api.g_varchar2
387 ,p_change_sc_status_flag in varchar2 default hr_api.g_varchar2
388 ,p_attribute_category in varchar2 default hr_api.g_varchar2
389 ,p_attribute1 in varchar2 default hr_api.g_varchar2
390 ,p_attribute2 in varchar2 default hr_api.g_varchar2
391 ,p_attribute3 in varchar2 default hr_api.g_varchar2
392 ,p_attribute4 in varchar2 default hr_api.g_varchar2
393 ,p_attribute5 in varchar2 default hr_api.g_varchar2
394 ,p_attribute6 in varchar2 default hr_api.g_varchar2
395 ,p_attribute7 in varchar2 default hr_api.g_varchar2
396 ,p_attribute8 in varchar2 default hr_api.g_varchar2
397 ,p_attribute9 in varchar2 default hr_api.g_varchar2
398 ,p_attribute10 in varchar2 default hr_api.g_varchar2
399 ,p_attribute11 in varchar2 default hr_api.g_varchar2
400 ,p_attribute12 in varchar2 default hr_api.g_varchar2
401 ,p_attribute13 in varchar2 default hr_api.g_varchar2
402 ,p_attribute14 in varchar2 default hr_api.g_varchar2
403 ,p_attribute15 in varchar2 default hr_api.g_varchar2
404 ,p_attribute16 in varchar2 default hr_api.g_varchar2
405 ,p_attribute17 in varchar2 default hr_api.g_varchar2
406 ,p_attribute18 in varchar2 default hr_api.g_varchar2
407 ,p_attribute19 in varchar2 default hr_api.g_varchar2
408 ,p_attribute20 in varchar2 default hr_api.g_varchar2
409 ,p_attribute21 in varchar2 default hr_api.g_varchar2
410 ,p_attribute22 in varchar2 default hr_api.g_varchar2
411 ,p_attribute23 in varchar2 default hr_api.g_varchar2
412 ,p_attribute24 in varchar2 default hr_api.g_varchar2
413 ,p_attribute25 in varchar2 default hr_api.g_varchar2
414 ,p_attribute26 in varchar2 default hr_api.g_varchar2
415 ,p_attribute27 in varchar2 default hr_api.g_varchar2
416 ,p_attribute28 in varchar2 default hr_api.g_varchar2
417 ,p_attribute29 in varchar2 default hr_api.g_varchar2
418 ,p_attribute30 in varchar2 default hr_api.g_varchar2
419 ,p_object_version_number in out nocopy number
420 ,p_status_code out nocopy varchar2
421 ,p_duplicate_name_warning out nocopy boolean
422 ,p_no_life_events_warning out nocopy boolean
423 );
424 --
425 -- ----------------------------------------------------------------------------
426 -- |------------------------< delete_perf_mgmt_plan >-------------------------|
427 -- ----------------------------------------------------------------------------
428 --
429 -- {Start Of Comments}
430 /*#
431 * This API deletes a performance management plan.
432 *
433 * Plans that are published cannot be deleted.
434 *
435 * <p><b>Licensing</b><br>
436 * This API is licensed for use with Human Resources.
437 *
438 * <p><b>Prerequisites</b><br>
439 * The performance management plan must exist.
440 *
441 * <p><b>Post Success</b><br>
442 * The performance management plan will have been deleted.
443 *
444 * <p><b>Post Failure</b><br>
445 * The performance management plan will not be deleted and an error will be
446 * raised.
447 *
448 * @param p_validate If true, then validation alone will be performed and the
449 * database will remain unchanged. If false and all validation checks pass,
450 * then the database will be modified.
451 * @param p_plan_id Identifies the performance management plan to be deleted.
452 * @param p_object_version_number Current version number of the performance
453 * management plan to be deleted.
454 * @rep:displayname Delete Performance Management Plan
455 * @rep:category BUSINESS_ENTITY PER_PERF_MGMT_PLAN
456 * @rep:lifecycle active
457 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
458 * @rep:scope public
459 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
460 */
461 --
462 -- {End Of Comments}
463 --
464 --
465 procedure delete_perf_mgmt_plan
466 (p_validate in boolean default false
467 ,p_plan_id in number
468 ,p_object_version_number in number
469 );
470 --
471 -- ----------------------------------------------------------------------------
472 -- |--------------------------------< publish_plan >--------------------------|
473 -- ----------------------------------------------------------------------------
474 --
475 -- {Start Of Comments}
476 /*#
477 * This API publishes a performance management plan.
478 *
479 * Publishing a plan: creates or updates personal scorecards for the
480 * population; can automatically allocate objectives from the objectives
481 * library to eligible members of the plan population; notifies individuals
482 * who should start the objective-setting process.
483 *
484 * Note: this process performs many actions so the publish plan concurrent
485 * program can be used as an alternative to this API.
486 *
487 * Warning: this process can be difficult to reverse.
488 *
489 * <p><b>Licensing</b><br>
490 * This API is licensed for use with Human Resources.
491 *
492 * <p><b>Prerequisites</b><br>
493 * The performance management plan must exist, and must have a draft or
494 * updated status.
495 *
496 * <p><b>Post Success</b><br>
497 * The performance management plan will have been published.
498 *
499 * <p><b>Post Failure</b><br>
500 * The performance management plan will not be deleted and an error will be
501 * raised.
502 *
503 * @param p_validate If true, then validation alone will be performed and the
504 * database will remain unchanged. If false and all validation checks pass,
505 * then the database will be modified.
506 * @param p_effective_date This is used for: a) validating lookup values,
507 * b) determining the plan population and objective eligibility, and c)
508 * end-dating personal scorecards and objectives for members that are no
509 * longer part of the population. The lsat item only applies to publishing
510 * an updated plan.
511 * @param p_plan_id Identifies the performance management plan to be published.
512 * @param p_object_version_number Current version number of the performance
513 * management plan to be published.
514 * @rep:displayname Publish Performance Management Plan
515 * @rep:category BUSINESS_ENTITY PER_PERF_MGMT_PLAN
516 * @rep:lifecycle active
517 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
518 * @rep:scope public
519 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
520 */
521 --
522 -- {End Of Comments}
523 --
524 --
525 procedure publish_plan
526 (p_validate in boolean default false
527 ,p_effective_date in date
528 ,p_plan_id in number
529 ,p_object_version_number in out nocopy number
530 );
531 --
532 -- ----------------------------------------------------------------------------
533 -- |----------------------------< reverse_publish_plan >----------------------|
534 -- ----------------------------------------------------------------------------
535 --
536 -- {Start Of Comments}
537 /*#
538 * This API reverses the publication of a performance management plan.
539 *
540 * Warning: this API attempts to delete all personal scorecards, appraisals
541 * and objectives associated with the performance management plan. It does
542 * not end-date these objects it deletes them from the database. This
543 * should only be used when a plan has been published by error. When an
544 * objective has been given performance ratings, the objective cannot be
545 * deleted, which means that this API will fail.
546 *
547 * <p><b>Licensing</b><br>
548 * This API is licensed for use with Human Resources.
549 *
550 * <p><b>Prerequisites</b><br>
551 * The performance management plan must exist, and must have a published
552 * status.
553 *
554 * <p><b>Post Success</b><br>
555 * The publication of the performance management plan will have been reversed.
556 *
557 * <p><b>Post Failure</b><br>
558 * The publication of the performance management plan will not be reversed and
559 * an error will be raised.
560 *
561 * @param p_validate If true, then validation alone will be performed and the
562 * database will remain unchanged. If false and all validation checks pass,
563 * then the database will be modified.
564 * @param p_plan_id Identifies the performance management plan where
565 * publication should be reversed.
566 * @param p_object_version_number Current version number of the performance
567 * management plan to be reverse published.
568 * @rep:displayname Reverse Publish Performance Management Plan
569 * @rep:category BUSINESS_ENTITY PER_PERF_MGMT_PLAN
570 * @rep:lifecycle active
571 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
572 * @rep:scope public
573 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
574 */
575 --
576 -- {End Of Comments}
577 --
578 --
579 procedure reverse_publish_plan
580 (p_validate in boolean default false
581 ,p_plan_id in number
582 ,p_object_version_number in out nocopy number
583 );
584 --
585 end HR_PERF_MGMT_PLAN_API;