DBA Data[Home] [Help]

PACKAGE BODY: APPS.PER_SPP_DEL

Source


1 Package Body per_spp_del as
2 /* $Header: pespprhi.pkb 120.6 2010/01/12 06:37:43 skura ship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |                     Private Global Definitions                           |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package  varchar2(33)	:= '  per_spp_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 per_spp_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     per_spp_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 per_spinal_point_placements_f
72     where       placement_id = p_rec.placement_id
73     and	  effective_start_date = p_validation_start_date;
74     --
75     per_spp_shd.g_api_dml := false;   -- Unset the api dml status
76   Else
77     per_spp_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 per_spinal_point_placements_f
83     where        placement_id = p_rec.placement_id
84     and	  effective_start_date >= p_validation_start_date;
85     --
86     per_spp_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     per_spp_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 per_spp_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   per_spp_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 per_spp_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       := per_spp_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;
181     --
178     Else
179       p_rec.effective_end_date := p_validation_end_date;
180     End If;
182     -- Update the current effective end date record
183     --
184     per_spp_shd.upd_effective_end_date
185       (p_effective_date	        => p_effective_date
186       ,p_base_key_value	        => p_rec.placement_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 per_spp_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   per_spp_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 per_spp_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 -- changes start for 7457065
303   l_step_end_date        per_spinal_point_steps_f.effective_end_date%type;
304   l_next_placement_st_date  per_spinal_point_steps_f.effective_start_date%type;
305 --
306     cursor c_step_end_date is
307     select max(effective_end_date)
308     from per_spinal_point_steps_f
309     where step_id = p_rec.step_id;
310     -- max taken because there may be date track updates to the step
311     -- records in the table per_spinal_point_steps_f
312 --
313     cursor c_next_placement_st_date is
314     select min(effective_start_date)
315     from per_spinal_point_placements_f
316     where assignment_id = p_rec.assignment_id
317     and effective_start_date > p_rec.effective_start_date;
318 -- changes end for 7457065
319 --
320 Begin
321   hr_utility.set_location('Entering:'||l_proc, 5);
322 
323  -- Code changes start for bug 7457065
324  If (p_datetrack_mode <> hr_api.g_zap) then
325   open c_step_end_date;
326   fetch c_step_end_date into l_step_end_date;
327   close c_step_end_date;
328 
329   if l_step_end_date < p_rec.effective_end_date then
330     open c_next_placement_st_date;
331     fetch c_next_placement_st_date into l_next_placement_st_date;
332     close c_next_placement_st_date;
333 
334     if l_next_placement_st_date is not null then
335       if (l_next_placement_st_date - l_step_end_date) > 1 then
336          fnd_message.set_name('PER', 'HR_50439_SP_GAP_ERROR');
337          fnd_message.set_token('END_DATE',l_step_end_date);
338          fnd_message.raise_error;
339       end if;
340     else
341       update per_spinal_point_placements_f
342       set effective_end_date = l_step_end_date
343       where placement_id = p_rec.placement_id
344       and effective_start_date = p_rec.effective_start_date;
345     end if;
346   end if;
347  end if; --   If (p_datetrack_mode <> hr_api.g_zap) then
348 -- Code changes end for bug 7457065
349 
350    begin
351     --
352     per_spp_rkd.after_delete
353       (p_effective_date
354       => p_effective_date
355       ,p_datetrack_mode
356       => p_datetrack_mode
357       ,p_validation_start_date
358       => p_validation_start_date
359       ,p_validation_end_date
360       => p_validation_end_date
361       ,p_placement_id
362       => p_rec.placement_id
363       ,p_effective_start_date
364       => p_rec.effective_start_date
365       ,p_effective_end_date
366       => p_rec.effective_end_date
367       ,p_effective_start_date_o
368       => per_spp_shd.g_old_rec.effective_start_date
369       ,p_effective_end_date_o
370       => per_spp_shd.g_old_rec.effective_end_date
371       ,p_business_group_id_o
372       => per_spp_shd.g_old_rec.business_group_id
373       ,p_assignment_id_o
374       => per_spp_shd.g_old_rec.assignment_id
375       ,p_step_id_o
376       => per_spp_shd.g_old_rec.step_id
377       ,p_auto_increment_flag_o
378       => per_spp_shd.g_old_rec.auto_increment_flag
379       ,p_parent_spine_id_o
380       => per_spp_shd.g_old_rec.parent_spine_id
381       ,p_reason_o
382       => per_spp_shd.g_old_rec.reason
383       ,p_request_id_o
384       => per_spp_shd.g_old_rec.request_id
385       ,p_program_application_id_o
386       => per_spp_shd.g_old_rec.program_application_id
387       ,p_program_id_o
388       => per_spp_shd.g_old_rec.program_id
389       ,p_program_update_date_o
390       => per_spp_shd.g_old_rec.program_update_date
391       ,p_increment_number_o
392       => per_spp_shd.g_old_rec.increment_number
393       ,p_information1_o                   => per_spp_shd.g_old_rec.information1
394       ,p_information2_o                   => per_spp_shd.g_old_rec.information2
395       ,p_information3_o                   => per_spp_shd.g_old_rec.information3
396       ,p_information4_o                   => per_spp_shd.g_old_rec.information4
397       ,p_information5_o                   => per_spp_shd.g_old_rec.information5
398       ,p_information6_o                   => per_spp_shd.g_old_rec.information6
399       ,p_information7_o                   => per_spp_shd.g_old_rec.information7
400       ,p_information8_o                   => per_spp_shd.g_old_rec.information8
401       ,p_information9_o                   => per_spp_shd.g_old_rec.information9
402       ,p_information10_o                  => per_spp_shd.g_old_rec.information10
403       ,p_information11_o                  => per_spp_shd.g_old_rec.information11
404       ,p_information12_o                  => per_spp_shd.g_old_rec.information12
405       ,p_information13_o                  => per_spp_shd.g_old_rec.information13
406       ,p_information14_o                  => per_spp_shd.g_old_rec.information14
407       ,p_information15_o                  => per_spp_shd.g_old_rec.information15
408       ,p_information16_o                  => per_spp_shd.g_old_rec.information16
409       ,p_information17_o                  => per_spp_shd.g_old_rec.information17
410       ,p_information18_o                  => per_spp_shd.g_old_rec.information18
411       ,p_information19_o                  => per_spp_shd.g_old_rec.information19
412       ,p_information20_o                  => per_spp_shd.g_old_rec.information20
413       ,p_information21_o                  => per_spp_shd.g_old_rec.information21
414       ,p_information22_o                  => per_spp_shd.g_old_rec.information22
415       ,p_information23_o                  => per_spp_shd.g_old_rec.information23
416       ,p_information24_o                  => per_spp_shd.g_old_rec.information24
417       ,p_information25_o                  => per_spp_shd.g_old_rec.information25
418       ,p_information26_o                  => per_spp_shd.g_old_rec.information26
419       ,p_information27_o                  => per_spp_shd.g_old_rec.information27
420       ,p_information28_o                  => per_spp_shd.g_old_rec.information28
421       ,p_information29_o                  => per_spp_shd.g_old_rec.information29
422       ,p_information30_o                  => per_spp_shd.g_old_rec.information30
423       ,p_information_category_o           => per_spp_shd.g_old_rec.information_category
424       ,p_object_version_number_o
425       => per_spp_shd.g_old_rec.object_version_number
426       );
427     --
428   exception
429     --
430     when hr_api.cannot_find_prog_unit then
431       --
432       hr_api.cannot_find_prog_unit_error
433         (p_module_name => 'PER_SPINAL_POINT_PLACEMENTS_F'
434         ,p_hook_type   => 'AD');
435       --
436   end;
437   --
438   hr_utility.set_location(' Leaving:'||l_proc, 10);
439 End post_delete;
440 --
441 -- ----------------------------------------------------------------------------
442 -- |---------------------------------< del >----------------------------------|
443 -- ----------------------------------------------------------------------------
444 Procedure del
445   (p_effective_date in     date
446   ,p_datetrack_mode in     varchar2
447   ,p_rec            in out nocopy per_spp_shd.g_rec_type
448   ) is
449 --
450   l_proc			varchar2(72) := g_package||'del';
451   l_validation_start_date	date;
452   l_validation_end_date		date;
453 --
454 Begin
455   hr_utility.set_location('Entering:'||l_proc, 5);
456   --
457   -- Ensure that the DateTrack delete mode is valid
458   --
459   dt_api.validate_dt_del_mode(p_datetrack_mode => p_datetrack_mode);
460   --
461   -- We must lock the row which we need to delete.
462   --
463   per_spp_shd.lck
464     (p_effective_date                   => p_effective_date
465     ,p_datetrack_mode                   => p_datetrack_mode
466     ,p_placement_id                     => p_rec.placement_id
467     ,p_object_version_number            => p_rec.object_version_number
468     ,p_validation_start_date            => l_validation_start_date
469     ,p_validation_end_date              => l_validation_end_date
470     );
471   --
472   -- Call the supporting delete validate operation
473   --
474   per_spp_bus.delete_validate
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   -- Call the supporting pre-delete operation
483   --
484   per_spp_del.pre_delete
485     (p_rec                              => p_rec
486     ,p_effective_date                   => p_effective_date
487     ,p_datetrack_mode                   => p_datetrack_mode
488     ,p_validation_start_date            => l_validation_start_date
489     ,p_validation_end_date              => l_validation_end_date
490     );
491   --
492   -- Delete the row.
493   --
494   per_spp_del.delete_dml
495     (p_rec                              => p_rec
496     ,p_effective_date                   => p_effective_date
497     ,p_datetrack_mode                   => p_datetrack_mode
498     ,p_validation_start_date            => l_validation_start_date
499     ,p_validation_end_date              => l_validation_end_date
500     );
501   -- Call the supporting post-delete operation
502   --
503 
504   per_spp_del.post_delete
505     (p_rec                              => p_rec
506     ,p_effective_date                   => p_effective_date
507     ,p_datetrack_mode                   => p_datetrack_mode
508     ,p_validation_start_date            => l_validation_start_date
509     ,p_validation_end_date              => l_validation_end_date
510     );
511 
512   --
513   hr_utility.set_location(' Leaving:'||l_proc, 5);
514 End del;
515 --
516 -- ----------------------------------------------------------------------------
517 -- |--------------------------------< del >-----------------------------------|
518 -- ----------------------------------------------------------------------------
519 Procedure del
520   (p_effective_date                   in     date
521   ,p_datetrack_mode                   in     varchar2
522   ,p_placement_id                     in     number
523   ,p_object_version_number            in out nocopy number
524   ,p_effective_start_date                out nocopy date
525   ,p_effective_end_date	                 out nocopy date
526   ) is
527 --
528   l_rec		per_spp_shd.g_rec_type;
529   l_proc	varchar2(72) := g_package||'del';
530 --
531 Begin
532   hr_utility.set_location('Entering:'||l_proc, 5);
533   --
534   -- As the delete procedure accepts a plsql record structure we do need to
535   -- convert the  arguments into the record structure.
536   -- We don't need to call the supplied conversion argument routine as we
537   -- only need a few attributes.
538   --
539   l_rec.placement_id		:= p_placement_id;
540   l_rec.object_version_number 	:= p_object_version_number;
541   --
542   -- Having converted the arguments into the per_spp_rec
543   -- plsql record structure we must call the corresponding entity
544   -- business process
545   --
546   per_spp_del.del
547      (p_effective_date
548      ,p_datetrack_mode
549      ,l_rec
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 per_spp_del;