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;