1 Package Body ben_vrr_upd as
2 /* $Header: bevrrrhi.pkb 120.0.12010000.2 2008/08/05 15:46:13 ubhat ship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- | Private Global Definitions |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package varchar2(33) := ' ben_vrr_upd.'; -- Global package name
9 --
10 -- ----------------------------------------------------------------------------
11 -- |----------------------------< dt_update_dml >-----------------------------|
12 -- ----------------------------------------------------------------------------
13 -- {Start Of Comments}
14 --
15 -- Description:
16 -- This procedure controls the execution of dml from the datetrack mode
17 -- of CORRECTION only. It is important to note that the object version
18 -- number is only increment by 1 because the datetrack correction is
19 -- soley for one datetracked row.
20 -- This procedure controls the actual dml update logic. The functions of this
21 -- procedure are as follows:
22 -- 1) Get the next object_version_number.
23 -- 2) To set and unset the g_api_dml status as required (as we are about to
24 -- perform dml).
25 -- 3) To update the specified row in the schema using the primary key in
26 -- the predicates.
27 -- 4) To trap any constraint violations that may have occurred.
28 -- 5) To raise any other errors.
29 --
30 -- Prerequisites:
31 -- This is an internal private procedure which must be called from the
32 -- update_dml procedure.
33 --
34 -- In Parameters:
35 -- A Pl/Sql record structre.
36 --
37 -- Post Success:
38 -- The specified row will be updated in the schema.
39 --
40 -- Post Failure:
41 -- On the update dml failure it is important to note that we always reset the
42 -- g_api_dml status to false.
43 -- If a check or unique integrity constraint violation is raised the
44 -- constraint_error procedure will be called.
45 -- If any other error is reported, the error will be raised after the
46 -- g_api_dml status is reset.
47 --
48 -- Developer Implementation Notes:
49 -- The update 'set' arguments list should be modified if any of your
50 -- attributes are not updateable.
51 --
52 -- Access Status:
53 -- Internal Row Handler Use Only.
54 --
55 -- {End Of Comments}
56 -- ----------------------------------------------------------------------------
57 Procedure dt_update_dml
58 (p_rec in out nocopy ben_vrr_shd.g_rec_type,
59 p_effective_date in date,
60 p_datetrack_mode in varchar2,
61 p_validation_start_date in date,
62 p_validation_end_date in date) is
63 --
64 l_proc varchar2(72) := g_package||'dt_update_dml';
65 --
66 Begin
67 hr_utility.set_location('Entering:'||l_proc, 5);
68 --
69 If (p_datetrack_mode = 'CORRECTION') then
70 hr_utility.set_location(l_proc, 10);
71 --
72 -- Because we are updating a row we must get the next object
73 -- version number.
74 --
75 p_rec.object_version_number :=
76 dt_api.get_object_version_number
77 (p_base_table_name => 'ben_vrbl_rt_rl_f',
78 p_base_key_column => 'vrbl_rt_rl_id',
79 p_base_key_value => p_rec.vrbl_rt_rl_id);
80 --
81 ben_vrr_shd.g_api_dml := true; -- Set the api dml status
82 --
83 -- Update the ben_vrbl_rt_rl_f Row
84 --
85 update ben_vrbl_rt_rl_f
86 set
87 drvbl_fctr_apls_flag = p_rec.drvbl_fctr_apls_flag,
88 rt_trtmt_cd = p_rec.rt_trtmt_cd,
89 vrbl_rt_rl_id = p_rec.vrbl_rt_rl_id,
90 business_group_id = p_rec.business_group_id,
91 formula_id = p_rec.formula_id,
92 acty_base_rt_id = p_rec.acty_base_rt_id,
93 ordr_to_aply_num = p_rec.ordr_to_aply_num,
94 vrr_attribute_category = p_rec.vrr_attribute_category,
95 vrr_attribute1 = p_rec.vrr_attribute1,
96 vrr_attribute2 = p_rec.vrr_attribute2,
97 vrr_attribute3 = p_rec.vrr_attribute3,
98 vrr_attribute4 = p_rec.vrr_attribute4,
99 vrr_attribute5 = p_rec.vrr_attribute5,
100 vrr_attribute6 = p_rec.vrr_attribute6,
101 vrr_attribute7 = p_rec.vrr_attribute7,
102 vrr_attribute8 = p_rec.vrr_attribute8,
103 vrr_attribute9 = p_rec.vrr_attribute9,
104 vrr_attribute10 = p_rec.vrr_attribute10,
105 vrr_attribute11 = p_rec.vrr_attribute11,
106 vrr_attribute12 = p_rec.vrr_attribute12,
107 vrr_attribute13 = p_rec.vrr_attribute13,
108 vrr_attribute14 = p_rec.vrr_attribute14,
109 vrr_attribute15 = p_rec.vrr_attribute15,
110 vrr_attribute16 = p_rec.vrr_attribute16,
111 vrr_attribute17 = p_rec.vrr_attribute17,
112 vrr_attribute18 = p_rec.vrr_attribute18,
113 vrr_attribute19 = p_rec.vrr_attribute19,
114 vrr_attribute20 = p_rec.vrr_attribute20,
115 vrr_attribute21 = p_rec.vrr_attribute21,
116 vrr_attribute22 = p_rec.vrr_attribute22,
117 vrr_attribute23 = p_rec.vrr_attribute23,
118 vrr_attribute24 = p_rec.vrr_attribute24,
119 vrr_attribute25 = p_rec.vrr_attribute25,
120 vrr_attribute26 = p_rec.vrr_attribute26,
121 vrr_attribute27 = p_rec.vrr_attribute27,
122 vrr_attribute28 = p_rec.vrr_attribute28,
123 vrr_attribute29 = p_rec.vrr_attribute29,
124 vrr_attribute30 = p_rec.vrr_attribute30,
125 object_version_number = p_rec.object_version_number
126 where vrbl_rt_rl_id = p_rec.vrbl_rt_rl_id
127 and effective_start_date = p_validation_start_date
128 and effective_end_date = p_validation_end_date;
129 --
130 ben_vrr_shd.g_api_dml := false; -- Unset the api dml status
131 --
132 -- Set the effective start and end dates
133 --
134 p_rec.effective_start_date := p_validation_start_date;
135 p_rec.effective_end_date := p_validation_end_date;
136 End If;
137 --
138 hr_utility.set_location(' Leaving:'||l_proc, 15);
139 Exception
140 When hr_api.check_integrity_violated Then
141 -- A check constraint has been violated
142 ben_vrr_shd.g_api_dml := false; -- Unset the api dml status
143 ben_vrr_shd.constraint_error
144 (p_constraint_name => hr_api.strip_constraint_name(SQLERRM));
145 When hr_api.unique_integrity_violated Then
146 -- Unique integrity has been violated
147 ben_vrr_shd.g_api_dml := false; -- Unset the api dml status
148 ben_vrr_shd.constraint_error
149 (p_constraint_name => hr_api.strip_constraint_name(SQLERRM));
150 When Others Then
151 ben_vrr_shd.g_api_dml := false; -- Unset the api dml status
152 Raise;
153 End dt_update_dml;
154 --
155 -- ----------------------------------------------------------------------------
156 -- |------------------------------< update_dml >------------------------------|
157 -- ----------------------------------------------------------------------------
158 -- {Start Of Comments}
159 --
160 -- Description:
161 -- This procedure calls the dt_update_dml control logic which handles
162 -- the actual datetrack dml.
163 --
164 -- Prerequisites:
165 -- This is an internal private procedure which must be called from the upd
166 -- procedure.
167 --
168 -- In Parameters:
169 -- A Pl/Sql record structre.
170 --
171 -- Post Success:
172 -- Processing contines.
173 --
174 -- Post Failure:
175 -- No specific error handling is required within this procedure.
176 --
177 -- Developer Implementation Notes:
178 -- The update 'set' arguments list should be modified if any of your
179 -- attributes are not updateable.
180 --
181 -- Access Status:
182 -- Internal Row Handler Use Only.
183 --
184 -- {End Of Comments}
185 -- ----------------------------------------------------------------------------
186 Procedure update_dml
187 (p_rec in out nocopy ben_vrr_shd.g_rec_type,
188 p_effective_date in date,
189 p_datetrack_mode in varchar2,
190 p_validation_start_date in date,
191 p_validation_end_date in date) is
192 --
193 l_proc varchar2(72) := g_package||'update_dml';
194 --
195 Begin
196 hr_utility.set_location('Entering:'||l_proc, 5);
197 --
198 dt_update_dml(p_rec => p_rec,
199 p_effective_date => p_effective_date,
200 p_datetrack_mode => p_datetrack_mode,
201 p_validation_start_date => p_validation_start_date,
202 p_validation_end_date => p_validation_end_date);
203 --
204 hr_utility.set_location(' Leaving:'||l_proc, 10);
205 End update_dml;
206 --
207 -- ----------------------------------------------------------------------------
208 -- |----------------------------< dt_pre_update >-----------------------------|
209 -- ----------------------------------------------------------------------------
210 -- {Start Of Comments}
211 --
212 -- Description:
213 -- The dt_pre_update procedure controls the execution
214 -- of dml for the datetrack modes of: UPDATE, UPDATE_OVERRIDE
215 -- and UPDATE_CHANGE_INSERT only. The execution required is as
216 -- follows:
217 --
218 -- 1) Providing the datetrack update mode is not 'CORRECTION'
219 -- then set the effective end date of the current row (this
220 -- will be the validation_start_date - 1).
221 -- 2) If the datetrack mode is 'UPDATE_OVERRIDE' then call the
222 -- corresponding delete_dml process to delete any future rows
223 -- where the effective_start_date is greater than or equal to
224 -- the validation_start_date.
225 -- 3) Call the insert_dml process to insert the new updated row
226 -- details..
227 --
228 -- Prerequisites:
229 -- This is an internal procedure which is called from the
230 -- pre_update procedure.
231 --
232 -- In Parameters:
233 --
234 -- Post Success:
235 -- Processing continues.
236 --
237 -- Post Failure:
238 -- If an error has occurred, an error message and exception will be raised
239 -- but not handled.
240 --
241 -- Developer Implementation Notes:
242 -- This is an internal procedure which is required by Datetrack. Don't
243 -- remove or modify.
244 --
245 -- Access Status:
246 -- Internal Row Handler Use Only.
247 --
248 -- {End Of Comments}
249 -- ----------------------------------------------------------------------------
250 Procedure dt_pre_update
251 (p_rec in out nocopy ben_vrr_shd.g_rec_type,
252 p_effective_date in date,
253 p_datetrack_mode in varchar2,
254 p_validation_start_date in date,
255 p_validation_end_date in date) is
256 --
257 l_proc varchar2(72) := g_package||'dt_pre_update';
258 l_dummy_version_number number;
259 --
260 Begin
261 hr_utility.set_location('Entering:'||l_proc, 5);
262 If (p_datetrack_mode <> 'CORRECTION') then
263 hr_utility.set_location(l_proc, 10);
264 --
265 -- Update the current effective end date
266 --
267 ben_vrr_shd.upd_effective_end_date
268 (p_effective_date => p_effective_date,
269 p_base_key_value => p_rec.vrbl_rt_rl_id,
270 p_new_effective_end_date => (p_validation_start_date - 1),
271 p_validation_start_date => p_validation_start_date,
272 p_validation_end_date => p_validation_end_date,
273 p_object_version_number => l_dummy_version_number);
274 --
275 If (p_datetrack_mode = 'UPDATE_OVERRIDE') then
276 hr_utility.set_location(l_proc, 15);
277 --
278 -- As the datetrack mode is 'UPDATE_OVERRIDE' then we must
279 -- delete any future rows
280 --
281 ben_vrr_del.delete_dml
282 (p_rec => p_rec,
283 p_effective_date => p_effective_date,
284 p_datetrack_mode => p_datetrack_mode,
285 p_validation_start_date => p_validation_start_date,
286 p_validation_end_date => p_validation_end_date);
287 End If;
288 hr_utility.set_location(l_proc, 20);
289 --
290 -- We must now insert the updated row
291 --
292 ben_vrr_ins.insert_dml
293 (p_rec => p_rec,
294 p_effective_date => p_effective_date,
295 p_datetrack_mode => p_datetrack_mode,
296 p_validation_start_date => p_validation_start_date,
297 p_validation_end_date => p_validation_end_date);
298 End If;
299 hr_utility.set_location(' Leaving:'||l_proc, 20);
300 End dt_pre_update;
301 --
302 -- ----------------------------------------------------------------------------
303 -- |------------------------------< pre_update >------------------------------|
304 -- ----------------------------------------------------------------------------
305 -- {Start Of Comments}
306 --
307 -- Description:
308 -- This private procedure contains any processing which is required before
309 -- the update dml.
310 --
311 -- Prerequisites:
312 -- This is an internal procedure which is called from the upd procedure.
313 --
314 -- In Parameters:
315 -- A Pl/Sql record structre.
316 --
317 -- Post Success:
318 -- Processing continues.
319 --
320 -- Post Failure:
321 -- If an error has occurred, an error message and exception will be raised
322 -- but not handled.
323 --
324 -- Developer Implementation Notes:
325 -- Any pre-processing required before the update dml is issued should be
326 -- coded within this procedure. It is important to note that any 3rd party
327 -- maintenance should be reviewed before placing in this procedure. The call
328 -- to the dt_update_dml procedure should NOT be removed.
329 --
330 -- Access Status:
331 -- Internal Row Handler Use Only.
332 --
333 -- {End Of Comments}
334 -- ----------------------------------------------------------------------------
335 Procedure pre_update
336 (p_rec in out nocopy ben_vrr_shd.g_rec_type,
337 p_effective_date in date,
338 p_datetrack_mode in varchar2,
339 p_validation_start_date in date,
340 p_validation_end_date in date) is
341 --
342 l_proc varchar2(72) := g_package||'pre_update';
343 --
344 Begin
345 hr_utility.set_location('Entering:'||l_proc, 5);
346 --
347 --
348 --
349 dt_pre_update
350 (p_rec => p_rec,
351 p_effective_date => p_effective_date,
352 p_datetrack_mode => p_datetrack_mode,
353 p_validation_start_date => p_validation_start_date,
354 p_validation_end_date => p_validation_end_date);
355 --
356 hr_utility.set_location(' Leaving:'||l_proc, 10);
357 End pre_update;
358 --
359 -- ----------------------------------------------------------------------------
360 -- |-----------------------------< post_update >------------------------------|
361 -- ----------------------------------------------------------------------------
362 -- {Start Of Comments}
363 --
364 -- Description:
365 -- This private procedure contains any processing which is required after the
366 -- update dml.
367 --
368 -- Prerequisites:
369 -- This is an internal procedure which is called from the upd procedure.
370 --
371 -- In Parameters:
372 -- A Pl/Sql record structre.
373 --
374 -- Post Success:
375 -- Processing continues.
376 --
377 -- Post Failure:
378 -- If an error has occurred, an error message and exception will be raised
379 -- but not handled.
380 --
381 -- Developer Implementation Notes:
382 -- Any post-processing required after the update dml is issued should be
383 -- coded within this procedure. It is important to note that any 3rd party
384 -- maintenance should be reviewed before placing in this procedure.
385 --
386 -- Access Status:
387 -- Internal Row Handler Use Only.
388 --
389 -- {End Of Comments}
390 -- ----------------------------------------------------------------------------
391 Procedure post_update
392 (p_rec in ben_vrr_shd.g_rec_type,
393 p_effective_date in date,
394 p_datetrack_mode in varchar2,
395 p_validation_start_date in date,
396 p_validation_end_date in date) is
397 --
398 l_proc varchar2(72) := g_package||'post_update';
399 --
400 Begin
401 hr_utility.set_location('Entering:'||l_proc, 5);
402 --
403 --
404 -- Start of API User Hook for post_update.
405 --
406 begin
407 --
408 ben_vrr_rku.after_update
409 (
410 p_vrbl_rt_rl_id =>p_rec.vrbl_rt_rl_id
411 ,p_effective_start_date =>p_rec.effective_start_date
412 ,p_effective_end_date =>p_rec.effective_end_date
413 ,p_drvbl_fctr_apls_flag =>p_rec.drvbl_fctr_apls_flag
414 ,p_rt_trtmt_cd =>p_rec.rt_trtmt_cd
415 ,p_business_group_id =>p_rec.business_group_id
416 ,p_formula_id =>p_rec.formula_id
417 ,p_acty_base_rt_id =>p_rec.acty_base_rt_id
418 ,p_ordr_to_aply_num =>p_rec.ordr_to_aply_num
419 ,p_vrr_attribute_category =>p_rec.vrr_attribute_category
420 ,p_vrr_attribute1 =>p_rec.vrr_attribute1
421 ,p_vrr_attribute2 =>p_rec.vrr_attribute2
422 ,p_vrr_attribute3 =>p_rec.vrr_attribute3
423 ,p_vrr_attribute4 =>p_rec.vrr_attribute4
424 ,p_vrr_attribute5 =>p_rec.vrr_attribute5
425 ,p_vrr_attribute6 =>p_rec.vrr_attribute6
426 ,p_vrr_attribute7 =>p_rec.vrr_attribute7
427 ,p_vrr_attribute8 =>p_rec.vrr_attribute8
428 ,p_vrr_attribute9 =>p_rec.vrr_attribute9
429 ,p_vrr_attribute10 =>p_rec.vrr_attribute10
430 ,p_vrr_attribute11 =>p_rec.vrr_attribute11
431 ,p_vrr_attribute12 =>p_rec.vrr_attribute12
432 ,p_vrr_attribute13 =>p_rec.vrr_attribute13
433 ,p_vrr_attribute14 =>p_rec.vrr_attribute14
434 ,p_vrr_attribute15 =>p_rec.vrr_attribute15
435 ,p_vrr_attribute16 =>p_rec.vrr_attribute16
436 ,p_vrr_attribute17 =>p_rec.vrr_attribute17
437 ,p_vrr_attribute18 =>p_rec.vrr_attribute18
438 ,p_vrr_attribute19 =>p_rec.vrr_attribute19
439 ,p_vrr_attribute20 =>p_rec.vrr_attribute20
440 ,p_vrr_attribute21 =>p_rec.vrr_attribute21
441 ,p_vrr_attribute22 =>p_rec.vrr_attribute22
442 ,p_vrr_attribute23 =>p_rec.vrr_attribute23
443 ,p_vrr_attribute24 =>p_rec.vrr_attribute24
444 ,p_vrr_attribute25 =>p_rec.vrr_attribute25
445 ,p_vrr_attribute26 =>p_rec.vrr_attribute26
446 ,p_vrr_attribute27 =>p_rec.vrr_attribute27
447 ,p_vrr_attribute28 =>p_rec.vrr_attribute28
448 ,p_vrr_attribute29 =>p_rec.vrr_attribute29
449 ,p_vrr_attribute30 =>p_rec.vrr_attribute30
450 ,p_object_version_number =>p_rec.object_version_number
451 ,p_effective_date =>p_effective_date
452 ,p_datetrack_mode =>p_datetrack_mode
453 ,p_validation_start_date =>p_validation_start_date
454 ,p_validation_end_date =>p_validation_end_date
455 ,p_effective_start_date_o =>ben_vrr_shd.g_old_rec.effective_start_date
456 ,p_effective_end_date_o =>ben_vrr_shd.g_old_rec.effective_end_date
457 ,p_drvbl_fctr_apls_flag_o =>ben_vrr_shd.g_old_rec.drvbl_fctr_apls_flag
458 ,p_rt_trtmt_cd_o =>ben_vrr_shd.g_old_rec.rt_trtmt_cd
459 ,p_business_group_id_o =>ben_vrr_shd.g_old_rec.business_group_id
460 ,p_formula_id_o =>ben_vrr_shd.g_old_rec.formula_id
461 ,p_acty_base_rt_id_o =>ben_vrr_shd.g_old_rec.acty_base_rt_id
462 ,p_ordr_to_aply_num_o =>ben_vrr_shd.g_old_rec.ordr_to_aply_num
463 ,p_vrr_attribute_category_o =>ben_vrr_shd.g_old_rec.vrr_attribute_category
464 ,p_vrr_attribute1_o =>ben_vrr_shd.g_old_rec.vrr_attribute1
465 ,p_vrr_attribute2_o =>ben_vrr_shd.g_old_rec.vrr_attribute2
466 ,p_vrr_attribute3_o =>ben_vrr_shd.g_old_rec.vrr_attribute3
467 ,p_vrr_attribute4_o =>ben_vrr_shd.g_old_rec.vrr_attribute4
468 ,p_vrr_attribute5_o =>ben_vrr_shd.g_old_rec.vrr_attribute5
469 ,p_vrr_attribute6_o =>ben_vrr_shd.g_old_rec.vrr_attribute6
470 ,p_vrr_attribute7_o =>ben_vrr_shd.g_old_rec.vrr_attribute7
471 ,p_vrr_attribute8_o =>ben_vrr_shd.g_old_rec.vrr_attribute8
472 ,p_vrr_attribute9_o =>ben_vrr_shd.g_old_rec.vrr_attribute9
473 ,p_vrr_attribute10_o =>ben_vrr_shd.g_old_rec.vrr_attribute10
474 ,p_vrr_attribute11_o =>ben_vrr_shd.g_old_rec.vrr_attribute11
475 ,p_vrr_attribute12_o =>ben_vrr_shd.g_old_rec.vrr_attribute12
476 ,p_vrr_attribute13_o =>ben_vrr_shd.g_old_rec.vrr_attribute13
477 ,p_vrr_attribute14_o =>ben_vrr_shd.g_old_rec.vrr_attribute14
478 ,p_vrr_attribute15_o =>ben_vrr_shd.g_old_rec.vrr_attribute15
479 ,p_vrr_attribute16_o =>ben_vrr_shd.g_old_rec.vrr_attribute16
480 ,p_vrr_attribute17_o =>ben_vrr_shd.g_old_rec.vrr_attribute17
481 ,p_vrr_attribute18_o =>ben_vrr_shd.g_old_rec.vrr_attribute18
482 ,p_vrr_attribute19_o =>ben_vrr_shd.g_old_rec.vrr_attribute19
483 ,p_vrr_attribute20_o =>ben_vrr_shd.g_old_rec.vrr_attribute20
484 ,p_vrr_attribute21_o =>ben_vrr_shd.g_old_rec.vrr_attribute21
485 ,p_vrr_attribute22_o =>ben_vrr_shd.g_old_rec.vrr_attribute22
486 ,p_vrr_attribute23_o =>ben_vrr_shd.g_old_rec.vrr_attribute23
487 ,p_vrr_attribute24_o =>ben_vrr_shd.g_old_rec.vrr_attribute24
488 ,p_vrr_attribute25_o =>ben_vrr_shd.g_old_rec.vrr_attribute25
489 ,p_vrr_attribute26_o =>ben_vrr_shd.g_old_rec.vrr_attribute26
490 ,p_vrr_attribute27_o =>ben_vrr_shd.g_old_rec.vrr_attribute27
491 ,p_vrr_attribute28_o =>ben_vrr_shd.g_old_rec.vrr_attribute28
492 ,p_vrr_attribute29_o =>ben_vrr_shd.g_old_rec.vrr_attribute29
493 ,p_vrr_attribute30_o =>ben_vrr_shd.g_old_rec.vrr_attribute30
494 ,p_object_version_number_o =>ben_vrr_shd.g_old_rec.object_version_number
495 );
496 --
497 exception
498 --
499 when hr_api.cannot_find_prog_unit then
500 --
501 hr_api.cannot_find_prog_unit_error
502 (p_module_name => 'ben_vrbl_rt_rl_f'
503 ,p_hook_type => 'AU');
504 --
505 end;
506 --
507 -- End of API User Hook for post_update.
508 --
509 --
510 hr_utility.set_location(' Leaving:'||l_proc, 10);
511 End post_update;
512 --
513 -- ----------------------------------------------------------------------------
514 -- |-----------------------------< convert_defs >-----------------------------|
515 -- ----------------------------------------------------------------------------
516 -- {Start Of Comments}
517 --
518 -- Description:
519 -- The Convert_Defs procedure has one very important function:
520 -- It must return the record structure for the row with all system defaulted
521 -- values converted into its corresponding parameter value for update. When
522 -- we attempt to update a row through the Upd process , certain
523 -- parameters can be defaulted which enables flexibility in the calling of
524 -- the upd process (e.g. only attributes which need to be updated need to be
525 -- specified). For the upd process to determine which attributes
526 -- have NOT been specified we need to check if the parameter has a reserved
527 -- system default value. Therefore, for all parameters which have a
528 -- corresponding reserved system default mechanism specified we need to
529 -- check if a system default is being used. If a system default is being
530 -- used then we convert the defaulted value into its corresponding attribute
531 -- value held in the g_old_rec data structure.
532 --
533 -- Prerequisites:
534 -- This private function can only be called from the upd process.
535 --
536 -- In Parameters:
537 -- A Pl/Sql record structre.
538 --
539 -- Post Success:
540 -- The record structure will be returned with all system defaulted parameter
541 -- values converted into its current row attribute value.
542 --
543 -- Post Failure:
544 -- No direct error handling is required within this function. Any possible
545 -- errors within this procedure will be a PL/SQL value error due to conversion
546 -- of datatypes or data lengths.
547 --
548 -- Developer Implementation Notes:
549 -- None.
550 --
551 -- Access Status:
552 -- Internal Row Handler Use Only.
553 --
554 -- {End Of Comments}
555 -- ----------------------------------------------------------------------------
556 Procedure convert_defs(p_rec in out nocopy ben_vrr_shd.g_rec_type) is
557 --
558 l_proc varchar2(72) := g_package||'convert_defs';
559 --
560 Begin
561 --
562 hr_utility.set_location('Entering:'||l_proc, 5);
563 --
564 -- We must now examine each argument value in the
565 -- p_rec plsql record structure
566 -- to see if a system default is being used. If a system default
567 -- is being used then we must set to the 'current' argument value.
568 --
569 If (p_rec.drvbl_fctr_apls_flag = hr_api.g_varchar2) then
570 p_rec.drvbl_fctr_apls_flag :=
571 ben_vrr_shd.g_old_rec.drvbl_fctr_apls_flag;
572 End If;
573 If (p_rec.rt_trtmt_cd = hr_api.g_varchar2) then
574 p_rec.rt_trtmt_cd :=
575 ben_vrr_shd.g_old_rec.rt_trtmt_cd;
576 End If;
577 If (p_rec.business_group_id = hr_api.g_number) then
578 p_rec.business_group_id :=
579 ben_vrr_shd.g_old_rec.business_group_id;
580 End If;
581 If (p_rec.formula_id = hr_api.g_number) then
582 p_rec.formula_id :=
583 ben_vrr_shd.g_old_rec.formula_id;
584 End If;
585 /*If (p_rec.actl_prem_id = hr_api.g_number) then
586 p_rec.actl_prem_id :=
587 ben_vrr_shd.g_old_rec.actl_prem_id;
588 End If;*/
589 If (p_rec.acty_base_rt_id = hr_api.g_number) then
590 p_rec.acty_base_rt_id :=
591 ben_vrr_shd.g_old_rec.acty_base_rt_id;
592 End If;
593 If (p_rec.ordr_to_aply_num = hr_api.g_number) then
594 p_rec.ordr_to_aply_num :=
595 ben_vrr_shd.g_old_rec.ordr_to_aply_num;
596 End If;
597 If (p_rec.vrr_attribute_category = hr_api.g_varchar2) then
598 p_rec.vrr_attribute_category :=
599 ben_vrr_shd.g_old_rec.vrr_attribute_category;
600 End If;
601 If (p_rec.vrr_attribute1 = hr_api.g_varchar2) then
602 p_rec.vrr_attribute1 :=
603 ben_vrr_shd.g_old_rec.vrr_attribute1;
604 End If;
605 If (p_rec.vrr_attribute2 = hr_api.g_varchar2) then
606 p_rec.vrr_attribute2 :=
607 ben_vrr_shd.g_old_rec.vrr_attribute2;
608 End If;
609 If (p_rec.vrr_attribute3 = hr_api.g_varchar2) then
610 p_rec.vrr_attribute3 :=
611 ben_vrr_shd.g_old_rec.vrr_attribute3;
612 End If;
613 If (p_rec.vrr_attribute4 = hr_api.g_varchar2) then
614 p_rec.vrr_attribute4 :=
615 ben_vrr_shd.g_old_rec.vrr_attribute4;
616 End If;
617 If (p_rec.vrr_attribute5 = hr_api.g_varchar2) then
618 p_rec.vrr_attribute5 :=
619 ben_vrr_shd.g_old_rec.vrr_attribute5;
620 End If;
621 If (p_rec.vrr_attribute6 = hr_api.g_varchar2) then
622 p_rec.vrr_attribute6 :=
623 ben_vrr_shd.g_old_rec.vrr_attribute6;
624 End If;
625 If (p_rec.vrr_attribute7 = hr_api.g_varchar2) then
626 p_rec.vrr_attribute7 :=
627 ben_vrr_shd.g_old_rec.vrr_attribute7;
628 End If;
629 If (p_rec.vrr_attribute8 = hr_api.g_varchar2) then
630 p_rec.vrr_attribute8 :=
631 ben_vrr_shd.g_old_rec.vrr_attribute8;
632 End If;
633 If (p_rec.vrr_attribute9 = hr_api.g_varchar2) then
634 p_rec.vrr_attribute9 :=
635 ben_vrr_shd.g_old_rec.vrr_attribute9;
636 End If;
637 If (p_rec.vrr_attribute10 = hr_api.g_varchar2) then
638 p_rec.vrr_attribute10 :=
639 ben_vrr_shd.g_old_rec.vrr_attribute10;
640 End If;
641 If (p_rec.vrr_attribute11 = hr_api.g_varchar2) then
642 p_rec.vrr_attribute11 :=
643 ben_vrr_shd.g_old_rec.vrr_attribute11;
644 End If;
645 If (p_rec.vrr_attribute12 = hr_api.g_varchar2) then
646 p_rec.vrr_attribute12 :=
647 ben_vrr_shd.g_old_rec.vrr_attribute12;
648 End If;
649 If (p_rec.vrr_attribute13 = hr_api.g_varchar2) then
650 p_rec.vrr_attribute13 :=
651 ben_vrr_shd.g_old_rec.vrr_attribute13;
652 End If;
653 If (p_rec.vrr_attribute14 = hr_api.g_varchar2) then
654 p_rec.vrr_attribute14 :=
655 ben_vrr_shd.g_old_rec.vrr_attribute14;
656 End If;
657 If (p_rec.vrr_attribute15 = hr_api.g_varchar2) then
658 p_rec.vrr_attribute15 :=
659 ben_vrr_shd.g_old_rec.vrr_attribute15;
660 End If;
661 If (p_rec.vrr_attribute16 = hr_api.g_varchar2) then
662 p_rec.vrr_attribute16 :=
663 ben_vrr_shd.g_old_rec.vrr_attribute16;
664 End If;
665 If (p_rec.vrr_attribute17 = hr_api.g_varchar2) then
666 p_rec.vrr_attribute17 :=
667 ben_vrr_shd.g_old_rec.vrr_attribute17;
668 End If;
669 If (p_rec.vrr_attribute18 = hr_api.g_varchar2) then
670 p_rec.vrr_attribute18 :=
671 ben_vrr_shd.g_old_rec.vrr_attribute18;
672 End If;
673 If (p_rec.vrr_attribute19 = hr_api.g_varchar2) then
674 p_rec.vrr_attribute19 :=
675 ben_vrr_shd.g_old_rec.vrr_attribute19;
676 End If;
677 If (p_rec.vrr_attribute20 = hr_api.g_varchar2) then
678 p_rec.vrr_attribute20 :=
679 ben_vrr_shd.g_old_rec.vrr_attribute20;
680 End If;
681 If (p_rec.vrr_attribute21 = hr_api.g_varchar2) then
682 p_rec.vrr_attribute21 :=
683 ben_vrr_shd.g_old_rec.vrr_attribute21;
684 End If;
685 If (p_rec.vrr_attribute22 = hr_api.g_varchar2) then
686 p_rec.vrr_attribute22 :=
687 ben_vrr_shd.g_old_rec.vrr_attribute22;
688 End If;
689 If (p_rec.vrr_attribute23 = hr_api.g_varchar2) then
690 p_rec.vrr_attribute23 :=
691 ben_vrr_shd.g_old_rec.vrr_attribute23;
692 End If;
693 If (p_rec.vrr_attribute24 = hr_api.g_varchar2) then
694 p_rec.vrr_attribute24 :=
695 ben_vrr_shd.g_old_rec.vrr_attribute24;
696 End If;
697 If (p_rec.vrr_attribute25 = hr_api.g_varchar2) then
698 p_rec.vrr_attribute25 :=
699 ben_vrr_shd.g_old_rec.vrr_attribute25;
700 End If;
701 If (p_rec.vrr_attribute26 = hr_api.g_varchar2) then
702 p_rec.vrr_attribute26 :=
703 ben_vrr_shd.g_old_rec.vrr_attribute26;
704 End If;
705 If (p_rec.vrr_attribute27 = hr_api.g_varchar2) then
706 p_rec.vrr_attribute27 :=
707 ben_vrr_shd.g_old_rec.vrr_attribute27;
708 End If;
709 If (p_rec.vrr_attribute28 = hr_api.g_varchar2) then
710 p_rec.vrr_attribute28 :=
711 ben_vrr_shd.g_old_rec.vrr_attribute28;
712 End If;
713 If (p_rec.vrr_attribute29 = hr_api.g_varchar2) then
714 p_rec.vrr_attribute29 :=
715 ben_vrr_shd.g_old_rec.vrr_attribute29;
716 End If;
717 If (p_rec.vrr_attribute30 = hr_api.g_varchar2) then
718 p_rec.vrr_attribute30 :=
719 ben_vrr_shd.g_old_rec.vrr_attribute30;
720 End If;
721
722 --
723 hr_utility.set_location(' Leaving:'||l_proc, 10);
724 --
725 End convert_defs;
726 --
727 -- ----------------------------------------------------------------------------
728 -- |---------------------------------< upd >----------------------------------|
729 -- ----------------------------------------------------------------------------
730 Procedure upd
731 (
732 p_rec in out nocopy ben_vrr_shd.g_rec_type,
733 p_effective_date in date,
734 p_datetrack_mode in varchar2
735 ) is
736 --
737 l_proc varchar2(72) := g_package||'upd';
738 l_validation_start_date date;
739 l_validation_end_date date;
740 --
741 Begin
742 hr_utility.set_location('Entering:'||l_proc, 5);
743 --
744 -- Ensure that the DateTrack update mode is valid
745 --
746 dt_api.validate_dt_upd_mode(p_datetrack_mode => p_datetrack_mode);
747 --
748 -- We must lock the row which we need to update.
749 --
750 ben_vrr_shd.lck
751 (p_effective_date => p_effective_date,
752 p_datetrack_mode => p_datetrack_mode,
753 p_vrbl_rt_rl_id => p_rec.vrbl_rt_rl_id,
754 p_object_version_number => p_rec.object_version_number,
755 p_validation_start_date => l_validation_start_date,
756 p_validation_end_date => l_validation_end_date);
757 --
758 -- 1. During an update system defaults are used to determine if
759 -- arguments have been defaulted or not. We must therefore
760 -- derive the full record structure values to be updated.
761 --
762 -- 2. Call the supporting update validate operations.
763 --
764 convert_defs(p_rec);
765 ben_vrr_bus.update_validate
766 (p_rec => p_rec,
767 p_effective_date => p_effective_date,
768 p_datetrack_mode => p_datetrack_mode,
769 p_validation_start_date => l_validation_start_date,
770 p_validation_end_date => l_validation_end_date);
771 --
772 -- Call the supporting pre-update operation
773 --
774 pre_update
775 (p_rec => p_rec,
776 p_effective_date => p_effective_date,
777 p_datetrack_mode => p_datetrack_mode,
778 p_validation_start_date => l_validation_start_date,
779 p_validation_end_date => l_validation_end_date);
780 --
781 -- Update the row.
782 --
783 update_dml
784 (p_rec => p_rec,
785 p_effective_date => p_effective_date,
786 p_datetrack_mode => p_datetrack_mode,
787 p_validation_start_date => l_validation_start_date,
788 p_validation_end_date => l_validation_end_date);
789 --
790 -- Call the supporting post-update operation
791 --
792 post_update
793 (p_rec => p_rec,
794 p_effective_date => p_effective_date,
795 p_datetrack_mode => p_datetrack_mode,
796 p_validation_start_date => l_validation_start_date,
797 p_validation_end_date => l_validation_end_date);
798 End upd;
799 --
800 -- ----------------------------------------------------------------------------
801 -- |---------------------------------< upd >----------------------------------|
802 -- ----------------------------------------------------------------------------
803 Procedure upd
804 (
805 p_vrbl_rt_rl_id in number,
806 p_effective_start_date out nocopy date,
807 p_effective_end_date out nocopy date,
808 p_drvbl_fctr_apls_flag in varchar2 default hr_api.g_varchar2,
809 p_rt_trtmt_cd in varchar2 default hr_api.g_varchar2,
810 p_business_group_id in number default hr_api.g_number,
811 p_formula_id in number default hr_api.g_number,
812 p_acty_base_rt_id in number default hr_api.g_number,
813 p_ordr_to_aply_num in number default hr_api.g_number,
814 p_vrr_attribute_category in varchar2 default hr_api.g_varchar2,
815 p_vrr_attribute1 in varchar2 default hr_api.g_varchar2,
816 p_vrr_attribute2 in varchar2 default hr_api.g_varchar2,
817 p_vrr_attribute3 in varchar2 default hr_api.g_varchar2,
818 p_vrr_attribute4 in varchar2 default hr_api.g_varchar2,
819 p_vrr_attribute5 in varchar2 default hr_api.g_varchar2,
820 p_vrr_attribute6 in varchar2 default hr_api.g_varchar2,
821 p_vrr_attribute7 in varchar2 default hr_api.g_varchar2,
822 p_vrr_attribute8 in varchar2 default hr_api.g_varchar2,
823 p_vrr_attribute9 in varchar2 default hr_api.g_varchar2,
824 p_vrr_attribute10 in varchar2 default hr_api.g_varchar2,
825 p_vrr_attribute11 in varchar2 default hr_api.g_varchar2,
826 p_vrr_attribute12 in varchar2 default hr_api.g_varchar2,
827 p_vrr_attribute13 in varchar2 default hr_api.g_varchar2,
828 p_vrr_attribute14 in varchar2 default hr_api.g_varchar2,
829 p_vrr_attribute15 in varchar2 default hr_api.g_varchar2,
830 p_vrr_attribute16 in varchar2 default hr_api.g_varchar2,
831 p_vrr_attribute17 in varchar2 default hr_api.g_varchar2,
832 p_vrr_attribute18 in varchar2 default hr_api.g_varchar2,
833 p_vrr_attribute19 in varchar2 default hr_api.g_varchar2,
834 p_vrr_attribute20 in varchar2 default hr_api.g_varchar2,
835 p_vrr_attribute21 in varchar2 default hr_api.g_varchar2,
836 p_vrr_attribute22 in varchar2 default hr_api.g_varchar2,
837 p_vrr_attribute23 in varchar2 default hr_api.g_varchar2,
838 p_vrr_attribute24 in varchar2 default hr_api.g_varchar2,
839 p_vrr_attribute25 in varchar2 default hr_api.g_varchar2,
840 p_vrr_attribute26 in varchar2 default hr_api.g_varchar2,
841 p_vrr_attribute27 in varchar2 default hr_api.g_varchar2,
842 p_vrr_attribute28 in varchar2 default hr_api.g_varchar2,
843 p_vrr_attribute29 in varchar2 default hr_api.g_varchar2,
844 p_vrr_attribute30 in varchar2 default hr_api.g_varchar2,
845 p_object_version_number in out nocopy number,
846 p_effective_date in date,
847 p_datetrack_mode in varchar2
848 ) is
849 --
850 l_rec ben_vrr_shd.g_rec_type;
851 l_proc varchar2(72) := g_package||'upd';
852 --
853 Begin
854 hr_utility.set_location('Entering:'||l_proc, 5);
855 --
856 -- Call conversion function to turn arguments into the
857 -- l_rec structure.
858 --
859 l_rec :=
860 ben_vrr_shd.convert_args
861 (
862 p_vrbl_rt_rl_id,
863 null,
864 null,
865 p_drvbl_fctr_apls_flag,
866 p_rt_trtmt_cd,
867 p_business_group_id,
868 p_formula_id,
869 p_acty_base_rt_id,
870 p_ordr_to_aply_num,
871 p_vrr_attribute_category,
872 p_vrr_attribute1,
873 p_vrr_attribute2,
874 p_vrr_attribute3,
875 p_vrr_attribute4,
876 p_vrr_attribute5,
877 p_vrr_attribute6,
878 p_vrr_attribute7,
879 p_vrr_attribute8,
880 p_vrr_attribute9,
881 p_vrr_attribute10,
882 p_vrr_attribute11,
883 p_vrr_attribute12,
884 p_vrr_attribute13,
885 p_vrr_attribute14,
886 p_vrr_attribute15,
887 p_vrr_attribute16,
888 p_vrr_attribute17,
889 p_vrr_attribute18,
890 p_vrr_attribute19,
891 p_vrr_attribute20,
892 p_vrr_attribute21,
893 p_vrr_attribute22,
894 p_vrr_attribute23,
895 p_vrr_attribute24,
896 p_vrr_attribute25,
897 p_vrr_attribute26,
898 p_vrr_attribute27,
899 p_vrr_attribute28,
900 p_vrr_attribute29,
901 p_vrr_attribute30,
902 p_object_version_number
903 );
904 --
905 -- Having converted the arguments into the
906 -- plsql record structure we call the corresponding record
907 -- business process.
908 --
909 upd(l_rec, p_effective_date, p_datetrack_mode);
910 p_object_version_number := l_rec.object_version_number;
911 p_effective_start_date := l_rec.effective_start_date;
912 p_effective_end_date := l_rec.effective_end_date;
913 --
914 --
915 hr_utility.set_location(' Leaving:'||l_proc, 10);
916 End upd;
917 --
918 end ben_vrr_upd;