DBA Data[Home] [Help]

PACKAGE BODY: APPS.GHR_CAA_BUS

Source


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;