DBA Data[Home] [Help]

PACKAGE BODY: APPS.BEN_OTP_DEL

Source


1 Package Body ben_otp_del as
2 /* $Header: beotprhi.pkb 115.3 2003/09/25 00:30:57 rpgupta noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |                     Private Global Definitions                           |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package  varchar2(33)	:= '  ben_otp_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 ben_otp_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     ben_otp_shd.g_api_dml := true;  -- Set the api dml status
67     --
68     -- Delete the where the effective start date is equal
69     -- to the validation end date.
70     --
71     delete from ben_optip_f
72     where       optip_id = p_rec.optip_id
73     and	  effective_start_date = p_validation_start_date;
74     --
75     ben_otp_shd.g_api_dml := false;   -- Unset the api dml status
76   Else
77     ben_otp_shd.g_api_dml := true;  -- Set the api dml status
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 ben_optip_f
83     where        optip_id = p_rec.optip_id
84     and	  effective_start_date >= p_validation_start_date;
85     --
86     ben_otp_shd.g_api_dml := false;   -- Unset the api dml status
87   End If;
88   --
89   hr_utility.set_location(' Leaving:'||l_proc, 20);
90 --
91 Exception
92   When Others Then
93     ben_otp_shd.g_api_dml := false;   -- Unset the api dml status
94     Raise;
95 --
96 End dt_delete_dml;
97 --
98 -- ----------------------------------------------------------------------------
99 -- |------------------------------< delete_dml >------------------------------|
100 -- ----------------------------------------------------------------------------
101 Procedure delete_dml
102   (p_rec                     in out nocopy ben_otp_shd.g_rec_type
103   ,p_effective_date          in date
104   ,p_datetrack_mode          in varchar2
105   ,p_validation_start_date   in date
106   ,p_validation_end_date     in date
107   ) is
108 --
109   l_proc	varchar2(72) := g_package||'delete_dml';
110 --
111 Begin
112   hr_utility.set_location('Entering:'||l_proc, 5);
113   --
114   ben_otp_del.dt_delete_dml
115     (p_rec                   => p_rec
116     ,p_effective_date        => p_effective_date
117     ,p_datetrack_mode        => p_datetrack_mode
118     ,p_validation_start_date => p_validation_start_date
119     ,p_validation_end_date   => p_validation_end_date
120     );
121   --
122   hr_utility.set_location(' Leaving:'||l_proc, 10);
123 End delete_dml;
124 --
125 -- ----------------------------------------------------------------------------
126 -- |----------------------------< dt_pre_delete >-----------------------------|
127 -- ----------------------------------------------------------------------------
128 -- {Start Of Comments}
129 --
130 -- Description:
131 --   The dt_pre_delete process controls the execution of dml
132 --   for the datetrack modes: DELETE, FUTURE_CHANGE
133 --   and DELETE_NEXT_CHANGE only.
134 --
135 -- Prerequisites:
136 --   This is an internal procedure which is called from the pre_delete
137 --   procedure.
138 --
139 -- In Parameters:
140 --   A Pl/Sql record structure.
141 --
142 -- Post Success:
143 --   Processing continues.
144 --
145 -- Post Failure:
146 --   If an error has occurred, an error message and exception will be raised
147 --   but not handled.
148 --
149 -- Developer Implementation Notes:
150 --   This is an internal procedure which is required by Datetrack. Don't
151 --   remove or modify.
152 --
153 -- Access Status:
154 --   Internal Row Handler Use Only.
155 --
156 -- {End Of Comments}
157 -- ----------------------------------------------------------------------------
158 Procedure dt_pre_delete
159   (p_rec                     in out nocopy ben_otp_shd.g_rec_type
160   ,p_effective_date          in date
161   ,p_datetrack_mode          in varchar2
162   ,p_validation_start_date   in date
163   ,p_validation_end_date     in date
164   ) is
165 --
166   l_proc	varchar2(72) := g_package||'dt_pre_delete';
167 --
168 Begin
169   hr_utility.set_location('Entering:'||l_proc, 5);
170   --
171   If (p_datetrack_mode <> hr_api.g_zap) then
172     --
173     p_rec.effective_start_date
174       := ben_otp_shd.g_old_rec.effective_start_date;
175     --
176     If (p_datetrack_mode = hr_api.g_delete) then
177       p_rec.effective_end_date := p_validation_start_date - 1;
178     Else
179       p_rec.effective_end_date := p_validation_end_date;
180     End If;
181     --
182     -- Update the current effective end date record
183     --
184     ben_otp_shd.upd_effective_end_date
185       (p_effective_date	        => p_effective_date
186       ,p_base_key_value	        => p_rec.optip_id
187       ,p_new_effective_end_date => p_rec.effective_end_date
188       ,p_validation_start_date  => p_validation_start_date
189       ,p_validation_end_date	=> p_validation_end_date
190       ,p_object_version_number            => p_rec.object_version_number
191       );
192   Else
193     p_rec.effective_start_date := null;
194     p_rec.effective_end_date   := null;
195   End If;
196   hr_utility.set_location(' Leaving:'||l_proc, 10);
197 End dt_pre_delete;
198 --
199 -- ----------------------------------------------------------------------------
200 -- |------------------------------< pre_delete >------------------------------|
201 -- ----------------------------------------------------------------------------
202 -- {Start Of Comments}
203 --
204 -- Description:
205 --   This private procedure contains any processing which is required before
206 --   the delete dml.
207 --
208 -- Prerequisites:
209 --   This is an internal procedure which is called from the del procedure.
210 --
211 -- In Parameters:
212 --   A Pl/Sql record structure.
213 --
214 -- Post Success:
215 --   Processing continues.
216 --
217 -- Post Failure:
218 --   If an error has occurred, an error message and exception will be raised
219 --   but not handled.
220 --
221 -- Developer Implementation Notes:
222 --   Any pre-processing required before the delete dml is issued should be
223 --   coded within this procedure. It is important to note that any 3rd party
224 --   maintenance should be reviewed before placing in this procedure. The call
225 --   to the dt_delete_dml procedure should NOT be removed.
226 --
227 -- Access Status:
228 --   Internal Row Handler Use Only.
229 --
230 -- {End Of Comments}
231 -- ----------------------------------------------------------------------------
232 Procedure pre_delete
233   (p_rec                   in out nocopy ben_otp_shd.g_rec_type
234   ,p_effective_date        in date
235   ,p_datetrack_mode        in varchar2
236   ,p_validation_start_date in date
237   ,p_validation_end_date   in date
238   ) is
239 --
240   l_proc	varchar2(72) := g_package||'pre_delete';
241 --
242   --
243 --
244 Begin
245   hr_utility.set_location('Entering:'||l_proc, 5);
246   --
247 --
248   --
249   ben_otp_del.dt_pre_delete
250     (p_rec                   => p_rec
251     ,p_effective_date        => p_effective_date
252     ,p_datetrack_mode        => p_datetrack_mode
253     ,p_validation_start_date => p_validation_start_date
254     ,p_validation_end_date   => p_validation_end_date
255     );
256   --
257   hr_utility.set_location(' Leaving:'||l_proc, 10);
258 End pre_delete;
259 --
260 -- ----------------------------------------------------------------------------
261 -- |----------------------------< post_delete >-------------------------------|
262 -- ----------------------------------------------------------------------------
263 -- {Start Of Comments}
264 --
265 -- Description:
266 --   This private procedure contains any processing which is required after the
267 --   delete dml.
268 --
269 -- Prerequisites:
270 --   This is an internal procedure which is called from the del procedure.
271 --
272 -- In Parameters:
273 --   A Pl/Sql record structure.
274 --
275 -- Post Success:
276 --   Processing continues.
277 --
278 -- Post Failure:
279 --   If an error has occurred, an error message and exception will be raised
280 --   but not handled.
281 --
282 -- Developer Implementation Notes:
283 --   Any post-processing required after the delete dml is issued should be
284 --   coded within this procedure. It is important to note that any 3rd party
285 --   maintenance should be reviewed before placing in this procedure.
286 --
287 -- Access Status:
288 --   Internal Row Handler Use Only.
289 --
290 -- {End Of Comments}
291 -- ----------------------------------------------------------------------------
292 Procedure post_delete
293   (p_rec                   in ben_otp_shd.g_rec_type
294   ,p_effective_date        in date
295   ,p_datetrack_mode        in varchar2
296   ,p_validation_start_date in date
297   ,p_validation_end_date   in date
298   ) is
299 --
300   l_proc	varchar2(72) := g_package||'post_delete';
301 --
302 Begin
303   hr_utility.set_location('Entering:'||l_proc, 5);
304    begin
305     --
306     ben_otp_rkd.after_delete
307       (p_effective_date
308       => p_effective_date
309       ,p_datetrack_mode
310       => p_datetrack_mode
311       ,p_validation_start_date
312       => p_validation_start_date
313       ,p_validation_end_date
314       => p_validation_end_date
315       ,p_optip_id
316       => p_rec.optip_id
317       ,p_effective_start_date
318       => p_rec.effective_start_date
319       ,p_effective_end_date
320       => p_rec.effective_end_date
321       ,p_effective_start_date_o
322       => ben_otp_shd.g_old_rec.effective_start_date
323       ,p_effective_end_date_o
324       => ben_otp_shd.g_old_rec.effective_end_date
325       ,p_business_group_id_o
326       => ben_otp_shd.g_old_rec.business_group_id
327       ,p_pgm_id_o
328       => ben_otp_shd.g_old_rec.pgm_id
329       ,p_ptip_id_o
330       => ben_otp_shd.g_old_rec.ptip_id
331       ,p_pl_typ_id_o
332       => ben_otp_shd.g_old_rec.pl_typ_id
333       ,p_opt_id_o
334       => ben_otp_shd.g_old_rec.opt_id
335       ,p_cmbn_ptip_opt_id_o
336       => ben_otp_shd.g_old_rec.cmbn_ptip_opt_id
337       ,p_legislation_code_o
338       => ben_otp_shd.g_old_rec.legislation_code
339       ,p_legislation_subgroup_o
340       => ben_otp_shd.g_old_rec.legislation_subgroup
341       ,p_otp_attribute_category_o
342       => ben_otp_shd.g_old_rec.otp_attribute_category
343       ,p_otp_attribute1_o
344       => ben_otp_shd.g_old_rec.otp_attribute1
345       ,p_otp_attribute2_o
346       => ben_otp_shd.g_old_rec.otp_attribute2
347       ,p_otp_attribute3_o
348       => ben_otp_shd.g_old_rec.otp_attribute3
349       ,p_otp_attribute4_o
350       => ben_otp_shd.g_old_rec.otp_attribute4
351       ,p_otp_attribute5_o
352       => ben_otp_shd.g_old_rec.otp_attribute5
353       ,p_otp_attribute6_o
354       => ben_otp_shd.g_old_rec.otp_attribute6
355       ,p_otp_attribute7_o
356       => ben_otp_shd.g_old_rec.otp_attribute7
357       ,p_otp_attribute8_o
358       => ben_otp_shd.g_old_rec.otp_attribute8
359       ,p_otp_attribute9_o
360       => ben_otp_shd.g_old_rec.otp_attribute9
361       ,p_otp_attribute10_o
362       => ben_otp_shd.g_old_rec.otp_attribute10
363       ,p_otp_attribute11_o
364       => ben_otp_shd.g_old_rec.otp_attribute11
365       ,p_otp_attribute12_o
366       => ben_otp_shd.g_old_rec.otp_attribute12
367       ,p_otp_attribute13_o
368       => ben_otp_shd.g_old_rec.otp_attribute13
369       ,p_otp_attribute14_o
370       => ben_otp_shd.g_old_rec.otp_attribute14
371       ,p_otp_attribute15_o
372       => ben_otp_shd.g_old_rec.otp_attribute15
373       ,p_otp_attribute16_o
374       => ben_otp_shd.g_old_rec.otp_attribute16
375       ,p_otp_attribute17_o
376       => ben_otp_shd.g_old_rec.otp_attribute17
377       ,p_otp_attribute18_o
378       => ben_otp_shd.g_old_rec.otp_attribute18
379       ,p_otp_attribute19_o
380       => ben_otp_shd.g_old_rec.otp_attribute19
381       ,p_otp_attribute20_o
382       => ben_otp_shd.g_old_rec.otp_attribute20
383       ,p_otp_attribute21_o
384       => ben_otp_shd.g_old_rec.otp_attribute21
385       ,p_otp_attribute22_o
386       => ben_otp_shd.g_old_rec.otp_attribute22
387       ,p_otp_attribute23_o
388       => ben_otp_shd.g_old_rec.otp_attribute23
389       ,p_otp_attribute24_o
390       => ben_otp_shd.g_old_rec.otp_attribute24
391       ,p_otp_attribute25_o
392       => ben_otp_shd.g_old_rec.otp_attribute25
393       ,p_otp_attribute26_o
394       => ben_otp_shd.g_old_rec.otp_attribute26
395       ,p_otp_attribute27_o
396       => ben_otp_shd.g_old_rec.otp_attribute27
397       ,p_otp_attribute28_o
398       => ben_otp_shd.g_old_rec.otp_attribute28
399       ,p_otp_attribute29_o
400       => ben_otp_shd.g_old_rec.otp_attribute29
401       ,p_otp_attribute30_o
402       => ben_otp_shd.g_old_rec.otp_attribute30
403       ,p_object_version_number_o
404       => ben_otp_shd.g_old_rec.object_version_number
405       );
406     --
407   exception
408     --
409     when hr_api.cannot_find_prog_unit then
410       --
411       hr_api.cannot_find_prog_unit_error
412         (p_module_name => 'BEN_OPTIP_F'
413         ,p_hook_type   => 'AD');
414       --
415   end;
416   --
417   hr_utility.set_location(' Leaving:'||l_proc, 10);
418 End post_delete;
419 --
420 -- ----------------------------------------------------------------------------
421 -- |---------------------------------< del >----------------------------------|
422 -- ----------------------------------------------------------------------------
423 Procedure del
424   (p_effective_date in     date
425   ,p_datetrack_mode in     varchar2
426   ,p_rec            in out nocopy ben_otp_shd.g_rec_type
427   ) is
428 --
429   l_proc			varchar2(72) := g_package||'del';
430   l_validation_start_date	date;
431   l_validation_end_date		date;
432 --
433 Begin
434   hr_utility.set_location('Entering:'||l_proc, 5);
435   --
436   -- Ensure that the DateTrack delete mode is valid
437   --
438   dt_api.validate_dt_del_mode(p_datetrack_mode => p_datetrack_mode);
439   --
440   -- We must lock the row which we need to delete.
441   --
442   ben_otp_shd.lck
443     (p_effective_date                   => p_effective_date
444     ,p_datetrack_mode                   => p_datetrack_mode
445     ,p_optip_id                         => p_rec.optip_id
446     ,p_object_version_number            => p_rec.object_version_number
447     ,p_validation_start_date            => l_validation_start_date
448     ,p_validation_end_date              => l_validation_end_date
449     );
450   --
451   -- Call the supporting delete validate operation
452   --
453   ben_otp_bus.delete_validate
454     (p_rec                              => p_rec
455     ,p_effective_date                   => p_effective_date
456     ,p_datetrack_mode                   => p_datetrack_mode
457     ,p_validation_start_date            => l_validation_start_date
458     ,p_validation_end_date              => l_validation_end_date
459     );
460   --
461   -- Call the supporting pre-delete operation
462   --
463   ben_otp_del.pre_delete
464     (p_rec                              => p_rec
465     ,p_effective_date                   => p_effective_date
466     ,p_datetrack_mode                   => p_datetrack_mode
467     ,p_validation_start_date            => l_validation_start_date
468     ,p_validation_end_date              => l_validation_end_date
469     );
470   --
471   -- Delete the row.
472   --
473   ben_otp_del.delete_dml
474     (p_rec                              => p_rec
475     ,p_effective_date                   => p_effective_date
476     ,p_datetrack_mode                   => p_datetrack_mode
477     ,p_validation_start_date            => l_validation_start_date
478     ,p_validation_end_date              => l_validation_end_date
479     );
480   -- Call the supporting post-delete operation
481   --
482   ben_otp_del.post_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   hr_utility.set_location(' Leaving:'||l_proc, 5);
491 End del;
492 --
493 -- ----------------------------------------------------------------------------
494 -- |--------------------------------< del >-----------------------------------|
495 -- ----------------------------------------------------------------------------
496 Procedure del
497   (p_effective_date                   in     date
498   ,p_datetrack_mode                   in     varchar2
499   ,p_optip_id                         in     number
500   ,p_object_version_number            in out nocopy number
501   ,p_effective_start_date                out nocopy date
502   ,p_effective_end_date	                 out nocopy date
503   ) is
504 --
505   l_rec		ben_otp_shd.g_rec_type;
506   l_proc	varchar2(72) := g_package||'del';
507 --
508 Begin
509   hr_utility.set_location('Entering:'||l_proc, 5);
510   --
511   -- As the delete procedure accepts a plsql record structure we do need to
512   -- convert the  arguments into the record structure.
513   -- We don't need to call the supplied conversion argument routine as we
514   -- only need a few attributes.
515   --
516   l_rec.optip_id		:= p_optip_id;
517   l_rec.object_version_number 	:= p_object_version_number;
518   --
519   -- Having converted the arguments into the ben_otp_rec
520   -- plsql record structure we must call the corresponding entity
521   -- business process
522   --
523   ben_otp_del.del
524      (p_effective_date
525      ,p_datetrack_mode
526      ,l_rec
527      );
528   --
529   -- Set the out arguments
530   --
531   p_object_version_number            := l_rec.object_version_number;
532   p_effective_start_date             := l_rec.effective_start_date;
533   p_effective_end_date               := l_rec.effective_end_date;
534   --
535   hr_utility.set_location(' Leaving:'||l_proc, 10);
536 End del;
537 --
538 end ben_otp_del;