[Home] [Help]
PACKAGE BODY: APPS.HR_CLE_DEL
Source
1 Package Body hr_cle_del as
2 /* $Header: hrclerhi.pkb 115.6 2002/12/03 09:27:16 hjonnala noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- | Private Global Definitions |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package varchar2(33) := ' hr_cle_del.'; -- Global package name
9 --
10 -- ----------------------------------------------------------------------------
11 -- |----------------------------< dt_delete_dml >-----------------------------|
12 -- ----------------------------------------------------------------------------
13 -- {Start Of Comments}
14 --
15 -- Description:
16 -- This procedure controls the actual dml delete logic for the datetrack
17 -- delete modes: ZAP, DELETE, FUTURE_CHANGE and DELETE_NEXT_CHANGE. The
18 -- execution is as follows:
19 -- 1) To set and unset the g_api_dml status as required (as we are about to
20 -- perform dml).
21 -- 2) If the delete mode is DELETE_NEXT_CHANGE then delete where the
22 -- effective start date is equal to the validation start date.
23 -- 3) If the delete mode is not DELETE_NEXT_CHANGE then delete
24 -- all rows for the entity where the effective start date is greater
25 -- than or equal to the validation start date.
26 -- 4) To raise any errors.
27 --
28 -- Prerequisites:
29 -- This is an internal private procedure which must be called from the
30 -- delete_dml procedure.
31 --
32 -- In Parameters:
33 -- A Pl/Sql record structure.
34 --
35 -- Post Success:
36 -- The specified row will be delete from the schema.
37 --
38 -- Post Failure:
39 -- On the delete dml failure it is important to note that we always reset the
40 -- g_api_dml status to false.
41 -- If any other error is reported, the error will be raised after the
42 -- g_api_dml status is reset.
43 --
44 -- Developer Implementation Notes:
45 -- This is an internal private procedure which must be called from the
46 -- delete_dml procedure.
47 --
48 -- Access Status:
49 -- Internal Row Handler Use Only.
50 --
51 -- {End Of Comments}
52 -- ----------------------------------------------------------------------------
53 Procedure dt_delete_dml
54 (p_rec in out nocopy hr_cle_shd.g_rec_type
55 ,p_effective_date in date
56 ,p_datetrack_mode in varchar2
57 ,p_validation_start_date in date
58 ,p_validation_end_date in date
59 ) is
60 --
61 l_proc varchar2(72) := g_package||'dt_delete_dml';
62 --
63 Begin
64 hr_utility.set_location('Entering:'||l_proc, 5);
65 If (p_datetrack_mode = hr_api.g_delete_next_change) then
66 --
67 --
68 -- Delete the where the effective start date is equal
69 -- to the validation end date.
70 --
71 delete from hr_de_soc_ins_contr_lvls_f
72 where soc_ins_contr_lvls_id = p_rec.soc_ins_contr_lvls_id
73 and effective_start_date = p_validation_start_date;
74 --
75 --
76 Else
77 --
78 --
79 -- Delete the row(s) where the effective start date is greater than
80 -- or equal to the validation start date.
81 --
82 delete from hr_de_soc_ins_contr_lvls_f
83 where soc_ins_contr_lvls_id = p_rec.soc_ins_contr_lvls_id
84 and effective_start_date >= p_validation_start_date;
85 --
86 --
87 End If;
88 --
89 hr_utility.set_location(' Leaving:'||l_proc, 20);
90 --
91 End dt_delete_dml;
92 --
93 -- ----------------------------------------------------------------------------
94 -- |------------------------------< delete_dml >------------------------------|
95 -- ----------------------------------------------------------------------------
96 Procedure delete_dml
97 (p_rec in out nocopy hr_cle_shd.g_rec_type
98 ,p_effective_date in date
99 ,p_datetrack_mode in varchar2
100 ,p_validation_start_date in date
101 ,p_validation_end_date in date
102 ) is
103 --
104 l_proc varchar2(72) := g_package||'delete_dml';
105 --
106 Begin
107 hr_utility.set_location('Entering:'||l_proc, 5);
108 --
109 hr_cle_del.dt_delete_dml
110 (p_rec => p_rec
111 ,p_effective_date => p_effective_date
112 ,p_datetrack_mode => p_datetrack_mode
113 ,p_validation_start_date => p_validation_start_date
114 ,p_validation_end_date => p_validation_end_date
115 );
116 --
117 hr_utility.set_location(' Leaving:'||l_proc, 10);
118 End delete_dml;
119 --
120 -- ----------------------------------------------------------------------------
121 -- |----------------------------< dt_pre_delete >-----------------------------|
122 -- ----------------------------------------------------------------------------
123 -- {Start Of Comments}
124 --
125 -- Description:
126 -- The dt_pre_delete process controls the execution of dml
127 -- for the datetrack modes: DELETE, FUTURE_CHANGE
128 -- and DELETE_NEXT_CHANGE only.
129 --
130 -- Prerequisites:
131 -- This is an internal procedure which is called from the pre_delete
132 -- procedure.
133 --
134 -- In Parameters:
135 -- A Pl/Sql record structure.
136 --
137 -- Post Success:
138 -- Processing continues.
139 --
140 -- Post Failure:
141 -- If an error has occurred, an error message and exception will be raised
142 -- but not handled.
143 --
144 -- Developer Implementation Notes:
145 -- This is an internal procedure which is required by Datetrack. Don't
146 -- remove or modify.
147 --
148 -- Access Status:
149 -- Internal Row Handler Use Only.
150 --
151 -- {End Of Comments}
152 -- ----------------------------------------------------------------------------
153 Procedure dt_pre_delete
154 (p_rec in out nocopy hr_cle_shd.g_rec_type
155 ,p_effective_date in date
156 ,p_datetrack_mode in varchar2
157 ,p_validation_start_date in date
158 ,p_validation_end_date in date
159 ) is
160 --
161 l_proc varchar2(72) := g_package||'dt_pre_delete';
162 --
163 Begin
164 hr_utility.set_location('Entering:'||l_proc, 5);
165 --
166 If (p_datetrack_mode <> hr_api.g_zap) then
167 --
168 p_rec.effective_start_date
169 := hr_cle_shd.g_old_rec.effective_start_date;
170 --
171 If (p_datetrack_mode = hr_api.g_delete) then
172 p_rec.effective_end_date := p_validation_start_date - 1;
173 Else
174 p_rec.effective_end_date := p_validation_end_date;
175 End If;
176 --
177 -- Update the current effective end date record
178 --
179 hr_cle_shd.upd_effective_end_date
180 (p_effective_date => p_effective_date
181 ,p_base_key_value => p_rec.soc_ins_contr_lvls_id
182 ,p_new_effective_end_date => p_rec.effective_end_date
183 ,p_validation_start_date => p_validation_start_date
184 ,p_validation_end_date => p_validation_end_date
185 ,p_object_version_number => p_rec.object_version_number
186 );
187 Else
188 p_rec.effective_start_date := null;
189 p_rec.effective_end_date := null;
190 End If;
191 hr_utility.set_location(' Leaving:'||l_proc, 10);
192 End dt_pre_delete;
193 --
194 -- ----------------------------------------------------------------------------
195 -- |------------------------------< pre_delete >------------------------------|
196 -- ----------------------------------------------------------------------------
197 -- {Start Of Comments}
198 --
199 -- Description:
200 -- This private procedure contains any processing which is required before
201 -- the delete dml.
202 --
203 -- Prerequisites:
204 -- This is an internal procedure which is called from the del procedure.
205 --
206 -- In Parameters:
207 -- A Pl/Sql record structure.
208 --
209 -- Post Success:
210 -- Processing continues.
211 --
212 -- Post Failure:
213 -- If an error has occurred, an error message and exception will be raised
214 -- but not handled.
215 --
216 -- Developer Implementation Notes:
217 -- Any pre-processing required before the delete dml is issued should be
218 -- coded within this procedure. It is important to note that any 3rd party
219 -- maintenance should be reviewed before placing in this procedure. The call
220 -- to the dt_delete_dml procedure should NOT be removed.
221 --
222 -- Access Status:
223 -- Internal Row Handler Use Only.
224 --
225 -- {End Of Comments}
226 -- ----------------------------------------------------------------------------
227 Procedure pre_delete
228 (p_rec in out nocopy hr_cle_shd.g_rec_type
229 ,p_effective_date in date
230 ,p_datetrack_mode in varchar2
231 ,p_validation_start_date in date
232 ,p_validation_end_date in date
233 ) is
234 --
235 l_proc varchar2(72) := g_package||'pre_delete';
236 --
237 --
238 --
239 Begin
240 hr_utility.set_location('Entering:'||l_proc, 5);
241 --
242 --
243 --
244 hr_cle_del.dt_pre_delete
245 (p_rec => p_rec
246 ,p_effective_date => p_effective_date
247 ,p_datetrack_mode => p_datetrack_mode
248 ,p_validation_start_date => p_validation_start_date
249 ,p_validation_end_date => p_validation_end_date
250 );
251 --
252 hr_utility.set_location(' Leaving:'||l_proc, 10);
253 End pre_delete;
254 --
255 -- ----------------------------------------------------------------------------
256 -- |----------------------------< post_delete >-------------------------------|
257 -- ----------------------------------------------------------------------------
258 -- {Start Of Comments}
259 --
260 -- Description:
261 -- This private procedure contains any processing which is required after
262 -- the delete dml.
263 --
264 -- Prerequisites:
265 -- This is an internal procedure which is called from the del procedure.
266 --
267 -- In Parameters:
268 -- A Pl/Sql record structure.
269 --
270 -- Post Success:
271 -- Processing continues.
272 --
273 -- Post Failure:
274 -- If an error has occurred, an error message and exception will be raised
275 -- but not handled.
276 --
277 -- Developer Implementation Notes:
278 -- Any post-processing required after the delete dml is issued should be
279 -- coded within this procedure. It is important to note that any 3rd party
280 -- maintenance should be reviewed before placing in this procedure.
281 --
282 -- Access Status:
283 -- Internal Row Handler Use Only.
284 --
285 -- {End Of Comments}
286 -- ----------------------------------------------------------------------------
287 Procedure post_delete
288 (p_rec in hr_cle_shd.g_rec_type
289 ,p_effective_date in date
290 ,p_datetrack_mode in varchar2
291 ,p_validation_start_date in date
292 ,p_validation_end_date in date
293 ) is
294 --
295 l_proc varchar2(72) := g_package||'post_delete';
296 --
297 Begin
298 hr_utility.set_location('Entering:'||l_proc, 5);
299 begin
300 --
301 hr_cle_rkd.after_delete
302 (p_effective_date
303 => p_effective_date
304 ,p_datetrack_mode
305 => p_datetrack_mode
306 ,p_validation_start_date
307 => p_validation_start_date
308 ,p_validation_end_date
309 => p_validation_end_date
310 ,p_soc_ins_contr_lvls_id
311 => p_rec.soc_ins_contr_lvls_id
312 ,p_effective_start_date
313 => p_rec.effective_start_date
314 ,p_effective_end_date
315 => p_rec.effective_end_date
316 ,p_organization_id_o
317 => hr_cle_shd.g_old_rec.organization_id
318 ,p_normal_percentage_o
319 => hr_cle_shd.g_old_rec.normal_percentage
320 ,p_normal_amount_o
321 => hr_cle_shd.g_old_rec.normal_amount
322 ,p_increased_percentage_o
323 => hr_cle_shd.g_old_rec.increased_percentage
324 ,p_increased_amount_o
325 => hr_cle_shd.g_old_rec.increased_amount
326 ,p_reduced_percentage_o
327 => hr_cle_shd.g_old_rec.reduced_percentage
328 ,p_reduced_amount_o
329 => hr_cle_shd.g_old_rec.reduced_amount
330 ,p_effective_start_date_o
331 => hr_cle_shd.g_old_rec.effective_start_date
332 ,p_effective_end_date_o
333 => hr_cle_shd.g_old_rec.effective_end_date
334 ,p_attribute_category_o
335 => hr_cle_shd.g_old_rec.attribute_category
336 ,p_attribute1_o
337 => hr_cle_shd.g_old_rec.attribute1
338 ,p_attribute2_o
339 => hr_cle_shd.g_old_rec.attribute2
340 ,p_attribute3_o
341 => hr_cle_shd.g_old_rec.attribute3
342 ,p_attribute4_o
343 => hr_cle_shd.g_old_rec.attribute4
344 ,p_attribute5_o
345 => hr_cle_shd.g_old_rec.attribute5
346 ,p_attribute6_o
347 => hr_cle_shd.g_old_rec.attribute6
348 ,p_attribute7_o
349 => hr_cle_shd.g_old_rec.attribute7
350 ,p_attribute8_o
351 => hr_cle_shd.g_old_rec.attribute8
352 ,p_attribute9_o
353 => hr_cle_shd.g_old_rec.attribute9
354 ,p_attribute10_o
355 => hr_cle_shd.g_old_rec.attribute10
356 ,p_attribute11_o
357 => hr_cle_shd.g_old_rec.attribute11
358 ,p_attribute12_o
359 => hr_cle_shd.g_old_rec.attribute12
360 ,p_attribute13_o
361 => hr_cle_shd.g_old_rec.attribute13
362 ,p_attribute14_o
363 => hr_cle_shd.g_old_rec.attribute14
364 ,p_attribute15_o
365 => hr_cle_shd.g_old_rec.attribute15
366 ,p_attribute16_o
367 => hr_cle_shd.g_old_rec.attribute16
368 ,p_attribute17_o
369 => hr_cle_shd.g_old_rec.attribute17
370 ,p_attribute18_o
371 => hr_cle_shd.g_old_rec.attribute18
372 ,p_attribute19_o
373 => hr_cle_shd.g_old_rec.attribute19
374 ,p_attribute20_o
375 => hr_cle_shd.g_old_rec.attribute20
376 ,p_object_version_number_o
377 => hr_cle_shd.g_old_rec.object_version_number
378 ,p_attribute21_o
379 => hr_cle_shd.g_old_rec.attribute21
380 ,p_attribute22_o
381 => hr_cle_shd.g_old_rec.attribute22
382 ,p_attribute23_o
383 => hr_cle_shd.g_old_rec.attribute23
384 ,p_attribute24_o
385 => hr_cle_shd.g_old_rec.attribute24
386 ,p_attribute25_o
387 => hr_cle_shd.g_old_rec.attribute25
388 ,p_attribute26_o
389 => hr_cle_shd.g_old_rec.attribute26
390 ,p_attribute27_o
391 => hr_cle_shd.g_old_rec.attribute27
392 ,p_attribute28_o
393 => hr_cle_shd.g_old_rec.attribute28
394 ,p_attribute29_o
395 => hr_cle_shd.g_old_rec.attribute29
396 ,p_attribute30_o
397 => hr_cle_shd.g_old_rec.attribute30
398 ,p_flat_tax_limit_per_month_o
399 => hr_cle_shd.g_old_rec.flat_tax_limit_per_month
400 ,p_flat_tax_limit_per_year_o
401 => hr_cle_shd.g_old_rec.flat_tax_limit_per_year
402 ,p_min_increased_contribution_o
403 => hr_cle_shd.g_old_rec.min_increased_contribution
404 ,p_max_increased_contribution_o
405 => hr_cle_shd.g_old_rec.max_increased_contribution
406 ,p_month1_o
407 => hr_cle_shd.g_old_rec.month1
408 ,p_month1_min_contribution_o
409 => hr_cle_shd.g_old_rec.month1_min_contribution
410 ,p_month1_max_contribution_o
411 => hr_cle_shd.g_old_rec.month1_max_contribution
412 ,p_month2_o
413 => hr_cle_shd.g_old_rec.month2
414 ,p_month2_min_contribution_o
415 => hr_cle_shd.g_old_rec.month2_min_contribution
416 ,p_month2_max_contribution_o
417 => hr_cle_shd.g_old_rec.month2_max_contribution
418 ,p_employee_contribution_o
419 => hr_cle_shd.g_old_rec.employee_contribution
420 ,p_contribution_level_type_o
421 => hr_cle_shd.g_old_rec.contribution_level_type
422 );
423 --
424 exception
425 --
426 when hr_api.cannot_find_prog_unit then
427 --
428 hr_api.cannot_find_prog_unit_error
429 (p_module_name => 'HR_DE_SOC_INS_CONTR_LVLS_F'
430 ,p_hook_type => 'AD');
431 --
432 end;
433 --
434 hr_utility.set_location(' Leaving:'||l_proc, 10);
435 End post_delete;
436 --
437 -- ----------------------------------------------------------------------------
438 -- |---------------------------------< del >----------------------------------|
439 -- ----------------------------------------------------------------------------
440 Procedure del
441 (p_effective_date in date
442 ,p_datetrack_mode in varchar2
443 ,p_rec in out nocopy hr_cle_shd.g_rec_type
444 ) is
445 --
446 l_proc varchar2(72) := g_package||'del';
447 l_validation_start_date date;
448 l_validation_end_date date;
449 --
450 Begin
451 hr_utility.set_location('Entering:'||l_proc, 5);
452 --
453 -- Ensure that the DateTrack delete mode is valid
454 --
455 hr_utility.trace('object1' ||p_rec.object_version_number);
456 dt_api.validate_dt_del_mode(p_datetrack_mode => p_datetrack_mode);
457 hr_utility.trace('object2' ||p_rec.object_version_number);
458 --
459 -- We must lock the row which we need to delete.
460 --
461 hr_cle_shd.lck
462 (p_effective_date => p_effective_date
463 ,p_datetrack_mode => p_datetrack_mode
464 ,p_soc_ins_contr_lvls_id => p_rec.soc_ins_contr_lvls_id
465 ,p_object_version_number => p_rec.object_version_number
466 ,p_validation_start_date => l_validation_start_date
467 ,p_validation_end_date => l_validation_end_date
468 );
469 --
470 -- Call the supporting delete validate operation
471 --
472 hr_cle_bus.delete_validate
473 (p_rec => p_rec
474 ,p_effective_date => p_effective_date
475 ,p_datetrack_mode => p_datetrack_mode
476 ,p_validation_start_date => l_validation_start_date
477 ,p_validation_end_date => l_validation_end_date
478 );
479 --
480 -- Call the supporting pre-delete operation
481 --
482 hr_cle_del.pre_delete
483 (p_rec => p_rec
484 ,p_effective_date => p_effective_date
485 ,p_datetrack_mode => p_datetrack_mode
486 ,p_validation_start_date => l_validation_start_date
487 ,p_validation_end_date => l_validation_end_date
488 );
489 --
490 -- Delete the row.
491 --
492 hr_cle_del.delete_dml
493 (p_rec => p_rec
494 ,p_effective_date => p_effective_date
495 ,p_datetrack_mode => p_datetrack_mode
496 ,p_validation_start_date => l_validation_start_date
497 ,p_validation_end_date => l_validation_end_date
498 );
499 -- Call the supporting post-delete operation
500 --
501 hr_cle_del.post_delete
502 (p_rec => p_rec
503 ,p_effective_date => p_effective_date
504 ,p_datetrack_mode => p_datetrack_mode
505 ,p_validation_start_date => l_validation_start_date
506 ,p_validation_end_date => l_validation_end_date
507 );
508 --
509 hr_utility.set_location(' Leaving:'||l_proc, 5);
510 End del;
511 --
512 -- ----------------------------------------------------------------------------
513 -- |--------------------------------< del >-----------------------------------|
514 -- ----------------------------------------------------------------------------
515 Procedure del
516 (p_effective_date in date
517 ,p_datetrack_mode in varchar2
518 ,p_soc_ins_contr_lvls_id in number
519 ,p_object_version_number in out nocopy number
520 ,p_effective_start_date out nocopy date
521 ,p_effective_end_date out nocopy date
522 ) is
523 --
524 l_rec hr_cle_shd.g_rec_type;
525 l_proc varchar2(72) := g_package||'del';
526 --
527 Begin
528 hr_utility.set_location('Entering:'||l_proc, 5);
529 --
530 -- As the delete procedure accepts a plsql record structure we do need to
531 -- convert the arguments into the record structure.
532 -- We don't need to call the supplied conversion argument routine as we
533 -- only need a few attributes.
534 --
535 hr_utility.trace('passed' ||p_object_version_number);
536 l_rec.soc_ins_contr_lvls_id := p_soc_ins_contr_lvls_id;
537 l_rec.object_version_number := p_object_version_number;
538 --
539 -- Having converted the arguments into the hr_cle_rec
540 -- plsql record structure we must call the corresponding entity
541 -- business process
542 --
543 hr_utility.trace('object3' ||l_rec.object_version_number);
544
545 hr_cle_del.del
546 (p_effective_date
547 ,p_datetrack_mode
548 ,l_rec
549 );
550 --
551 --
552 -- Set the out arguments
553 --
554 p_object_version_number := l_rec.object_version_number;
555 p_effective_start_date := l_rec.effective_start_date;
556 p_effective_end_date := l_rec.effective_end_date;
557 --
558 hr_utility.set_location(' Leaving:'||l_proc, 10);
559 End del;
560 --
561 end hr_cle_del;