1 Package Body ghr_caa_bus as
2 /* $Header: ghcaarhi.pkb 115.1 2003/01/30 19:24:47 asubrahm noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- | Private Global Definitions |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package varchar2(33) := ' ghr_caa_bus.'; -- Global package name
9 --
10 -- The following two global variables are only to be
11 -- used by the return_legislation_code function.
12 --
13 g_legislation_code varchar2(150) default null;
14 g_compl_agency_appeal_id number default null;
15 --
16 -- ---------------------------------------------------------------------------
17 -- |----------------------< set_security_group_id >--------------------------|
18 -- ---------------------------------------------------------------------------
19 --
20 Procedure set_security_group_id
21 (p_compl_agency_appeal_id in number
22 ) is
23 --
24 -- Declare cursor
25 --
26 -- EDIT_HERE In the following cursor statement add join(s) between
27 -- ghr_compl_agency_appeals and PER_BUSINESS_GROUPS
28 -- so that the security_group_id for
29 -- the current business group context can be derived.
30 -- Remove this comment when the edit has been completed.
31 cursor csr_sec_grp is
32 select pbg.security_group_id
33 from per_business_groups pbg
34 , ghr_compl_agency_appeals caa
35 -- , EDIT_HERE table_name(s) 333
36 where caa.compl_agency_appeal_id = p_compl_agency_appeal_id;
37 -- and pbg.business_group_id = EDIT_HERE 333.business_group_id;
38 --
39 -- Declare local variables
40 --
41 l_security_group_id number;
42 l_proc varchar2(72) := g_package||'set_security_group_id';
43 --
44 begin
45 --
46 hr_utility.set_location('Entering:'|| l_proc, 10);
47 --
48 -- Ensure that all the mandatory parameter are not null
49 --
50 hr_api.mandatory_arg_error
51 (p_api_name => l_proc
52 ,p_argument => 'compl_agency_appeal_id'
53 ,p_argument_value => p_compl_agency_appeal_id
54 );
55 --
56 open csr_sec_grp;
57 fetch csr_sec_grp into l_security_group_id;
58 --
59 if csr_sec_grp%notfound then
60 --
61 close csr_sec_grp;
62 --
63 -- The primary key is invalid therefore we must error
64 --
65 fnd_message.set_name('PAY','HR_7220_INVALID_PRIMARY_KEY');
66 fnd_message.raise_error;
67 --
68 end if;
69 close csr_sec_grp;
70 --
71 -- Set the security_group_id in CLIENT_INFO
72 --
73 hr_api.set_security_group_id
74 (p_security_group_id => l_security_group_id
75 );
76 --
77 hr_utility.set_location(' Leaving:'|| l_proc, 20);
78 --
79 end set_security_group_id;
80 --
81 -- ---------------------------------------------------------------------------
82 -- |---------------------< return_legislation_code >-------------------------|
83 -- ---------------------------------------------------------------------------
84 --
85 Function return_legislation_code
86 (p_compl_agency_appeal_id in number
87 )
88 Return Varchar2 Is
89 --
90 -- Declare cursor
91 --
92 -- EDIT_HERE In the following cursor statement add join(s) between
93 -- ghr_compl_agency_appeals and PER_BUSINESS_GROUPS
94 -- so that the legislation_code for
95 -- the current business group context can be derived.
96 -- Remove this comment when the edit has been completed.
97 cursor csr_leg_code is
98 select pbg.legislation_code
99 from per_business_groups pbg
100 , ghr_compl_agency_appeals caa
101 -- , EDIT_HERE table_name(s) 333
102 where caa.compl_agency_appeal_id = p_compl_agency_appeal_id;
103 -- and pbg.business_group_id = EDIT_HERE 333.business_group_id;
104 --
105 -- Declare local variables
106 --
107 l_legislation_code varchar2(150);
108 l_proc varchar2(72) := g_package||'return_legislation_code';
109 --
110 Begin
111 --
112 hr_utility.set_location('Entering:'|| l_proc, 10);
113 --
114 -- Ensure that all the mandatory parameter are not null
115 --
116 hr_api.mandatory_arg_error
117 (p_api_name => l_proc
118 ,p_argument => 'compl_agency_appeal_id'
119 ,p_argument_value => p_compl_agency_appeal_id
120 );
121 --
122 if ( nvl(ghr_caa_bus.g_compl_agency_appeal_id, hr_api.g_number)
123 = p_compl_agency_appeal_id) then
124 --
125 -- The legislation code has already been found with a previous
126 -- call to this function. Just return the value in the global
127 -- variable.
128 --
129 l_legislation_code := ghr_caa_bus.g_legislation_code;
130 hr_utility.set_location(l_proc, 20);
131 else
132 --
133 -- The ID is different to the last call to this function
134 -- or this is the first call to this function.
135 --
136 open csr_leg_code;
137 fetch csr_leg_code into l_legislation_code;
138 --
139 if csr_leg_code%notfound then
140 --
141 -- The primary key is invalid therefore we must error
142 --
143 close csr_leg_code;
144 fnd_message.set_name('PAY','HR_7220_INVALID_PRIMARY_KEY');
145 fnd_message.raise_error;
146 end if;
147 hr_utility.set_location(l_proc,30);
148 --
149 -- Set the global variables so the values are
150 -- available for the next call to this function.
151 --
152 close csr_leg_code;
153 ghr_caa_bus.g_compl_agency_appeal_id := p_compl_agency_appeal_id;
154 ghr_caa_bus.g_legislation_code := l_legislation_code;
155 end if;
156 hr_utility.set_location(' Leaving:'|| l_proc, 40);
157 return l_legislation_code;
158 end return_legislation_code;
159 --
160 -- ----------------------------------------------------------------------------
161 -- |-----------------------< chk_non_updateable_args >------------------------|
162 -- ----------------------------------------------------------------------------
163 -- {Start Of Comments}
164 --
165 -- Description:
166 -- This procedure is used to ensure that non updateable attributes have
167 -- not been updated. If an attribute has been updated an error is generated.
168 --
169 -- Pre Conditions:
170 -- g_old_rec has been populated with details of the values currently in
171 -- the database.
172 --
173 -- In Arguments:
174 -- p_rec has been populated with the updated values the user would like the
175 -- record set to.
176 --
177 -- Post Success:
178 -- Processing continues if all the non updateable attributes have not
179 -- changed.
180 --
181 -- Post Failure:
182 -- An application error is raised if any of the non updatable attributes
183 -- have been altered.
184 --
185 -- {End Of Comments}
186 -- ----------------------------------------------------------------------------
187 Procedure chk_non_updateable_args
188 (p_effective_date in date
189 ,p_rec in ghr_caa_shd.g_rec_type
190 ) IS
191 --
192 l_proc varchar2(72) := g_package || 'chk_non_updateable_args';
193 l_error EXCEPTION;
194 l_argument varchar2(30);
195 --
196 Begin
197 --
198 -- Only proceed with the validation if a row exists for the current
199 -- record in the HR Schema.
200 --
201 IF NOT ghr_caa_shd.api_updating
202 (p_compl_agency_appeal_id => p_rec.compl_agency_appeal_id
203 ,p_object_version_number => p_rec.object_version_number
204 ) THEN
205 fnd_message.set_name('PER', 'HR_6153_ALL_PROCEDURE_FAIL');
206 fnd_message.set_token('PROCEDURE ', l_proc);
207 fnd_message.set_token('STEP ', '5');
208 fnd_message.raise_error;
209 END IF;
210 --
211 -- EDIT_HERE: Add checks to ensure non-updateable args have
212 -- not been updated.
213 --
214 EXCEPTION
215 WHEN l_error THEN
216 hr_api.argument_changed_error
217 (p_api_name => l_proc
218 ,p_argument => l_argument);
219 WHEN OTHERS THEN
220 RAISE;
221 End chk_non_updateable_args;
222 --
223
224 --
225 -----------------------------<chk_reason_for_appeal>----------------------------------
226 --
227 --
228
229 PROCEDURE chk_reason_for_appeal(p_compl_agency_appeal_id in ghr_compl_agency_appeals.compl_agency_appeal_id%TYPE,
230 p_reason_for_appeal in ghr_compl_agency_appeals.reason_for_appeal%TYPE,
231 p_effective_date in date,
232 p_object_version_number in number)
233
234 IS
235
236 l_proc varchar2(72) := g_package||'chk_reason_for_appeal';
237 l_api_updating boolean;
238
239
240 BEGIN
241
242 hr_utility.set_location('Entering: '|| l_proc, 10);
243
244 -- Check Mandatory Parameters are set
245
246 hr_api.mandatory_arg_error
247 (p_api_name => l_proc,
248 p_argument => 'effective date',
249 p_argument_value => p_effective_date
250 );
251
252 --
253 -- Only Proceed with the validation if:
254 --
255 -- a) The current g_old_rec is current and
256 -- b) The reason_for_appeal value has changed
257 -- c) A record is being inserted.
258 --
259
260 l_api_updating := ghr_caa_shd.api_updating(
261 p_compl_agency_appeal_id => p_compl_agency_appeal_id,
262 p_object_version_number => p_object_version_number);
263
264 IF (l_api_updating
265 AND
266 ((nvl(ghr_caa_shd.g_old_rec.reason_for_appeal,hr_api.g_varchar2)
267 <> nvl(p_reason_for_appeal,hr_api.g_varchar2))))
268 OR
269 NOT l_api_updating THEN
270
271 --
272 hr_utility.set_location(l_proc,20);
273 --
274 -- If reason_for_appeal is not null then
275 -- Check if the reason_for_appeal value exists in fnd_lookups
276 -- Where the look up type is 'GHR_US_APPEAL_REASON'
277 --
278
279 IF p_reason_for_appeal is NOT NULL THEN
280
281 IF hr_api.not_exists_in_hr_lookups
282 (p_effective_date => p_effective_date,
283 p_lookup_type => 'GHR_US_APPEAL_REASON',
284 p_lookup_code => p_reason_for_appeal
285 ) THEN
286
287 -- Error: Invalid Subject to IA Action
288
289 -- New Message
290
291 hr_utility.set_message(8301,'GHR_38708_INV_COMP_APPEAL_RESN');
292 hr_utility.raise_error;
293 END IF;
294 hr_utility.set_location(l_proc,30);
295
296 END IF;
297
298 END IF;
299
300 hr_utility.set_location('Leaving: '|| l_proc, 40);
301
302 END chk_reason_for_appeal;
303
304 --
305 -----------------------------<chk_decision>-----------------------------------
306 --
307 --
308
309 PROCEDURE chk_decision(p_compl_agency_appeal_id in ghr_compl_agency_appeals.compl_agency_appeal_id%TYPE,
310 p_decision in ghr_compl_agency_appeals.decision%TYPE,
311 p_effective_date in date,
312 p_object_version_number in number)
313
314 IS
315
316 l_proc varchar2(72) := g_package||'chk_decision';
317 l_api_updating boolean;
318
319
320 BEGIN
321
322 hr_utility.set_location('Entering: '|| l_proc, 10);
323
324 -- Check Mandatory Parameters are set
325
326 hr_api.mandatory_arg_error
327 (p_api_name => l_proc,
328 p_argument => 'effective date',
329 p_argument_value => p_effective_date
330 );
331
332 --
333 -- Only Proceed with the validation if:
334 --
335 -- a) The current g_old_rec is current and
336 -- b) The decision value has changed
337 -- c) A record is being inserted.
338 --
339
340 l_api_updating := ghr_caa_shd.api_updating(
341 p_compl_agency_appeal_id => p_compl_agency_appeal_id,
342 p_object_version_number => p_object_version_number);
343
344 IF (l_api_updating
345 AND
346 ((nvl(ghr_caa_shd.g_old_rec.decision,hr_api.g_varchar2)
347 <> nvl(p_decision,hr_api.g_varchar2))))
348 OR
349 NOT l_api_updating THEN
350
351 --
352 hr_utility.set_location(l_proc,20);
353 --
354 -- If decision is not null then
355 -- Check if the decision value exists in fnd_lookups
356 -- Where the look up type is 'GHR_US_APPEAL_DECISION'
357 --
358
359 --
360 IF p_decision is NOT NULL THEN
361
362 IF hr_api.not_exists_in_hr_lookups
363 (p_effective_date => p_effective_date,
364 p_lookup_type => 'GHR_US_APPEAL_DECISION',
365 p_lookup_code => p_decision
366 ) THEN
367
368 -- Error: Invalid Subject to IA Action
369
370 -- New Message
371
372 hr_utility.set_message(8301,'GHR_38709_INV_COMP_DECISION');
373 hr_utility.raise_error;
374 END IF;
375 hr_utility.set_location(l_proc,30);
376
377 END IF;
378
379 END IF;
380
381 hr_utility.set_location('Leaving: '|| l_proc, 40);
382
383 END chk_decision;
384
385 --
386 -----------------------------<chk_rfr_requested_by>------------------------------------
387 --
388 --
389
390 PROCEDURE chk_rfr_requested_by(p_compl_agency_appeal_id in ghr_compl_agency_appeals.compl_agency_appeal_id%TYPE,
391 p_rfr_requested_by in ghr_compl_agency_appeals.rfr_requested_by%TYPE,
392 p_effective_date in date,
393 p_object_version_number in number)
394
395 IS
396
397 l_proc varchar2(72) := g_package||'chk_rfr_requested_by';
398 l_api_updating boolean;
399
400
401 BEGIN
402
403 hr_utility.set_location('Entering: '|| l_proc, 10);
404
405 -- Check Mandatory Parameters are set
406
407 hr_api.mandatory_arg_error
408 (p_api_name => l_proc,
409 p_argument => 'effective date',
410 p_argument_value => p_effective_date
411 );
412
413 --
414 -- Only Proceed with the validation if:
415 --
416 -- a) The current g_old_rec is current and
417 -- b) The rfr_requested_by value has changed
418 -- c) A record is being inserted.
419 --
420
421 l_api_updating := ghr_caa_shd.api_updating(
422 p_compl_agency_appeal_id => p_compl_agency_appeal_id,
423 p_object_version_number => p_object_version_number);
424
425 IF (l_api_updating
426 AND
427 ((nvl(ghr_caa_shd.g_old_rec.rfr_requested_by,hr_api.g_varchar2)
428 <> nvl(p_rfr_requested_by,hr_api.g_varchar2))))
429 OR
430 NOT l_api_updating THEN
431
432 --
433 hr_utility.set_location(l_proc,20);
434 --
435 -- If rfr_requested_by is not null then
436 -- Check if the rfr_requested_by value exists in fnd_lookups
437 -- Where the look up type is 'GHR_US_REQUESTOR'
438 --
439
440 IF p_rfr_requested_by is NOT NULL THEN
441
442 IF hr_api.not_exists_in_hr_lookups
443 (p_effective_date => p_effective_date,
444 p_lookup_type => 'GHR_US_REQUESTOR',
445 p_lookup_code => p_rfr_requested_by
446 ) THEN
447
448 -- Error: Invalid Subject to IA Action
449
450 -- New Message
451
452 hr_utility.set_message(8301,'GHR_38711_INV_COMP_REQUESTOR');
453 hr_utility.raise_error;
454 END IF;
455 hr_utility.set_location(l_proc,30);
456
457 END IF;
458
459 END IF;
460
461 hr_utility.set_location('Leaving: '|| l_proc, 40);
462
463 END chk_rfr_requested_by;
464
465 --
466 -----------------------------<chk_rfr_decision>------------------------------------
467 --
468 --
469
470 PROCEDURE chk_rfr_decision(p_compl_agency_appeal_id in ghr_compl_agency_appeals.compl_agency_appeal_id%TYPE,
471 p_rfr_decision in ghr_compl_agency_appeals.rfr_decision%TYPE,
472 p_effective_date in date,
473 p_object_version_number in number)
474
475 IS
476
477 l_proc varchar2(72) := g_package||'chk_rfr_decision';
478 l_api_updating boolean;
479
480
481 BEGIN
482
483 hr_utility.set_location('Entering: '|| l_proc, 10);
484
485 -- Check Mandatory Parameters are set
486
487 hr_api.mandatory_arg_error
488 (p_api_name => l_proc,
489 p_argument => 'effective date',
490 p_argument_value => p_effective_date
491 );
492
493 --
494 -- Only Proceed with the validation if:
495 --
496 -- a) The current g_old_rec is current and
497 -- b) The rfr_decision value has changed
498 -- c) A record is being inserted.
499 --
500
501 l_api_updating := ghr_caa_shd.api_updating(
502 p_compl_agency_appeal_id => p_compl_agency_appeal_id,
503 p_object_version_number => p_object_version_number);
504
505 IF (l_api_updating
506 AND
507 ((nvl(ghr_caa_shd.g_old_rec.rfr_decision,hr_api.g_varchar2)
508 <> nvl(p_rfr_decision,hr_api.g_varchar2))))
509 OR
510 NOT l_api_updating THEN
511
512 --
513 hr_utility.set_location(l_proc,20);
514 --
515 -- If rfr_decision is not null then
516 -- Check if the rfr_decision value exists in fnd_lookups
517 -- Where the look up type is 'GHR_US_OFO_RFR_DECISION'
518 --
519
520 IF p_rfr_decision is NOT NULL THEN
521
522 IF hr_api.not_exists_in_hr_lookups
523 (p_effective_date => p_effective_date,
524 p_lookup_type => 'GHR_US_OFO_RFR_DECISION',
525 p_lookup_code => p_rfr_decision
526 ) THEN
527
528 -- Error: Invalid Subject to IA Action
529
530 -- New Message
531
532 hr_utility.set_message(8301,'GHR_38710_INV_COMP_OFO_RFR_DES');
533 hr_utility.raise_error;
534 END IF;
535 hr_utility.set_location(l_proc,30);
536
537 END IF;
538
539 END IF;
540
541 hr_utility.set_location('Leaving: '|| l_proc, 40);
542
543 END chk_rfr_decision;
544
545 --
546 -- ----------------------------------------------------------------------------
547 -- |---------------------------< insert_validate >----------------------------|
548 -- ----------------------------------------------------------------------------
549 Procedure insert_validate
550 (p_effective_date in date
551 ,p_rec in ghr_caa_shd.g_rec_type
552 ) is
553 --
554 l_proc varchar2(72) := g_package||'insert_validate';
555 --
556 Begin
557 hr_utility.set_location('Entering:'||l_proc, 5);
558 --
559 -- Call all supporting business operations
560 --
561 --
562 -- EDIT_HERE: As this table does not have a mandatory business_group_id
563 -- column, ensure client_info is populated by calling a suitable
564 -- ???_???_bus.set_security_group_id procedure, or add one of the following
565 -- comments:
566 -- "-- No business group context. HR_STANDARD_LOOKUPS used for validation."
567 -- "-- CLIENT_INFO not set. No lookup validation or joins to HR_LOOKUPS."
568 --
569 --
570
571 chk_reason_for_appeal(p_compl_agency_appeal_id => p_rec.compl_agency_appeal_id
572 ,p_reason_for_appeal => p_rec.reason_for_appeal
573 ,p_effective_date => p_effective_date
574 ,p_object_version_number => p_rec.object_version_number);
575
576 chk_decision(p_compl_agency_appeal_id => p_rec.compl_agency_appeal_id
577 ,p_decision => p_rec.decision
578 ,p_effective_date => p_effective_date
579 ,p_object_version_number => p_rec.object_version_number);
580
581 chk_rfr_requested_by(p_compl_agency_appeal_id => p_rec.compl_agency_appeal_id
582 ,p_rfr_requested_by => p_rec.rfr_requested_by
583 ,p_effective_date => p_effective_date
584 ,p_object_version_number => p_rec.object_version_number);
585
586 chk_rfr_decision(p_compl_agency_appeal_id => p_rec.compl_agency_appeal_id
587 ,p_rfr_decision => p_rec.rfr_decision
588 ,p_effective_date => p_effective_date
589 ,p_object_version_number => p_rec.object_version_number);
590
591 hr_utility.set_location(' Leaving:'||l_proc, 10);
592 End insert_validate;
593 --
594 -- ----------------------------------------------------------------------------
595 -- |---------------------------< update_validate >----------------------------|
596 -- ----------------------------------------------------------------------------
597 Procedure update_validate
598 (p_effective_date in date
599 ,p_rec in ghr_caa_shd.g_rec_type
600 ) is
601 --
602 l_proc varchar2(72) := g_package||'update_validate';
603 --
604 Begin
605 hr_utility.set_location('Entering:'||l_proc, 5);
606 --
607 -- Call all supporting business operations
608 --
609 --
610 -- EDIT_HERE: As this table does not have a mandatory business_group_id
611 -- column, ensure client_info is populated by calling a suitable
612 -- ???_???_bus.set_security_group_id procedure, or add one of the following
613 -- comments:
614 -- "-- No business group context. HR_STANDARD_LOOKUPS used for validation."
615 -- "-- CLIENT_INFO not set. No lookup validation or joins to HR_LOOKUPS."
616 --
617 chk_non_updateable_args
618 (p_effective_date => p_effective_date
619 ,p_rec => p_rec
620 );
621 --
622
623 chk_reason_for_appeal(p_compl_agency_appeal_id => p_rec.compl_agency_appeal_id
624 ,p_reason_for_appeal => p_rec.reason_for_appeal
625 ,p_effective_date => p_effective_date
626 ,p_object_version_number => p_rec.object_version_number);
627
628 chk_decision(p_compl_agency_appeal_id => p_rec.compl_agency_appeal_id
629 ,p_decision => p_rec.decision
630 ,p_effective_date => p_effective_date
631 ,p_object_version_number => p_rec.object_version_number);
632
633 chk_rfr_requested_by(p_compl_agency_appeal_id => p_rec.compl_agency_appeal_id
634 ,p_rfr_requested_by => p_rec.rfr_requested_by
635 ,p_effective_date => p_effective_date
636 ,p_object_version_number => p_rec.object_version_number);
637
638 chk_rfr_decision(p_compl_agency_appeal_id => p_rec.compl_agency_appeal_id
639 ,p_rfr_decision => p_rec.rfr_decision
640 ,p_effective_date => p_effective_date
641 ,p_object_version_number => p_rec.object_version_number);
642
643
644 --
645 --
646 hr_utility.set_location(' Leaving:'||l_proc, 10);
647 End update_validate;
648 --
649 -- ----------------------------------------------------------------------------
650 -- |---------------------------< delete_validate >----------------------------|
651 -- ----------------------------------------------------------------------------
652 Procedure delete_validate
653 (p_rec in ghr_caa_shd.g_rec_type
654 ) is
655 --
656 l_proc varchar2(72) := g_package||'delete_validate';
657 --
658 Begin
659 hr_utility.set_location('Entering:'||l_proc, 5);
660 --
661 -- Call all supporting business operations
662 --
663 hr_utility.set_location(' Leaving:'||l_proc, 10);
664 End delete_validate;
665 --
666 end ghr_caa_bus;