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 --