1 Package pqh_rei_upd as
2 /* $Header: pqreirhi.pkh 120.0 2005/05/29 02:27:10 appldev 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 update a fully validated row for the HR schema passing back
13 -- to the calling process, any system generated values (e.g.
14 -- object version number attribute). This process is the main
15 -- backbone of the upd business process. The processing of this
16 -- procedure is as follows:
17 -- 1) If the p_validate parameter has been set to true then a savepoint
18 -- is issued.
19 -- 2) The row to be updated is locked and selected into the record
20 -- structure g_old_rec.
21 -- 3) Because on update parameters which are not part of the update do not
22 -- have to be defaulted, we need to build up the updated row by
23 -- converting any system defaulted parameters to their corresponding
24 -- value.
25 -- 4) The controlling validation process update_validate is then executed
26 -- which will execute all private and public validation business rule
27 -- processes.
28 -- 5) The pre_update process is then executed which enables any
29 -- logic to be processed before the update dml process is executed.
30 -- 6) The update_dml process will physical perform the update dml into the
31 -- specified entity.
32 -- 7) The post_update process is then executed which enables any
33 -- logic to be processed after the update dml process.
34 -- 8) If the p_validate parameter has been set to true an exception is
35 -- raised which is handled and processed by performing a rollback to
36 -- the savepoint which was issued at the beginning of the upd process.
37 --
38 -- Prerequisites:
39 -- The main parameters to the business process have to be in the record
40 -- format.
41 --
42 -- In Parameters:
43 -- p_validate
44 -- Determines if the process is to be validated. Setting this
45 -- boolean value to true will invoke the process to be validated. The
46 -- default is false. The validation is controlled by a savepoint and
47 -- rollback mechanism. The savepoint is issued at the beginning of the
48 -- process and is rollbacked at the end of the process
49 -- when all the processing has been completed. The rollback is controlled
50 -- by raising and handling the exception hr_api.validate_enabled. We use
51 -- the exception because, by raising the exception with the
52 -- process, we can exit successfully without having any of the 'OUT'
53 -- parameters being set.
54 --
55 -- Post Success:
56 -- The specified row will be fully validated and updated for the specified
57 -- entity without being committed.If the p_validate argument has been set
58 -- to true then all the work will be rolled back.
59 --
60 -- Post Failure:
61 -- If an error has occurred, an error message will be raised.
62 --
63 -- Developer Implementation Notes:
64 -- None.
65 --
66 -- Access Status:
67 -- Internal Development Use Only.
68 --
69 -- {End Of Comments}
70 -- ----------------------------------------------------------------------------
71 Procedure upd
72 (p_rec in out nocopy pqh_rei_shd.g_rec_type
73 ,p_validate in boolean default false
74 );
75 --
76 -- ----------------------------------------------------------------------------
77 -- |---------------------------------< upd >----------------------------------|
78 -- ----------------------------------------------------------------------------
79 -- {Start Of Comments}
80 --
81 -- Description:
82 -- This procedure is the attribute interface for the update
83 -- process for the specified entity and is the outermost layer. The role
84 -- of this process is to update a fully validated row into the HR schema
85 -- passing back to the calling process, any system generated values
86 -- (e.g. object version number attributes). The processing of this
87 -- procedure is as follows:
88 -- 1) The attributes are converted into a local record structure by
89 -- calling the convert_args function.
90 -- 2) After the conversion has taken place, the corresponding record upd
91 -- interface process is executed.
92 -- 3) OUT parameters are then set to their corresponding record attributes.
93 --
94 -- Prerequisites:
95 --
96 -- In Parameters:
97 -- p_validate
98 -- Determines if the process is to be validated. Setting this
99 -- Boolean value to true will invoke the process to be validated.
100 -- The default is false.
101 --
102 -- Post Success:
103 -- A fully validated row will be updated for the specified entity
104 -- without being committed (or rollbacked depending on the p_validate
105 -- status).
106 --
107 -- Post Failure:
108 -- If an error has occurred, an error message will be raised.
109 --
110 -- Developer Implementation Notes:
111 -- None.
112 --
113 -- Access Status:
114 -- Internal Development Use Only.
115 --
116 -- {End Of Comments}
117 -- ----------------------------------------------------------------------------
118 Procedure upd
119 (p_role_extra_info_id in number
120 ,p_object_version_number in out nocopy number
121 ,p_role_id in number default hr_api.g_number
122 ,p_information_type in varchar2 default hr_api.g_varchar2
123 ,p_request_id in number default hr_api.g_number
124 ,p_program_application_id in number default hr_api.g_number
125 ,p_program_id in number default hr_api.g_number
126 ,p_program_update_date in date default hr_api.g_date
127 ,p_attribute_category in varchar2 default hr_api.g_varchar2
128 ,p_attribute1 in varchar2 default hr_api.g_varchar2
129 ,p_attribute2 in varchar2 default hr_api.g_varchar2
130 ,p_attribute3 in varchar2 default hr_api.g_varchar2
131 ,p_attribute4 in varchar2 default hr_api.g_varchar2
132 ,p_attribute5 in varchar2 default hr_api.g_varchar2
133 ,p_attribute6 in varchar2 default hr_api.g_varchar2
134 ,p_attribute7 in varchar2 default hr_api.g_varchar2
135 ,p_attribute8 in varchar2 default hr_api.g_varchar2
136 ,p_attribute9 in varchar2 default hr_api.g_varchar2
137 ,p_attribute10 in varchar2 default hr_api.g_varchar2
138 ,p_attribute11 in varchar2 default hr_api.g_varchar2
139 ,p_attribute12 in varchar2 default hr_api.g_varchar2
140 ,p_attribute13 in varchar2 default hr_api.g_varchar2
141 ,p_attribute14 in varchar2 default hr_api.g_varchar2
142 ,p_attribute15 in varchar2 default hr_api.g_varchar2
143 ,p_attribute16 in varchar2 default hr_api.g_varchar2
144 ,p_attribute17 in varchar2 default hr_api.g_varchar2
145 ,p_attribute18 in varchar2 default hr_api.g_varchar2
146 ,p_attribute19 in varchar2 default hr_api.g_varchar2
147 ,p_attribute20 in varchar2 default hr_api.g_varchar2
148 ,p_attribute21 in varchar2 default hr_api.g_varchar2
149 ,p_attribute22 in varchar2 default hr_api.g_varchar2
150 ,p_attribute23 in varchar2 default hr_api.g_varchar2
151 ,p_attribute24 in varchar2 default hr_api.g_varchar2
152 ,p_attribute25 in varchar2 default hr_api.g_varchar2
153 ,p_attribute26 in varchar2 default hr_api.g_varchar2
154 ,p_attribute27 in varchar2 default hr_api.g_varchar2
155 ,p_attribute28 in varchar2 default hr_api.g_varchar2
156 ,p_attribute29 in varchar2 default hr_api.g_varchar2
157 ,p_attribute30 in varchar2 default hr_api.g_varchar2
158 ,p_information_category in varchar2 default hr_api.g_varchar2
159 ,p_information1 in varchar2 default hr_api.g_varchar2
160 ,p_information2 in varchar2 default hr_api.g_varchar2
161 ,p_information3 in varchar2 default hr_api.g_varchar2
162 ,p_information4 in varchar2 default hr_api.g_varchar2
163 ,p_information5 in varchar2 default hr_api.g_varchar2
164 ,p_information6 in varchar2 default hr_api.g_varchar2
165 ,p_information7 in varchar2 default hr_api.g_varchar2
166 ,p_information8 in varchar2 default hr_api.g_varchar2
167 ,p_information9 in varchar2 default hr_api.g_varchar2
168 ,p_information10 in varchar2 default hr_api.g_varchar2
169 ,p_information11 in varchar2 default hr_api.g_varchar2
170 ,p_information12 in varchar2 default hr_api.g_varchar2
171 ,p_information13 in varchar2 default hr_api.g_varchar2
172 ,p_information14 in varchar2 default hr_api.g_varchar2
173 ,p_information15 in varchar2 default hr_api.g_varchar2
174 ,p_information16 in varchar2 default hr_api.g_varchar2
175 ,p_information17 in varchar2 default hr_api.g_varchar2
176 ,p_information18 in varchar2 default hr_api.g_varchar2
177 ,p_information19 in varchar2 default hr_api.g_varchar2
178 ,p_information20 in varchar2 default hr_api.g_varchar2
179 ,p_information21 in varchar2 default hr_api.g_varchar2
180 ,p_information22 in varchar2 default hr_api.g_varchar2
181 ,p_information23 in varchar2 default hr_api.g_varchar2
182 ,p_information24 in varchar2 default hr_api.g_varchar2
183 ,p_information25 in varchar2 default hr_api.g_varchar2
184 ,p_information26 in varchar2 default hr_api.g_varchar2
185 ,p_information27 in varchar2 default hr_api.g_varchar2
186 ,p_information28 in varchar2 default hr_api.g_varchar2
187 ,p_information29 in varchar2 default hr_api.g_varchar2
188 ,p_information30 in varchar2 default hr_api.g_varchar2
189 ,p_validate in boolean default false
190 );
191 --
192 end pqh_rei_upd;