DBA Data[Home] [Help]

PACKAGE: APPS.PE_PEI_INS

Source


1 Package pe_pei_ins AUTHID CURRENT_USER as
2 /* $Header: pepeirhi.pkh 120.0 2005/05/31 13:21:30 appldev noship $ */
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   (
67   p_rec        in out nocopy pe_pei_shd.g_rec_type,
68   p_validate   in     boolean default false
69   );
70 --
71 -- ----------------------------------------------------------------------------
72 -- |---------------------------------< ins >----------------------------------|
73 -- ----------------------------------------------------------------------------
74 -- {Start Of Comments}
75 --
76 -- Description:
77 --   This procedure is the attribute interface for the insert
78 --   process for the specified entity and is the outermost layer. The role
79 --   of this process is to insert a fully validated row into the HR schema
80 --   passing back to the calling process, any system generated values
81 --   (e.g. object version number attributes).The processing of this
82 --   procedure is as follows:
83 --   1) The attributes are converted into a local record structure by
84 --      calling the convert_args function.
85 --   2) After the conversion has taken place, the corresponding record ins
86 --      interface process is executed.
87 --   3) OUT parameters are then set to their corresponding record attributes.
88 --
89 -- Pre Conditions:
90 --
91 -- In Parameters:
92 --   p_validate
93 --     Determines if the process is to be validated. Setting this
94 --     Boolean value to true will invoke the process to be validated.
95 --     The default is false.
96 --
97 -- Post Success:
98 --   A fully validated row will be inserted for the specified entity
99 --   without being committed (or rollbacked depending on the p_validate
100 --   status).
101 --
102 -- Post Failure:
103 --   If an error has occurred, an error message will be supplied with the work
104 --   rolled back.
105 --
106 -- Developer Implementation Notes:
107 --   None.
108 --
109 -- Access Status:
110 --   Internal Development Use Only.
111 --
112 -- {End Of Comments}
113 -- ----------------------------------------------------------------------------
114 Procedure ins
115   (
116   p_person_extra_info_id         out nocopy number,
117   p_person_id                    in number,
118   p_information_type             in varchar2,
119   p_request_id                   in number           default null,
120   p_program_application_id       in number           default null,
121   p_program_id                   in number           default null,
122   p_program_update_date          in date             default null,
123   p_pei_attribute_category       in varchar2         default null,
124   p_pei_attribute1               in varchar2         default null,
125   p_pei_attribute2               in varchar2         default null,
126   p_pei_attribute3               in varchar2         default null,
127   p_pei_attribute4               in varchar2         default null,
128   p_pei_attribute5               in varchar2         default null,
129   p_pei_attribute6               in varchar2         default null,
130   p_pei_attribute7               in varchar2         default null,
131   p_pei_attribute8               in varchar2         default null,
132   p_pei_attribute9               in varchar2         default null,
133   p_pei_attribute10              in varchar2         default null,
134   p_pei_attribute11              in varchar2         default null,
135   p_pei_attribute12              in varchar2         default null,
136   p_pei_attribute13              in varchar2         default null,
137   p_pei_attribute14              in varchar2         default null,
138   p_pei_attribute15              in varchar2         default null,
139   p_pei_attribute16              in varchar2         default null,
140   p_pei_attribute17              in varchar2         default null,
141   p_pei_attribute18              in varchar2         default null,
142   p_pei_attribute19              in varchar2         default null,
143   p_pei_attribute20              in varchar2         default null,
144   p_pei_information_category     in varchar2         default null,
145   p_pei_information1             in varchar2         default null,
146   p_pei_information2             in varchar2         default null,
147   p_pei_information3             in varchar2         default null,
148   p_pei_information4             in varchar2         default null,
149   p_pei_information5             in varchar2         default null,
150   p_pei_information6             in varchar2         default null,
151   p_pei_information7             in varchar2         default null,
152   p_pei_information8             in varchar2         default null,
153   p_pei_information9             in varchar2         default null,
154   p_pei_information10            in varchar2         default null,
155   p_pei_information11            in varchar2         default null,
156   p_pei_information12            in varchar2         default null,
157   p_pei_information13            in varchar2         default null,
158   p_pei_information14            in varchar2         default null,
159   p_pei_information15            in varchar2         default null,
160   p_pei_information16            in varchar2         default null,
161   p_pei_information17            in varchar2         default null,
162   p_pei_information18            in varchar2         default null,
163   p_pei_information19            in varchar2         default null,
164   p_pei_information20            in varchar2         default null,
165   p_pei_information21            in varchar2         default null,
166   p_pei_information22            in varchar2         default null,
167   p_pei_information23            in varchar2         default null,
168   p_pei_information24            in varchar2         default null,
169   p_pei_information25            in varchar2         default null,
170   p_pei_information26            in varchar2         default null,
171   p_pei_information27            in varchar2         default null,
172   p_pei_information28            in varchar2         default null,
173   p_pei_information29            in varchar2         default null,
174   p_pei_information30            in varchar2         default null,
175   p_object_version_number        out nocopy number,
176   p_validate                     in boolean   default false
177   );
178 --
179 end pe_pei_ins;