1 Package per_pyp_ins AUTHID CURRENT_USER as
2 /* $Header: pepyprhi.pkh 120.8 2009/06/10 12:58:59 vkodedal ship $ */
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_pay_proposal_id in number);
30 --
31 --
32 -- ----------------------------------------------------------------------------
33 -- |---------------------------------< ins >----------------------------------|
34 -- ----------------------------------------------------------------------------
35 -- {Start Of Comments}
36 --
37 -- Description:
38 -- This procedure is the record interface for the insert process
39 -- for the specified entity. The role of this process is to insert a fully
40 -- validated row, into the HR schema passing back to the calling process,
41 -- any system generated values (e.g. primary and object version number
42 -- attributes). This process is the main backbone of the ins
43 -- process. The processing of this procedure is as follows:
44 -- 1) If the p_validate parameter has been set to true then a savepoint is
45 -- issued.
46 -- 2) The controlling validation process insert_validate is then executed
47 -- which will execute all private and public validation business rule
48 -- processes.
49 -- 3) The pre_insert business process is then executed which enables any
50 -- logic to be processed before the insert dml process is executed.
51 -- 4) The insert_dml process will physical perform the insert dml into the
52 -- specified entity.
53 -- 5) The post_insert business process is then executed which enables any
54 -- logic to be processed after the insert dml process.
55 -- 6) If the p_validate parameter has been set to true an exception is
56 -- raised which is handled and processed by performing a rollback to the
57 -- savepoint which was issued at the beginning of the Ins process.
58 --
59 -- Pre Conditions:
60 -- The main parameters to the this process have to be in the record
61 -- format.
62 --
63 -- In Parameters:
64 -- p_validate
65 -- Determines if the process is to be validated. Setting this
66 -- boolean value to true will invoke the process to be validated. The
67 -- default is false. The validation is controlled by a savepoint and
68 -- rollback mechanism. The savepoint is issued at the beginning of the
69 -- process and is rollbacked at the end of the process
70 -- when all the processing has been completed. The rollback is controlled
71 -- by raising and handling the exception hr_api.validate_enabled. We use
72 -- the exception because, by raising the exception with the business
73 -- process, we can exit successfully without having any of the 'OUT'
74 -- parameters being set.
75 --
76 -- Post Success:
77 -- A fully validated row will be inserted into the specified entity
78 -- without being committed. If the p_validate parameter has been set to true
79 -- then all the work will be rolled back.
80 --
81 -- Post Failure:
82 -- If an error has occurred, an error message will be supplied with the work
83 -- rolled back.
84 --
85 -- Developer Implementation Notes:
86 -- None.
87 --
88 -- Access Status:
89 -- Internal Development Use Only.
90 --
91 -- {End Of Comments}
92 -- ----------------------------------------------------------------------------
93 Procedure ins
94 (
95 p_rec in out nocopy per_pyp_shd.g_rec_type,
96 p_validate in boolean default false,
97 p_inv_next_sal_date_warning out nocopy boolean,
98 p_proposed_salary_warning out nocopy boolean,
99 p_approved_warning out nocopy boolean,
100 p_payroll_warning out nocopy boolean
101 );
102 --
103 -- ----------------------------------------------------------------------------
104 -- |---------------------------------< ins >----------------------------------|
105 -- ----------------------------------------------------------------------------
106 -- {Start Of Comments}
107 --
108 -- Description:
109 -- This procedure is the attribute interface for the insert
110 -- process for the specified entity and is the outermost layer. The role
111 -- of this process is to insert a fully validated row into the HR schema
112 -- passing back to the calling process, any system generated values
113 -- (e.g. object version number attributes).The processing of this
114 -- procedure is as follows:
115 -- 1) The attributes are converted into a local record structure by
116 -- calling the convert_args function.
117 -- 2) After the conversion has taken place, the corresponding record ins
118 -- interface process is executed.
119 -- 3) OUT parameters are then set to their corresponding record attributes.
120 --
121 -- Pre Conditions:
122 --
123 -- In Parameters:
124 -- p_validate
125 -- Determines if the process is to be validated. Setting this
126 -- Boolean value to true will invoke the process to be validated.
127 -- The default is false.
128 --
129 -- Post Success:
130 -- A fully validated row will be inserted for the specified entity
131 -- without being committed (or rollbacked depending on the p_validate
132 -- status).
133 --
134 -- Post Failure:
135 -- If an error has occurred, an error message will be supplied with the work
136 -- rolled back.
137 --
138 -- Developer Implementation Notes:
139 -- None.
140 --
141 -- Access Status:
142 -- Internal Development Use Only.
143 --
144 -- {End Of Comments}
145 -- ----------------------------------------------------------------------------
146 Procedure ins
147 (
148 p_pay_proposal_id out nocopy number,
149 p_assignment_id in number,
150 p_business_group_id in number,
151 p_change_date in date default null,
152 p_comments in varchar2 default null,
153 p_next_sal_review_date in date default null,
154 p_proposal_reason in varchar2 default null,
155 p_proposed_salary_n in number default null,
156 p_forced_ranking in number default null,
157 p_date_to in date default null,
158 p_performance_review_id in number default null,
159 p_attribute_category in varchar2 default null,
160 p_attribute1 in varchar2 default null,
161 p_attribute2 in varchar2 default null,
162 p_attribute3 in varchar2 default null,
163 p_attribute4 in varchar2 default null,
164 p_attribute5 in varchar2 default null,
165 p_attribute6 in varchar2 default null,
166 p_attribute7 in varchar2 default null,
167 p_attribute8 in varchar2 default null,
168 p_attribute9 in varchar2 default null,
169 p_attribute10 in varchar2 default null,
170 p_attribute11 in varchar2 default null,
171 p_attribute12 in varchar2 default null,
172 p_attribute13 in varchar2 default null,
173 p_attribute14 in varchar2 default null,
174 p_attribute15 in varchar2 default null,
175 p_attribute16 in varchar2 default null,
176 p_attribute17 in varchar2 default null,
177 p_attribute18 in varchar2 default null,
178 p_attribute19 in varchar2 default null,
179 p_attribute20 in varchar2 default null,
180 p_object_version_number out nocopy number,
181 p_multiple_components in varchar2 default null,
182 p_approved in varchar2 default null,
183 p_validate in boolean default false,
184 p_inv_next_sal_date_warning out nocopy boolean,
185 p_proposed_salary_warning out nocopy boolean,
186 p_approved_warning out nocopy boolean,
187 p_payroll_warning out nocopy boolean
188 );
189 --
190 end per_pyp_ins;