DBA Data[Home] [Help]

PACKAGE BODY: APPS.PAY_BLD_BUS

Source


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;
74     hr_api.set_security_group_id
71     --
72     -- Set the security_group_id in CLIENT_INFO
73     --
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
223   ,p_legislation_subgroup IN varchar2 DEFAULT NULL) IS
220   (p_insert               IN boolean
221   ,p_business_group_id    IN number
222   ,p_legislation_code     IN varchar2
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      --
370   -- Call all supporting business operations
367      hr_multi_message.end_validation_set;
368   END IF;
369   --
371   --
372   hr_utility.set_location(' Leaving:'||l_proc, 10);
373 End delete_validate;
374 --
375 end pay_bld_bus;