1 Package Body per_cnl_bus as
2 /* $Header: pecnlrhi.pkb 120.0 2005/05/31 06:55 appldev noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- | Private Global Definitions |
6 -- ----------------------------------------------------------------------------
7 --
8 g_package varchar2(33) := ' per_cnl_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_location_id number default null;
15 --
16 -- ---------------------------------------------------------------------------
17 -- |----------------------< set_security_group_id >--------------------------|
18 -- ---------------------------------------------------------------------------
19 --
20 Procedure set_security_group_id
21 (p_location_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 Null,Null --pbg.security_group_id,
29 --pbg.legislation_code
30 from -- per_business_groups_perf pbg
31 per_ri_config_locations cnl
32 where cnl.location_id = p_location_id;
33 --and pbg.business_group_id (+) = cnl.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 => 'location_id'
50 ,p_argument_value => p_location_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,'LOCATION_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_location_id in number
93 )
94 Return Varchar2 Is
95 --
96 -- Declare cursor
97 --
98 cursor csr_leg_code is
99 select Null --pbg.legislation_code
100 from -- per_business_groups_perf pbg
101 per_ri_config_locations cnl
102 where cnl.location_id = p_location_id;
103 --and pbg.business_group_id (+) = cnl.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 => 'location_id'
119 ,p_argument_value => p_location_id
120 );
121 --
122 if ( nvl(per_cnl_bus.g_location_id, hr_api.g_number)
123 = p_location_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 := per_cnl_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 per_cnl_bus.g_location_id := p_location_id;
154 per_cnl_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 per_cnl_shd.g_rec_type
190 ) IS
191 --
192 l_proc varchar2(72) := g_package || 'chk_non_updateable_args';
193 --
194 Begin
195 --
196 -- Only proceed with the validation if a row exists for the current
197 -- record in the HR Schema.
198 --
199 IF NOT per_cnl_shd.api_updating
200 (p_location_id => p_rec.location_id
201 ,p_object_version_number => p_rec.object_version_number
202 ) THEN
203 fnd_message.set_name('PER', 'HR_6153_ALL_PROCEDURE_FAIL');
204 fnd_message.set_token('PROCEDURE ', l_proc);
205 fnd_message.set_token('STEP ', '5');
206 fnd_message.raise_error;
207 END IF;
208 --
209 -- EDIT_HERE: Add checks to ensure non-updateable args have
210 -- not been updated.
211 --
212 End chk_non_updateable_args;
213 --
214 -- ----------------------------------------------------------------------------
215 -- |---------------------------< insert_validate >----------------------------|
216 -- ----------------------------------------------------------------------------
217 Procedure insert_validate
218 (p_effective_date in date
219 ,p_rec in per_cnl_shd.g_rec_type
220 ) is
221 --
222 l_proc varchar2(72) := g_package||'insert_validate';
223 --
224 Begin
225 hr_utility.set_location('Entering:'||l_proc, 5);
226 --
227 -- Call all supporting business operations
228 --
229 -- EDIT_HERE: The following call to hr_api.validate_bus_grp_id
230 -- will only be valid when the business_group_id is not null.
231 -- As this column is defined as optional on the table then
232 -- different logic will be required to handle the null case.
233 -- If this is a start-up data entity then:
234 -- a) add code to stop null values being processed by this
235 -- row handler
236 -- If this is not a start-up data entity then either:
237 -- b) ignore the security_group_id value held in
238 -- client_info. This includes performing lookup
239 -- validation against the HR_STANDARD_LOOKUPS view.
240 -- or c) (less likely) ensure the correct security_group_id
241 -- value is set in client_info.
242 -- Remove this comment when the edit has been completed.
243 -- Validate Important Attributes
244 /* hr_api.validate_bus_grp_id
245 (p_business_group_id => p_rec.business_group_id
246 ,p_associated_column1 => per_cnl_shd.g_tab_nam|| '.BUSINESS_GROUP_ID'); */
247 --
248 -- After validating the set of important attributes,
249 -- if Multiple Message detection is enabled and at least
250 -- one error has been found then abort further validation.
251 --
252 hr_multi_message.end_validation_set;
253 --
254 -- Validate Dependent Attributes
255 --
256 --
257 hr_utility.set_location(' Leaving:'||l_proc, 10);
258 End insert_validate;
259 --
260 -- ----------------------------------------------------------------------------
261 -- |---------------------------< update_validate >----------------------------|
262 -- ----------------------------------------------------------------------------
263 Procedure update_validate
264 (p_effective_date in date
265 ,p_rec in per_cnl_shd.g_rec_type
266 ) is
267 --
268 l_proc varchar2(72) := g_package||'update_validate';
269 --
270 Begin
271 hr_utility.set_location('Entering:'||l_proc, 5);
272 --
273 -- Call all supporting business operations
274 --
275 -- EDIT_HERE: The following call to hr_api.validate_bus_grp_id
276 -- will only be valid when the business_group_id is not null.
277 -- As this column is defined as optional on the table then
278 -- different logic will be required to handle the null case.
279 -- If this is a start-up data entity then:
280 -- a) add code to stop null values being processed by this
281 -- row handler
282 -- If this is not a start-up data entity then either:
283 -- b) ignore the security_group_id value held in
284 -- client_info. This includes performing lookup
285 -- validation against the HR_STANDARD_LOOKUPS view.
286 -- or c) (less likely) ensure the correct security_group_id
287 -- value is set in client_info.
288 -- Remove this comment when the edit has been completed.
289 -- Validate Important Attributes
290 /* hr_api.validate_bus_grp_id
291 (p_business_group_id => p_rec.business_group_id
292 ,p_associated_column1 => per_cnl_shd.g_tab_nam
293 || '.BUSINESS_GROUP_ID'); */
294 --
295 -- After validating the set of important attributes,
296 -- if Multiple Message detection is enabled and at least
297 -- one error has been found then abort further validation.
298 --
299 hr_multi_message.end_validation_set;
300 --
301 -- Validate Dependent Attributes
302 --
303 chk_non_updateable_args
304 (p_effective_date => p_effective_date
305 ,p_rec => p_rec
306 );
307 --
308 --
309 hr_utility.set_location(' Leaving:'||l_proc, 10);
310 End update_validate;
311 --
315 Procedure delete_validate
312 -- ----------------------------------------------------------------------------
313 -- |---------------------------< delete_validate >----------------------------|
314 -- ----------------------------------------------------------------------------
316 (p_rec in per_cnl_shd.g_rec_type
317 ) is
318 --
319 l_proc varchar2(72) := g_package||'delete_validate';
320 --
321 Begin
322 hr_utility.set_location('Entering:'||l_proc, 5);
323 --
324 -- Call all supporting business operations
325 --
326 hr_utility.set_location(' Leaving:'||l_proc, 10);
327 End delete_validate;
328 --
329 end per_cnl_bus;