1 Package ssp_ern_upd AUTHID CURRENT_USER as
2 /* $Header: spernrhi.pkh 120.0.12000000.1 2007/01/17 14:14:38 appldev noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |---------------------------------< upd >----------------------------------|
6 -- ----------------------------------------------------------------------------
7 --
8 -- Description:
9 -- This procedure is the record interface for the update
10 -- process for the specified entity. The role of this process is
11 -- to update a fully validated row for the HR schema passing back
12 -- to the calling process, any system generated values (e.g.
13 -- object version number attribute). This process is the main
14 -- backbone of the upd business process. The processing of this
15 -- procedure is as follows:
16 -- 1) If the p_validate parameter has been set to true then a savepoint
17 -- is issued.
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 -- 8) If the p_validate parameter has been set to true an exception is
34 -- raised which is handled and processed by performing a rollback to
35 -- the savepoint which was issued at the beginning of the upd process.
36 --
37 -- Pre Conditions:
38 -- The main parameters to the business process have to be in the record
39 -- format.
40 --
41 -- In Parameters:
42 -- p_validate
43 -- Determines if the process is to be validated. Setting this
44 -- boolean value to true will invoke the process to be validated. The
45 -- default is false. The validation is controlled by a savepoint and
46 -- rollback mechanism. The savepoint is issued at the beginning of the
47 -- process and is rollbacked at the end of the process
48 -- when all the processing has been completed. The rollback is controlled
49 -- by raising and handling the exception hr_api.validate_enabled. We use
50 -- the exception because, by raising the exception with the
51 -- process, we can exit successfully without having any of the 'OUT'
52 -- parameters being set.
53 --
54 -- Post Success:
55 -- The specified row will be fully validated and updated for the specified
56 -- entity without being committed. If the p_validate argument has been set
57 -- to true then all the work will be rolled back.
58 --
59 -- Post Failure:
60 -- If an error has occurred, an error message will be supplied with the work
61 -- rolled back.
62 --
63 -- Developer Implementation Notes:
64 -- None.
65 --
66 -- Access Status:
67 -- Internal Development Use Only.
68 --
69 -- ----------------------------------------------------------------------------
70 Procedure upd
71 (
72 p_rec in out nocopy ssp_ern_shd.g_rec_type,
73 p_validate in boolean default false
74 );
75 --
76 -- ----------------------------------------------------------------------------
77 -- |---------------------------------< upd >----------------------------------|
78 -- ----------------------------------------------------------------------------
79 -- OLD VERSION, left in in case it is called from places other than SSPWSENT,
80 -- or if a customer gets shipped this package but not the correct
81 -- version of the form.
82 --
83 -- Description:
84 -- This procedure is the attribute interface for the update
85 -- process for the specified entity and is the outermost layer. The role
86 -- of this process is to update a fully validated row into the HR schema
87 -- passing back to the calling process, any system generated values
88 -- (e.g. object version number attributes). The processing of this
89 -- procedure is as follows:
90 -- 1) The attributes are converted into a local record structure by
91 -- calling the convert_defs function.
92 -- 2) After the conversion has taken place, the corresponding record upd
93 -- interface process is executed.
94 -- 3) OUT parameters are then set to their corresponding record attributes.
95 --
96 -- Pre Conditions:
97 --
98 -- In Parameters:
99 -- p_validate
100 -- Determines if the process is to be validated. Setting this
101 -- Boolean value to true will invoke the process to be validated.
102 -- The default is false.
103 --
104 -- Post Success:
105 -- A fully validated row will be updated for the specified entity
106 -- without being committed (or rollbacked depending on the p_validate
107 -- status).
108 --
109 -- Post Failure:
110 -- If an error has occurred, an error message will be supplied with the work
111 -- rolled back.
112 --
113 -- Developer Implementation Notes:
114 -- None.
115 --
116 -- Access Status:
117 -- Internal Development Use Only.
118 --
119 -- ----------------------------------------------------------------------------
120 --
121 Procedure upd
122 (
123 p_earnings_calculations_id in number,
124 p_object_version_number in out nocopy number,
125 p_average_earnings_amount in out nocopy number,
126 p_validate in boolean default false
127 );
128 --
129 -- ----------------------------------------------------------------------------
130 -- |---------------------------------< upd >----------------------------------|
131 -- ----------------------------------------------------------------------------
132 -- NEW VERSION, overloads previous version.
133 --
134 -- Description:
135 -- This procedure is the attribute interface for the update
136 -- process for the specified entity and is the outermost layer. The role
137 -- of this process is to update a fully validated row into the HR schema
138 -- passing back to the calling process, any system generated values
139 -- (e.g. object version number attributes). The processing of this
140 -- procedure is as follows:
141 -- 1) The attributes are converted into a local record structure by
142 -- calling the convert_defs function.
143 -- 2) After the conversion has taken place, the corresponding record upd
144 -- interface process is executed.
145 -- 3) OUT parameters are then set to their corresponding record attributes.
146 --
147 -- Pre Conditions:
148 --
149 -- In Parameters:
150 -- p_validate
151 -- Determines if the process is to be validated. Setting this
152 -- Boolean value to true will invoke the process to be validated.
153 -- The default is false.
154 --
155 -- Post Success:
156 -- A fully validated row will be updated for the specified entity
157 -- without being committed (or rollbacked depending on the p_validate
158 -- status).
159 --
160 -- Post Failure:
161 -- If an error has occurred, an error message will be supplied with the work
162 -- rolled back.
163 --
164 -- Developer Implementation Notes:
165 -- None.
166 --
167 -- Access Status:
168 -- Internal Development Use Only.
169 --
170 -- ----------------------------------------------------------------------------
171 Procedure upd
172 (
173 p_earnings_calculations_id in number,
174 p_object_version_number in out nocopy number,
175 p_average_earnings_amount in out nocopy number,
176 p_user_entered in out nocopy varchar2,
177 p_absence_category in out nocopy varchar2,
178 p_payment_periods in out nocopy number,
179 p_validate in boolean default false
180 );
181 --
182 end ssp_ern_upd;