1 Package per_ppc_ins AUTHID CURRENT_USER as
2 /* $Header: peppcrhi.pkh 120.1 2006/03/14 18:16:34 scnair 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 -- p_validation_strength
48 -- Determines how strong the validation should be. Should always be set
49 -- to STRONG unless called from the insert component api which is trying
50 -- to insert a component in to a proposal which is about to be changed.
51 -- In this case it should be set to WEAK and the conditions that
52 -- you cannot insert components for an approved proposal, or insert
53 -- components for a proposal with multiple components set to
54 -- 'N' will be ignored.
55 --
56 --
57 -- Post Success:
58 -- A fully validated row will be inserted into the specified entity
59 -- without being committed. If the p_validate parameter has been set to true
60 -- then all the work will be rolled back.
61 --
62 -- Post Failure:
63 -- If an error has occurred, an error message will be supplied with the work
64 -- rolled back.
65 --
66 -- Developer Implementation Notes:
67 -- None.
68 --
69 -- Access Status:
70 -- Internal Development Use Only.
71 --
72 -- {End Of Comments}
73 -- ----------------------------------------------------------------------------
74 Procedure ins
75 (
76 p_rec in out nocopy per_ppc_shd.g_rec_type,
77 p_validation_strength in varchar2 default 'STRONG',
78 p_validate in boolean default false
79 );
80 --
81 -- ----------------------------------------------------------------------------
82 -- |---------------------------------< ins >----------------------------------|
83 -- ----------------------------------------------------------------------------
84 -- {Start Of Comments}
85 --
86 -- Description:
87 -- This procedure is the attribute interface for the insert
88 -- process for the specified entity and is the outermost layer. The role
89 -- of this process is to insert a fully validated row into the HR schema
90 -- passing back to the calling process, any system generated values
91 -- (e.g. object version number attributes).The processing of this
92 -- procedure is as follows:
93 -- 1) The attributes are converted into a local record structure by
94 -- calling the convert_args function.
95 -- 2) After the conversion has taken place, the corresponding record ins
96 -- interface process is executed.
97 -- 3) OUT parameters are then set to their corresponding record attributes.
98 --
99 -- Pre Conditions:
100 --
101 -- In Parameters:
102 -- p_validate
103 -- Determines if the process is to be validated. Setting this
104 -- Boolean value to true will invoke the process to be validated.
105 -- The default is false.
106 -- p_validation_strength
107 -- Determines how strong the validation should be. Should always be set
108 -- to STRONG unless called from the insert component api which is trying
109 -- to insert a component in to a proposal which is about to be changed.
110 -- In this case it should be set to WEAK and the conditions that
111 -- you cannot insert components for an approved proposal, or insert
112 -- components for a proposal with multiple components set to
113 -- 'N' will be ignored.
114 --
115 --
116 -- Post Success:
117 -- A fully validated row will be inserted for the specified entity
118 -- without being committed (or rollbacked depending on the p_validate
119 -- status).
120 --
121 -- Post Failure:
122 -- If an error has occurred, an error message will be supplied with the work
123 -- rolled back.
124 --
125 -- Developer Implementation Notes:
126 -- None.
127 --
128 -- Access Status:
129 -- Internal Development Use Only.
130 --
131 -- {End Of Comments}
132 -- ----------------------------------------------------------------------------
133 Procedure ins
134 (
135 p_component_id out nocopy number,
136 p_pay_proposal_id in number,
137 p_business_group_id in number,
138 p_approved in varchar2,
139 p_component_reason in varchar2,
140 p_change_amount_n in number default null,
141 p_change_percentage in number default null,
142 p_comments in varchar2 default null,
143 p_attribute_category in varchar2 default null,
144 p_attribute1 in varchar2 default null,
145 p_attribute2 in varchar2 default null,
146 p_attribute3 in varchar2 default null,
147 p_attribute4 in varchar2 default null,
148 p_attribute5 in varchar2 default null,
149 p_attribute6 in varchar2 default null,
150 p_attribute7 in varchar2 default null,
151 p_attribute8 in varchar2 default null,
152 p_attribute9 in varchar2 default null,
153 p_attribute10 in varchar2 default null,
154 p_attribute11 in varchar2 default null,
155 p_attribute12 in varchar2 default null,
156 p_attribute13 in varchar2 default null,
157 p_attribute14 in varchar2 default null,
158 p_attribute15 in varchar2 default null,
159 p_attribute16 in varchar2 default null,
160 p_attribute17 in varchar2 default null,
161 p_attribute18 in varchar2 default null,
162 p_attribute19 in varchar2 default null,
163 p_attribute20 in varchar2 default null,
164 p_object_version_number out nocopy number,
165 p_validation_strength in varchar2 default 'STRONG',
166 p_validate in boolean default false
167 );
168 --
169 end per_ppc_ins;