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