DBA Data[Home] [Help]

PACKAGE: APPS.HR_SCL_INS

Source


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;