DBA Data[Home] [Help]

PACKAGE BODY: APPS.GHR_CDT_BUS

Source


1 Package Body ghr_cdt_bus as
2 /* $Header: ghcdtrhi.pkb 115.4 2003/01/30 19:25:13 asubrahm noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |                     Private Global Definitions                           |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package  varchar2(33) := '  ghr_cdt_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_ca_detail_id          number         default null;
15 --
16 --  ---------------------------------------------------------------------------
17 --  |----------------------< set_security_group_id >--------------------------|
18 --  ---------------------------------------------------------------------------
19 --
20 Procedure set_security_group_id
21   (p_compl_ca_detail_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_ca_details 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_ca_details cdt
35       --   , EDIT_HERE table_name(s) 333
36      where cdt.compl_ca_detail_id = p_compl_ca_detail_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_ca_detail_id'
53     ,p_argument_value     => p_compl_ca_detail_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_ca_detail_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_ca_details 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_ca_details cdt
101       --   , EDIT_HERE table_name(s) 333
102      where cdt.compl_ca_detail_id = p_compl_ca_detail_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_ca_detail_id'
119     ,p_argument_value     => p_compl_ca_detail_id
120     );
121   --
122   if ( nvl(ghr_cdt_bus.g_compl_ca_detail_id, hr_api.g_number)
123        = p_compl_ca_detail_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_cdt_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_cdt_bus.g_compl_ca_detail_id          := p_compl_ca_detail_id;
154     ghr_cdt_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_cdt_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_cdt_shd.api_updating
202       (p_compl_ca_detail_id                   => p_rec.compl_ca_detail_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_category>------------------------------
226 --
227 --
228 
229 PROCEDURE chk_category(p_compl_ca_detail_id   in ghr_compl_ca_details.compl_ca_detail_id%TYPE,
230 		       p_category              in ghr_compl_ca_details.category%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_category';
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 category value has changed
257 -- c) A record is being inserted.
258 --
259 
260 	l_api_updating := ghr_cdt_shd.api_updating(
261 					p_compl_ca_detail_id  => p_compl_ca_detail_id,
262 					p_object_version_number	=> p_object_version_number);
263 
264 	IF (l_api_updating
265         AND
266         ((nvl(ghr_cdt_shd.g_old_rec.category,hr_api.g_varchar2)
267 				<> nvl(p_category,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 category is not null then
275 --	Check if the category value exists in fnd_lookups
276 --	Where the look up type is 'GHR_US_CA_CATEGORIES'
277 --
278 
279 	IF p_category 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_CA_CATEGORIES',
284 			 p_lookup_code	=>	p_category
285 			) THEN
286 
287 	-- Error: Invalid Subject to IA Action
288 
289                -- New Message
290 
291 	       hr_utility.set_message(8301,'GHR_38704_INV_COMP_CATEGORY');
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_category;
303 
304 --
305 -----------------------------<chk_type>-------------------------------------
306 --
307 --
308 /*
309 PROCEDURE chk_type(p_compl_ca_detail_id   in ghr_compl_ca_details.compl_ca_detail_id%TYPE,
310 		   p_category              in ghr_compl_ca_details.category%TYPE,
311                    p_type                  in ghr_compl_ca_details.type%TYPE,
312 		   p_effective_date        in date,
313 		   p_object_version_number in number)
314 
315 IS
316 
317 l_proc	varchar2(72) := g_package||'chk_type';
318 l_api_updating boolean;
319 
320 l_monetary         varchar2(30) := '10'; -- Lookup code for 'Category' in fnd_common_lookups having Meaning Monetary
321 l_non_monetary     varchar2(30) := '20'; -- Lookup code for 'Category' in fnd_common_lookups having Meaning Non Monetary
322 l_lookup_type      varchar2(30);
323 BEGIN
324 
325 	hr_utility.set_location('Entering: '|| l_proc, 10);
326 
327 -- Check Mandatory Parameters are set
328 
329 	hr_api.mandatory_arg_error
330 		(p_api_name	 => l_proc,
331          	p_argument       => 'effective date',
332          	p_argument_value => p_effective_date
333 		);
334 
335 --
336 -- Only Proceed with the validation if:
337 --
338 -- a) The current g_old_rec is current and
339 -- b) The type value has changed
340 -- c) A record is being inserted.
341 --
342 
343 	l_api_updating := ghr_cdt_shd.api_updating(
344 					p_compl_ca_detail_id  => p_compl_ca_detail_id,
345 					p_object_version_number	=> p_object_version_number);
346 
347 	IF (l_api_updating
348         AND
349         ((nvl(ghr_cdt_shd.g_old_rec.type,hr_api.g_varchar2)
350 				<> nvl(p_type,hr_api.g_varchar2))))
351         OR
352 	NOT l_api_updating THEN
353 
354 --
355 	hr_utility.set_location(l_proc,20);
356 --
357 -- 	If type is not null then
358 --	If category value = '10' (Monetary) then check if the type value exists in fnd_lookups
359 --	Where the look up type is 'GHR_US_CA_TYPE_MONETARY'
360 --
361 --	If category value = '20' (Non Monetary) then check if the type value exists in fnd_lookups
362 --	Where the look up type is 'GHR_US_CA_TYPE_NON_MONETARY'
363 --
364 --
365 
366 	IF p_type is NOT NULL THEN
367            IF p_category = l_monetary then
368              l_lookup_type := 'GHR_US_CA_TYPE_MONETARY';
369            ELSIF p_category = l_non_monetary then
370              l_lookup_type := 'GHR_US_CA_TYPE_NON_MONETARY';
371            END IF;
372 
373 	   IF hr_api.not_exists_in_hr_lookups
374 			(p_effective_date	=>	p_effective_date,
375 			 p_lookup_type	=>    l_lookup_type,
376 			 p_lookup_code	=>	p_type
377 			) THEN
378 
379 	-- Error: Invalid Subject to IA Action
380 
381                -- New Message
382 
383 	       hr_utility.set_message(8301,'GHR_38705_INV_COMP_TYPE');
384 	       hr_utility.raise_error;
385 	   END IF;
386 	   hr_utility.set_location(l_proc,30);
387 
388 	END IF;
389 
390      END IF;
391 
392      hr_utility.set_location('Leaving: '|| l_proc, 40);
393 
394 END chk_type;
395 */
396 
397 --
398 -----------------------------<chk_phase>-----------------------------------
399 --
400 --
401 
402 PROCEDURE chk_phase(p_compl_ca_detail_id   in ghr_compl_ca_details.compl_ca_detail_id%TYPE,
403 		    p_phase                 in ghr_compl_ca_details.phase%TYPE,
404 		    p_effective_date        in date,
405 		    p_object_version_number in number)
406 
407 IS
408 
409 l_proc	varchar2(72) := g_package||'chk_phase';
410 l_api_updating boolean;
411 
412 
413 BEGIN
414 
415 	hr_utility.set_location('Entering: '|| l_proc, 10);
416 
417 -- Check Mandatory Parameters are set
418 
419 	hr_api.mandatory_arg_error
420 		(p_api_name	 => l_proc,
421          	p_argument       => 'effective date',
422          	p_argument_value => p_effective_date
423 		);
424 
425 --
426 -- Only Proceed with the validation if:
427 --
428 -- a) The current g_old_rec is current and
429 -- b) The phase value has changed
430 -- c) A record is being inserted.
431 --
432 
433 	l_api_updating := ghr_cdt_shd.api_updating(
434 					p_compl_ca_detail_id  => p_compl_ca_detail_id,
435 					p_object_version_number	=> p_object_version_number);
436 
437 	IF (l_api_updating
438         AND
439         ((nvl(ghr_cdt_shd.g_old_rec.phase,hr_api.g_varchar2)
440 				<> nvl(p_phase,hr_api.g_varchar2))))
441         OR
442 	NOT l_api_updating THEN
443 
444 --
445 	hr_utility.set_location(l_proc,20);
446 --
447 -- 	If phase is not null then
448 --	Check if the phase value exists in fnd_lookups
449 --	Where the look up type is 'GHR_US_CA_PHASES'
450 --
451 
452 	IF p_phase is NOT NULL THEN
453 
454 	   IF hr_api.not_exists_in_hr_lookups
455 			(p_effective_date	=>	p_effective_date,
456 			 p_lookup_type	=>    'GHR_US_CA_PHASES',
457 			 p_lookup_code	=>	p_phase
458 			) THEN
459 
463 
460 	-- Error: Invalid Subject to IA Action
461 
462                -- New Message
464 	       hr_utility.set_message(8301,'GHR_38706_INV_COMP_PHASE');
465 	       hr_utility.raise_error;
466 	   END IF;
467 	   hr_utility.set_location(l_proc,30);
468 
469 	END IF;
470 
471      END IF;
472 
473      hr_utility.set_location('Leaving: '|| l_proc, 40);
474 
475 END chk_phase;
476 
477 --
478 -- ----------------------------------------------------------------------------
479 -- |---------------------------< insert_validate >----------------------------|
480 -- ----------------------------------------------------------------------------
481 Procedure insert_validate
482   (p_effective_date               in date
483   ,p_rec                          in ghr_cdt_shd.g_rec_type
484   ) is
485 --
486   l_proc  varchar2(72) := g_package||'insert_validate';
487 --
488 Begin
489   hr_utility.set_location('Entering:'||l_proc, 5);
490   --
491   -- Call all supporting business operations
492   --
493   --
494   -- EDIT_HERE: As this table does not have a mandatory business_group_id
495   -- column, ensure client_info is populated by calling a suitable
496   -- ???_???_bus.set_security_group_id procedure, or add one of the following
497   -- comments:
498   -- "-- No business group context.  HR_STANDARD_LOOKUPS used for validation."
499   -- "-- CLIENT_INFO not set.  No lookup validation or joins to HR_LOOKUPS."
500   --
501   --
502 
503   chk_category(p_compl_ca_detail_id    => p_rec.compl_ca_detail_id
504               ,p_category              => p_rec.category
505               ,p_effective_date        => p_effective_date
506               ,p_object_version_number => p_rec.object_version_number);
507 /*
508   chk_type(p_compl_ca_detail_id    => p_rec.compl_ca_detail_id
509           ,p_category              => p_rec.category
510           ,p_type                  => p_rec.type
511           ,p_effective_date        => p_effective_date
512           ,p_object_version_number => p_rec.object_version_number);
513 */
514 
515   chk_phase(p_compl_ca_detail_id    => p_rec.compl_ca_detail_id
516            ,p_phase                 => p_rec.phase
517            ,p_effective_date        => p_effective_date
518            ,p_object_version_number => p_rec.object_version_number);
519 
520 
521   hr_utility.set_location(' Leaving:'||l_proc, 10);
522 End insert_validate;
523 --
524 -- ----------------------------------------------------------------------------
525 -- |---------------------------< update_validate >----------------------------|
526 -- ----------------------------------------------------------------------------
527 Procedure update_validate
528   (p_effective_date               in date
529   ,p_rec                          in ghr_cdt_shd.g_rec_type
530   ) is
531 --
532   l_proc  varchar2(72) := g_package||'update_validate';
533 --
534 Begin
535   hr_utility.set_location('Entering:'||l_proc, 5);
536   --
537   -- Call all supporting business operations
538   --
539   --
540   -- EDIT_HERE: As this table does not have a mandatory business_group_id
541   -- column, ensure client_info is populated by calling a suitable
542   -- ???_???_bus.set_security_group_id procedure, or add one of the following
543   -- comments:
544   -- "-- No business group context.  HR_STANDARD_LOOKUPS used for validation."
545   -- "-- CLIENT_INFO not set.  No lookup validation or joins to HR_LOOKUPS."
546   --
547   chk_non_updateable_args
548     (p_effective_date              => p_effective_date
549       ,p_rec              => p_rec
550     );
551 
552   --
553   chk_category(p_compl_ca_detail_id    => p_rec.compl_ca_detail_id
554               ,p_category              => p_rec.category
555               ,p_effective_date        => p_effective_date
556               ,p_object_version_number => p_rec.object_version_number);
557 
558 /*
559   chk_type(p_compl_ca_detail_id    => p_rec.compl_ca_detail_id
560           ,p_category              => p_rec.category
561           ,p_type                  => p_rec.type
562           ,p_effective_date        => p_effective_date
563           ,p_object_version_number => p_rec.object_version_number);
564 */
565 
566   chk_phase(p_compl_ca_detail_id    => p_rec.compl_ca_detail_id
567            ,p_phase                 => p_rec.phase
568            ,p_effective_date        => p_effective_date
569            ,p_object_version_number => p_rec.object_version_number);
570 
571 
572   --
573   --
574   hr_utility.set_location(' Leaving:'||l_proc, 10);
575 End update_validate;
576 --
577 -- ----------------------------------------------------------------------------
578 -- |---------------------------< delete_validate >----------------------------|
579 -- ----------------------------------------------------------------------------
580 Procedure delete_validate
581   (p_rec                          in ghr_cdt_shd.g_rec_type
582   ) is
583 --
584   l_proc  varchar2(72) := g_package||'delete_validate';
585 --
586 Begin
587   hr_utility.set_location('Entering:'||l_proc, 5);
588   --
589   -- Call all supporting business operations
590   --
591   hr_utility.set_location(' Leaving:'||l_proc, 10);
592 End delete_validate;
593 --
594 end ghr_cdt_bus;