1 Package per_job_ins AUTHID CURRENT_USER as
2 /* $Header: pejobrhi.pkh 120.0 2005/05/31 10:48:07 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_job_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 then 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 -- Pre Conditions:
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 supplied with the work
82 -- rolled back.
83 --
84 -- Developer Implementation Notes:
85 -- None.
86 --
87 -- Access Status:
88 -- Internal Development Use Only.
89 --
90 -- {End Of Comments}
91 -- ----------------------------------------------------------------------------
92 Procedure ins
93 (
94 p_rec in out nocopy per_job_shd.g_rec_type,
95 p_validate in boolean default false
96 );
97 --
98 -- ----------------------------------------------------------------------------
99 -- |---------------------------------< ins >----------------------------------|
100 -- ----------------------------------------------------------------------------
101 -- {Start Of Comments}
102 --
103 -- Description:
104 -- This procedure is the attribute interface for the insert
105 -- process for the specified entity and is the outermost layer. The role
106 -- of this process is to insert a fully validated row into the HR schema
107 -- passing back to the calling process, any system generated values
108 -- (e.g. object version number attributes).The processing of this
109 -- procedure is as follows:
110 -- 1) The attributes are converted into a local record structure by
111 -- calling the convert_args function.
112 -- 2) After the conversion has taken place, the corresponding record ins
113 -- interface process is executed.
114 -- 3) OUT parameters are then set to their corresponding record attributes.
115 --
116 -- Pre Conditions:
117 --
118 -- In Parameters:
119 -- p_validate
120 -- Determines if the process is to be validated. Setting this
121 -- Boolean value to true will invoke the process to be validated.
122 -- The default is false.
123 --
124 -- Post Success:
125 -- A fully validated row will be inserted for the specified entity
126 -- without being committed (or rollbacked depending on the p_validate
127 -- status).
128 --
129 -- Post Failure:
130 -- If an error has occurred, an error message will be supplied with the work
131 -- rolled back.
132 --
133 -- Developer Implementation Notes:
134 -- None.
135 --
136 -- Access Status:
137 -- Internal Development Use Only.
138 --
139 -- {End Of Comments}
140 -- ----------------------------------------------------------------------------
141 Procedure ins
142 (
143 p_job_id out nocopy number,
144 p_business_group_id in number,
145 p_job_definition_id in number,
146 p_date_from in date,
147 p_comments in varchar2 default null,
148 p_date_to in date default null,
149 p_approval_authority in number default null,
150 p_name in varchar2 default null,
151 p_request_id in number default null,
152 p_program_application_id in number default null,
153 p_program_id in number default null,
154 p_program_update_date in date default null,
155 p_attribute_category in varchar2 default null,
156 p_attribute1 in varchar2 default null,
157 p_attribute2 in varchar2 default null,
158 p_attribute3 in varchar2 default null,
159 p_attribute4 in varchar2 default null,
160 p_attribute5 in varchar2 default null,
161 p_attribute6 in varchar2 default null,
162 p_attribute7 in varchar2 default null,
163 p_attribute8 in varchar2 default null,
164 p_attribute9 in varchar2 default null,
165 p_attribute10 in varchar2 default null,
166 p_attribute11 in varchar2 default null,
167 p_attribute12 in varchar2 default null,
168 p_attribute13 in varchar2 default null,
169 p_attribute14 in varchar2 default null,
170 p_attribute15 in varchar2 default null,
171 p_attribute16 in varchar2 default null,
172 p_attribute17 in varchar2 default null,
173 p_attribute18 in varchar2 default null,
174 p_attribute19 in varchar2 default null,
175 p_attribute20 in varchar2 default null,
176 p_job_information_category in varchar2 default null,
177 p_job_information1 in varchar2 default null,
178 p_job_information2 in varchar2 default null,
179 p_job_information3 in varchar2 default null,
180 p_job_information4 in varchar2 default null,
181 p_job_information5 in varchar2 default null,
182 p_job_information6 in varchar2 default null,
183 p_job_information7 in varchar2 default null,
184 p_job_information8 in varchar2 default null,
185 p_job_information9 in varchar2 default null,
186 p_job_information10 in varchar2 default null,
187 p_job_information11 in varchar2 default null,
188 p_job_information12 in varchar2 default null,
189 p_job_information13 in varchar2 default null,
190 p_job_information14 in varchar2 default null,
191 p_job_information15 in varchar2 default null,
192 p_job_information16 in varchar2 default null,
193 p_job_information17 in varchar2 default null,
194 p_job_information18 in varchar2 default null,
195 p_job_information19 in varchar2 default null,
196 p_job_information20 in varchar2 default null,
197 p_benchmark_job_flag in varchar2 default 'N',
198 p_benchmark_job_id in number default null,
199 p_emp_rights_flag in varchar2 default 'N',
200 p_job_group_id in number,
201 p_object_version_number out nocopy number,
202 p_validate in boolean default false
203 );
204 end per_job_ins;