1 Package per_pds_ins AUTHID CURRENT_USER as
2 /* $Header: pepdsrhi.pkh 120.2 2011/11/17 09:33:49 sidsaxen ship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |------------------------< set_base_key_value >----------------------------|
6 -- ----------------------------------------------------------------------------
7 -- {Start of Comments}
8 -- Description:
9 -- This procedure is called to register the next ID value from the database
10 -- sequence.
11 --
12 -- Prerequisites:
13 --
14 -- In Parameters:
15 -- Primary Key
16 --
17 -- Post Success:
18 --
19 -- Post Failure:
20 --
21 -- Developer Implementation Notes:
22 -- None.
23 --
24 -- Access Status:
25 -- Internal Development Use Only.
26 --
27 -- {End of Comments}
28 -- ----------------------------------------------------------------------------
29 procedure set_base_key_value
30 (p_period_of_service_id in number);
31 --
32 -- ----------------------------------------------------------------------------
33 -- |---------------------------------< ins >----------------------------------|
34 -- ----------------------------------------------------------------------------
35 -- {Start Of Comments}
36 --
37 -- Description:
38 -- This procedure is the record interface for the insert business process
39 -- for the specified entity. The role of this process is to insert a fully
40 -- validated row, into the HR schema passing back to the calling process,
41 -- any system generated values (e.g. primary and object version number
42 -- attributes). This process is the main backbone of the ins business
43 -- process. The processing of this procedure is as follows:
44 -- 1) If the p_validate argument has been set to true then a savepoint is
45 -- issued.
46 -- 2) The controlling validation process insert_validate is then executed
47 -- which will execute all private and Internal Development Use Only validation business rule
48 -- processes.
49 -- 3) The pre_insert business process is then executed which enables any
50 -- logic to be processed before the insert dml process is executed.
51 -- 4) The insert_dml process will physical perform the insert dml into the
52 -- specified entity.
53 -- 5) The post_insert business process is then executed which enables any
54 -- logic to be processed after the insert dml process.
55 -- 6) If the p_validate argument has been set to true an exception is raised
56 -- which is handled and processed by performing a rollback to the
57 -- savepoint which was issued at the beginning of the Ins process.
58 --
59 -- Pre Conditions:
60 -- The main arguments to the business process have to be in the record
61 -- format.
62 --
63 -- In Arguments:
64 -- p_validate
65 -- Determines if the business process is to be validated. Setting this
66 -- boolean value to true will invoke the process to be validated. The
67 -- default is false. The validation is controlled by a savepoint and
68 -- rollback mechanism. The savepoint is issued at the beginning of the
69 -- business process and is rollbacked at the end of the business process
70 -- when all the processing has been completed. The rollback is controlled
71 -- by raising and handling the exception hr_api.validate_enabled. We use
72 -- the exception because, by raising the exception with the business
73 -- process, we can exit successfully without having any of the 'OUT'
74 -- arguments being set.
75 --
76 -- p_validate_df_flex
77 -- Optional parameter used to determine whether descriptive flexfield
78 -- validation is to be performed or bypassed. API calls that insert a PDS
79 -- row but are unable to provide mandatory PDS flex field values,
80 -- eg. CREATE_EMPLOYEE API will have the parameter value set TRUE
81 --
82 -- p_effective_date
83 -- Mandatory parameter used for calls to the standard lookup value
84 -- derivation procedures.
85 --
86 -- Post Success:
87 -- A fully validated row will be inserted into the specified entity
88 -- without being committed. If the p_validate argument has been set to true
89 -- then all the work will be rolled back.
90 --
91 -- Post Failure:
92 -- If an error has occurred, an error message will be supplied with the work
93 -- rolled back.
94 --
95 -- Developer Implementation Notes:
96 -- None.
97 --
98 -- Access Status:
99 -- Internal Development Use Only.
100 --
101 -- {End Of Comments}
102 -- ----------------------------------------------------------------------------
103 Procedure ins
104 (
105 p_rec in out nocopy per_pds_shd.g_rec_type,
106 p_effective_date in date,
107 p_validate in boolean default false,
108 p_validate_df_flex in boolean default true
109 );
110 --
111 -- ----------------------------------------------------------------------------
112 -- |---------------------------------< ins >----------------------------------|
113 -- ----------------------------------------------------------------------------
114 -- {Start Of Comments}
115 --
116 -- Description:
117 -- This procedure is the attribute interface for the insert business
118 -- process for the specified entity and is the outermost layer. The role
119 -- of this process is to insert a fully validated row into the HR schema
120 -- passing back to the calling process, any system generated values
121 -- (e.g. object version number attributes).The processing of this
122 -- procedure is as follows:
123 -- 1) The attributes are converted into a local record structure by
124 -- calling the convert_args function.
125 -- 2) After the conversion has taken place, the corresponding record ins
126 -- interface business process is executed.
127 -- 3) OUT arguments are then set to their corresponding record arguments.
128 --
129 -- Pre Conditions:
130 --
131 -- In Arguments:
132 -- p_validate
133 -- Determines if the business process is to be validated. Setting this
134 -- Boolean value to true will invoke the process to be validated.
135 -- The default is false.
136 --
137 -- p_validate_df_flex
138 -- Optional parameter used to determine whether descriptive flexfield
139 -- validation is to be performed or bypassed.
140 --
141 -- p_effective_date
142 -- Mandatory parameter used for calls to the standard lookup value
143 -- derivation procedures.
144 --
145 -- Post Success:
146 -- A fully validated row will be inserted for the specified entity
147 -- without being committed (or rollbacked depending on the p_validate
148 -- status).
149 --
150 -- Post Failure:
151 -- If an error has occurred, an error message will be supplied with the work
152 -- rolled back.
153 --
154 -- Developer Implementation Notes:
155 -- None.
156 --
157 -- Access Status:
158 -- Internal Development Use Only.
159 --
160 -- {End Of Comments}
161 -- ----------------------------------------------------------------------------
162 Procedure ins
163 (
164 --
165 -- 70.3 change a start.
166 --
167 p_period_of_service_id out nocopy number,
168 p_business_group_id in number,
169 p_person_id in number,
170 p_date_start in date,
171 p_comments in varchar2 default null,
172 p_adjusted_svc_date in date default null,
173 p_request_id in number default null,
174 p_program_application_id in number default null,
175 p_program_id in number default null,
176 p_program_update_date in date default null,
177 p_attribute_category in varchar2 default null,
178 p_attribute1 in varchar2 default null,
179 p_attribute2 in varchar2 default null,
180 p_attribute3 in varchar2 default null,
181 p_attribute4 in varchar2 default null,
182 p_attribute5 in varchar2 default null,
183 p_attribute6 in varchar2 default null,
184 p_attribute7 in varchar2 default null,
185 p_attribute8 in varchar2 default null,
186 p_attribute9 in varchar2 default null,
187 p_attribute10 in varchar2 default null,
188 p_attribute11 in varchar2 default null,
189 p_attribute12 in varchar2 default null,
190 p_attribute13 in varchar2 default null,
191 p_attribute14 in varchar2 default null,
192 p_attribute15 in varchar2 default null,
193 p_attribute16 in varchar2 default null,
194 p_attribute17 in varchar2 default null,
195 p_attribute18 in varchar2 default null,
196 p_attribute19 in varchar2 default null,
197 p_attribute20 in varchar2 default null,
198 p_object_version_number out nocopy number,
199 p_prior_employment_ssp_weeks in number default null,
200 p_prior_employment_ssp_paid_to in date default null,
201 p_pds_information_category in varchar2 default null,
202 p_pds_information1 in varchar2 default null,
203 p_pds_information2 in varchar2 default null,
204 p_pds_information3 in varchar2 default null,
205 p_pds_information4 in varchar2 default null,
206 p_pds_information5 in varchar2 default null,
207 p_pds_information6 in varchar2 default null,
208 p_pds_information7 in varchar2 default null,
209 p_pds_information8 in varchar2 default null,
210 p_pds_information9 in varchar2 default null,
211 p_pds_information10 in varchar2 default null,
212 p_pds_information11 in varchar2 default null,
213 p_pds_information12 in varchar2 default null,
214 p_pds_information13 in varchar2 default null,
215 p_pds_information14 in varchar2 default null,
216 p_pds_information15 in varchar2 default null,
217 p_pds_information16 in varchar2 default null,
218 p_pds_information17 in varchar2 default null,
219 p_pds_information18 in varchar2 default null,
220 p_pds_information19 in varchar2 default null,
221 p_pds_information20 in varchar2 default null,
222 p_pds_information21 in varchar2 default null,
223 p_pds_information22 in varchar2 default null,
224 p_pds_information23 in varchar2 default null,
225 p_pds_information24 in varchar2 default null,
226 p_pds_information25 in varchar2 default null,
227 p_pds_information26 in varchar2 default null,
228 p_pds_information27 in varchar2 default null,
229 p_pds_information28 in varchar2 default null,
230 p_pds_information29 in varchar2 default null,
231 p_pds_information30 in varchar2 default null,
232 p_effective_date in date,
233 p_validate in boolean default false,
234 p_validate_df_flex in boolean default true
235 );
236 --
237 -- 70.3 change a end.
238 --
239 --
240 end per_pds_ins;