Auto-destination rule properties are divided into:
rule options: auto-dispatch option, destination
rule expression: one or more conditions and logical operators
Rule Options:
auto-dispatch option - if the Make the Dispatch action instant if only one destination found checkbox is checked, the 'AUTO_DISPATCH' text is prefixed to the rule expression which will make the system execute the dispatch action immediately if only one destination meets the criteria stated in this rule expression. If this box is not checked, the user is going to be presented with a choice list of destinations.
destination - depending on the operation selected, the destination is either a User Login (for ASSIGN operation only) or a Queue name (for all other operations).
for ASSIGN operation, the destination may be defined by stating a user login ID explicitly, or it can be retrieved by the system from a specified field.
for all operations other than ASSIGN, the destination may be defined by stating a queue name explicitly, or it can be retrieved by the system from a specified field.
To specify a queue name / user login:
select User Login / Queue Name radio button
enter a name in the adjacent text box, and/or
click Find A User Login / Find A Queue button to verify and select a name from the list.
To specify a field:
select Path To A Field Containing User Login / Path To A Field Containing Queue Name radio button
enter a full path in the adjacent text box, or
click Build A Path button to access Auto-Destination Target Path builder window
build the path and save it by double-clicking on the target field within the Auto-Destination Target Path builder window.
Note: For more information on paths, go to the Path Editor section of this guide.
Rule Expression:
This section consists of:
validation box: a place where all the conditions of the expression are combined and any syntax errors are highlighted
condition builder: a set of controls to define a path to a field, an operator, and a value to compare to
condition grid: a table in which all the conditions and operators can be accessed and manipulated individually
action buttons
To update the expression, use the buttons next to the condition grid:
Add - to insert a new condition after the currently selected one
Replace - to modify the currently selected condition
Up or Down - the selected condition will be moved up or down one row within the grid.
Remove - to delete the currently selected condition
build the path and save it by double-clicking on the target field within the Auto-Destination Rule Clause Path builder window
select a comparison operator from the Operator drop-down list
enter a value to compare into the Value text box (enclose strings in double-quotes)
when finished, click Add or Replace to accept the new condition into the grid
use Clear to empty both Path and Value fields
To build a complex expression:
use ( and ) to group conditions
use AND and/or OR between conditions and/or groups of conditions
(, ), AND, OR will be added after the currently selected condition or at the top of the grid if none is selected
the resulting expression will be verified syntactically. Any errors will be highlighted by:
a red border within the Rule Expression validation box,
a message explaining the nature of the error.
the rule expression will be immediately updated in the validation box to show the resulting expression in whole, with a syntax error highlighted (if any found) and the currently selected condition/operator emphasized with a colored background.
