dispatch_case

Public Function dispatch_case(ByVal case_id As String, _
                              ByVal queue_name As String, _
                              ByVal disp_date As String, _
                              ByVal user_name As String, _
                              ByVal gen_time_bombs As Boolean) As Integer

Description

This API causes the specified case to be dispatched to the specified queue. The case must be in open condition, and not currently dispatched to a queue. The API allows for the setting of the dispatch date, and the user who dispatched the case. The API can also generate a time bomb (for business rule notification).

Parameters

Parameter Name	Required?	Description
case_id	Yes	The case to dispatch
queue_name	Yes	The queue to dispatch to
disp_date	No	When was the case dispatched. If this parameter is left blank, the case is dispatched at the current time
user_name	No	The user who dispatched the case. If left blank, the current user performs the dispatch.
gen_time_bombs	Yes	Should a time_bomb be generated (for notifications/business rules)

Returns

Value	Meaning
0	No errors
-1	Cannot find the specified case
-2	The case is already dispatched
-3	The case is closed and may not be dispatched
-4	The specified user cannot be found
-5	The specified new queue name cannot be found
-6	The DISPATCH activity string is not found
-7	The specified queue does not allow dispatches of cases
-8	Cannot find the employee record for the designated user

Examples

Dispatch case number 'C154' to queue 'Hardware'. The dispatch is performed by the current user and is dispatched at the current time. Generate a time bomb.

JavaScript:

var ret_int = fccs.dispatch_case("C154", "Hardware", "", "", true);

Visual Basic:

Dim ret_int As Integer

ret_int = fccs.dispatch_case("C154", "Hardware", "", "", True)

Dispatch case number '2' at 10PM on November 23rd of 1997 to 'Software'. Dispatch should be logged as performed by dave. Don't generate a time bomb.

JavaScript:

var ret_int = fccs.dispatch_case("2", "Software",
                                 "11/23/97 22:00:00", "dave", false);

Visual Basic:

Dim ret_int As Integer

ret_int = fccs.dispatch_case("2", "Software", "11/23/97 22:00:00", _
                             "dave", False)