DBA Data[Home] [Help]

PACKAGE: APPS.PQH_REI_INS

Source


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;