1 Package Body ben_xwc_del as
2 /* $Header: bexwcrhi.pkb 120.3 2006/04/27 11:31:07 tjesumic noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- | Private Global Definitions |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package varchar2(33) := ' ben_xwc_del.'; -- Global package name
9
10 --
11 -- ----------------------------------------------------------------------------
12 -- ----------------------< delete_app_ownerships >----------------------------|
13 -- ----------------------------------------------------------------------------
14 --
15 -- Description:
16 -- Deletes row(s) from hr_application_ownerships depending on the mode that
17 -- the row handler has been called in.
18 --
19 -- ----------------------------------------------------------------------------
20 PROCEDURE delete_app_ownerships(p_pk_column IN varchar2
21 ,p_pk_value IN varchar2) IS
22 --
23 BEGIN
24 --
25 IF (hr_startup_data_api_support.return_startup_mode
26 IN ('STARTUP','GENERIC')) THEN
27 --
28 DELETE FROM hr_application_ownerships
29 WHERE key_name = p_pk_column
30 AND key_value = p_pk_value;
31 --
32 END IF;
33 END delete_app_ownerships;
34 --
35 -- ----------------------------------------------------------------------------
36 -- ----------------------< delete_app_ownerships >----------------------------|
37 -- ----------------------------------------------------------------------------
38 PROCEDURE delete_app_ownerships(p_pk_column IN varchar2
39 ,p_pk_value IN number) IS
40 --
41 BEGIN
42 delete_app_ownerships(p_pk_column, to_char(p_pk_value));
43 END delete_app_ownerships;
44
45 --
46 -- ----------------------------------------------------------------------------
47 -- |------------------------------< delete_dml >------------------------------|
48 -- ----------------------------------------------------------------------------
49 -- {Start Of Comments}
50 --
51 -- Description:
52 -- This procedure controls the actual dml delete logic. The functions of
53 -- this procedure are as follows:
54 -- 1) To set and unset the g_api_dml status as required (as we are about to
55 -- perform dml).
56 -- 2) To delete the specified row from the schema using the primary key in
57 -- the predicates.
58 -- 3) To trap any constraint violations that may have occurred.
59 -- 4) To raise any other errors.
60 --
61 -- Prerequisites:
62 -- This is an internal private procedure which must be called from the del
63 -- procedure.
64 --
65 -- In Parameters:
66 -- A Pl/Sql record structre.
67 --
68 -- Post Success:
69 -- The specified row will be delete from the schema.
70 --
71 -- Post Failure:
72 -- On the delete dml failure it is important to note that we always reset the
73 -- g_api_dml status to false.
74 -- If a child integrity constraint violation is raised the
75 -- constraint_error procedure will be called.
76 -- If any other error is reported, the error will be raised after the
77 -- g_api_dml status is reset.
78 --
79 -- Developer Implementation Notes:
80 -- None.
81 --
82 -- Access Status:
83 -- Internal Row Handler Use Only.
84 --
85 -- {End Of Comments}
86 -- ----------------------------------------------------------------------------
87 Procedure delete_dml(p_rec in ben_xwc_shd.g_rec_type) is
88 --
89 l_proc varchar2(72) := g_package||'delete_dml';
90 --
91 Begin
92 hr_utility.set_location('Entering:'||l_proc, 5);
93 --
94 ben_xwc_shd.g_api_dml := true; -- Set the api dml status
95 --
96 -- Delete the ben_ext_where_clause row.
97 --
98 delete from ben_ext_where_clause
99 where ext_where_clause_id = p_rec.ext_where_clause_id;
100 --
101 ben_xwc_shd.g_api_dml := false; -- Unset the api dml status
102 --
103 hr_utility.set_location(' Leaving:'||l_proc, 10);
104 --
105 Exception
106 When hr_api.child_integrity_violated then
107 -- Child integrity has been violated
108 ben_xwc_shd.g_api_dml := false; -- Unset the api dml status
109 ben_xwc_shd.constraint_error
110 (p_constraint_name => hr_api.strip_constraint_name(SQLERRM));
111 When Others Then
112 ben_xwc_shd.g_api_dml := false; -- Unset the api dml status
113 Raise;
114 End delete_dml;
115 --
116 -- ----------------------------------------------------------------------------
117 -- |------------------------------< pre_delete >------------------------------|
118 -- ----------------------------------------------------------------------------
119 -- {Start Of Comments}
120 --
121 -- Description:
122 -- This private procedure contains any processing which is required before
123 -- the delete dml.
124 --
125 -- Prerequisites:
126 -- This is an internal procedure which is called from the del procedure.
127 --
128 -- In Parameters:
129 -- A Pl/Sql record structre.
130 --
131 -- Post Success:
132 -- Processing continues.
133 --
134 -- Post Failure:
135 -- If an error has occurred, an error message and exception will be raised
136 -- but not handled.
137 --
138 -- Developer Implementation Notes:
139 -- Any pre-processing required before the delete dml is issued should be
140 -- coded within this procedure. It is important to note that any 3rd party
141 -- maintenance should be reviewed before placing in this procedure.
142 --
143 -- Access Status:
144 -- Internal Row Handler Use Only.
145 --
146 -- {End Of Comments}
147 -- ----------------------------------------------------------------------------
148 Procedure pre_delete(p_rec in ben_xwc_shd.g_rec_type) is
149 --
150 l_proc varchar2(72) := g_package||'pre_delete';
151 --
152 Begin
153 hr_utility.set_location('Entering:'||l_proc, 5);
154 --
155 hr_utility.set_location(' Leaving:'||l_proc, 10);
156 End pre_delete;
157 --
158 -- ----------------------------------------------------------------------------
159 -- |-----------------------------< post_delete >------------------------------|
160 -- ----------------------------------------------------------------------------
161 -- {Start Of Comments}
162 --
163 -- Description:
164 -- This private procedure contains any processing which is required after the
165 -- delete dml.
166 --
167 -- Prerequisites:
168 -- This is an internal procedure which is called from the del procedure.
169 --
170 -- In Parameters:
171 -- A Pl/Sql record structre.
172 --
173 -- Post Success:
174 -- Processing continues.
175 --
176 -- Post Failure:
177 -- If an error has occurred, an error message and exception will be raised
178 -- but not handled.
179 --
180 -- Developer Implementation Notes:
181 -- Any post-processing required after the delete dml is issued should be
182 -- coded within this procedure. It is important to note that any 3rd party
183 -- maintenance should be reviewed before placing in this procedure.
184 --
185 -- Access Status:
186 -- Internal table Handler Use Only.
187 --
188 -- {End Of Comments}
189 -- ----------------------------------------------------------------------------
190 Procedure post_delete(
191 p_effective_date in date,p_rec in ben_xwc_shd.g_rec_type) is
192 --
193 l_proc varchar2(72) := g_package||'post_delete';
194 --
195 Begin
196 hr_utility.set_location('Entering:'||l_proc, 5);
197 --
198 --
199 -- Delete ownerships if applicable
200 --
201 delete_app_ownerships('EXT_WHERE_CLAUSE_ID', p_rec.ext_where_clause_id);
202 --
203 -- Start of API User Hook for post_delete.
204 --
205 begin
206 --
207 ben_xwc_rkd.after_delete
208 (
209 p_ext_where_clause_id =>p_rec.ext_where_clause_id
210 ,p_seq_num_o =>ben_xwc_shd.g_old_rec.seq_num
211 ,p_oper_cd_o =>ben_xwc_shd.g_old_rec.oper_cd
212 ,p_val_o =>ben_xwc_shd.g_old_rec.val
213 ,p_and_or_cd_o =>ben_xwc_shd.g_old_rec.and_or_cd
214 ,p_ext_data_elmt_id_o =>ben_xwc_shd.g_old_rec.ext_data_elmt_id
215 ,p_cond_ext_data_elmt_id_o =>ben_xwc_shd.g_old_rec.cond_ext_data_elmt_id
216 ,p_ext_rcd_in_file_id_o =>ben_xwc_shd.g_old_rec.ext_rcd_in_file_id
217 ,p_ext_data_elmt_in_rcd_id_o =>ben_xwc_shd.g_old_rec.ext_data_elmt_in_rcd_id
218 ,p_business_group_id_o =>ben_xwc_shd.g_old_rec.business_group_id
219 ,p_legislation_code_o =>ben_xwc_shd.g_old_rec.legislation_code
220 ,p_object_version_number_o =>ben_xwc_shd.g_old_rec.object_version_number
221 ,p_cond_ext_data_elmt_in_rcd__o=>ben_xwc_shd.g_old_rec.cond_ext_data_elmt_in_rcd_id
222 );
223 --
224 exception
225 --
226 when hr_api.cannot_find_prog_unit then
227 --
228 hr_api.cannot_find_prog_unit_error
229 (p_module_name => 'ben_ext_where_clause'
230 ,p_hook_type => 'AD');
231 --
232 end;
233 --
234 -- End of API User Hook for post_delete.
235 --
236 --
237 hr_utility.set_location(' Leaving:'||l_proc, 10);
238 End post_delete;
239 --
240 -- ----------------------------------------------------------------------------
241 -- |---------------------------------< del >----------------------------------|
242 -- ----------------------------------------------------------------------------
243 Procedure del
244 (
245 p_effective_date in date,
246 p_rec in ben_xwc_shd.g_rec_type
247 ) is
248 --
249 l_proc varchar2(72) := g_package||'del';
250 --
251 Begin
252 hr_utility.set_location('Entering:'||l_proc, 5);
253 --
254 -- We must lock the row which we need to delete.
255 --
256 ben_xwc_shd.lck
257 (
258 p_rec.ext_where_clause_id,
259 p_rec.object_version_number
260 );
261 --
262 -- Call the supporting delete validate operation
263 --
264 ben_xwc_bus.delete_validate(p_rec
265 ,p_effective_date);
266 --
267 -- Call the supporting pre-delete operation
268 --
269 pre_delete(p_rec);
270 --
271 -- Delete the row.
272 --
273 delete_dml(p_rec);
274 --
275 -- Call the supporting post-delete operation
276 --
277 post_delete(
278 p_effective_date,p_rec);
279 End del;
280 --
281 -- ----------------------------------------------------------------------------
282 -- |---------------------------------< del >----------------------------------|
283 -- ----------------------------------------------------------------------------
284 Procedure del
285 (
286 p_effective_date in date,
287 p_ext_where_clause_id in number,
288 p_legislation_code in varchar2 default null,
289 p_object_version_number in number
290 ) is
291 --
292 l_rec ben_xwc_shd.g_rec_type;
293 l_proc varchar2(72) := g_package||'del';
294 --
295 Begin
296 hr_utility.set_location('Entering:'||l_proc, 5);
297 --
298 -- As the delete procedure accepts a plsql record structure we do need to
299 -- convert the arguments into the record structure.
300 -- We don't need to call the supplied conversion argument routine as we
301 -- only need a few attributes.
302 --
303 l_rec.ext_where_clause_id := p_ext_where_clause_id;
304 l_rec.legislation_code := p_legislation_code;
305 l_rec.object_version_number := p_object_version_number;
306 --
307 -- Having converted the arguments into the ben_xwc_rec
308 -- plsql record structure we must call the corresponding entity
309 -- business process
310 --
311 del(
312 p_effective_date,l_rec);
313 --
314 hr_utility.set_location(' Leaving:'||l_proc, 10);
315 End del;
316 --
317 end ben_xwc_del;