1 Package hr_scl_ins AUTHID CURRENT_USER as
2 /* $Header: hrsclrhi.pkh 115.4 2002/12/03 08:22:25 raranjan ship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |---------------------------------< ins >----------------------------------|
6 -- ----------------------------------------------------------------------------
7 -- {Start Of Comments}
8 --
9 -- Description:
10 -- This procedure is the record interface for the insert process
11 -- for the specified entity. The role of this process is to insert a fully
12 -- validated row, into the HR schema passing back to the calling process,
13 -- any system generated values (e.g. primary and object version number
14 -- attributes). This process is the main backbone of the ins
15 -- process. The processing of this procedure is as follows:
16 -- 1) If the p_validate parameter has been set to true then a savepoint is
17 -- issued.
18 -- 2) The controlling validation process insert_validate is then executed
19 -- which will execute all private and public validation business rule
20 -- processes.
21 -- 3) The pre_insert business process is then executed which enables any
22 -- logic to be processed before the insert dml process is executed.
23 -- 4) The insert_dml process will physical perform the insert dml into the
24 -- specified entity.
25 -- 5) The post_insert business process is then executed which enables any
26 -- logic to be processed after the insert dml process.
27 -- 6) If the p_validate parameter has been set to true an exception is
28 -- raised which is handled and processed by performing a rollback to the
29 -- savepoint which was issued at the beginning of the Ins process.
30 --
31 -- Pre Conditions:
32 -- The main parameters to the this process have to be in the record
33 -- format.
34 --
35 -- In Parameters:
36 -- p_validate
37 -- Determines if the process is to be validated. Setting this
38 -- boolean value to true will invoke the process to be validated. The
39 -- default is false. The validation is controlled by a savepoint and
40 -- rollback mechanism. The savepoint is issued at the beginning of the
41 -- process and is rollbacked at the end of the process
42 -- when all the processing has been completed. The rollback is controlled
43 -- by raising and handling the exception hr_api.validate_enabled. We use
44 -- the exception because, by raising the exception with the business
45 -- process, we can exit successfully without having any of the 'OUT'
46 -- parameters being set.
47 --
48 -- Post Success:
49 -- A fully validated row will be inserted into the specified entity
50 -- without being committed. If the p_validate parameter has been set to true
51 -- then all the work will be rolled back.
52 --
53 -- Post Failure:
54 -- If an error has occurred, an error message will be supplied with the work
55 -- rolled back.
56 --
57 -- Developer Implementation Notes:
58 -- None.
59 --
60 -- Access Status:
61 -- Internal Development Use Only.
62 --
63 -- {End Of Comments}
64 -- ----------------------------------------------------------------------------
65 Procedure ins
66 (p_rec in out nocopy hr_scl_shd.g_rec_type,
67 p_validate in boolean default false);
68 --
69 -- ----------------------------------------------------------------------------
70 -- |---------------------------------< ins >----------------------------------|
71 -- ----------------------------------------------------------------------------
72 -- {Start Of Comments}
73 --
74 -- Description:
75 -- This procedure is the attribute interface for the insert
76 -- process for the specified entity and is the outermost layer. The role
77 -- of this process is to insert a fully validated row into the HR schema
78 -- passing back to the calling process, any system generated values
79 -- (e.g. object version number attributes).The processing of this
80 -- procedure is as follows:
81 -- 1) The attributes are converted into a local record structure by
82 -- calling the convert_args function.
83 -- 2) After the conversion has taken place, the corresponding record ins
84 -- interface process is executed.
85 -- 3) OUT parameters are then set to their corresponding record attributes.
86 --
87 -- Pre Conditions:
88 --
89 -- In Parameters:
90 -- p_validate
91 -- Determines if the process is to be validated. Setting this
92 -- Boolean value to true will invoke the process to be validated.
93 -- The default is false.
94 --
95 -- Post Success:
96 -- A fully validated row will be inserted for the specified entity
97 -- without being committed (or rollbacked depending on the p_validate
98 -- status).
99 --
100 -- Post Failure:
101 -- If an error has occurred, an error message will be supplied with the work
102 -- rolled back.
103 --
104 -- Developer Implementation Notes:
105 -- None.
106 --
107 -- Access Status:
108 -- Internal Development Use Only.
109 --
110 -- {End Of Comments}
111 -- ----------------------------------------------------------------------------
112 Procedure ins
113 (
114 p_soft_coding_keyflex_id out nocopy number,
115 p_concatenated_segments out nocopy varchar2,
116 p_request_id in number default null,
117 p_program_application_id in number default null,
118 p_program_id in number default null,
119 p_program_update_date in date default null,
120 p_id_flex_num in number,
121 p_summary_flag in varchar2,
122 p_enabled_flag in varchar2,
123 p_start_date_active in date default null,
124 p_end_date_active in date default null,
125 p_segment1 in varchar2 default null,
126 p_segment2 in varchar2 default null,
127 p_segment3 in varchar2 default null,
128 p_segment4 in varchar2 default null,
129 p_segment5 in varchar2 default null,
130 p_segment6 in varchar2 default null,
131 p_segment7 in varchar2 default null,
132 p_segment8 in varchar2 default null,
133 p_segment9 in varchar2 default null,
134 p_segment10 in varchar2 default null,
135 p_segment11 in varchar2 default null,
136 p_segment12 in varchar2 default null,
137 p_segment13 in varchar2 default null,
138 p_segment14 in varchar2 default null,
139 p_segment15 in varchar2 default null,
140 p_segment16 in varchar2 default null,
141 p_segment17 in varchar2 default null,
142 p_segment18 in varchar2 default null,
143 p_segment19 in varchar2 default null,
144 p_segment20 in varchar2 default null,
145 p_segment21 in varchar2 default null,
146 p_segment22 in varchar2 default null,
147 p_segment23 in varchar2 default null,
148 p_segment24 in varchar2 default null,
149 p_segment25 in varchar2 default null,
150 p_segment26 in varchar2 default null,
151 p_segment27 in varchar2 default null,
152 p_segment28 in varchar2 default null,
153 p_segment29 in varchar2 default null,
154 p_segment30 in varchar2 default null,
155 p_validate in boolean default false
156 );
157 --
158 -- ----------------------------------------------------------------------------
159 -- |-------------------------------< ins_or_sel >-----------------------------|
160 -- ----------------------------------------------------------------------------
161 -- {Start Of Comments}
162 --
163 -- Description:
164 -- This procedure controls the processing required to insert a new
165 -- combination or return the the combination id for an existing
166 -- combination.
167 -- 1. If a combination does not exist a new combination is inserted
168 -- returning the new p_people_group_id.
169 -- 2. If the segments are null (i.e. a null combination) then the out
170 -- arguments are set to null.
171 -- 3. If a combination does exist the p_soft_coding_keyflex_id is returned.
172 --
173 -- Pre Conditions:
174 --
175 -- In Arguments:
176 -- p_business_group_id => is specified to enable the derivation of the
177 -- id_flex_num within the process
178 -- hr_scl_shd.segment_combination_check.
179 --
180 -- Post Success:
181 -- If a combination already exists the out arguments are returned.
182 -- If a combination does not exist then the combination is inserted into
183 -- the soft coded table and the out arguments are returned.
184 -- Processing continues.
185 --
186 -- Post Failure:
187 -- This process has no specific error handling and will only error if an
188 -- application error has ocurred at a lower level.
189 --
190 -- Developer Implementation Notes:
191 -- None.
192 --
193 -- Access Status:
194 -- Internal Development Use Only.
195 --
196 -- {End Of Comments}
197 -- ----------------------------------------------------------------------------
198 procedure ins_or_sel
199 (p_segment1 in varchar2 default null,
200 p_segment2 in varchar2 default null,
201 p_segment3 in varchar2 default null,
202 p_segment4 in varchar2 default null,
203 p_segment5 in varchar2 default null,
204 p_segment6 in varchar2 default null,
205 p_segment7 in varchar2 default null,
206 p_segment8 in varchar2 default null,
207 p_segment9 in varchar2 default null,
208 p_segment10 in varchar2 default null,
209 p_segment11 in varchar2 default null,
210 p_segment12 in varchar2 default null,
211 p_segment13 in varchar2 default null,
212 p_segment14 in varchar2 default null,
213 p_segment15 in varchar2 default null,
214 p_segment16 in varchar2 default null,
215 p_segment17 in varchar2 default null,
216 p_segment18 in varchar2 default null,
217 p_segment19 in varchar2 default null,
218 p_segment20 in varchar2 default null,
219 p_segment21 in varchar2 default null,
220 p_segment22 in varchar2 default null,
221 p_segment23 in varchar2 default null,
222 p_segment24 in varchar2 default null,
223 p_segment25 in varchar2 default null,
224 p_segment26 in varchar2 default null,
225 p_segment27 in varchar2 default null,
226 p_segment28 in varchar2 default null,
227 p_segment29 in varchar2 default null,
228 p_segment30 in varchar2 default null,
229 p_business_group_id in number,
230 p_request_id in number default null,
231 p_program_application_id in number default null,
232 p_program_id in number default null,
233 p_program_update_date in date default null,
234 p_soft_coding_keyflex_id out nocopy number,
235 p_concatenated_segments out nocopy varchar2,
236 p_validate in boolean default false);
237 --
238 end hr_scl_ins;