DBA Data[Home] [Help]

PACKAGE BODY: APPS.PQH_ACC_DEL

Source


1 Package Body pqh_acc_del as
2 /* $Header: pqaccrhi.pkb 115.4 2004/03/15 23:54:54 svorugan noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |                     Private Global Definitions                           |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package  varchar2(33) := '  pqh_acc_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 pqh_acc_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 pqh_accommodations_f
72     where       accommodation_id = p_rec.accommodation_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 pqh_accommodations_f
83     where        accommodation_id = p_rec.accommodation_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 pqh_acc_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   pqh_acc_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 pqh_acc_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       := pqh_acc_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     pqh_acc_shd.upd_effective_end_date
180       (p_effective_date         => p_effective_date
181       ,p_base_key_value         => p_rec.accommodation_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 pqh_acc_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   pqh_acc_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 pqh_acc_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     pqh_acc_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_accommodation_id
311       => p_rec.accommodation_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_accommodation_name_o
317       => pqh_acc_shd.g_old_rec.accommodation_name
318       ,p_effective_start_date_o
319       => pqh_acc_shd.g_old_rec.effective_start_date
320       ,p_effective_end_date_o
321       => pqh_acc_shd.g_old_rec.effective_end_date
322       ,p_business_group_id_o
323       => pqh_acc_shd.g_old_rec.business_group_id
324       ,p_location_id_o
325       => pqh_acc_shd.g_old_rec.location_id
326       ,p_accommodation_desc_o
327       => pqh_acc_shd.g_old_rec.accommodation_desc
328       ,p_accommodation_type_o
329       => pqh_acc_shd.g_old_rec.accommodation_type
330       ,p_style_o
331       => pqh_acc_shd.g_old_rec.style
332       ,p_address_line_1_o
333       => pqh_acc_shd.g_old_rec.address_line_1
334       ,p_address_line_2_o
335       => pqh_acc_shd.g_old_rec.address_line_2
336       ,p_address_line_3_o
337       => pqh_acc_shd.g_old_rec.address_line_3
338       ,p_town_or_city_o
339       => pqh_acc_shd.g_old_rec.town_or_city
340       ,p_country_o
341       => pqh_acc_shd.g_old_rec.country
342       ,p_postal_code_o
343       => pqh_acc_shd.g_old_rec.postal_code
344       ,p_region_1_o
345       => pqh_acc_shd.g_old_rec.region_1
346       ,p_region_2_o
347       => pqh_acc_shd.g_old_rec.region_2
348       ,p_region_3_o
349       => pqh_acc_shd.g_old_rec.region_3
350       ,p_telephone_number_1_o
351       => pqh_acc_shd.g_old_rec.telephone_number_1
352       ,p_telephone_number_2_o
353       => pqh_acc_shd.g_old_rec.telephone_number_2
354       ,p_telephone_number_3_o
355       => pqh_acc_shd.g_old_rec.telephone_number_3
356       ,p_floor_number_o
357       => pqh_acc_shd.g_old_rec.floor_number
358       ,p_floor_area_o
359       => pqh_acc_shd.g_old_rec.floor_area
360       ,p_floor_area_measure_unit_o
361       => pqh_acc_shd.g_old_rec.floor_area_measure_unit
362       ,p_main_rooms_o
363       => pqh_acc_shd.g_old_rec.main_rooms
364       ,p_family_size_o
365       => pqh_acc_shd.g_old_rec.family_size
366       ,p_suitability_disabled_o
367       => pqh_acc_shd.g_old_rec.suitability_disabled
368       ,p_rental_value_o
369       => pqh_acc_shd.g_old_rec.rental_value
370       ,p_rental_value_currency_o
371       => pqh_acc_shd.g_old_rec.rental_value_currency
372       ,p_owner_o
373       => pqh_acc_shd.g_old_rec.owner
374       ,p_comments_o
375       => pqh_acc_shd.g_old_rec.comments
376       ,p_information_category_o
377       => pqh_acc_shd.g_old_rec.information_category
378       ,p_information1_o
379       => pqh_acc_shd.g_old_rec.information1
380       ,p_information2_o
381       => pqh_acc_shd.g_old_rec.information2
382       ,p_information3_o
383       => pqh_acc_shd.g_old_rec.information3
384       ,p_information4_o
385       => pqh_acc_shd.g_old_rec.information4
386       ,p_information5_o
387       => pqh_acc_shd.g_old_rec.information5
388       ,p_information6_o
389       => pqh_acc_shd.g_old_rec.information6
390       ,p_information7_o
391       => pqh_acc_shd.g_old_rec.information7
392       ,p_information8_o
393       => pqh_acc_shd.g_old_rec.information8
394       ,p_information9_o
395       => pqh_acc_shd.g_old_rec.information9
396       ,p_information10_o
397       => pqh_acc_shd.g_old_rec.information10
398       ,p_information11_o
399       => pqh_acc_shd.g_old_rec.information11
400       ,p_information12_o
401       => pqh_acc_shd.g_old_rec.information12
402       ,p_information13_o
403       => pqh_acc_shd.g_old_rec.information13
404       ,p_information14_o
405       => pqh_acc_shd.g_old_rec.information14
406       ,p_information15_o
407       => pqh_acc_shd.g_old_rec.information15
408       ,p_information16_o
409       => pqh_acc_shd.g_old_rec.information16
410       ,p_information17_o
411       => pqh_acc_shd.g_old_rec.information17
412       ,p_information18_o
413       => pqh_acc_shd.g_old_rec.information18
414       ,p_information19_o
415       => pqh_acc_shd.g_old_rec.information19
416       ,p_information20_o
417       => pqh_acc_shd.g_old_rec.information20
418       ,p_information21_o
419       => pqh_acc_shd.g_old_rec.information21
420       ,p_information22_o
421       => pqh_acc_shd.g_old_rec.information22
422       ,p_information23_o
423       => pqh_acc_shd.g_old_rec.information23
424       ,p_information24_o
425       => pqh_acc_shd.g_old_rec.information24
426       ,p_information25_o
427       => pqh_acc_shd.g_old_rec.information25
428       ,p_information26_o
429       => pqh_acc_shd.g_old_rec.information26
430       ,p_information27_o
431       => pqh_acc_shd.g_old_rec.information27
432       ,p_information28_o
433       => pqh_acc_shd.g_old_rec.information28
434       ,p_information29_o
435       => pqh_acc_shd.g_old_rec.information29
436       ,p_information30_o
437       => pqh_acc_shd.g_old_rec.information30
438       ,p_attribute_category_o
439       => pqh_acc_shd.g_old_rec.attribute_category
440       ,p_attribute1_o
441       => pqh_acc_shd.g_old_rec.attribute1
442       ,p_attribute2_o
443       => pqh_acc_shd.g_old_rec.attribute2
444       ,p_attribute3_o
445       => pqh_acc_shd.g_old_rec.attribute3
446       ,p_attribute4_o
447       => pqh_acc_shd.g_old_rec.attribute4
448       ,p_attribute5_o
449       => pqh_acc_shd.g_old_rec.attribute5
450       ,p_attribute6_o
451       => pqh_acc_shd.g_old_rec.attribute6
452       ,p_attribute7_o
453       => pqh_acc_shd.g_old_rec.attribute7
454       ,p_attribute8_o
455       => pqh_acc_shd.g_old_rec.attribute8
456       ,p_attribute9_o
457       => pqh_acc_shd.g_old_rec.attribute9
458       ,p_attribute10_o
459       => pqh_acc_shd.g_old_rec.attribute10
460       ,p_attribute11_o
461       => pqh_acc_shd.g_old_rec.attribute11
462       ,p_attribute12_o
463       => pqh_acc_shd.g_old_rec.attribute12
464       ,p_attribute13_o
465       => pqh_acc_shd.g_old_rec.attribute13
466       ,p_attribute14_o
467       => pqh_acc_shd.g_old_rec.attribute14
468       ,p_attribute15_o
469       => pqh_acc_shd.g_old_rec.attribute15
470       ,p_attribute16_o
471       => pqh_acc_shd.g_old_rec.attribute16
472       ,p_attribute17_o
473       => pqh_acc_shd.g_old_rec.attribute17
474       ,p_attribute18_o
475       => pqh_acc_shd.g_old_rec.attribute18
476       ,p_attribute19_o
477       => pqh_acc_shd.g_old_rec.attribute19
478       ,p_attribute20_o
479       => pqh_acc_shd.g_old_rec.attribute20
480       ,p_attribute21_o
481       => pqh_acc_shd.g_old_rec.attribute21
482       ,p_attribute22_o
483       => pqh_acc_shd.g_old_rec.attribute22
484       ,p_attribute23_o
485       => pqh_acc_shd.g_old_rec.attribute23
486       ,p_attribute24_o
487       => pqh_acc_shd.g_old_rec.attribute24
488       ,p_attribute25_o
489       => pqh_acc_shd.g_old_rec.attribute25
490       ,p_attribute26_o
491       => pqh_acc_shd.g_old_rec.attribute26
492       ,p_attribute27_o
493       => pqh_acc_shd.g_old_rec.attribute27
494       ,p_attribute28_o
495       => pqh_acc_shd.g_old_rec.attribute28
496       ,p_attribute29_o
497       => pqh_acc_shd.g_old_rec.attribute29
498       ,p_attribute30_o
499       => pqh_acc_shd.g_old_rec.attribute30
500       ,p_object_version_number_o
501       => pqh_acc_shd.g_old_rec.object_version_number
502       );
503     --
504   exception
505     --
506     when hr_api.cannot_find_prog_unit then
507       --
508       hr_api.cannot_find_prog_unit_error
509         (p_module_name => 'PQH_ACCOMMODATIONS_F'
510         ,p_hook_type   => 'AD');
511       --
512   end;
513   --
514   hr_utility.set_location(' Leaving:'||l_proc, 10);
515 End post_delete;
516 --
517 -- ----------------------------------------------------------------------------
518 -- |---------------------------------< del >----------------------------------|
519 -- ----------------------------------------------------------------------------
520 Procedure del
521   (p_effective_date in     date
522   ,p_datetrack_mode in     varchar2
523   ,p_rec            in out nocopy pqh_acc_shd.g_rec_type
524   ) is
525 --
526   l_proc                        varchar2(72) := g_package||'del';
527   l_validation_start_date       date;
528   l_validation_end_date         date;
529 --
530 Begin
531   hr_utility.set_location('Entering:'||l_proc, 5);
532   --
533   -- Ensure that the DateTrack delete mode is valid
534   --
535   dt_api.validate_dt_del_mode(p_datetrack_mode => p_datetrack_mode);
536   --
537   -- We must lock the row which we need to delete.
538   --
539   pqh_acc_shd.lck
540     (p_effective_date                   => p_effective_date
541     ,p_datetrack_mode                   => p_datetrack_mode
542     ,p_accommodation_id                 => p_rec.accommodation_id
543     ,p_object_version_number            => p_rec.object_version_number
544     ,p_validation_start_date            => l_validation_start_date
545     ,p_validation_end_date              => l_validation_end_date
546     );
547   --
548   -- Call the supporting delete validate operation
549   --
550   pqh_acc_bus.delete_validate
551     (p_rec                              => p_rec
552     ,p_effective_date                   => p_effective_date
553     ,p_datetrack_mode                   => p_datetrack_mode
554     ,p_validation_start_date            => l_validation_start_date
555     ,p_validation_end_date              => l_validation_end_date
556     );
557   --
558   -- Call to raise any errors on multi-message list
559   hr_multi_message.end_validation_set;
560   --
561   -- Call the supporting pre-delete operation
562   --
563   pqh_acc_del.pre_delete
564     (p_rec                              => p_rec
565     ,p_effective_date                   => p_effective_date
566     ,p_datetrack_mode                   => p_datetrack_mode
567     ,p_validation_start_date            => l_validation_start_date
568     ,p_validation_end_date              => l_validation_end_date
569     );
570   --
571   -- Delete the row.
572   --
573   pqh_acc_del.delete_dml
574     (p_rec                              => p_rec
575     ,p_effective_date                   => p_effective_date
576     ,p_datetrack_mode                   => p_datetrack_mode
577     ,p_validation_start_date            => l_validation_start_date
578     ,p_validation_end_date              => l_validation_end_date
579     );
580   -- Call the supporting post-delete operation
581   --
582   pqh_acc_del.post_delete
583     (p_rec                              => p_rec
584     ,p_effective_date                   => p_effective_date
585     ,p_datetrack_mode                   => p_datetrack_mode
586     ,p_validation_start_date            => l_validation_start_date
587     ,p_validation_end_date              => l_validation_end_date
588     );
589   --
590   -- Call to raise any errors on multi-message list
591   hr_multi_message.end_validation_set;
592   --
593   hr_utility.set_location(' Leaving:'||l_proc, 5);
594 End del;
595 --
596 -- ----------------------------------------------------------------------------
597 -- |--------------------------------< del >-----------------------------------|
598 -- ----------------------------------------------------------------------------
599 Procedure del
600   (p_effective_date                   in     date
601   ,p_datetrack_mode                   in     varchar2
602   ,p_accommodation_id                 in     number
603   ,p_object_version_number            in out nocopy number
604   ,p_effective_start_date                out nocopy date
605   ,p_effective_end_date                  out nocopy date
606   ) is
607 --
608   l_rec         pqh_acc_shd.g_rec_type;
609   l_proc        varchar2(72) := g_package||'del';
610 --
611 Begin
612   hr_utility.set_location('Entering:'||l_proc, 5);
613   --
614   -- As the delete procedure accepts a plsql record structure we do need to
615   -- convert the  arguments into the record structure.
616   -- We don't need to call the supplied conversion argument routine as we
617   -- only need a few attributes.
618   --
619   l_rec.accommodation_id          := p_accommodation_id;
620   l_rec.object_version_number     := p_object_version_number;
621   --
622   -- Having converted the arguments into the pqh_acc_rec
623   -- plsql record structure we must call the corresponding entity
624   -- business process
625   --
626   pqh_acc_del.del
627      (p_effective_date
628      ,p_datetrack_mode
629      ,l_rec
630      );
631   --
632   --
633   -- Set the out arguments
634   --
635   p_object_version_number            := l_rec.object_version_number;
636   p_effective_start_date             := l_rec.effective_start_date;
637   p_effective_end_date               := l_rec.effective_end_date;
638   --
639   hr_utility.set_location(' Leaving:'||l_proc, 10);
640 End del;
641 --
642 end pqh_acc_del;