DBA Data[Home] [Help]

PACKAGE BODY: APPS.PQH_RMV_BUS

Source


1 Package Body pqh_rmv_bus as
2 /* $Header: pqrmvrhi.pkb 120.2 2005/06/23 03:41 srenukun noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |                     Private Global Definitions                           |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package  varchar2(33) := '  pqh_rmv_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_node_value_id               number         default null;
15 --
16 --  ---------------------------------------------------------------------------
17 --  |----------------------< set_security_group_id >--------------------------|
18 --  ---------------------------------------------------------------------------
19 --
20 Procedure set_security_group_id
21   (p_node_value_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          , pqh_rt_matrix_node_values rmv
32      where rmv.node_value_id = p_node_value_id
33        and pbg.business_group_id (+) = rmv.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           => 'node_value_id'
50     ,p_argument_value     => p_node_value_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,'NODE_VALUE_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_node_value_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          , pqh_rt_matrix_node_values rmv
102      where rmv.node_value_id = p_node_value_id
103        and pbg.business_group_id (+) = rmv.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           => 'node_value_id'
119     ,p_argument_value     => p_node_value_id
120     );
121   --
122   if ( nvl(pqh_rmv_bus.g_node_value_id, hr_api.g_number)
123        = p_node_value_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 := pqh_rmv_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     pqh_rmv_bus.g_node_value_id               := p_node_value_id;
154     pqh_rmv_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 pqh_rmv_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 pqh_rmv_shd.api_updating
199       (p_node_value_id                     => p_rec.node_value_id
200       ,p_object_version_number             => p_rec.object_version_number
201       ) THEN
202      fnd_message.set_name('PER', 'HR_6153_ALL_PROCEDURE_FAIL');
203      fnd_message.set_token('PROCEDURE ', l_proc);
204      fnd_message.set_token('STEP ', '5');
205      fnd_message.raise_error;
206   END IF;
207   --
208   -- EDIT_HERE: Add checks to ensure non-updateable args have
209   --            not been updated.
210   --
211 End chk_non_updateable_args;
212 --
213 -- ----------------------------------------------------------------------------
214 -- |----------------------< chk_startup_action >------------------------------|
215 -- ----------------------------------------------------------------------------
216 --
217 -- Description:
218 --  This procedure will check that the current action is allowed according
219 --  to the current startup mode.
220 --
221 -- ----------------------------------------------------------------------------
222 PROCEDURE chk_startup_action
223   (p_insert               IN boolean
224   ,p_business_group_id    IN number
225   ,p_legislation_code     IN varchar2
226   ,p_legislation_subgroup IN varchar2 DEFAULT NULL) IS
227 --
228 BEGIN
229   --
230   -- Call the supporting procedure to check startup mode
231   -- EDIT_HERE: The following call should be edited if certain types of rows
232   -- are not permitted.
233   IF (p_insert) THEN
234     hr_startup_data_api_support.chk_startup_action
235       (p_generic_allowed   => TRUE
236       ,p_startup_allowed   => TRUE
237       ,p_user_allowed      => TRUE
238       ,p_business_group_id => p_business_group_id
239       ,p_legislation_code  => p_legislation_code
240       ,p_legislation_subgroup => p_legislation_subgroup
241       );
242   ELSE
243     hr_startup_data_api_support.chk_upd_del_startup_action
244       (p_generic_allowed   => TRUE
245       ,p_startup_allowed   => TRUE
246       ,p_user_allowed      => TRUE
247       ,p_business_group_id => p_business_group_id
248       ,p_legislation_code  => p_legislation_code
249       ,p_legislation_subgroup => p_legislation_subgroup
250       );
251   END IF;
252   --
253 END chk_startup_action;
254 --
255 -- ----------------------------------------------------------------------------
256 -- |---------------------------< insert_validate >----------------------------|
257 -- ----------------------------------------------------------------------------
258 Procedure insert_validate
259   (p_rec                          in pqh_rmv_shd.g_rec_type
260   ) is
261 --
262   l_proc  varchar2(72) := g_package||'insert_validate';
263 --
264 Begin
265   hr_utility.set_location('Entering:'||l_proc, 5);
266   --
267   -- Call all supporting business operations
268   --
269   --
270   chk_startup_action(true
271                     ,p_rec.business_group_id
272                     ,p_rec.legislation_code
273                     );
274   IF hr_startup_data_api_support.g_startup_mode
275                      NOT IN ('GENERIC','STARTUP') THEN
276      --
277      -- Validate Important Attributes
278      --
279      hr_api.validate_bus_grp_id
280        (p_business_group_id => p_rec.business_group_id
281        ,p_associated_column1 => pqh_rmv_shd.g_tab_nam
282                                 || '.BUSINESS_GROUP_ID');
283      --
284      -- after validating the set of important attributes,
285      -- if Multiple Message Detection is enabled and at least
286      -- one error has been found then abort further validation.
287      --
288      hr_multi_message.end_validation_set;
289   END IF;
290   --
291   --
292   -- Validate Dependent Attributes
293   --
294   --
295   hr_utility.set_location(' Leaving:'||l_proc, 10);
296 End insert_validate;
297 --
298 -- ----------------------------------------------------------------------------
299 -- |---------------------------< update_validate >----------------------------|
300 -- ----------------------------------------------------------------------------
301 Procedure update_validate
302   (p_rec                          in pqh_rmv_shd.g_rec_type
303   ) is
304 --
305   l_proc  varchar2(72) := g_package||'update_validate';
306 --
307 Begin
308   hr_utility.set_location('Entering:'||l_proc, 5);
309   --
310   -- Call all supporting business operations
311   --
312   --
313   chk_startup_action(false
314                     ,p_rec.business_group_id
315                     ,p_rec.legislation_code
316                     );
317   IF hr_startup_data_api_support.g_startup_mode
318                      NOT IN ('GENERIC','STARTUP') THEN
319      --
320      -- Validate Important Attributes
321      --
322      hr_api.validate_bus_grp_id
323        (p_business_group_id => p_rec.business_group_id
324        ,p_associated_column1 => pqh_rmv_shd.g_tab_nam
325                                 || '.BUSINESS_GROUP_ID');
326      --
327      -- After validating the set of important attributes,
328      -- if Multiple Message Detection is enabled and at least
329      -- one error has been found then abort further validation.
330      --
331      hr_multi_message.end_validation_set;
332   END IF;
333   --
334   --
335   -- Validate Dependent Attributes
336   --
337   chk_non_updateable_args
338     (p_rec              => p_rec
339     );
340   --
341   --
342   hr_utility.set_location(' Leaving:'||l_proc, 10);
343 End update_validate;
344 --
345 -- ----------------------------------------------------------------------------
346 -- |---------------------------< delete_validate >----------------------------|
347 -- ----------------------------------------------------------------------------
348 Procedure delete_validate
349   (p_rec                          in pqh_rmv_shd.g_rec_type
350   ) is
351 --
352   l_proc  varchar2(72) := g_package||'delete_validate';
353 --
354 Begin
355   hr_utility.set_location('Entering:'||l_proc, 5);
356   --
357     --
358   chk_startup_action(false
359                     ,pqh_rmv_shd.g_old_rec.business_group_id
360                     ,pqh_rmv_shd.g_old_rec.legislation_code
361                     );
362   IF hr_startup_data_api_support.g_startup_mode
363                      NOT IN ('GENERIC','STARTUP') THEN
364      --
365      -- Validate Important Attributes
366      --
367      --
368      -- After validating the set of important attributes,
369      -- if Multiple Message Detection is enabled and at least
370      -- one error has been found then abort further validation.
371      --
372      hr_multi_message.end_validation_set;
373   END IF;
374   --
375   -- Call all supporting business operations
376   --
377   hr_utility.set_location(' Leaving:'||l_proc, 10);
378 End delete_validate;
379 --
380 end pqh_rmv_bus;