1 PACKAGE IBU_REQ_PKG AUTHID CURRENT_USER as
2 /* $Header: ibursrs.pls 120.6 2011/12/12 09:11:29 lkadamba ship $ */
3 /*======================================================================+
4 | Copyright (c) 1999 Oracle Corporation |
5 | Redwood Shores, California, USA |
6 | All rights reserved. |
7 +======================================================================+
8 | FILENAME: ibursrs.pls |
9 | |
10 | PURPOSE |
11 | Creates the package specification |
12 | ARGUMENTS |
13 | |
14 | NOTES |
15 | Usage: start |
16 | HISTORY |
17 | 12.20.99 Alex Lau Created |
18 | 6-APR-2001 Alan Lau |
19 | Add major enhancement for 11.5.4.F |
20 | Commented out UpdateStatus, UpdateUrgency, CreateTask, |
21 | and GetContract. |
22 | 01-MAR-2002 klou |
23 | Add p_error_code to create_service_request procedure. |
24 | 15-MAR-2002 klou |
25 | Add p_serial_number to create_service_request. |
26 | 31-MAR-2002 klou (UCONTACT) |
27 | Add new parameters to UpdateServiceRequest to hanlde |
28 | update contacts in SR detail. |
29 | 15-APR-2002 klou |
30 | 1. Replace p_attr6 with p_cust_pref_lang_code in |
31 | create_service_request |
32 | 25-MAY-2002 WMA |
33 | 1. Add the SR location address information |
34 | 17-OCT-2002 WMA |
35 | 1. modified the create API according to CS change |
36 | 2. add five more parameters for bill to and ship to |
37 | 06-NOV-2002 SPOLAMRE |
38 | Added code to handle DFF |
39 | 13-NOV-2002 WMA |
40 | set the default values for the bill to and ship to |
41 | parameters |
42 | 115.50 03-DEC-2002 WZLI changed OUT and IN OUT calls to use NOCOPY |
43 | hint to enable pass by reference. |
44 | 115.51 06-dec-2002 wzli added two parameters: p_bill_to_party_id |
45 | and p_ship_to_party_id in the create |
46 | service request procedure. |
47 | 115.52 02-Jan-2002 wma add the API |
48 | get_default_status() |
49 | 115.53 31-Jan-2003 SPOLAMRE |
50 | Changed the PROCEDURE AddAttachment to take|
51 | file name as parameter |
52 | 115.54 09-OCT-2003 WZLI added procedure decodeErrorMsg |
53 | 115.55 20-OCT-2003 wzli added two parameterss: p_street_number and |
54 | p_timezone_id in the create SR procedure. |
55 | 115.56 10-MAR-2004 WZLI added parameter: p_note_status. |
56 | 115.57 28-NOV-2004 WMA modify the send Email API, add new API |
57 | StartEmailProcess(). |
58 | 120.1 9-SEP-2005 WMA add logic to handle the mulitbytes issues. |
59 | 120.2 28-NOV-2005 wzli added two parameters: p_ref_object_code and|
60 | p_ref_object_id in the create SR procedure |
61 | 12.3 10-DEC-2005 WMA add procedure validate_http_service_ticket |
62 | 120.5 12-FEB-2009 mkundali added for 12.1.2 enhancement bug8245975 |
63 | 120.6 12-DEC-2011 lkadamba Fix for Bug 12681852 (ISUPPORT PROJECT |
64 | PROJECT INTEGRATION FUNCTIONALITY) |
65 +======================================================================*/
66
67
68 /**
69 * Update Service Requests
70 */
71 PROCEDURE UpdateServiceRequest(
72 p_request_id IN NUMBER,
73 p_status_id IN NUMBER,
74 p_urgency_id IN NUMBER,
75 p_problem_description IN VARCHAR2,
76 p_problem_detail IN VARCHAR2,
77 p_note_type IN VARCHAR2,
78 p_last_updated_by IN NUMBER,
79 p_language IN VARCHAR2,
80 --UCONTACT
81 p_contact_party_id IN JTF_NUMBER_TABLE := null,
82 p_contact_type IN JTF_VARCHAR2_TABLE_100 := null,
83 p_contact_point_id IN JTF_NUMBER_TABLE := null,
84 p_contact_point_type IN JTF_VARCHAR2_TABLE_100 := null,
85 p_contact_primary IN JTF_VARCHAR2_TABLE_100 := null,
86 p_sr_contact_point_id IN JTF_NUMBER_TABLE := null,
87 -- done
88 x_return_status OUT NOCOPY VARCHAR2,
89 x_msg_count OUT NOCOPY NUMBER,
90 x_msg_data OUT NOCOPY VARCHAR2
91 );
92
93 /**
94 * Add Attachment to certain service request
95 */
96 procedure AddAttachment(
97 p_request_id IN NUMBER,
98 p_user_id IN VARCHAR2,
99 p_media_id IN NUMBER,
100 p_name IN VARCHAR2,
101 p_desc IN VARCHAR2);
102
103 /**
104 * CREATE_SERVICE_REQUEST
105 * Thin PL/SQL wrapper for callling TeleService API.
106 */
107 procedure create_service_request(
108 p_request_number IN OUT NOCOPY VARCHAR2,
109 p_type_id IN NUMBER,
110 p_account_id IN NUMBER,
111 p_product IN NUMBER,
112 p_inventory_item IN NUMBER,
113 p_problem_code_id IN VARCHAR2,
114 p_caller_type IN VARCHAR2,
115 p_language IN VARCHAR2,
116 p_urgency_id IN NUMBER,
117 p_summary IN VARCHAR2,
118 p_problem_description IN jtf_varchar2_table_32767,
119 p_problem_detail IN jtf_varchar2_table_32767,
120 p_note_status in jtf_varchar2_table_100,
121 p_contact_party_id in jtf_number_table,
122 p_contact_type in jtf_varchar2_table_100,
123 p_contact_point_id IN jtf_number_table,
124 p_contact_point_type in jtf_varchar2_table_100,
125 p_contact_primary in jtf_varchar2_table_100,
126
127 p_status_id IN NUMBER,
128 p_severity_id IN NUMBER,
129 -- p_owner_id IN NUMBER,
130 p_user_id IN NUMBER,
131 p_customer_id IN NUMBER,
132 p_platform_id IN NUMBER,
133 p_cp_revision_id IN NUMBER,
134 p_inv_item_revision IN VARCHAR2,
135 p_helpdesk_no IN VARCHAR2,
136 p_party_id IN NUMBER,
137 p_solved IN VARCHAR2,
138 p_employee_id IN NUMBER,
139 p_note_type IN jtf_varchar2_table_100,
140 p_contract_id in varchar2,
141 p_project_num in varchar2,
142 p_short_code in varchar2,
143 p_os_version in varchar2,
144 p_db_version in varchar2,
145 p_product_revision in varchar2,
146 -- p_attr_6 in varchar2,
147 p_cust_pref_lang_code in varchar2 := NULL,
148 p_pref_contact_method in varchar2,
149 p_rollout in varchar2,
150 p_error_code in varchar2 := NULL,
151 p_serial_number in varchar2 := NULL,
152 p_inv_category_id in NUMBER,
153 p_time_zone_id in NUMBER,
154 --for the SR location information
155 p_location_id in NUMBER,
156 p_address in varchar2 := NULL,
157 p_city in varchar2 := NULL,
158 p_state in varchar2 := NULL,
159 p_country in varchar2 := NULL,
160 p_province in varchar2 := NULL,
161 p_postal_code in varchar2 := NULL,
162 p_county in varchar2 := NULL,
163 -- add the following for 11.5.10
164 p_addrLine2 in varchar2 := NULL,
165 p_addrLine3 in varchar2 := NULL,
166 p_addrLine4 in varchar2 := NULL,
167 p_poboxNumber in varchar2 := NULL,
168 p_houseNumber in varchar2 := NULL,
169 p_streetSuffix in varchar2 := NULL,
170 p_street in varchar2 := NULL,
171 p_street_number in varchar2 := NULL,
172 p_floor in varchar2 := NULL,
173 p_suite in varchar2 := NULL,
174 p_postalPlus4Code in varchar2 := NULL,
175 p_position in varchar2 := NULL,
176 p_locationDirections in varchar2 := NULL,
177 p_description in varchar2 := NULL,
178 p_pointOfInterest in varchar2 := NULL,
179 p_crossStreet in varchar2 := NULL,
180 p_directionQualifier in varchar2 := NULL,
181 p_distanceQualifier in varchar2 := NULL,
182 p_distanceQualUom in varchar2 := NULL,
183 --for the bill to and ship to
184 p_bill_to_site_id in NUMBER := NULL,
185 p_bill_to_contact_id in NUMBER := NULL,
186 p_ship_to_site_id in NUMBER := NULL,
187 p_ship_to_contact_id in NUMBER := NULL,
188 p_install_site_use_id in NUMBER := NULL,
189 p_bill_to_party_id in NUMBER := NULL,
190 p_ship_to_party_id in NUMBER := NULL,
191 -- added for 11.5.10
192 p_bill_to_account_id in NUMBER,
193 p_ship_to_account_id in NUMBER,
194 -- added for link object enhancement
195 p_ref_object_code in varchar2,
196 p_ref_object_id in number,
197 -- added for eam enhancement
198 p_asset_id in number,
199 p_maint_org_id in number,
200 p_owning_dept_id in number,
201 p_eam_type in varchar2,
202 --for DFF
203 p_external_attribute_1 IN varchar2 := NULL,
204 p_external_attribute_2 IN varchar2 := NULL,
205 p_external_attribute_3 IN varchar2 := NULL,
206 p_external_attribute_4 IN varchar2 := NULL,
207 p_external_attribute_5 IN varchar2 := NULL,
208 p_external_attribute_6 IN varchar2 := NULL,
209 p_external_attribute_7 IN varchar2 := NULL,
210 p_external_attribute_8 IN varchar2 := NULL,
211 p_external_attribute_9 IN varchar2 := NULL,
212 p_external_attribute_10 IN varchar2 := NULL,
213 p_external_attribute_11 IN varchar2 := NULL,
214 p_external_attribute_12 IN varchar2 := NULL,
218 p_external_context IN varchar2 := NULL,
215 p_external_attribute_13 IN varchar2 := NULL,
216 p_external_attribute_14 IN varchar2 := NULL,
217 p_external_attribute_15 IN varchar2 := NULL,
219
220 x_return_status OUT NOCOPY VARCHAR2,
221 x_msg_count OUT NOCOPY NUMBER,
222 x_msg_data OUT NOCOPY VARCHAR2,
223 x_request_id OUT NOCOPY NUMBER,
224 p_site_name in varchar2 := NULL,
225 p_site_number in varchar2 := NULL,
226 p_addressee in varchar2 := NULL,
227
228 --Added for Bug Fix 12681852 (ISUPPORT PROJECT INTEGRATION FUNCTIONALITY)
229 p_project_id in number,
230 p_project_task_id in number
231 );
232
233 /**
234 * Send email notification for user
235 */
236 procedure send_email(
237 email_address_in in varchar2,
238 user_id in varchar2,
239 subject in varchar2,
240 msg_body in varchar2,
241 srID in number,
242 emailStyleSheet in varchar2,
243 emailbranding in varchar2,
244 emaillinkURL in varchar2,
245 notification_pref in varchar2,
246 contactType in varchar2,
247 contactID in number
248 );
249 /**
250 * Get the default status Id for SR creation
251 */
252
253 procedure get_default_status(
254 p_type_id in number,
255 x_status_id out nocopy number,
256 x_return_status out NOCOPY VARCHAR2
257 );
258
259 /**
260 * This API is used to handle the mulitbytes issues.
261 */
262 procedure check_string_length_bites(
263 p_string in varchar2,
264 p_targetlen number,
265 x_returnLen out NOCOPY number,
266 x_truncateCharNum out NOCOPY number
267 );
268 /**
269 * Decode the error messages:
270 * CS_SR_CANNOT_CLOSE_SR
271 * CS_SR_OPEN_TASKS_EXISTS
272 * CS_SR_OPEN_CHARGES_EXISTS
273 * CS_SR_SCHEDULED_TASKS_EXISTS
274 * CS_SR_TASK_DEBRIEF_INCOMPLETE
275 * TO
276 * "This service request cannot be closed at this time.
277 * Please call customer support for assistance."
278 */
279 procedure decodeErrorMsg;
280
281 /**
282 * Start the Email work flow process.
283 */
284
285 procedure StartEmailProcess (
286 roleName in varchar2,
287 srID in number,
288 subject in varchar2,
289 content Wf_Engine.TextTabTyp,
290 ProcessOwner in varchar2,
291 Workflowprocess in varchar2 default null,
292 item_type in varchar2 default null,
293 emailStyleSheet in varchar2,
294 emailbranding in varchar2,
295 emaillinkURL in varchar2);
296
297 /**
298 * get the object info from jtf_object
299 */
300 procedure getObjectInfo(
301 p_ref_object_code in varchar2,
302 x_select_id out NOCOPY varchar2,
303 x_from_table out NOCOPY varchar2,
304 x_where_clause out NOCOPY varchar2,
305 x_object_count out NOCOPY number
306 );
307
308 procedure checkObjectID(
309 p_ref_object_id in number,
310 p_select_id in varchar2,
311 p_from_table in varchar2,
312 p_where_clause in varchar2,
313 x_object_count out NOCOPY number
314 );
315
316 procedure validate_http_service_ticket(
317 p_ticket_string in varchar2,
318 x_return_status out NOCOPY VARCHAR2
319 );
320
321 END IBU_REQ_PKG;