1 Package per_eqt_upd as
2 /* $Header: peeqtrhi.pkh 120.0 2005/05/31 08:13:14 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 then 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 -- Pre Conditions:
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 supplied with the work
62 -- rolled back.
63 --
64 -- Developer Implementation Notes:
65 -- None.
66 --
67 -- Access Status:
68 -- Internal Development Use Only.
69 --
70 -- {End Of Comments}
71 -- ----------------------------------------------------------------------------
72 Procedure upd
73 (
74 p_rec in out nocopy per_eqt_shd.g_rec_type,
75 p_effective_date in date,
76 p_validate in boolean default false
77 );
78 --
79 -- ----------------------------------------------------------------------------
80 -- |---------------------------------< upd >----------------------------------|
81 -- ----------------------------------------------------------------------------
82 -- {Start Of Comments}
83 --
84 -- Description:
85 -- This procedure is the attribute interface for the update
86 -- process for the specified entity and is the outermost layer. The role
87 -- of this process is to update a fully validated row into the HR schema
88 -- passing back to the calling process, any system generated values
89 -- (e.g. object version number attributes). The processing of this
90 -- procedure is as follows:
91 -- 1) The attributes are converted into a local record structure by
92 -- calling the convert_defs function.
93 -- 2) After the conversion has taken place, the corresponding record upd
94 -- interface process is executed.
95 -- 3) OUT parameters are then set to their corresponding record attributes.
96 --
97 -- Pre Conditions:
98 --
99 -- In Parameters:
100 -- p_validate
101 -- Determines if the process is to be validated. Setting this
102 -- Boolean value to true will invoke the process to be validated.
103 -- The default is false.
104 --
105 -- Post Success:
106 -- A fully validated row will be updated for the specified entity
107 -- without being committed (or rollbacked depending on the p_validate
108 -- status).
109 --
110 -- Post Failure:
111 -- If an error has occurred, an error message will be supplied with the work
112 -- rolled back.
113 --
114 -- Developer Implementation Notes:
115 -- None.
116 --
117 -- Access Status:
118 -- Internal Development Use Only.
119 --
120 -- {End Of Comments}
121 ----------------------------------------------------------------------------
122
123 -- Added DDF columns as arguments to upd procedure
124
125 Procedure upd
126 (
127 p_qualification_type_id in number,
128 p_name in varchar2 default hr_api.g_varchar2,
129 p_category in varchar2 default hr_api.g_varchar2,
130 p_rank in number default hr_api.g_number,
131 p_attribute_category in varchar2 default hr_api.g_varchar2,
132 p_attribute1 in varchar2 default hr_api.g_varchar2,
133 p_attribute2 in varchar2 default hr_api.g_varchar2,
134 p_attribute3 in varchar2 default hr_api.g_varchar2,
135 p_attribute4 in varchar2 default hr_api.g_varchar2,
136 p_attribute5 in varchar2 default hr_api.g_varchar2,
137 p_attribute6 in varchar2 default hr_api.g_varchar2,
138 p_attribute7 in varchar2 default hr_api.g_varchar2,
139 p_attribute8 in varchar2 default hr_api.g_varchar2,
140 p_attribute9 in varchar2 default hr_api.g_varchar2,
141 p_attribute10 in varchar2 default hr_api.g_varchar2,
142 p_attribute11 in varchar2 default hr_api.g_varchar2,
143 p_attribute12 in varchar2 default hr_api.g_varchar2,
144 p_attribute13 in varchar2 default hr_api.g_varchar2,
145 p_attribute14 in varchar2 default hr_api.g_varchar2,
146 p_attribute15 in varchar2 default hr_api.g_varchar2,
147 p_attribute16 in varchar2 default hr_api.g_varchar2,
148 p_attribute17 in varchar2 default hr_api.g_varchar2,
149 p_attribute18 in varchar2 default hr_api.g_varchar2,
150 p_attribute19 in varchar2 default hr_api.g_varchar2,
151 p_attribute20 in varchar2 default hr_api.g_varchar2,
152 p_object_version_number in out nocopy number,
153 p_effective_date in date,
154 p_validate in boolean default false,
155 p_information_category in varchar2 default hr_api.g_varchar2,
156 p_information1 in varchar2 default hr_api.g_varchar2,
157 p_information2 in varchar2 default hr_api.g_varchar2,
158 p_information3 in varchar2 default hr_api.g_varchar2,
159 p_information4 in varchar2 default hr_api.g_varchar2,
160 p_information5 in varchar2 default hr_api.g_varchar2,
161 p_information6 in varchar2 default hr_api.g_varchar2,
162 p_information7 in varchar2 default hr_api.g_varchar2,
163 p_information8 in varchar2 default hr_api.g_varchar2,
164 p_information9 in varchar2 default hr_api.g_varchar2,
165 p_information10 in varchar2 default hr_api.g_varchar2,
166 p_information11 in varchar2 default hr_api.g_varchar2,
167 p_information12 in varchar2 default hr_api.g_varchar2,
168 p_information13 in varchar2 default hr_api.g_varchar2,
169 p_information14 in varchar2 default hr_api.g_varchar2,
170 p_information15 in varchar2 default hr_api.g_varchar2,
171 p_information16 in varchar2 default hr_api.g_varchar2,
172 p_information17 in varchar2 default hr_api.g_varchar2,
173 p_information18 in varchar2 default hr_api.g_varchar2,
174 p_information19 in varchar2 default hr_api.g_varchar2,
175 p_information20 in varchar2 default hr_api.g_varchar2,
176 p_information21 in varchar2 default hr_api.g_varchar2,
177 p_information22 in varchar2 default hr_api.g_varchar2,
178 p_information23 in varchar2 default hr_api.g_varchar2,
179 p_information24 in varchar2 default hr_api.g_varchar2,
180 p_information25 in varchar2 default hr_api.g_varchar2,
181 p_information26 in varchar2 default hr_api.g_varchar2,
182 p_information27 in varchar2 default hr_api.g_varchar2,
183 p_information28 in varchar2 default hr_api.g_varchar2,
184 p_information29 in varchar2 default hr_api.g_varchar2,
185 p_information30 in varchar2 default hr_api.g_varchar2
186 -- BUG3356369
187 ,p_qual_framework_id in number default hr_api.g_number
188 ,p_qualification_type in varchar2 default hr_api.g_varchar2
189 ,p_credit_type in varchar2 default hr_api.g_varchar2
190 ,p_credits in number default hr_api.g_number
191 ,p_level_type in varchar2 default hr_api.g_varchar2
192 ,p_level_number in number default hr_api.g_number
196 ,p_qa_organization in varchar2 default hr_api.g_varchar2
193 ,p_field in varchar2 default hr_api.g_varchar2
194 ,p_sub_field in varchar2 default hr_api.g_varchar2
195 ,p_provider in varchar2 default hr_api.g_varchar2
197 );
198 --
199 end per_eqt_upd;