1 Package per_spp_upd as
2 /* $Header: pespprhi.pkh 120.1 2005/12/12 21:15:29 vbanner noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |---------------------------------< upd >----------------------------------|
6 -- ----------------------------------------------------------------------------
7 -- {Start Of Comments}
8 --
9 -- Description:
10 -- This procedure is the record interface for the update
11 -- process for the specified entity. The role of this process is
12 -- to perform the datetrack update mode, fully validating the row
13 -- for the HR schema passing back to the calling process, any system
14 -- generated values (e.g. object version number attribute). This process
15 -- is the main backbone of the upd process. The processing of
16 -- this procedure is as follows:
17 -- 1) Ensure that the datetrack update mode is valid.
18 -- 2) The row to be updated is then locked and selected into the record
19 -- structure g_old_rec.
20 -- 3) Because on update parameters which are not part of the update do not
21 -- have to be defaulted, we need to build up the updated row by
22 -- converting any system defaulted parameters to their corresponding
23 -- value.
24 -- 4) The controlling validation process update_validate is then executed
25 -- which will execute all private and public validation business rule
26 -- processes.
27 -- 5) The pre_update process is then executed which enables any
28 -- logic to be processed before the update dml process is executed.
29 -- 6) The update_dml process will physical perform the update dml into the
30 -- specified entity.
31 -- 7) The post_update process is then executed which enables any
32 -- logic to be processed after the update dml process.
33 --
34 -- Prerequisites:
35 -- The main parameters to the process have to be in the record
36 -- format.
37 --
38 -- In Parameters:
39 -- p_effective_date
40 -- Specifies the date of the datetrack update operation.
41 -- p_datetrack_mode
42 -- Determines the datetrack update mode.
43 --
44 -- Post Success:
45 -- The specified row will be fully validated and datetracked updated for
46 -- the specified entity without being committed for the datetrack mode.
47 --
48 -- Post Failure:
49 -- If an error has occurred, an error message will be raised.
50 --
51 -- Developer Implementation Notes:
52 -- None.
53 --
54 -- Access Status:
55 -- Internal Development Use Only.
56 --
57 -- ----------------------------------------------------------------------------
58 Procedure upd
59 (p_effective_date in date
60 ,p_datetrack_mode in out nocopy varchar2
61 ,p_rec in out nocopy per_spp_shd.g_rec_type
62 );
63 --
64 -- ----------------------------------------------------------------------------
65 -- |-------------------------------< upd >------------------------------------|
66 -- ----------------------------------------------------------------------------
67 -- {Start Of Comments}
68 --
69 -- Description:
70 -- This procedure is the attribute interface for the datetrack update
71 -- process for the specified entity and is the outermost layer.
72 -- The role of this process is to update a fully validated row into the
73 -- HR schema passing back to the calling process, any system generated
74 -- values (e.g. object version number attributes). The processing of this
75 -- procedure is as follows:
76 -- 1) The attributes are converted into a local record structure by
77 -- calling the convert_args function.
78 -- 2) After the conversion has taken place, the corresponding record upd
79 -- interface process is executed.
80 -- 3) OUT parameters are then set to their corresponding record attributes.
81 --
82 -- Prerequisites:
83 --
84 -- In Parameters:
85 -- p_effective_date
86 -- Specifies the date of the datetrack update operation.
87 -- p_datetrack_mode
88 -- Determines the datetrack update mode.
89 --
90 -- Post Success:
91 -- A fully validated row will be updated for the specified entity
92 -- without being committed.
93 --
94 -- Post Failure:
95 -- If an error has occurred, an error message will be raised.
96 --
97 -- Developer Implementation Notes:
98 -- None.
99 --
100 -- Access Status:
101 -- Internal Development Use Only.
102 --
103 -- {End Of Comments}
104 -- ----------------------------------------------------------------------------
105 Procedure upd
106 (p_effective_date in date
107 ,p_datetrack_mode in out nocopy varchar2
108 ,p_placement_id in number
109 ,p_object_version_number in out nocopy number
110 ,p_business_group_id in number default hr_api.g_number
111 ,p_assignment_id in number default hr_api.g_number
112 ,p_step_id in number default hr_api.g_number
113 ,p_auto_increment_flag in varchar2 default hr_api.g_varchar2
114 -- ,p_parent_spine_id in number default hr_api.g_number
115 ,p_reason in varchar2 default hr_api.g_varchar2
116 ,p_request_id in number default hr_api.g_number
117 ,p_program_application_id in number default hr_api.g_number
118 ,p_program_id in number default hr_api.g_number
119 ,p_program_update_date in date default hr_api.g_date
120 ,p_increment_number in number default hr_api.g_number
121 ,p_information1 in varchar2 default hr_api.g_varchar2
122 ,p_information2 in varchar2 default hr_api.g_varchar2
123 ,p_information3 in varchar2 default hr_api.g_varchar2
124 ,p_information4 in varchar2 default hr_api.g_varchar2
125 ,p_information5 in varchar2 default hr_api.g_varchar2
126 ,p_information6 in varchar2 default hr_api.g_varchar2
127 ,p_information7 in varchar2 default hr_api.g_varchar2
128 ,p_information8 in varchar2 default hr_api.g_varchar2
129 ,p_information9 in varchar2 default hr_api.g_varchar2
130 ,p_information10 in varchar2 default hr_api.g_varchar2
131 ,p_information11 in varchar2 default hr_api.g_varchar2
132 ,p_information12 in varchar2 default hr_api.g_varchar2
133 ,p_information13 in varchar2 default hr_api.g_varchar2
134 ,p_information14 in varchar2 default hr_api.g_varchar2
135 ,p_information15 in varchar2 default hr_api.g_varchar2
136 ,p_information16 in varchar2 default hr_api.g_varchar2
137 ,p_information17 in varchar2 default hr_api.g_varchar2
138 ,p_information18 in varchar2 default hr_api.g_varchar2
139 ,p_information19 in varchar2 default hr_api.g_varchar2
140 ,p_information20 in varchar2 default hr_api.g_varchar2
141 ,p_information21 in varchar2 default hr_api.g_varchar2
142 ,p_information22 in varchar2 default hr_api.g_varchar2
143 ,p_information23 in varchar2 default hr_api.g_varchar2
144 ,p_information24 in varchar2 default hr_api.g_varchar2
145 ,p_information25 in varchar2 default hr_api.g_varchar2
146 ,p_information26 in varchar2 default hr_api.g_varchar2
147 ,p_information27 in varchar2 default hr_api.g_varchar2
148 ,p_information28 in varchar2 default hr_api.g_varchar2
149 ,p_information29 in varchar2 default hr_api.g_varchar2
150 ,p_information30 in varchar2 default hr_api.g_varchar2
151 ,p_information_category in varchar2 default hr_api.g_varchar2
152 ,p_effective_start_date in out nocopy date
153 ,p_effective_end_date in out nocopy date
154 );
155 --
156 -- ----------------------------------------------------------------------------
157 -- |---------------------------< update_dml >---------------------------------|
158 -- ----------------------------------------------------------------------------
159 -- {Start Of Comments}
160 --
161 -- Description:
162 --
163 -- Prerequisites:
164 --
165 -- In Parameters:
166 --
167 -- Post Success:
168 --
169 -- Post Failure:
170 --
171 -- Developer Implementation Notes:
172 -- None.
173 --
174 -- Access Status:
175 -- Internal Development Use Only.
176 --
177 -- {End Of Comments}
178 -- ----------------------------------------------------------------------------
179 Procedure update_dml
180 (p_rec in out nocopy per_spp_shd.g_rec_type
181 ,p_effective_date in date
182 ,p_datetrack_mode in varchar2
183 ,p_validation_start_date in date
184 ,p_validation_end_date in date
185 );
186 -- ----------------------------------------------------------------------------
187 -- |---------------------------< pre_update >---------------------------------|
188 -- ----------------------------------------------------------------------------
189 -- {Start Of Comments}
190 --
191 -- Description:
192 --
193 -- Prerequisites:
194 --
195 -- In Parameters:
196 --
197 -- Post Success:
198 --
199 -- Post Failure:
200 --
201 -- Developer Implementation Notes:
202 -- None.
203 --
204 -- Access Status:
205 -- Internal Development Use Only.
206 --
207 -- {End Of Comments}
208 -- ----------------------------------------------------------------------------
209 Procedure pre_update
210 (p_rec in out nocopy per_spp_shd.g_rec_type
211 ,p_effective_date in date
212 ,p_datetrack_mode in varchar2
213 ,p_validation_start_date in date
214 ,p_validation_end_date in date
215 );
216 -- ----------------------------------------------------------------------------
217 -- |---------------------------< post_update >--------------------------------|
218 -- ----------------------------------------------------------------------------
219 -- {Start Of Comments}
220 --
221 -- Description:
222 --
223 -- Prerequisites:
224 --
225 -- In Parameters:
226 --
227 -- Post Success:
228 --
229 -- Post Failure:
230 --
231 -- Developer Implementation Notes:
232 -- None.
233 --
234 -- Access Status:
235 -- Internal Development Use Only.
236 --
237 -- {End Of Comments}
238 -- ----------------------------------------------------------------------------
239 Procedure post_update
240 (p_rec in per_spp_shd.g_rec_type
241 ,p_effective_date in date
242 ,p_datetrack_mode in varchar2
243 ,p_validation_start_date in date
244 ,p_validation_end_date in date
245 );
246 end per_spp_upd;