1 Package PER_RECRUITMENT_ACTIVITY_API as
2 /* $Header: peraaapi.pkh 120.1 2005/10/02 02:23:28 aroussel $ */
3 /*#
4 * This package contains HR Recruitment Activity APIs.
5 * @rep:scope public
6 * @rep:product per
7 * @rep:displayname Recruitment Activity
8 */
9 --
10 -- ----------------------------------------------------------------------------
11 -- |-----------------------< create_recruitment_activity >--------------------|
12 -- ----------------------------------------------------------------------------
13 --
14 -- {Start Of Comments}
15 /*#
16 * This API creates a recruitment activity.
17 *
18 * Use this API to record the details of a recruitment activity, including the
19 * dates, costs, and people authorizing and organizing the event. Use the
20 * Create Recruitment Activity For API to associate a particular recruitment
21 * activity with a list of vacancies you define.
22 *
23 * <p><b>Licensing</b><br>
24 * This API is licensed for use with Human Resources and iRecruitment.
25 *
26 * <p><b>Prerequisites</b><br>
27 * The business group for which the recruitment activity is created must
28 * already exist.
29 *
30 * <p><b>Post Success</b><br>
31 * The recruitment activity will have been created.
32 *
33 * <p><b>Post Failure</b><br>
34 * The recruitment activity will not be created and an error will be raised.
35 * @param p_validate If true, then validation alone will be performed and the
36 * database will remain unchanged. If false and all validation checks pass,
37 * then the database will be modified.
38 * @param p_business_group_id Uniquely identifies the business group under
39 * which the Recruitment Activity is created.
40 * @param p_date_start Start date of the activity.
41 * @param p_name Name of the recruitment activity.
42 * @param p_authorising_person_id Uniquely identifies the person that
43 * authorized the activity.
44 * @param p_run_by_organization_id Uniquely identifies the organization running
45 * the activity.
46 * @param p_internal_contact_person_id Uniquely identifies the person who is
47 * the internal contact for the activity.
48 * @param p_parent_recruitment_activity Uniquely identifies this recruitment
49 * activity's parent activity.
50 * @param p_currency_code Currency the application uses to costs the activity.
51 * @param p_actual_cost Cost of the activity.
52 * @param p_comments Comment text.
53 * @param p_contact_telephone_number Telephone number of the contact for this
54 * activity.
55 * @param p_date_closing Date the activity closes.
56 * @param p_date_end Date the activity ends.
57 * @param p_external_contact Name of the external contact for the activity.
58 * @param p_planned_cost Planned cost of the activity.
59 * @param p_recruiting_site_id Uniquely identifies the recruiting site.
60 * @param p_recruiting_site_response The response from the recruiting site,
61 * indicating if the post succeeds.
62 * @param p_last_posted_date Date on which the posting was last sent.
63 * @param p_type Type of recruitment activity. Valid values are defined by the
64 * 'REC_TYPE' lookup type.
65 * @param p_attribute_category This context value determines which flexfield
66 * structure to use with the descriptive flexfield segments.
67 * @param p_attribute1 Descriptive flexfield segment.
68 * @param p_attribute2 Descriptive flexfield segment.
69 * @param p_attribute3 Descriptive flexfield segment.
70 * @param p_attribute4 Descriptive flexfield segment.
71 * @param p_attribute5 Descriptive flexfield segment.
72 * @param p_attribute6 Descriptive flexfield segment.
73 * @param p_attribute7 Descriptive flexfield segment.
74 * @param p_attribute8 Descriptive flexfield segment.
75 * @param p_attribute9 Descriptive flexfield segment.
76 * @param p_attribute10 Descriptive flexfield segment.
77 * @param p_attribute11 Descriptive flexfield segment.
78 * @param p_attribute12 Descriptive flexfield segment.
79 * @param p_attribute13 Descriptive flexfield segment.
80 * @param p_attribute14 Descriptive flexfield segment.
81 * @param p_attribute15 Descriptive flexfield segment.
82 * @param p_attribute16 Descriptive flexfield segment.
83 * @param p_attribute17 Descriptive flexfield segment.
84 * @param p_attribute18 Descriptive flexfield segment.
85 * @param p_attribute19 Descriptive flexfield segment.
86 * @param p_attribute20 Descriptive flexfield segment.
87 * @param p_posting_content_id Uniquely identifies the posting content.
88 * @param p_status The status of the recruitment activity. Valid values are
89 * defined by the 'REC_STATUS' lookup type.
90 * @param p_object_version_number If p_validate is false, then set to the
91 * version number of the created recruitment activity. If p_validate is true,
92 * then the value will be null.
93 * @param p_recruitment_activity_id If p_validate is false, then this uniquely
94 * identifies the recruitment activity created. If p_validate is true, then
95 * this is set to null.
96 * @rep:displayname Create Recruitment Activity
97 * @rep:category BUSINESS_ENTITY PER_RECRUITMENT_ACTIVITY
98 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
99 * @rep:scope public
100 * @rep:lifecycle active
101 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
102 */
103 --
104 -- {End Of Comments}
105 --
106 procedure CREATE_RECRUITMENT_ACTIVITY
107 (p_validate in boolean default false
108 ,p_business_group_id in number
109 ,p_date_start in date
110 ,p_name in varchar2
111 ,p_authorising_person_id in number default null
112 ,p_run_by_organization_id in number default null
113 ,p_internal_contact_person_id in number default null
114 ,p_parent_recruitment_activity in number default null
115 ,p_currency_code in varchar2 default null
116 ,p_actual_cost in varchar2 default null
117 ,p_comments in long default null
118 ,p_contact_telephone_number in varchar2 default null
119 ,p_date_closing in date default null
120 ,p_date_end in date default null
121 ,p_external_contact in varchar2 default null
122 ,p_planned_cost in varchar2 default null
123 ,p_recruiting_site_id in number default null
124 ,p_recruiting_site_response in varchar2 default null
125 ,p_last_posted_date in date default null
126 ,p_type in varchar2 default null
127 ,p_attribute_category in varchar2 default null
128 ,p_attribute1 in varchar2 default null
129 ,p_attribute2 in varchar2 default null
130 ,p_attribute3 in varchar2 default null
131 ,p_attribute4 in varchar2 default null
132 ,p_attribute5 in varchar2 default null
133 ,p_attribute6 in varchar2 default null
134 ,p_attribute7 in varchar2 default null
135 ,p_attribute8 in varchar2 default null
136 ,p_attribute9 in varchar2 default null
137 ,p_attribute10 in varchar2 default null
138 ,p_attribute11 in varchar2 default null
139 ,p_attribute12 in varchar2 default null
140 ,p_attribute13 in varchar2 default null
141 ,p_attribute14 in varchar2 default null
142 ,p_attribute15 in varchar2 default null
143 ,p_attribute16 in varchar2 default null
144 ,p_attribute17 in varchar2 default null
145 ,p_attribute18 in varchar2 default null
146 ,p_attribute19 in varchar2 default null
147 ,p_attribute20 in varchar2 default null
148 ,p_posting_content_id in number default null
149 ,p_status in varchar2 default null
150 ,p_object_version_number out nocopy number
151 ,p_recruitment_activity_id out nocopy number
152 );
153 --
154 -- ----------------------------------------------------------------------------
155 -- |-----------------------< update_recruitment_activity >--------------------|
156 -- ----------------------------------------------------------------------------
157 --
158 -- {Start Of Comments}
159 /*#
160 * This API updates a recruitment activity.
161 *
162 * Use this API to update the details of a recruitment activity, including the
163 * dates, costs, and people authorizing and organizing the event.
164 *
165 * <p><b>Licensing</b><br>
166 * This API is licensed for use with Human Resources and iRecruitment.
167 *
168 * <p><b>Prerequisites</b><br>
169 * The recruitment activity must already exist.
170 *
171 * <p><b>Post Success</b><br>
172 * The recruitment activity will have been updated.
173 *
174 * <p><b>Post Failure</b><br>
175 * The recruitment activity will not be updated and an error will be raised.
176 * @param p_validate If true, then validation alone will be performed and the
177 * database will remain unchanged. If false and all validation checks pass,
178 * then the database will be modified.
179 * @param p_recruitment_activity_id Uniquely identifies the recruitment
180 * activity that is being updated.
181 * @param p_authorising_person_id Uniquely identifies the person that
182 * authorized the activity.
183 * @param p_run_by_organization_id Uniquely identifies the organization running
184 * the activity.
185 * @param p_internal_contact_person_id Uniquely identifies the person who is
186 * the internal contact for this activity.
187 * @param p_parent_recruitment_activity Uniquely identifies this recruitment
188 * activity's parent activity.
189 * @param p_currency_code Currency the application uses to costs the activity.
190 * @param p_date_start Start date of the activity.
191 * @param p_name Name of the recruitment activity.
192 * @param p_actual_cost Cost of the activity.
193 * @param p_comments Comment text.
194 * @param p_contact_telephone_number Telephone Number of the contact for this
195 * activity.
196 * @param p_date_closing Date the activity closes.
197 * @param p_date_end Date the activity ends.
198 * @param p_external_contact Name of the external contact for this activity.
199 * @param p_planned_cost Planned cost of the activity.
200 * @param p_recruiting_site_id Uniquely identifies the recruiting site.
201 * @param p_recruiting_site_response The response from the recruiting site,
202 * indicating if the post succeeds.
203 * @param p_last_posted_date Date on which the posting was last sent.
204 * @param p_type Type of recruitment activity. Valid values are defined by the
205 * 'REC_TYPE' lookup type.
206 * @param p_attribute_category This context value determines which flexfield
207 * structure to use with the descriptive flexfield segments.
208 * @param p_attribute1 Descriptive flexfield segment.
209 * @param p_attribute2 Descriptive flexfield segment.
210 * @param p_attribute3 Descriptive flexfield segment.
211 * @param p_attribute4 Descriptive flexfield segment.
212 * @param p_attribute5 Descriptive flexfield segment.
213 * @param p_attribute6 Descriptive flexfield segment.
214 * @param p_attribute7 Descriptive flexfield segment.
215 * @param p_attribute8 Descriptive flexfield segment.
216 * @param p_attribute9 Descriptive flexfield segment.
217 * @param p_attribute10 Descriptive flexfield segment.
218 * @param p_attribute11 Descriptive flexfield segment.
219 * @param p_attribute12 Descriptive flexfield segment.
220 * @param p_attribute13 Descriptive flexfield segment.
221 * @param p_attribute14 Descriptive flexfield segment.
222 * @param p_attribute15 Descriptive flexfield segment.
223 * @param p_attribute16 Descriptive flexfield segment.
224 * @param p_attribute17 Descriptive flexfield segment.
225 * @param p_attribute18 Descriptive flexfield segment.
226 * @param p_attribute19 Descriptive flexfield segment.
227 * @param p_attribute20 Descriptive flexfield segment.
228 * @param p_posting_content_id Uniquely identifies the posting content.
229 * @param p_status The status of the recruitment activity. Valid values are
230 * defined by the 'REC_STATUS' lookup type.
231 * @param p_object_version_number Pass in the current version number of the
232 * recruitment activity to be updated. When the API completes if p_validate is
233 * false, will be set to the new version number of the updated recruitment
234 * activity. If p_validate is true will be set to the same value which was
235 * passed in.
236 * @rep:displayname Update Recruitment Activity
237 * @rep:category BUSINESS_ENTITY PER_RECRUITMENT_ACTIVITY
238 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
239 * @rep:scope public
240 * @rep:lifecycle active
241 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
242 */
243 --
244 -- {End Of Comments}
245 --
246 procedure UPDATE_RECRUITMENT_ACTIVITY
247 (p_validate in boolean default false
248 ,p_recruitment_activity_id in number
249 ,p_authorising_person_id in number default hr_api.g_number
250 ,p_run_by_organization_id in number default hr_api.g_number
251 ,p_internal_contact_person_id in number default hr_api.g_number
252 ,p_parent_recruitment_activity in number default hr_api.g_number
253 ,p_currency_code in varchar2 default hr_api.g_varchar2
254 ,p_date_start in date default hr_api.g_date
255 ,p_name in varchar2 default hr_api.g_varchar2
256 ,p_actual_cost in varchar2 default hr_api.g_varchar2
257 ,p_comments in long default hr_api.g_varchar2
258 ,p_contact_telephone_number in varchar2 default hr_api.g_varchar2
259 ,p_date_closing in date default hr_api.g_date
260 ,p_date_end in date default hr_api.g_date
261 ,p_external_contact in varchar2 default hr_api.g_varchar2
262 ,p_planned_cost in varchar2 default hr_api.g_varchar2
263 ,p_recruiting_site_id in number default hr_api.g_number
264 ,p_recruiting_site_response in varchar2 default hr_api.g_varchar2
265 ,p_last_posted_date in date default hr_api.g_date
266 ,p_type in varchar2 default hr_api.g_varchar2
267 ,p_attribute_category in varchar2 default hr_api.g_varchar2
268 ,p_attribute1 in varchar2 default hr_api.g_varchar2
269 ,p_attribute2 in varchar2 default hr_api.g_varchar2
270 ,p_attribute3 in varchar2 default hr_api.g_varchar2
271 ,p_attribute4 in varchar2 default hr_api.g_varchar2
272 ,p_attribute5 in varchar2 default hr_api.g_varchar2
273 ,p_attribute6 in varchar2 default hr_api.g_varchar2
274 ,p_attribute7 in varchar2 default hr_api.g_varchar2
275 ,p_attribute8 in varchar2 default hr_api.g_varchar2
276 ,p_attribute9 in varchar2 default hr_api.g_varchar2
277 ,p_attribute10 in varchar2 default hr_api.g_varchar2
278 ,p_attribute11 in varchar2 default hr_api.g_varchar2
279 ,p_attribute12 in varchar2 default hr_api.g_varchar2
280 ,p_attribute13 in varchar2 default hr_api.g_varchar2
281 ,p_attribute14 in varchar2 default hr_api.g_varchar2
282 ,p_attribute15 in varchar2 default hr_api.g_varchar2
283 ,p_attribute16 in varchar2 default hr_api.g_varchar2
284 ,p_attribute17 in varchar2 default hr_api.g_varchar2
285 ,p_attribute18 in varchar2 default hr_api.g_varchar2
286 ,p_attribute19 in varchar2 default hr_api.g_varchar2
287 ,p_attribute20 in varchar2 default hr_api.g_varchar2
288 ,p_posting_content_id in number default hr_api.g_number
289 ,p_status in varchar2 default hr_api.g_varchar2
290 ,p_object_version_number in out nocopy number
291 );
292 --
293 -- ----------------------------------------------------------------------------
294 -- |-----------------------< delete_recruitment_activity >--------------------|
295 -- ----------------------------------------------------------------------------
296 --
297 -- {Start Of Comments}
298 /*#
299 * This API deletes a recruitment activity.
300 *
301 * Use the Delete Recruitment Activity For API to remove an association between
302 * a particular recruitment activity and a vacancy.
303 *
304 * <p><b>Licensing</b><br>
305 * This API is licensed for use with Human Resources and iRecruitment.
306 *
307 * <p><b>Prerequisites</b><br>
308 * The recruitment activity must already exist.
309 *
310 * <p><b>Post Success</b><br>
311 * The recruitment activity will have been deleted.
312 *
313 * <p><b>Post Failure</b><br>
314 * The recruitment activity will not be deleted and an error will be raised.
315 * @param p_validate If true, then validation alone will be performed and the
316 * database will remain unchanged. If false and all validation checks pass,
317 * then the database will be modified.
318 * @param p_object_version_number Current version number of the Recruitment
319 * Activity to be deleted.
320 * @param p_recruitment_activity_id Uniquely identifies the Recruitment
321 * Activity that is being deleted.
322 * @rep:displayname Delete Recruitment Activity
323 * @rep:category BUSINESS_ENTITY PER_RECRUITMENT_ACTIVITY
324 * @rep:category MISC_EXTENSIONS HR_USER_HOOKS
325 * @rep:scope public
326 * @rep:lifecycle active
327 * @rep:ihelp PER/@scalapi APIs in Oracle HRMS
328 */
329 --
330 -- {End Of Comments}
331 --
332 procedure DELETE_RECRUITMENT_ACTIVITY
333 (p_validate in boolean default false
334 ,p_object_version_number in number
335 ,p_recruitment_activity_id in number
336 );
337 --
338 end PER_RECRUITMENT_ACTIVITY_API;