1 PACKAGE CSF_GANTT_DATA_PKG AUTHID CURRENT_USER As
2 /*$Header: CSFGTPLS.pls 120.19 2011/04/26 13:44:04 ramchint ship $*/
3
4 /* Change history
5 Date Userid Change
6 ---------- -------- ---------------------------------------------------
7 05/10/2004 vakulkar created new package for Gantt
8 14/10/2004 vakulkar addded global variable for userenv('lang')
9 changed the get_scheduled_task/virtual_tasks
10 procedures parameters
11 30/10/2004 vakulkar addded 2 extra parametrs to procedure
12 get_planned_shitfs.
13 created one new procedure for showing
14 real tasks in plantoption window
15 get_advise_real_tasks
16 09/12/2004 vakulkar modified get_scheduled_real_task,virtual_tasks
17 get_planned_shifts,get_planned_tasks procedure
18
19 In get_scheduled_real/virtual task removed
20 the code for populating tooltip.
21 Redesign the cursor for getting the data
22 like removed join cs_incident_all_b and other
23 tabels related to it.
24
25 Removed all uneccessary code for tooltip and
26 color and get_contact_point.
27
28 Created 3 new procedures for tooltip
29 get_tooltip_data_gantt
30 get_tooltip_data_sch_adv
31 get_gantt_task_color
32 28/12/2004 vakulkar Added Drag n Drop procedure for Gantt
33 23/02/2005 vakulkar Added Procedure get_skilled_resources
34 used when drag n drop is done from
35 one resource to another then check if
36 new resource has the same skills and they
37 are active on that day.
38 And if task is drag and drop to same resource
39 but diffrent date then validate the skills
40 same as above
41 Added get_resource_name, get_resource_type_name
42 Procedures which will be used by CSFDataSource.java
43 to populate Resources in Left pane of Gantt.
44
45 25/04/2005 vakulkar introduced new 3 new procedure for schedule advise gantt
46 1. g_do_match for matchin the color for task
47 2.g_get_custom_color for populating pl/sql table
48 which willbe used by g_do_match procedure for
49 getting the color
50 3.get_tooltip_for_plan_task this is used to show
51 tooltip for planned task
52
53 17/02/2006 vakulkar removed seven procedures and introduced two procedures for
54 doing the same task. The procedures removed are
55 1. get_resource_shifts
56 2. get_planned_shifts
57 3. get_scheduled_virtual_tasks
58 4. get_advise_real_tasks
59 5. get_scheduled_real_tasks
60 6. get_schedule_advise_tasks
61 7. get_adv_real_tasks
62 The procedure that are introduced are
63 1. get_dispatch_task_dtls
64 2. get_schedule_advise_options
65 */
66 -- ---------------------------------------------------------------------------
67 -- Public variable, constants, funtions
68 -- ---------------------------------------------------------------------------
69 blue Constant Number (3) := 255; -- color for regular tasks
70 red Constant Number (8) := 16711680;
71 -- color for escalated tasks
72 green Constant Number (5) := 65280;
73 -- color for task plan option
74 yellow Constant Number (8) := 16776960;
75
76
77 TYPE g_custom_color_rec IS RECORD (
78 task_type_id NUMBER,
79 task_priority_id NUMBER,
80 assignment_status_id NUMBER,
81 escalated_task VARCHAR2 (1),
82 background_col_dec NUMBER,
83 background_col_rgb VARCHAR2 (12)
84 );
85
86 TYPE g_custom_color_tbl IS TABLE OF g_custom_color_rec
87 INDEX BY BINARY_INTEGER;
88 -- color for task with actual times
89 Type tooltip_data_rec_type Is Record (
90 task_name jtf_tasks_tl.task_name%Type
91 , task_number jtf_tasks_b.task_number%Type
92 , task_type jtf_task_types_tl.Name%Type
93 , task_status jtf_task_statuses_vl.Name%Type
94 , address Varchar2 (2000)
95 , parts Varchar2 (30)
96 , incident_number cs_incidents_all_b.incident_number%Type
97 , incident_type_name cs_incident_types_tl.Name%Type
98 , incident_customer_name varchar2(1000) --bug no 5674408
99 , contact Varchar2 (2000)
100 , phone Varchar2 (2000)
101 , product_name mtl_system_items_kfv.concatenated_segments%Type
102 , serial_number csi_item_instances.serial_number%Type
103 , lot_number csi_item_instances.lot_number%Type
104 , resource_name Varchar2 (2000)
105 , planned_start Varchar2 (30)
106 , planned_end Varchar2 (30)
107 , scheduled_start_date Date
108 , scheduled_start Varchar2 (30)
109 , scheduled_end Varchar2 (30)
110 , actual_start Varchar2 (30)
111 , actual_end Varchar2 (30)
112 , departure_time Date
113 , travel_time Varchar2 (300)
114 , estimated_start Varchar2 (30)
115 , estimated_end Varchar2 (30)
116 , assigned_flag Varchar2 (30)
117 , is_plan_option Varchar2 (1)
118 );
119
120 type tooltip_setup_type is record
121 ( seq_no number
122 , field_name varchar2(50)
123 , field_value varchar2(50));
124
125 type tooltip_setup_tbl is table of tooltip_setup_type INDEX BY BINARY_INTEGER;
126
127
128 PROCEDURE get_message_text
129 ( p_api_version IN Number
130 , p_init_msg_list IN Varchar2 DEFAULT NULL
131 , x_return_status OUT NOCOPY Varchar2
132 , x_msg_count OUT NOCOPY Number
133 , x_msg_data OUT NOCOPY Varchar2
134 , p_message_text OUT NOCOPY jtf_varchar2_table_2000
135 , p_message_code OUT NOCOPY jtf_varchar2_table_2000
136 );
137
138 Procedure get_dispatch_task_dtls (
139 p_api_version IN Number
140 , p_init_msg_list IN Varchar2 DEFAULT NULL
141 , x_return_status OUT NOCOPY Varchar2
142 , x_msg_count OUT NOCOPY Number
143 , x_msg_data OUT NOCOPY Varchar2
144 , p_start_date_range IN DATE
145 , p_end_date_range IN DATE
146 , p_res_id OUT NOCOPY jtf_number_table
147 , p_res_type OUT NOCOPY jtf_varchar2_table_2000
148 , p_res_name OUT NOCOPY jtf_varchar2_table_2000
149 , p_res_typ_name OUT NOCOPY jtf_varchar2_table_2000
150 , p_res_key OUT NOCOPY jtf_varchar2_table_2000
151 , p_trip_id OUT NOCOPY jtf_number_table
152 , p_shift_start_date OUT NOCOPY jtf_date_table
153 , p_shift_end_date OUT NOCOPY jtf_date_table
154 , p_block_trip OUT NOCOPY jtf_number_table
155 , p_shift_res_key OUT NOCOPY jtf_varchar2_table_2000
156 , p_vir_task_id OUT NOCOPY jtf_varchar2_table_100
157 , p_vir_start_date OUT NOCOPY jtf_date_table
158 , p_vir_end_date OUT NOCOPY jtf_date_table
159 , p_vir_color OUT NOCOPY jtf_number_table
160 , p_vir_name OUT NOCOPY jtf_varchar2_table_100
161 , p_vir_duration OUT NOCOPY jtf_number_table
162 , p_vir_task_type_id OUT NOCOPY jtf_number_table
163 , p_vir_tooltip OUT NOCOPY jtf_varchar2_table_2000
164 , p_vir_resource_key OUT NOCOPY jtf_varchar2_table_2000
165 , real_task_id OUT NOCOPY jtf_varchar2_table_100
166 , real_start_date OUT NOCOPY jtf_date_table
167 , real_end_date OUT NOCOPY jtf_date_table
168 , real_color OUT NOCOPY jtf_number_table
169 , real_NAME OUT NOCOPY jtf_varchar2_table_2000
170 , real_tooltip OUT NOCOPY jtf_varchar2_table_2000
171 , real_DURATION OUT NOCOPY jtf_number_table
172 , real_task_type_id OUT NOCOPY jtf_number_table
173 , real_resource_key OUT NOCOPY jtf_varchar2_table_2000
174 , real_parts_required OUT NOCOPY jtf_varchar2_table_100
175 , real_access_hours OUT NOCOPY jtf_varchar2_table_100
176 , real_after_hours OUT NOCOPY jtf_varchar2_table_100
177 , real_customer_conf OUT NOCOPY jtf_varchar2_table_100
178 , real_task_depend OUT NOCOPY jtf_varchar2_table_100
179 , real_child_task OUT NOCOPY jtf_varchar2_table_100
180 , p_vir_avail_type OUT NOCOPY jtf_varchar2_table_2000
181 , p_show_arr_dep_tasks IN varchar2 DEFAULT 'N'
182 , p_terr_name OUT NOCOPY jtf_varchar2_table_2000
183 , p_contact OUT NOCOPY jtf_varchar2_table_2000
184 );
185
186
187 PROCEDURE get_schedule_advise_options
188 (
189 p_api_version IN NUMBER
190 , p_init_msg_list IN VARCHAR2 DEFAULT NULL
191 , x_return_status OUT NOCOPY VARCHAR2
192 , x_msg_count OUT NOCOPY NUMBER
193 , x_msg_data OUT NOCOPY VARCHAR2
194 , p_display_option IN VARCHAR2
195 , p_resource_id IN NUMBER
196 , p_resource_type IN VARCHAR2
197 , p_req_id IN NUMBER
198 , p_par_task IN NUMBER
199 , p_task_id IN NUMBER
200 , p_res_id OUT NOCOPY jtf_number_table
201 , p_res_type OUT NOCOPY jtf_varchar2_table_2000
202 , p_res_name OUT NOCOPY jtf_varchar2_table_2000
203 , p_res_typ_name OUT NOCOPY jtf_varchar2_table_2000
204 , p_res_key OUT NOCOPY jtf_varchar2_table_2000
205 , p_cost OUT NOCOPY jtf_number_table
206 , p_start_date IN DATE
207 , p_end_date IN DATE
208 , sch_adv_tz In Varchar2
209 , inc_tz_code In Varchar2
210 , trip_id OUT NOCOPY jtf_number_table
211 , start_date OUT NOCOPY jtf_date_table
212 , end_date OUT NOCOPY jtf_date_table
213 , block_trip OUT NOCOPY jtf_number_table
214 , p_bck_res_key OUT NOCOPY jtf_varchar2_table_2000
215 , plan_task_key OUT NOCOPY jtf_varchar2_table_100
216 , plan_start_date OUT NOCOPY jtf_date_table
217 , plan_end_date OUT NOCOPY jtf_date_table
218 , plan_color OUT NOCOPY jtf_number_table
219 , plan_name OUT NOCOPY jtf_varchar2_table_2000
220 , plan_tooltip OUT NOCOPY jtf_varchar2_table_2000
221 , plan_duration OUT NOCOPY jtf_number_table
222 , plan_task_type_id OUT NOCOPY jtf_number_table
223 , plan_resource_key OUT NOCOPY jtf_varchar2_table_2000
224 , real_task_key OUT NOCOPY jtf_varchar2_table_100
225 , real_start_date OUT NOCOPY jtf_date_table
226 , real_end_date OUT NOCOPY jtf_date_table
227 , real_color OUT NOCOPY jtf_number_table
228 , real_name OUT NOCOPY jtf_varchar2_table_2000
229 , real_tooltip OUT NOCOPY jtf_varchar2_table_2000
230 , real_duration OUT NOCOPY jtf_number_table
231 , real_task_type_id OUT NOCOPY jtf_number_table
232 , real_resource_key OUT NOCOPY jtf_varchar2_table_2000
233 , child_task OUT Nocopy jtf_varchar2_table_100
234 , real_parts_required OUT NOCOPY jtf_varchar2_table_100
235 , real_access_hours OUT NOCOPY jtf_varchar2_table_100
236 , real_after_hours OUT NOCOPY jtf_varchar2_table_100
237 , real_customer_conf OUT NOCOPY jtf_varchar2_table_100
238 , real_task_depend OUT NOCOPY jtf_varchar2_table_100
239 , oth_real_task_id Out Nocopy jtf_varchar2_table_100
240 , oth_real_start_date Out Nocopy jtf_date_table
241 , oth_real_end_date Out Nocopy jtf_date_table
242 , oth_real_color Out Nocopy jtf_number_table
243 , oth_real_Name Out Nocopy jtf_varchar2_table_2000
244 , oth_real_Duration Out Nocopy jtf_number_table
245 , oth_real_task_type_id Out Nocopy jtf_number_table
246 , oth_real_resource_key Out Nocopy jtf_varchar2_table_2000
247 , oth_real_child_task Out Nocopy jtf_varchar2_table_100
248 , oth_real_parts_required OUT NOCOPY jtf_varchar2_table_100
249 , oth_real_access_hours OUT NOCOPY jtf_varchar2_table_100
250 , oth_real_after_hours OUT NOCOPY jtf_varchar2_table_100
251 , oth_real_customer_conf OUT NOCOPY jtf_varchar2_table_100
252 , oth_real_task_depend OUT NOCOPY jtf_varchar2_table_100
253 , p_vir_avail_type OUT NOCOPY jtf_varchar2_table_2000
254 );
255
256 FUNCTION get_tooltip_data_sch_advise(
257 p_task_id NUMBER
258 , p_resource_id NUMBER
259 , p_resource_type VARCHAR2
260 , p_start_date DATE
261 , p_end_date DATE
262 , p_duration NUMBER
263 , sch_adv_tz varchar2
264 , p_server_tz_code VARCHAR2
265 , p_client_tz_code VARCHAR2
266 , p_timezone_enb boolean
267 , p_inc_tz_desc varchar2
268 , p_inc_tz_code VARCHAR2
269 )
270 Return varchar2;
271 FUNCTION get_tooltip_data_sch_advise_cu(
272 p_task_id NUMBER
273 , p_resource_id NUMBER
274 , p_resource_type VARCHAR2
275 , p_start_date DATE
276 , p_end_date DATE
277 , p_duration NUMBER
278 , sch_adv_tz varchar2
279 , p_server_tz_code VARCHAR2
280 , p_client_tz_code VARCHAR2
281 , p_timezone_enb boolean
282 , p_inc_tz_desc varchar2
283 , p_inc_tz_code VARCHAR2
284 )
285 Return varchar2;
286
287
288
289 FUNCTION get_tooltip_data_gantt(
290 p_task_id number
291 ,p_resource_id number
292 ,p_resource_type varchar2
293 ,p_start_date date
294 ,p_end_date date
295 ,p_inc_tz_code VARCHAR2
296 ,p_server_tz_code VARCHAR2
297 ,p_client_tz_code VARCHAR2
298 ,p_timezone_enb boolean
299 ) return varchar2;
300
301
302 FUNCTION get_tooltip_data_gantt_cust(
303 p_task_id number
304 ,p_resource_id number
305 ,p_resource_type varchar2
306 ,p_start_date date
307 ,p_end_date date
308 ,p_inc_tz_code VARCHAR2
309 ,p_server_tz_code VARCHAR2
310 ,p_client_tz_code VARCHAR2
311 ,p_timezone_enb boolean
312 ) return varchar2;
313
314
315 FUNCTION get_tooltip_for_plan_task(
316 p_task_id number
317 , p_resource_id number
318 , p_resource_type varchar2
319 , p_start_date date
320 , p_end_date date
321 , p_duration Number default 0
322 , p_inc_tz_code VARCHAR2
323 , p_server_tz_code VARCHAR2
324 , p_client_tz_code VARCHAR2
325 , p_timezone_enb boolean
326 , sch_adv_tz varchar2
327 , p_inc_tz_desc varchar2)
328 Return varchar2;
329
330 Function get_green
331 Return Number;
332
333 Function get_gantt_task_color (
334 p_task_id In Number
335 , p_task_type_id In Number
336 , p_task_priority_id In Number
337 , p_assignment_status_id In Number
338 , p_task_assignment_id In Number
339 , p_actual_start_date In Date
340 , p_actual_end_date In Date
341 , p_actual_effort In Number
342 , p_actual_effort_uom In Varchar2
343 , p_planned_effort In Number
344 , p_planned_effort_uom In Varchar2
345 , p_scheduled_start_date In Date
346 , p_scheduled_end_date In Date
347 )
348 Return Number;
349
350 Procedure get_planned_task (
351 p_api_version In Number
352 , p_init_msg_list In Varchar2 DEFAULT NULL
353 , p_request_id In varchar2
354 , x_return_status Out Nocopy Varchar2
355 , x_msg_count Out Nocopy Number
356 , x_msg_data Out Nocopy Varchar2
357 , task_id Out Nocopy jtf_varchar2_table_100
358 , start_date Out Nocopy jtf_date_table
359 , end_date Out Nocopy jtf_date_table
360 , color Out Nocopy jtf_number_table
361 , Name Out Nocopy jtf_varchar2_table_100
362 , tooltip Out Nocopy jtf_varchar2_table_2000
363 , Duration Out Nocopy jtf_number_table
364 , task_type_id Out Nocopy jtf_number_table
365 , resource_key Out Nocopy jtf_varchar2_table_2000
366 , sch_adv_tz In Varchar2
367 );
368
369 Function convert_to_days (
370 p_duration Number
371 , p_uom Varchar2
372 , p_uom_hours Varchar2
373 )
374 Return Number;
375
376 Procedure drag_n_drop
377 ( p_api_version in number
378 , p_init_msg_list in varchar2 DEFAULT NULL
379 , p_commit in varchar2 DEFAULT NULL
380 , p_task_id in number
381 , p_task_assignment_id in number default null
382 , p_object_version_number in out nocopy number
383 , p_old_resource_type_code in varchar2
384 , p_new_resource_type_code in varchar2
385 , p_old_resource_id in number
386 , p_new_resource_id in number
387 , p_cancel_status_id in number
388 , p_assignment_status_id in number
389 , p_old_object_capacity_id in number
390 , p_new_object_capacity_id in number
391 , p_sched_travel_distance in number default null
392 , p_sched_travel_duration in number default null
393 , p_sched_travel_duration_uom in varchar2 default null
394 , p_old_shift_construct_id in number default null
395 , p_new_shift_construct_id in number default null
396 , p_shift_changed in boolean
397 , p_task_changed in boolean
398 , p_assignment_changed in boolean
399 , p_time_occupied in number
400 , p_new_sched_start_date in date
401 , p_new_sched_end_date in date
402 , p_update_plan_date in varchar2 default 'N'
403 , p_planned_start_date IN DATE DEFAULT NULL
404 , p_planned_end_date IN DATE DEFAULT NULL
405 , p_planned_effort IN NUMBER DEFAULT NULL
406 , p_planned_effort_uom IN VARCHAR2 DEFAULT NULL
407 , x_return_status out nocopy varchar2
408 , x_msg_count out nocopy number
409 , x_msg_data out nocopy varchar2
410 , x_task_assignment_id out nocopy number
411 , x_task_object_version_number out nocopy number
412 , x_task_status_id out nocopy number
413 , x_task_status_name out nocopy varchar2
414 , x_task_type_id out nocopy number
415 );
416
417 FUNCTION get_skilled_resources
418 ( p_task_id number
419 , p_start date
420 , p_end date
421 , p_resource_id number default null
422 , p_resource_type varchar2 default null
423 ) return Number;
424
425 FUNCTION get_resource_name ( p_res_id number
426 , p_res_type varchar2 ) return varchar2;
427 FUNCTION get_resource_type_name ( p_res_type varchar2 ) return varchar2;
428 FUNCTION g_do_match (
429 p_task_type_id IN NUMBER,
430 p_task_priority_id IN NUMBER,
431 p_assignment_status_id IN NUMBER,
432 p_escalated_task IN VARCHAR2
433 )
434 RETURN NUMBER;
435
436 PROCEDURE insert_rows
437 ( p_setup_type IN varchar2
438 , p_tooltip_setup_tbl IN tooltip_setup_tbl
439 , p_delete_rows IN boolean
440 , p_user_id IN number
441 , p_login_id IN number
442 );
443
444 PROCEDURE delete_rows(p_user_id number);
445
446
447
448 END CSF_GANTT_DATA_PKG;