1 Package Body pay_bld_bus as
2 /* $Header: pybldrhi.pkb 120.0 2005/05/29 03:19 appldev noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- | Private Global Definitions |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package varchar2(33) := ' pay_bld_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_balance_dimension_id number default null;
15 --
16 -- ---------------------------------------------------------------------------
17 -- |----------------------< set_security_group_id >--------------------------|
18 -- ---------------------------------------------------------------------------
19 --
20 Procedure set_security_group_id
21 (p_balance_dimension_id in number
22 ,p_associated_column1 in varchar2 default null
23 ) is
24 --
25 -- Declare cursor
26 --
27 cursor csr_sec_grp is
28 select pbg.security_group_id,
29 pbg.legislation_code
30 from per_business_groups_perf pbg
31 , pay_balance_dimensions bld
32 where bld.balance_dimension_id = p_balance_dimension_id
33 and pbg.business_group_id (+) = bld.business_group_id;
34 --
35 -- Declare local variables
36 --
37 l_security_group_id number;
38 l_proc varchar2(72) := g_package||'set_security_group_id';
39 l_legislation_code varchar2(150);
40 --
41 begin
42 --
43 hr_utility.set_location('Entering:'|| l_proc, 10);
44 --
45 -- Ensure that all the mandatory parameter are not null
46 --
47 hr_api.mandatory_arg_error
48 (p_api_name => l_proc
49 ,p_argument => 'balance_dimension_id'
50 ,p_argument_value => p_balance_dimension_id
51 );
52 --
53 open csr_sec_grp;
54 fetch csr_sec_grp into l_security_group_id
55 , l_legislation_code;
56 --
57 if csr_sec_grp%notfound then
58 --
59 close csr_sec_grp;
60 --
61 -- The primary key is invalid therefore we must error
62 --
63 fnd_message.set_name('PAY','HR_7220_INVALID_PRIMARY_KEY');
64 hr_multi_message.add
65 (p_associated_column1
66 => nvl(p_associated_column1,'BALANCE_DIMENSION_ID')
67 );
68 --
69 else
70 close csr_sec_grp;
71 --
72 -- Set the security_group_id in CLIENT_INFO
73 --
74 hr_api.set_security_group_id
75 (p_security_group_id => l_security_group_id
76 );
77 --
78 -- Set the sessions legislation context in HR_SESSION_DATA
79 --
80 hr_api.set_legislation_context(l_legislation_code);
81 end if;
82 --
83 hr_utility.set_location(' Leaving:'|| l_proc, 20);
84 --
85 end set_security_group_id;
86 --
87 -- ---------------------------------------------------------------------------
88 -- |---------------------< return_legislation_code >-------------------------|
89 -- ---------------------------------------------------------------------------
90 --
91 Function return_legislation_code
92 (p_balance_dimension_id in number
93 )
94 Return Varchar2 Is
95 --
96 -- Declare cursor
97 --
98 cursor csr_leg_code is
99 select pbg.legislation_code
100 from per_business_groups_perf pbg
101 , pay_balance_dimensions bld
102 where bld.balance_dimension_id = p_balance_dimension_id
103 and pbg.business_group_id (+) = bld.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 => 'balance_dimension_id'
119 ,p_argument_value => p_balance_dimension_id
120 );
121 --
122 if ( nvl(pay_bld_bus.g_balance_dimension_id, hr_api.g_number)
123 = p_balance_dimension_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 := pay_bld_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 pay_bld_bus.g_balance_dimension_id := p_balance_dimension_id;
154 pay_bld_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_rec in pay_bld_shd.g_rec_type
189 ) IS
190 --
191 l_proc varchar2(72) := g_package || 'chk_non_updateable_args';
192 --
193 Begin
194 --
195 -- Only proceed with the validation if a row exists for the current
196 -- record in the HR Schema.
197 --
198 IF NOT pay_bld_shd.api_updating
199 (p_balance_dimension_id => p_rec.balance_dimension_id
200 ) THEN
201 fnd_message.set_name('PER', 'HR_6153_ALL_PROCEDURE_FAIL');
202 fnd_message.set_token('PROCEDURE ', l_proc);
203 fnd_message.set_token('STEP ', '5');
204 fnd_message.raise_error;
205 END IF;
206 --
207 --
208 End chk_non_updateable_args;
209 --
210 -- ----------------------------------------------------------------------------
211 -- |----------------------< chk_startup_action >------------------------------|
212 -- ----------------------------------------------------------------------------
213 --
214 -- Description:
215 -- This procedure will check that the current action is allowed according
216 -- to the current startup mode.
217 --
218 -- ----------------------------------------------------------------------------
219 PROCEDURE chk_startup_action
220 (p_insert IN boolean
221 ,p_business_group_id IN number
222 ,p_legislation_code IN varchar2
223 ,p_legislation_subgroup IN varchar2 DEFAULT NULL) IS
224 --
225 BEGIN
226 --
227 -- Call the supporting procedure to check startup mode
228 IF (p_insert) THEN
229 hr_startup_data_api_support.chk_startup_action
230 (p_generic_allowed => TRUE
231 ,p_startup_allowed => TRUE
232 ,p_user_allowed => TRUE
233 ,p_business_group_id => p_business_group_id
234 ,p_legislation_code => p_legislation_code
235 ,p_legislation_subgroup => p_legislation_subgroup
236 );
237 ELSE
238 hr_startup_data_api_support.chk_upd_del_startup_action
239 (p_generic_allowed => TRUE
240 ,p_startup_allowed => TRUE
241 ,p_user_allowed => TRUE
242 ,p_business_group_id => p_business_group_id
243 ,p_legislation_code => p_legislation_code
244 ,p_legislation_subgroup => p_legislation_subgroup
245 );
246 END IF;
247 --
248 END chk_startup_action;
249 --
250 -- ----------------------------------------------------------------------------
251 -- |---------------------------< insert_validate >----------------------------|
252 -- ----------------------------------------------------------------------------
253 Procedure insert_validate
254 (p_rec in pay_bld_shd.g_rec_type
255 ) is
256 --
257 l_proc varchar2(72) := g_package||'insert_validate';
258 --
259 Begin
260 hr_utility.set_location('Entering:'||l_proc, 5);
261 --
262 -- Call all supporting business operations
263 --
264 --
265 chk_startup_action(true
266 ,p_rec.business_group_id
267 ,p_rec.legislation_code
268 );
269 IF hr_startup_data_api_support.g_startup_mode
270 NOT IN ('GENERIC','STARTUP') THEN
271 --
272 -- Validate Important Attributes
273 --
274 hr_api.validate_bus_grp_id
275 (p_business_group_id => p_rec.business_group_id
276 ,p_associated_column1 => pay_bld_shd.g_tab_nam
277 || '.BUSINESS_GROUP_ID');
278 --
279 -- after validating the set of important attributes,
280 -- if Multiple Message Detection is enabled and at least
281 -- one error has been found then abort further validation.
282 --
283 hr_multi_message.end_validation_set;
284 END IF;
285 --
286 --
287 -- Validate Dependent Attributes
288 --
289 --
290 hr_utility.set_location(' Leaving:'||l_proc, 10);
291 End insert_validate;
292 --
293 -- ----------------------------------------------------------------------------
294 -- |---------------------------< update_validate >----------------------------|
295 -- ----------------------------------------------------------------------------
296 Procedure update_validate
297 (p_rec in pay_bld_shd.g_rec_type
298 ) is
299 --
300 l_proc varchar2(72) := g_package||'update_validate';
301 --
302 Begin
303 hr_utility.set_location('Entering:'||l_proc, 5);
304 --
305 -- Call all supporting business operations
306 --
307 --
308 chk_startup_action(false
309 ,p_rec.business_group_id
310 ,p_rec.legislation_code
311 );
312 IF hr_startup_data_api_support.g_startup_mode
313 NOT IN ('GENERIC','STARTUP') THEN
314 --
315 -- Validate Important Attributes
316 --
317 hr_api.validate_bus_grp_id
318 (p_business_group_id => p_rec.business_group_id
319 ,p_associated_column1 => pay_bld_shd.g_tab_nam
320 || '.BUSINESS_GROUP_ID');
321 --
322 -- After validating the set of important attributes,
323 -- if Multiple Message Detection is enabled and at least
324 -- one error has been found then abort further validation.
325 --
326 hr_multi_message.end_validation_set;
327 END IF;
328 --
329 --
330 -- Validate Dependent Attributes
331 --
332 chk_non_updateable_args
333 (p_rec => p_rec
334 );
335 --
336 --
337 hr_utility.set_location(' Leaving:'||l_proc, 10);
338 End update_validate;
339 --
340 -- ----------------------------------------------------------------------------
341 -- |---------------------------< delete_validate >----------------------------|
342 -- ----------------------------------------------------------------------------
343 Procedure delete_validate
344 (p_rec in pay_bld_shd.g_rec_type
345 ) is
346 --
347 l_proc varchar2(72) := g_package||'delete_validate';
348 --
349 Begin
350 hr_utility.set_location('Entering:'||l_proc, 5);
351 --
352 --
353 chk_startup_action(false
354 ,pay_bld_shd.g_old_rec.business_group_id
355 ,pay_bld_shd.g_old_rec.legislation_code
356 );
357 IF hr_startup_data_api_support.g_startup_mode
358 NOT IN ('GENERIC','STARTUP') THEN
359 --
360 -- Validate Important Attributes
361 --
362 --
363 -- After validating the set of important attributes,
364 -- if Multiple Message Detection is enabled and at least
365 -- one error has been found then abort further validation.
366 --
367 hr_multi_message.end_validation_set;
368 END IF;
369 --
370 -- Call all supporting business operations
371 --
372 hr_utility.set_location(' Leaving:'||l_proc, 10);
373 End delete_validate;
374 --
375 end pay_bld_bus;