DBA Data[Home] [Help]

PACKAGE BODY: APPS.PER_RTL_DEL

Source


1 Package Body per_rtl_del as
2 /* $Header: pertlrhi.pkb 120.0 2005/05/31 19:57:25 appldev noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |                     Private Global Definitions                           |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package  varchar2(33)	:= '  per_rtl_del.';  -- Global package name
9 --
10 -- ----------------------------------------------------------------------------
11 -- |------------------------------< delete_dml >------------------------------|
12 -- ----------------------------------------------------------------------------
13 -- {Start Of Comments}
14 --
15 -- Description:
16 --   This procedure controls the actual dml delete logic. The functions of
17 --   this procedure are as follows:
18 --   1) To delete the specified row from the schema using the primary key in
19 --      the predicates.
20 --   2) To trap any constraint violations that may have occurred.
21 --   3) To raise any other errors.
22 --
23 -- Pre Conditions:
24 --   This is an internal private procedure which must be called from the del
25 --   procedure.
26 --
27 -- In Parameters:
28 --   A Pl/Sql record structre.
29 --
30 -- Post Success:
31 --   The specified row will be delete from the schema.
32 --
33 -- Post Failure:
34 --   If a child integrity constraint violation is raised the
35 --   constraint_error procedure will be called.
36 --
37 -- Developer Implementation Notes:
38 --   None.
39 --
40 -- Access Status:
41 --   Internal Table Handler Use Only.
42 --
43 -- {End Of Comments}
44 -- ----------------------------------------------------------------------------
45 Procedure delete_dml(p_rec in per_rtl_shd.g_rec_type) is
46 --
47   l_proc  varchar2(72) := g_package||'delete_dml';
48 --
49 Begin
50   hr_utility.set_location('Entering:'||l_proc, 5);
51   --
52   -- Delete the per_rating_levels row.
53   --
54   delete from per_rating_levels
55   where rating_level_id = p_rec.rating_level_id;
56   --
57   hr_utility.set_location(' Leaving:'||l_proc, 10);
58 --
59 Exception
60   When hr_api.child_integrity_violated then
61     -- Child integrity has been violated
62     per_rtl_shd.constraint_error
63       (p_constraint_name => hr_api.strip_constraint_name(SQLERRM));
64   When Others Then
65     Raise;
66 End delete_dml;
67 --
68 -- ----------------------------------------------------------------------------
69 -- |------------------------------< pre_delete >------------------------------|
70 -- ----------------------------------------------------------------------------
71 -- {Start Of Comments}
72 --
73 -- Description:
74 --   This private procedure contains any processing which is required before
75 --   the delete dml.
76 --
77 -- Pre Conditions:
78 --   This is an internal procedure which is called from the del procedure.
79 --
80 -- In Parameters:
81 --   A Pl/Sql record structre.
82 --
83 -- Post Success:
84 --   Processing continues.
85 --
86 -- Post Failure:
87 --   If an error has occurred, an error message and exception will be raised
88 --   but not handled.
89 --
90 -- Developer Implementation Notes:
91 --   Any pre-processing required before the delete dml is issued should be
92 --   coded within this procedure. It is important to note that any 3rd party
93 --   maintenance should be reviewed before placing in this procedure.
94 --
95 -- Access Status:
96 --   Internal Table Handler Use Only.
97 --
98 -- {End Of Comments}
99 -- ----------------------------------------------------------------------------
100 Procedure pre_delete(p_rec in per_rtl_shd.g_rec_type) is
101 --
102   l_proc  varchar2(72) := g_package||'pre_delete';
103 --
104 Begin
105   hr_utility.set_location('Entering:'||l_proc, 5);
106   --
107   hr_utility.set_location(' Leaving:'||l_proc, 10);
108 End pre_delete;
109 --
110 -- ----------------------------------------------------------------------------
111 -- |-----------------------------< post_delete >------------------------------|
112 -- ----------------------------------------------------------------------------
113 -- {Start Of Comments}
114 --
115 -- Description:
116 --   This private procedure contains any processing which is required after the
117 --   delete dml.
118 --
119 -- Pre Conditions:
120 --   This is an internal procedure which is called from the del procedure.
121 --
122 -- In Parameters:
123 --   A Pl/Sql record structre.
124 --
125 -- Post Success:
126 --   Processing continues.
127 --
128 -- Post Failure:
129 --   If an error has occurred, an error message and exception will be raised
130 --   but not handled.
131 --
132 -- Developer Implementation Notes:
133 --   Any post-processing required after the delete dml is issued should be
134 --   coded within this procedure. It is important to note that any 3rd party
135 --   maintenance should be reviewed before placing in this procedure.
136 --
137 -- Access Status:
138 --   Internal table Handler Use Only.
139 --
140 -- {End Of Comments}
141 -- ----------------------------------------------------------------------------
142 Procedure post_delete(p_rec in per_rtl_shd.g_rec_type) is
143 --
144   l_proc  varchar2(72) := g_package||'post_delete';
145 --
146 Begin
147   hr_utility.set_location('Entering:'||l_proc, 5);
148   --
149   -- This is a hook point and the user hook for post_delete is called here.
150   --
151   begin
152      per_rtl_rkd.after_delete	(
153       p_rating_level_id         => p_rec.rating_level_id                      ,
154       p_business_group_id_o     => per_rtl_shd.g_old_rec.business_group_id    ,
155       p_object_version_number_o => per_rtl_shd.g_old_rec.object_version_number,
156       p_step_value_o            => per_rtl_shd.g_old_rec.step_value           ,
157       p_name_o                  => per_rtl_shd.g_old_rec.name                 ,
158       p_rating_scale_id_o       => per_rtl_shd.g_old_rec.rating_scale_id      ,
159       p_competence_id_o         => per_rtl_shd.g_old_rec.competence_id        ,
160       p_behavioural_indicator_o => per_rtl_shd.g_old_rec.behavioural_indicator,
161       p_attribute_category_o    => per_rtl_shd.g_old_rec.attribute_category   ,
162       p_attribute1_o            => per_rtl_shd.g_old_rec.attribute1   ,
163       p_attribute2_o            => per_rtl_shd.g_old_rec.attribute2   ,
164       p_attribute3_o            => per_rtl_shd.g_old_rec.attribute3   ,
165       p_attribute4_o            => per_rtl_shd.g_old_rec.attribute4   ,
166       p_attribute5_o            => per_rtl_shd.g_old_rec.attribute5   ,
167       p_attribute6_o            => per_rtl_shd.g_old_rec.attribute6   ,
168       p_attribute7_o            => per_rtl_shd.g_old_rec.attribute7   ,
169       p_attribute8_o            => per_rtl_shd.g_old_rec.attribute8   ,
170       p_attribute9_o            => per_rtl_shd.g_old_rec.attribute9   ,
171       p_attribute10_o           => per_rtl_shd.g_old_rec.attribute10  ,
172       p_attribute11_o           => per_rtl_shd.g_old_rec.attribute11  ,
173       p_attribute12_o           => per_rtl_shd.g_old_rec.attribute12  ,
174       p_attribute13_o           => per_rtl_shd.g_old_rec.attribute13  ,
175       p_attribute14_o           => per_rtl_shd.g_old_rec.attribute14  ,
176       p_attribute15_o           => per_rtl_shd.g_old_rec.attribute15  ,
177       p_attribute16_o           => per_rtl_shd.g_old_rec.attribute16  ,
178       p_attribute17_o           => per_rtl_shd.g_old_rec.attribute17  ,
179       p_attribute18_o           => per_rtl_shd.g_old_rec.attribute18  ,
180       p_attribute19_o           => per_rtl_shd.g_old_rec.attribute19  ,
181       p_attribute20_o           => per_rtl_shd.g_old_rec.attribute20  );
182      exception
183         when hr_api.cannot_find_prog_unit then
184              hr_api.cannot_find_prog_unit_error
185 		 (	p_module_name => 'PER_RATING_LEVELS'
186 		 	,p_hook_type  => 'AD'
187 	        );
188   end;
189   -- End of API User Hook for post_delete.
190   --
191   hr_utility.set_location(' Leaving:'||l_proc, 10);
192 End post_delete;
193 --
194 -- ----------------------------------------------------------------------------
195 -- |---------------------------------< del >----------------------------------|
196 -- ----------------------------------------------------------------------------
197 Procedure del
198   (
199   p_rec	      in per_rtl_shd.g_rec_type,
200   p_validate  in boolean default false
201   ) is
202 --
203   l_proc  varchar2(72) := g_package||'del';
204 --
205 Begin
206   hr_utility.set_location('Entering:'||l_proc, 5);
207   --
208   -- Determine if the business process is to be validated.
209   --
210   If p_validate then
211     --
212     -- Issue the savepoint.
213     --
214     SAVEPOINT del_per_rtl;
215   End If;
216   --
217   -- We must lock the row which we need to delete.
218   --
219   per_rtl_shd.lck
220 	(
221 	p_rec.rating_level_id,
222 	p_rec.object_version_number
223 	);
224   --
225   -- Call the supporting delete validate operation
226   --
227   per_rtl_bus.delete_validate(p_rec);
228   --
229   -- Call the supporting pre-delete operation
230   --
231   pre_delete(p_rec);
232   --
233   -- Delete the row.
234   --
235   delete_dml(p_rec);
236   --
237   -- Call the supporting post-delete operation
238   --
239   post_delete(p_rec);
240   --
241   -- If we are validating then raise the Validate_Enabled exception
242   --
243   If p_validate then
244     Raise HR_Api.Validate_Enabled;
245   End If;
246   --
247   hr_utility.set_location(' Leaving:'||l_proc, 10);
248 Exception
249   When HR_Api.Validate_Enabled Then
250     --
251     -- As the Validate_Enabled exception has been raised
252     -- we must rollback to the savepoint
253     --
254     ROLLBACK TO del_per_rtl;
255 End del;
256 --
257 -- ----------------------------------------------------------------------------
258 -- |---------------------------------< del >----------------------------------|
259 -- ----------------------------------------------------------------------------
260 Procedure del
261   (
262   p_rating_level_id                    in number,
263   p_object_version_number              in number,
264   p_validate                           in boolean default false
265   ) is
266 --
267   l_rec	  per_rtl_shd.g_rec_type;
268   l_proc  varchar2(72) := g_package||'del';
269 --
270 Begin
271   hr_utility.set_location('Entering:'||l_proc, 5);
272   --
273   -- As the delete procedure accepts a plsql record structure we do need to
274   -- convert the  arguments into the record structure.
275   -- We don't need to call the supplied conversion argument routine as we
276   -- only need a few attributes.
277   --
278   l_rec.rating_level_id:= p_rating_level_id;
279   l_rec.object_version_number := p_object_version_number;
280   --
281   -- Having converted the arguments into the per_rtl_rec
282   -- plsql record structure we must call the corresponding entity
283   -- business process
284   --
285   del(l_rec, p_validate);
286   --
287   hr_utility.set_location(' Leaving:'||l_proc, 10);
290 end per_rtl_del;
288 End del;
289 --