1 Package pqh_rei_ins AUTHID CURRENT_USER as
2 /* $Header: pqreirhi.pkh 120.0 2005/05/29 02:27:10 appldev noship $ */
3 -- ----------------------------------------------------------------------------
4 -- |------------------------< set_base_key_value >----------------------------|
5 -- ----------------------------------------------------------------------------
6 -- {Start of Comments}
7 -- Description:
8 -- This procedure is called to register the next ID value from the database
9 -- sequence.
10 --
11 -- Prerequisites:
12 --
13 -- In Parameters:
14 -- Primary Key
15 --
16 -- Post Success:
17 --
18 -- Post Failure:
19 --
20 -- Developer Implementation Notes:
21 -- None.
22 --
23 -- Access Status:
24 -- Internal Development Use Only.
25 --
26 -- {End of Comments}
27 -- ----------------------------------------------------------------------------
28 procedure set_base_key_value
29 (p_role_extra_info_id in number);
30 --
31 -- ----------------------------------------------------------------------------
32 -- |---------------------------------< ins >----------------------------------|
33 -- ----------------------------------------------------------------------------
34 -- {Start Of Comments}
35 --
36 -- Description:
37 -- This procedure is the record interface for the insert process
38 -- for the specified entity. The role of this process is to insert a fully
39 -- validated row, into the HR schema passing back to the calling process,
40 -- any system generated values (e.g. primary and object version number
41 -- attributes). This process is the main backbone of the ins
42 -- process. The processing of this procedure is as follows:
43 -- 1) If the p_validate parameter has been set to true then a savepoint is
44 -- issued.
45 -- 2) The controlling validation process insert_validate is executed
46 -- which will execute all private and public validation business rule
47 -- processes.
48 -- 3) The pre_insert business process is then executed which enables any
49 -- logic to be processed before the insert dml process is executed.
50 -- 4) The insert_dml process will physical perform the insert dml into the
51 -- specified entity.
52 -- 5) The post_insert business process is then executed which enables any
53 -- logic to be processed after the insert dml process.
54 -- 6) If the p_validate parameter has been set to true an exception is
55 -- raised which is handled and processed by performing a rollback to the
56 -- savepoint which was issued at the beginning of the Ins process.
57 --
58 -- Prerequisites:
59 -- The main parameters to the this process have to be in the record
60 -- format.
61 --
62 -- In Parameters:
63 -- p_validate
64 -- Determines if the process is to be validated. Setting this
65 -- boolean value to true will invoke the process to be validated. The
66 -- default is false. The validation is controlled by a savepoint and
67 -- rollback mechanism. The savepoint is issued at the beginning of the
68 -- process and is rollbacked at the end of the process
69 -- when all the processing has been completed. The rollback is controlled
70 -- by raising and handling the exception hr_api.validate_enabled. We use
71 -- the exception because, by raising the exception with the business
72 -- process, we can exit successfully without having any of the 'OUT'
73 -- parameters being set.
74 --
75 -- Post Success:
76 -- A fully validated row will be inserted into the specified entity
77 -- without being committed.If the p_validate parameter has been set to true
78 -- then all the work will be rolled back.
79 --
80 -- Post Failure:
81 -- If an error has occurred, an error message will be raised.
82 --
83 -- Developer Implementation Notes:
84 -- None.
85 --
86 -- Access Status:
87 -- Internal Development Use Only.
88 --
89 -- {End Of Comments}
90 -- ----------------------------------------------------------------------------
91 Procedure ins
92 ( p_rec in out nocopy pqh_rei_shd.g_rec_type
93 ,p_validate in boolean default false
94 );
95
96 --
97 -- ----------------------------------------------------------------------------
98 -- |---------------------------------< ins >----------------------------------|
99 -- ----------------------------------------------------------------------------
100 -- {Start Of Comments}
101 --
102 -- Description:
103 -- This procedure is the attribute interface for the insert
104 -- process for the specified entity and is the outermost layer. The role
105 -- of this process is to insert a fully validated row into the HR schema
106 -- passing back to the calling process, any system generated values
107 -- (e.g. object version number attributes).The processing of this
108 -- procedure is as follows:
109 -- 1) The attributes are converted into a local record structure by
110 -- calling the convert_args function.
111 -- 2) After the conversion has taken place, the corresponding record ins
112 -- interface process is executed.
113 -- 3) OUT parameters are then set to their corresponding record attributes.
114 --
115 -- Prerequisites:
116 --
117 -- In Parameters:
118 -- p_validate
119 -- Determines if the process is to be validated. Setting this
120 -- Boolean value to true will invoke the process to be validated.
121 -- The default is false.
122 --
123 -- Post Success:
124 -- A fully validated row will be inserted for the specified entity
125 -- without being committed (or rollbacked depending on the p_validate
126 -- status).
127 -- Post Failure:
128 -- If an error has occurred, an error message will be raised.
129 --
130 -- Developer Implementation Notes:
131 -- None.
132 --
133 -- Access Status:
134 -- Internal Development Use Only.
135 --
136 -- {End Of Comments}
137 -- ----------------------------------------------------------------------------
138 Procedure ins
139 (p_role_id in number
140 ,p_information_type in varchar2
141 ,p_request_id in number default null
142 ,p_program_application_id in number default null
143 ,p_program_id in number default null
144 ,p_program_update_date in date default null
145 ,p_attribute_category in varchar2 default null
146 ,p_attribute1 in varchar2 default null
147 ,p_attribute2 in varchar2 default null
148 ,p_attribute3 in varchar2 default null
149 ,p_attribute4 in varchar2 default null
150 ,p_attribute5 in varchar2 default null
151 ,p_attribute6 in varchar2 default null
152 ,p_attribute7 in varchar2 default null
153 ,p_attribute8 in varchar2 default null
154 ,p_attribute9 in varchar2 default null
155 ,p_attribute10 in varchar2 default null
156 ,p_attribute11 in varchar2 default null
157 ,p_attribute12 in varchar2 default null
158 ,p_attribute13 in varchar2 default null
159 ,p_attribute14 in varchar2 default null
160 ,p_attribute15 in varchar2 default null
161 ,p_attribute16 in varchar2 default null
162 ,p_attribute17 in varchar2 default null
163 ,p_attribute18 in varchar2 default null
164 ,p_attribute19 in varchar2 default null
165 ,p_attribute20 in varchar2 default null
166 ,p_attribute21 in varchar2 default null
167 ,p_attribute22 in varchar2 default null
168 ,p_attribute23 in varchar2 default null
169 ,p_attribute24 in varchar2 default null
170 ,p_attribute25 in varchar2 default null
171 ,p_attribute26 in varchar2 default null
172 ,p_attribute27 in varchar2 default null
173 ,p_attribute28 in varchar2 default null
174 ,p_attribute29 in varchar2 default null
175 ,p_attribute30 in varchar2 default null
176 ,p_information_category in varchar2 default null
177 ,p_information1 in varchar2 default null
178 ,p_information2 in varchar2 default null
179 ,p_information3 in varchar2 default null
180 ,p_information4 in varchar2 default null
181 ,p_information5 in varchar2 default null
182 ,p_information6 in varchar2 default null
183 ,p_information7 in varchar2 default null
184 ,p_information8 in varchar2 default null
185 ,p_information9 in varchar2 default null
186 ,p_information10 in varchar2 default null
187 ,p_information11 in varchar2 default null
188 ,p_information12 in varchar2 default null
189 ,p_information13 in varchar2 default null
190 ,p_information14 in varchar2 default null
191 ,p_information15 in varchar2 default null
192 ,p_information16 in varchar2 default null
193 ,p_information17 in varchar2 default null
194 ,p_information18 in varchar2 default null
195 ,p_information19 in varchar2 default null
196 ,p_information20 in varchar2 default null
197 ,p_information21 in varchar2 default null
198 ,p_information22 in varchar2 default null
199 ,p_information23 in varchar2 default null
200 ,p_information24 in varchar2 default null
201 ,p_information25 in varchar2 default null
202 ,p_information26 in varchar2 default null
203 ,p_information27 in varchar2 default null
204 ,p_information28 in varchar2 default null
205 ,p_information29 in varchar2 default null
206 ,p_information30 in varchar2 default null
207 ,p_role_extra_info_id out nocopy number
208 ,p_object_version_number out nocopy number
209 ,p_validate in boolean default false
210 );
211 --
212 end pqh_rei_ins;