1 Package Body per_par_del as
2 /* $Header: peparrhi.pkb 120.1 2007/06/20 07:48:26 rapandi ship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- | Private Global Definitions |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package varchar2(33) := ' per_par_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_par_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_participants row.
53 --
54 delete from per_participants
55 where participant_id = p_rec.participant_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_par_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_par_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_par_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_par_rkd.after_delete (
153 p_participant_id => p_rec.participant_id ,
154 p_business_group_id_o => per_par_shd.g_old_rec.business_group_id ,
155 p_object_version_number_o => per_par_shd.g_old_rec.object_version_number,
156 p_questionnaire_template_id_o => per_par_shd.g_old_rec.questionnaire_template_id,
157 p_participation_in_table_o =>
158 per_par_shd.g_old_rec.participation_in_table ,
159 p_participation_in_column_o =>
160 per_par_shd.g_old_rec.participation_in_column ,
161 p_participation_in_id_o => per_par_shd.g_old_rec.participation_in_id ,
162 p_participation_status_o => per_par_shd.g_old_rec.participation_status ,
163 p_participation_type_o => per_par_shd.g_old_rec.participation_type ,
164 p_last_notified_date_o => per_par_shd.g_old_rec.last_notified_date ,
165 p_date_completed_o => per_par_shd.g_old_rec.date_completed ,
166 p_comments_o => per_par_shd.g_old_rec.comments ,
167 p_person_id_o => per_par_shd.g_old_rec.person_id ,
168 p_attribute_category_o => per_par_shd.g_old_rec.attribute_category ,
169 p_attribute1_o => per_par_shd.g_old_rec.attribute1 ,
170 p_attribute2_o => per_par_shd.g_old_rec.attribute2 ,
171 p_attribute3_o => per_par_shd.g_old_rec.attribute3 ,
172 p_attribute4_o => per_par_shd.g_old_rec.attribute4 ,
173 p_attribute5_o => per_par_shd.g_old_rec.attribute5 ,
174 p_attribute6_o => per_par_shd.g_old_rec.attribute6 ,
175 p_attribute7_o => per_par_shd.g_old_rec.attribute7 ,
176 p_attribute8_o => per_par_shd.g_old_rec.attribute8 ,
177 p_attribute9_o => per_par_shd.g_old_rec.attribute9 ,
178 p_attribute10_o => per_par_shd.g_old_rec.attribute10 ,
179 p_attribute11_o => per_par_shd.g_old_rec.attribute11 ,
180 p_attribute12_o => per_par_shd.g_old_rec.attribute12 ,
181 p_attribute13_o => per_par_shd.g_old_rec.attribute13 ,
182 p_attribute14_o => per_par_shd.g_old_rec.attribute14 ,
183 p_attribute15_o => per_par_shd.g_old_rec.attribute15 ,
184 p_attribute16_o => per_par_shd.g_old_rec.attribute16 ,
185 p_attribute17_o => per_par_shd.g_old_rec.attribute17 ,
186 p_attribute18_o => per_par_shd.g_old_rec.attribute18 ,
187 p_attribute19_o => per_par_shd.g_old_rec.attribute19 ,
188 p_attribute20_o => per_par_shd.g_old_rec.attribute20 );
189 exception
190 when hr_api.cannot_find_prog_unit then
191 hr_api.cannot_find_prog_unit_error
192 ( p_module_name => 'PER_PARTICIPANTS'
193 ,p_hook_type => 'AD'
194 );
195 end;
196 -- End of API User Hook for post_delete.
197 --
198 hr_utility.set_location(' Leaving:'||l_proc, 10);
199 End post_delete;
200 --
201 -- ----------------------------------------------------------------------------
202 -- |---------------------------------< del >----------------------------------|
203 -- ----------------------------------------------------------------------------
204 Procedure del
205 (
206 p_rec in per_par_shd.g_rec_type,
207 p_validate in boolean default false
208 ) is
209 --
210 l_proc varchar2(72) := g_package||'del';
211 --
212 Begin
213 hr_utility.set_location('Entering:'||l_proc, 5);
214 --
215 -- Determine if the business process is to be validated.
216 --
217 If p_validate then
218 --
219 -- Issue the savepoint.
220 --
221 SAVEPOINT del_per_par;
222 End If;
223 --
224 -- We must lock the row which we need to delete.
225 --
226 per_par_shd.lck
227 (
228 p_rec.participant_id,
229 p_rec.object_version_number
230 );
231 --
232 -- Call the supporting delete validate operation
233 --
234 per_par_bus.delete_validate(p_rec);
235
236 --
237 hr_multi_message.end_validation_set;
238 --
239
240 --
241 -- Call the supporting pre-delete operation
242 --
243 pre_delete(p_rec);
244 --
245 -- Delete the row.
246 --
247 delete_dml(p_rec);
248 --
249 -- Call the supporting post-delete operation
250 --
251 post_delete(p_rec);
252
253 --
254 hr_multi_message.end_validation_set;
255 --
256
257 --
258 -- If we are validating then raise the Validate_Enabled exception
259 --
260 If p_validate then
261 Raise HR_Api.Validate_Enabled;
262 End If;
263 --
264 hr_utility.set_location(' Leaving:'||l_proc, 10);
265 Exception
266 When HR_Api.Validate_Enabled Then
267 --
268 -- As the Validate_Enabled exception has been raised
269 -- we must rollback to the savepoint
270 --
271 ROLLBACK TO del_per_par;
272 End del;
273 --
274 -- ----------------------------------------------------------------------------
275 -- |---------------------------------< del >----------------------------------|
276 -- ----------------------------------------------------------------------------
277 Procedure del
278 (
279 p_participant_id in number,
280 p_object_version_number in number,
281 p_validate in boolean default false
282 ) is
283 --
284 l_rec per_par_shd.g_rec_type;
285 l_proc varchar2(72) := g_package||'del';
286 --
287 Begin
288 hr_utility.set_location('Entering:'||l_proc, 5);
289 --
290 -- As the delete procedure accepts a plsql record structure we do need to
291 -- convert the arguments into the record structure.
292 -- We don't need to call the supplied conversion argument routine as we
293 -- only need a few attributes.
294 --
295 l_rec.participant_id:= p_participant_id;
296 l_rec.object_version_number := p_object_version_number;
297 --
298 -- Having converted the arguments into the per_par_rec
299 -- plsql record structure we must call the corresponding entity
300 -- business process
301 --
302 del(l_rec, p_validate);
303 --
304 hr_utility.set_location(' Leaving:'||l_proc, 10);
305 End del;
306 --
307 end per_par_del;