DBA Data[Home] [Help]

PACKAGE BODY: APPS.PER_POS_DEL

Source


1 Package Body per_pos_del as
2 /* $Header: peposrhi.pkb 120.0.12010000.1 2008/07/28 05:23:58 appldev ship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |                     Private Global Definitions                           |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package  varchar2(33)	:= '  per_pos_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 this
17 --   procedure are as follows:
18 --   1) To set and unset the g_api_dml status as required (as we are about to
19 --      perform dml).
20 --   2) To delete the specified row from the schema using the primary key in
21 --      the predicates.
22 --   3) To trap any constraint violations that may have occurred.
23 --   4) To raise any other errors.
24 --
25 -- Pre Conditions:
26 --   This is an internal private procedure which must be called from the del
27 --   procedure.
28 --
29 -- In Arguments:
30 --   A Pl/Sql record structre.
31 --
32 -- Post Success:
33 --   The specified row will be delete from the schema.
34 --
35 -- Post Failure:
36 --   On the delete dml failure it is important to note that we always reset the
37 --   g_api_dml status to false.
38 --   If a child integrity constraint violation is raised the
39 --   constraint_error procedure will be called.
40 --   If any other error is reported, the error will be raised after the
41 --   g_api_dml status is reset.
42 --
43 -- Developer Implementation Notes:
44 --   None.
45 --
46 -- Access Status:
47 --   Internal Table Handler Use Only.
48 --
49 -- {End Of Comments}
50 -- ----------------------------------------------------------------------------
51 Procedure delete_dml(p_rec in per_pos_shd.g_rec_type) is
52 --
53   l_proc  varchar2(72) := g_package||'delete_dml';
54 --
55 Begin
56   hr_utility.set_location('Entering:'||l_proc, 5);
57   --
58   per_pos_shd.g_api_dml := true;  -- Set the api dml status
59   --
60   -- Delete the per_all_positions row.
61   --
62   delete from per_all_positions
63   where position_id = p_rec.position_id;
64   --
65   per_pos_shd.g_api_dml := false;   -- Unset the api dml status
66   --
67   hr_utility.set_location(' Leaving:'||l_proc, 10);
68 --
69 Exception
70   When hr_api.child_integrity_violated then
71     -- Child integrity has been violated
72     per_pos_shd.g_api_dml := false;   -- Unset the api dml status
73     per_pos_shd.constraint_error
74       (p_constraint_name => hr_api.strip_constraint_name(SQLERRM));
75   When Others Then
76     per_pos_shd.g_api_dml := false;   -- Unset the api dml status
77     Raise;
78 End delete_dml;
79 --
80 -- ----------------------------------------------------------------------------
81 -- |------------------------------< pre_delete >------------------------------|
82 -- ----------------------------------------------------------------------------
83 -- {Start Of Comments}
84 --
85 -- Description:
86 --   This private procedure contains any processing which is required before
87 --   the delete dml.
88 --
89 -- Pre Conditions:
90 --   This is an internal procedure which is called from the del procedure.
91 --
92 -- In Arguments:
93 --   A Pl/Sql record structre.
94 --
95 -- Post Success:
96 --   Processing continues.
97 --
98 -- Post Failure:
99 --   If an error has occurred, an error message and exception will be raised
100 --   but not handled.
101 --
102 -- Developer Implementation Notes:
103 --   Any pre-processing required before the delete dml is issued should be
104 --   coded within this procedure. It is important to note that any 3rd party
105 --   maintenance should be reviewed before placing in this procedure.
106 --
107 -- Access Status:
108 --   Internal Table Handler Use Only.
109 --
110 -- {End Of Comments}
111 -- ----------------------------------------------------------------------------
112 Procedure pre_delete(p_rec in per_pos_shd.g_rec_type) is
113 --
114   l_proc  varchar2(72) := g_package||'pre_delete';
115 --
116 Begin
117   hr_utility.set_location('Entering:'||l_proc, 5);
118   --
119   hr_utility.set_location(' Leaving:'||l_proc, 10);
120 End pre_delete;
121 --
122 -- ----------------------------------------------------------------------------
123 -- |-----------------------------< post_delete >------------------------------|
124 -- ----------------------------------------------------------------------------
125 -- {Start Of Comments}
126 --
127 -- Description:
128 --   This private procedure contains any processing which is required after the
129 --   delete dml.
130 --
131 -- Pre Conditions:
132 --   This is an internal procedure which is called from the del procedure.
133 --
134 -- In Arguments:
135 --   A Pl/Sql record structre.
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 --   Any post-processing required after the delete dml is issued should be
146 --   coded within this procedure. It is important to note that any 3rd party
147 --   maintenance should be reviewed before placing in this procedure.
148 --
149 -- Access Status:
150 --   Internal table Handler Use Only.
151 --
152 -- {End Of Comments}
153 -- ----------------------------------------------------------------------------
154 Procedure post_delete(p_rec in per_pos_shd.g_rec_type) is
155 --
156   l_proc  varchar2(72) := g_package||'post_delete';
157 --
158 Begin
159   hr_utility.set_location('Entering:'||l_proc, 5);
160   --
161   -- Start of API User Hook for post_delete.
162   begin
163     per_pos_rkd.after_delete
164       (p_position_id                  => p_rec.position_id
165       ,p_business_group_id_o
166           => per_pos_shd.g_old_rec.business_group_id
167       ,p_job_id_o
168           => per_pos_shd.g_old_rec.job_id
169       ,p_organization_id_o
170           => per_pos_shd.g_old_rec.organization_id
171       ,p_successor_position_id_o
172           => per_pos_shd.g_old_rec.successor_position_id
173       ,p_relief_position_id_o
174           => per_pos_shd.g_old_rec.relief_position_id
175       ,p_location_id_o
176           => per_pos_shd.g_old_rec.location_id
177       ,p_position_definition_id_o
178           => per_pos_shd.g_old_rec.position_definition_id
179       ,p_date_effective_o
180           => per_pos_shd.g_old_rec.date_effective
181       ,p_comments_o
182           => per_pos_shd.g_old_rec.comments
183       ,p_date_end_o
184           => per_pos_shd.g_old_rec.date_end
185       ,p_frequency_o
186           => per_pos_shd.g_old_rec.frequency
187       ,p_name_o
188           => per_pos_shd.g_old_rec.name
189       ,p_probation_period_o
190           => per_pos_shd.g_old_rec.probation_period
191       ,p_probation_period_units_o
192           => per_pos_shd.g_old_rec.probation_period_units
193       ,p_replacement_required_flag_o
194           => per_pos_shd.g_old_rec.replacement_required_flag
195       ,p_time_normal_finish_o
196           => per_pos_shd.g_old_rec.time_normal_finish
197       ,p_time_normal_start_o
198           => per_pos_shd.g_old_rec.time_normal_start
199       ,p_status_o
200           => per_pos_shd.g_old_rec.status
201       ,p_working_hours_o
202           => per_pos_shd.g_old_rec.working_hours
203       ,p_request_id_o
204           => per_pos_shd.g_old_rec.request_id
205       ,p_program_application_id_o
206           => per_pos_shd.g_old_rec.program_application_id
207       ,p_program_id_o
208           => per_pos_shd.g_old_rec.program_id
209       ,p_program_update_date_o
210           => per_pos_shd.g_old_rec.program_update_date
211       ,p_attribute_category_o
212           => per_pos_shd.g_old_rec.attribute_category
213       ,p_attribute1_o
214           => per_pos_shd.g_old_rec.attribute1
215       ,p_attribute2_o
216           => per_pos_shd.g_old_rec.attribute2
217       ,p_attribute3_o
218           => per_pos_shd.g_old_rec.attribute3
219       ,p_attribute4_o
220           => per_pos_shd.g_old_rec.attribute4
221       ,p_attribute5_o
222           => per_pos_shd.g_old_rec.attribute5
223       ,p_attribute6_o
224           => per_pos_shd.g_old_rec.attribute6
225       ,p_attribute7_o
226           => per_pos_shd.g_old_rec.attribute7
227       ,p_attribute8_o
228           => per_pos_shd.g_old_rec.attribute8
229       ,p_attribute9_o
230           => per_pos_shd.g_old_rec.attribute9
231       ,p_attribute10_o
232           => per_pos_shd.g_old_rec.attribute10
233       ,p_attribute11_o
234           => per_pos_shd.g_old_rec.attribute11
235       ,p_attribute12_o
236           => per_pos_shd.g_old_rec.attribute12
237       ,p_attribute13_o
238           => per_pos_shd.g_old_rec.attribute13
239       ,p_attribute14_o
240           => per_pos_shd.g_old_rec.attribute14
241       ,p_attribute15_o
242           => per_pos_shd.g_old_rec.attribute15
243       ,p_attribute16_o
244           => per_pos_shd.g_old_rec.attribute16
245       ,p_attribute17_o
246           => per_pos_shd.g_old_rec.attribute17
247       ,p_attribute18_o
248           => per_pos_shd.g_old_rec.attribute18
249       ,p_attribute19_o
250           => per_pos_shd.g_old_rec.attribute19
251       ,p_attribute20_o
252           => per_pos_shd.g_old_rec.attribute20
253       ,p_object_version_number_o
254           => per_pos_shd.g_old_rec.object_version_number
255       );
256   exception
257     when hr_api.cannot_find_prog_unit then
258       hr_api.cannot_find_prog_unit_error
259         (p_module_name => 'PER_POSITIONS'
260         ,p_hook_type   => 'AD'
261         );
262   end;
263   -- End of API User Hook for post_delete.
264   --
265   hr_utility.set_location(' Leaving:'||l_proc, 10);
266 End post_delete;
267 --
268 -- ----------------------------------------------------------------------------
272   (
269 -- |---------------------------------< del >----------------------------------|
270 -- ----------------------------------------------------------------------------
271 Procedure del
273   p_rec	      in per_pos_shd.g_rec_type,
274   p_validate  in boolean default false
275   ) is
276 --
277   l_proc  varchar2(72) := g_package||'del';
278 --
279 Begin
280   hr_utility.set_location('Entering:'||l_proc, 5);
281   --
282   -- Determine if the business process is to be validated.
283   --
284   If p_validate then
285     --
286     -- Issue the savepoint.
287     --
288     SAVEPOINT del_per_pos;
289   End If;
290   --
291   -- We must lock the row which we need to delete.
292   --
293   per_pos_shd.lck
294 	(
295 	p_rec.position_id,
296 	p_rec.object_version_number
297 	);
298   --
299   -- Call the supporting delete validate operation
300   --
301   per_pos_bus.delete_validate(p_rec);
302   --
303   -- Call the supporting pre-delete operation
304   --
305   pre_delete(p_rec);
306   --
307   -- Delete the row.
308   --
309   delete_dml(p_rec);
310   --
311   -- Call the supporting post-delete operation
312   --
313   post_delete(p_rec);
314   --
315   -- If we are validating then raise the Validate_Enabled exception
316   --
317   If p_validate then
318     Raise HR_Api.Validate_Enabled;
319   End If;
320   --
321   hr_utility.set_location(' Leaving:'||l_proc, 10);
322 Exception
323   When HR_Api.Validate_Enabled Then
324     --
325     -- As the Validate_Enabled exception has been raised
326     -- we must rollback to the savepoint
327     --
328     ROLLBACK TO del_per_pos;
329 End del;
330 --
331 -- ----------------------------------------------------------------------------
332 -- |---------------------------------< del >----------------------------------|
333 -- ----------------------------------------------------------------------------
334 Procedure del
335   (
336   p_position_id                        in number,
337   p_object_version_number              in number,
338   p_validate                           in boolean default false
339   ) is
340 --
341   l_rec	  per_pos_shd.g_rec_type;
342   l_proc  varchar2(72) := g_package||'del';
343 --
344 Begin
345   hr_utility.set_location('Entering:'||l_proc, 5);
346   --
347   -- As the delete procedure accepts a plsql record structure we do need to
348   -- convert the  arguments into the record structure.
349   -- We don't need to call the supplied conversion argument routine as we
350   -- only need a few attributes.
351   --
352   l_rec.position_id:= p_position_id;
353   l_rec.object_version_number := p_object_version_number;
354   --
355   -- Having converted the arguments into the per_pos_rec
356   -- plsql record structure we must call the corresponding entity
357   -- business process
358   --
359   del(l_rec, p_validate);
360   --
361   hr_utility.set_location(' Leaving:'||l_proc, 10);
362 End del;
363 --
364 end per_pos_del;