DBA Data[Home] [Help]

PACKAGE BODY: APPS.BEN_VEP_DEL

Source


1 Package Body ben_vep_del as
2 /* $Header: beveprhi.pkb 120.0.12010000.2 2008/08/05 15:33:44 ubhat ship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |                     Private Global Definitions                           |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package  varchar2(33)	:= '  ben_vep_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_vep_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_vep_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_VRBL_RT_ELIG_PRFL_f
72     where       vrbl_rt_elig_prfl_id = p_rec.vrbl_rt_elig_prfl_id
73     and	  effective_start_date = p_validation_start_date;
74     --
75     ben_vep_shd.g_api_dml := false;   -- Unset the api dml status
76   Else
77     ben_vep_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_VRBL_RT_ELIG_PRFL_f
83     where        vrbl_rt_elig_prfl_id = p_rec.vrbl_rt_elig_prfl_id
84     and	  effective_start_date >= p_validation_start_date;
85     --
86     ben_vep_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_vep_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_vep_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_vep_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_vep_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_vep_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_vep_shd.upd_effective_end_date
185       (p_effective_date	        => p_effective_date
186       ,p_base_key_value	        => p_rec.vrbl_rt_elig_prfl_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_vep_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_vep_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_vep_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_vep_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_vrbl_rt_elig_prfl_id
316       => p_rec.vrbl_rt_elig_prfl_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_vep_shd.g_old_rec.effective_start_date
323       ,p_effective_end_date_o
324       => ben_vep_shd.g_old_rec.effective_end_date
325       ,p_business_group_id_o
326       => ben_vep_shd.g_old_rec.business_group_id
327       ,p_vrbl_rt_prfl_id_o
328       => ben_vep_shd.g_old_rec.vrbl_rt_prfl_id
329       ,p_eligy_prfl_id_o
330       => ben_vep_shd.g_old_rec.eligy_prfl_id
331       ,p_mndtry_flag_o
332       => ben_vep_shd.g_old_rec.mndtry_flag
333       ,p_vep_attribute_category_o
334       => ben_vep_shd.g_old_rec.vep_attribute_category
335       ,p_vep_attribute1_o
336       => ben_vep_shd.g_old_rec.vep_attribute1
337       ,p_vep_attribute2_o
338       => ben_vep_shd.g_old_rec.vep_attribute2
339       ,p_vep_attribute3_o
340       => ben_vep_shd.g_old_rec.vep_attribute3
341       ,p_vep_attribute4_o
342       => ben_vep_shd.g_old_rec.vep_attribute4
343       ,p_vep_attribute5_o
344       => ben_vep_shd.g_old_rec.vep_attribute5
345       ,p_vep_attribute6_o
346       => ben_vep_shd.g_old_rec.vep_attribute6
347       ,p_vep_attribute7_o
348       => ben_vep_shd.g_old_rec.vep_attribute7
349       ,p_vep_attribute8_o
350       => ben_vep_shd.g_old_rec.vep_attribute8
351       ,p_vep_attribute9_o
352       => ben_vep_shd.g_old_rec.vep_attribute9
353       ,p_vep_attribute10_o
354       => ben_vep_shd.g_old_rec.vep_attribute10
355       ,p_vep_attribute11_o
356       => ben_vep_shd.g_old_rec.vep_attribute11
357       ,p_vep_attribute12_o
358       => ben_vep_shd.g_old_rec.vep_attribute12
359       ,p_vep_attribute13_o
360       => ben_vep_shd.g_old_rec.vep_attribute13
361       ,p_vep_attribute14_o
362       => ben_vep_shd.g_old_rec.vep_attribute14
363       ,p_vep_attribute15_o
364       => ben_vep_shd.g_old_rec.vep_attribute15
365       ,p_vep_attribute16_o
366       => ben_vep_shd.g_old_rec.vep_attribute16
367       ,p_vep_attribute17_o
368       => ben_vep_shd.g_old_rec.vep_attribute17
369       ,p_vep_attribute18_o
370       => ben_vep_shd.g_old_rec.vep_attribute18
371       ,p_vep_attribute19_o
372       => ben_vep_shd.g_old_rec.vep_attribute19
373       ,p_vep_attribute20_o
374       => ben_vep_shd.g_old_rec.vep_attribute20
375       ,p_vep_attribute21_o
376       => ben_vep_shd.g_old_rec.vep_attribute21
377       ,p_vep_attribute22_o
378       => ben_vep_shd.g_old_rec.vep_attribute22
379       ,p_vep_attribute23_o
380       => ben_vep_shd.g_old_rec.vep_attribute23
381       ,p_vep_attribute24_o
382       => ben_vep_shd.g_old_rec.vep_attribute24
383       ,p_vep_attribute25_o
384       => ben_vep_shd.g_old_rec.vep_attribute25
385       ,p_vep_attribute26_o
386       => ben_vep_shd.g_old_rec.vep_attribute26
387       ,p_vep_attribute27_o
388       => ben_vep_shd.g_old_rec.vep_attribute27
389       ,p_vep_attribute28_o
390       => ben_vep_shd.g_old_rec.vep_attribute28
391       ,p_vep_attribute29_o
392       => ben_vep_shd.g_old_rec.vep_attribute29
393       ,p_vep_attribute30_o
394       => ben_vep_shd.g_old_rec.vep_attribute30
395       ,p_object_version_number_o
396       => ben_vep_shd.g_old_rec.object_version_number
397       );
398     --
399   exception
400     --
401     when hr_api.cannot_find_prog_unit then
402       --
403       hr_api.cannot_find_prog_unit_error
404         (p_module_name => 'BEN_VRBL_RT_ELIG_PRFL_F'
405         ,p_hook_type   => 'AD');
406       --
407   end;
408   --
409   hr_utility.set_location(' Leaving:'||l_proc, 10);
410 End post_delete;
411 --
412 -- ----------------------------------------------------------------------------
413 -- |---------------------------------< del >----------------------------------|
414 -- ----------------------------------------------------------------------------
415 Procedure del
416   (p_effective_date in     date
417   ,p_datetrack_mode in     varchar2
418   ,p_rec            in out nocopy ben_vep_shd.g_rec_type
419   ) is
420 --
421   l_proc			varchar2(72) := g_package||'del';
422   l_validation_start_date	date;
423   l_validation_end_date		date;
424 --
425 Begin
426   hr_utility.set_location('Entering:'||l_proc, 5);
427   --
428   -- Ensure that the DateTrack delete mode is valid
429   --
430   dt_api.validate_dt_del_mode(p_datetrack_mode => p_datetrack_mode);
431   --
432   -- We must lock the row which we need to delete.
433   --
434   ben_vep_shd.lck
435     (p_effective_date                   => p_effective_date
436     ,p_datetrack_mode                   => p_datetrack_mode
437     ,p_vrbl_rt_elig_prfl_id                         => p_rec.vrbl_rt_elig_prfl_id
438     ,p_object_version_number            => p_rec.object_version_number
439     ,p_validation_start_date            => l_validation_start_date
440     ,p_validation_end_date              => l_validation_end_date
441     );
442   --
443   -- Call the supporting delete validate operation
444   --
445   ben_vep_bus.delete_validate
446     (p_rec                              => p_rec
447     ,p_effective_date                   => p_effective_date
448     ,p_datetrack_mode                   => p_datetrack_mode
449     ,p_validation_start_date            => l_validation_start_date
450     ,p_validation_end_date              => l_validation_end_date
451     );
452   --
453   -- Call the supporting pre-delete operation
454   --
455   ben_vep_del.pre_delete
456     (p_rec                              => p_rec
457     ,p_effective_date                   => p_effective_date
458     ,p_datetrack_mode                   => p_datetrack_mode
459     ,p_validation_start_date            => l_validation_start_date
460     ,p_validation_end_date              => l_validation_end_date
461     );
462   --
463   -- Delete the row.
464   --
465   ben_vep_del.delete_dml
466     (p_rec                              => p_rec
467     ,p_effective_date                   => p_effective_date
468     ,p_datetrack_mode                   => p_datetrack_mode
469     ,p_validation_start_date            => l_validation_start_date
470     ,p_validation_end_date              => l_validation_end_date
471     );
472   -- Call the supporting post-delete operation
473   --
474   ben_vep_del.post_delete
475     (p_rec                              => p_rec
476     ,p_effective_date                   => p_effective_date
477     ,p_datetrack_mode                   => p_datetrack_mode
478     ,p_validation_start_date            => l_validation_start_date
479     ,p_validation_end_date              => l_validation_end_date
480     );
481   --
482   hr_utility.set_location(' Leaving:'||l_proc, 5);
483 End del;
484 --
485 -- ----------------------------------------------------------------------------
486 -- |--------------------------------< del >-----------------------------------|
487 -- ----------------------------------------------------------------------------
488 Procedure del
489   (p_effective_date                   in     date
490   ,p_datetrack_mode                   in     varchar2
491   ,p_vrbl_rt_elig_prfl_id                         in     number
492   ,p_object_version_number            in out nocopy number
493   ,p_effective_start_date                out nocopy date
494   ,p_effective_end_date	                 out nocopy date
495   ) is
496 --
497   l_rec		ben_vep_shd.g_rec_type;
498   l_proc	varchar2(72) := g_package||'del';
499 --
500 Begin
501   hr_utility.set_location('Entering:'||l_proc, 5);
502   --
503   -- As the delete procedure accepts a plsql record structure we do need to
504   -- convert the  arguments into the record structure.
505   -- We don't need to call the supplied conversion argument routine as we
506   -- only need a few attributes.
507   --
508   l_rec.vrbl_rt_elig_prfl_id		:= p_vrbl_rt_elig_prfl_id;
509   l_rec.object_version_number 	:= p_object_version_number;
510   --
511   -- Having converted the arguments into the ben_vep_rec
512   -- plsql record structure we must call the corresponding entity
513   -- business process
514   --
515   ben_vep_del.del
516      (p_effective_date
517      ,p_datetrack_mode
518      ,l_rec
519      );
520   --
521   -- Set the out arguments
522   --
523   p_object_version_number            := l_rec.object_version_number;
524   p_effective_start_date             := l_rec.effective_start_date;
525   p_effective_end_date               := l_rec.effective_end_date;
526   --
527   hr_utility.set_location(' Leaving:'||l_proc, 10);
528 End del;
529 --
530 end ben_vep_del;