Segmentaion PDF

C H A P T E R 3
Segmentation
This chapter discusses call segmentation in a script. It includes:

• An introduction to the different types of segmentation you can perform in a
script
• Information about nodes that refine call type definition
• A discussion about nodes that refine call type schedule
• Instructions about changing call type
• Information about changing script processing paths
• A discussion about querying an external database
• Instructions about using application gateways
Introducing Segmentation
Call segmentation is the process of categorizing incoming calls. By examining
information about the call, you can determine the type of service the caller
requires.
The first information ICM software uses to categorize a call is the call type. (For
more information about defining call types, see Chapter 2, “Call Types”.) Ideally,
you should use call types to perform as much of the call segmentation as possible.
Cisco ICM Software Script Editor Guide

78-11590-04 3-1
Chapter 3 Segmentation
Refining Call Type Definition
However, in some cases you might want to perform further segmentation within a
routing script. The ICM Software Script Editor makes this possible by providing
nodes that let you:
• Refine the call type definition. Call qualifier nodes branch based on the
dialed number, calling line ID, or caller-entered digits associated with the
current call.
• Refine the call type schedule. The Time and Day of Week nodes branch
based on the time of day.
• Change the call type. The Call Type and Requalify nodes change the call
type for accounting or routing purposes.
• Change the script processing paths. The Go To Script, Switch, and If nodes
change the direction of call handling.
• Query another database. The DB Lookup facility retrieves data from an
external database.
• Use gateways. The application gateway invokes an external application from
within a routing script; ICM Gateway accesses a Remote ICM.
The sections that follow describe these features and how to use them.

ICM software’s Script Editor includes nodes that let you refine the call type
definition by examining the specific call qualifiers for a call:
• The Dialed Number (DN) node
• The Calling Line ID (CLID) node
• The Caller-Entered Digits (CED) node
Each of these nodes allows you to branch to a connection depending on a value.
This allows you to create another level of call segmentation within the script.
For example, you might define a call type for calls from certain area codes in
Massachusetts and Pennsylvania. Within the script you can examine the specific
calling line ID of the call and alter the classification or routing of the call based
on the specific area code from which the call originated.

3-2 78-11590-04
Figure 3-1 Call Type Definition in Script
In this script fragment, the first CLID node segments off calls from the 617 area
code for special treatment. The second CLID node segments off calls from the 215
or 412 area code.
Tip You can also use the ClidInRegion built-in function to test whether the CLID
value is in a specific region. For information on built-in functions, see
Chapter 5, “Formulas”.
Dialed Number (DN) Node

The Dialed Number (DN) node examines the number dialed by the caller to see
whether it matches a value in a list of dialed numbers that you provide.
Figure 3-2 Dialed Number Node

78-11590-04 3-3
How to add a Dialed Number (DN) node
Step 1 Within Script Editor, place the Dialed Number object in the workspace and
right-click to open the Properties dialog box.
Step 2 Select the Dialed Numbers to be associated with the node and click the Add
button to assign them to the Target Dialed Numbers field.
Step 3 Optionally, click the Comment tab and create descriptive text to appear in the
node in the Script Editor.
Step 4 Optionally, modify the Comments tab.
Step 5 Optionally, modify the Labels tab.
Step 6 Click OK to apply changes and to close the dialog box.
Calling Line ID (CLID) Node

The Calling Line ID (CLID) node lets you examine the billing telephone number
of the caller to see if it matches:
• A specific CLID value that you provide (for example, a specific region, area
code—as shown in Figure 3-3—or an area code plus local exchange).
• A variable expression.
Figure 3-3 Calling Line ID Node
By default, ICM software compares the list of values against the calling line ID
of the call. In practice, however, you are more likely to define a call type that
applies to one or more entire area codes or local exchanges.

3-4 78-11590-04
How to add a CLID node
Step 1 Within Script Editor, place the CLID object in the workspace and set up its target
connections.
Note You must insert targets and connection branches from the CLID node
before you can define the node’s properties.
Step 2 Right-click to open the CLID Properties dialog box.

Step 3 Use the Case column and Region, Prefix, or Exact Match buttons to specify
calling line ID values and specify the connection each value applies to. (The
Script Editor automatically sorts the list of CLID values you add.)
Warning If you ever delete a connection associated with a case, the case information
you specified in the Properties dialog box is deleted, also.
Step 4 If you want to specify another value or expression to be used instead of the CLID,
click the Variable tab.
Step 5 Click the Use Expression radio button and enter an expression to be used instead
of the calling line ID. For each call, the expression you enter will be compared
against the list of values in the node.
Step 6 Optionally, modify the Comment tab.
Caller-Entered Digits (CED) Node

The Caller-Entered Digits (CED) node lets you examine the digits entered by the
caller in response to prompts to see if they match a specific string. Alternately,
you can specify that CEDs are not entered or not required.

78-11590-04 3-5
Figure 3-4 Caller-Entered Digits Node
There are two cases where a call might not have a CED value: the caller is not
prompted for digits (the CED value is a null string) or the caller was prompted but
did not make an entry (the CED value is a hyphen).
Warning If you ever delete a connection associated with a case, the case
information you specified in the Properties dialog box is also deleted.
How to add a CED node
Step 1 Within Script Editor, place the CED object in the workspace and set up its target
connections.
Note You must insert targets and connection branches from the CED node
before you can define the node’s properties.
Step 2 Right-click to open the CED Properties dialog box.

Step 3 Click the Add Digits button. An entry appears in the Case/CED list.
Step 4 Choose the Case (connection number) and do one of the following:
• Enter a CED string value for the connection. You can associate one or more
values with each connection. Valid characters are the digits 0 through 9, the
asterisk (*), and the number sign (#).
• Click the Add None button to add the value of None to a connection,
specifying that it matches only those cases where no digits are entered or
when no digits are required.

3-6 78-11590-04
Refining Call Type Schedule
Note Before clicking the No Digits button, choose an option to specify

whether the branch applies to either or both of these cases: None
applies to both cases, None Entered applies only if the caller was
prompted for digits, but did not enter any, None Required applies
only if the caller was not prompted for digits.


As the call qualifier nodes let you refine the call type definition, the Time and Day
of Week nodes let you refine the call type schedule within a script.
Time Node
The Time node allows you to branch to two or more connections within a script
based on the current time at the ICM Central Controller.
Figure 3-5 Time Node
In the example, script control flows to one of three branches depending on the
time of day.

78-11590-04 3-7
The Time node also provides the option of creating an “Otherwise” branch. Call
control passes to the Otherwise branch in situations where none of the specific
time ranges apply.
How to add a Time node
Step 1 Within Script Editor, place the Time object in the workspace and set up its target
connections.
Note You must insert targets and connection branches from the Time node
before you can define the Time node’s properties.
Step 2 Right-click to open the properties dialog box. The top part of the dialog box
displays a column for each output branch (initially assigning a label, A, B, C, etc.,
to each branch) and a column on the left listing the hours of the day.
Step 3 To add a time range, choose a value in the Connections field and click the Add
Time button. The Add Time dialog box appears.
Step 4 Use the Start time and End time scrolling lists to select a time range or ranges
(you can create multiple time ranges for each branch). Click OK. The Add time
dialog box closes and the range specified for the branch is shown in the Time
Ranges field and the Time graph.
Step 5 Optionally, rename an output branch column by selecting the column name in the
Connections field and click the Modify Name button. The label name becomes
highlighted and you can make changes.
Step 6 Optionally, designate one branch as the Otherwise branch: select a column name
in the Connections field and click the Make Otherwise button. The column is
renamed Other and assigned no time range.
Warning If you ever delete a connection associated with a case, the case
information you specified in the Properties dialog box is also deleted.


3-8 78-11590-04
Day of Week Node

The Day of Week node transfers control to one of several branches depending on
the current day of week (Sunday, Monday, etc.). You can define multiple output
connections from the Day of Week node and associate each with one or more days
of the week.
Figure 3-6 Day of Week Node
How to add a Day of Week node
Step 1 Within Script Editor, place the Day of Week object in the workspace and set up
its target connections.
Note You must insert targets and connection branches from the Day of
Week node before you can define the node’s properties.
Step 2 Right-click to open the properties dialog box. The top part of the dialog box
displays a column for each output branch (initially assigning a label, A, B, C, etc.,
to each branch) and a column on the left listing the days of the week.

78-11590-04 3-9
Changing Script Processing Paths
Step 3 To create a day grid assigning days of the week to output branches, left-click in a
spot in the grid to associate a day of week with a connection. A checkmark
appears in the grid.
Note You can associate each day of the week with exactly one connection.
However, you can associate each connection with one or more days of
the week.
Step 4 Optionally, rename an output branch column by selecting the column name in the
Connections field and clicking the Modify Name button. The label name becomes
highlighted and you can make changes.

ICM software includes three nodes that enable you to change the direction of
script processing:
• Go To Script node
• Switch node
• If node
Using the Go To Script Node to Change to Another Script

The Go To Script node directs call processing to another script without changing
the call type. When ICM software encounters a Go To Script node, it stops
executing the current script and starts the script indicated in the node.

3-10 78-11590-04
Figure 3-7 Go To Script Node
Note The Go To Script node has no output connection.
For example, you might have several scripts that check for exception conditions
and, if none are found, execute a standard subroutine. Instead of including that
subroutine as a branch from the failure output terminal of each of the exception
conditions, you could use a Go To Script node pointing to a separate script
containing the subroutine.
Note Within an administrative script, you can go to only another administrative

script. Within a routing script, you can go to only another routing script.
How to add a Go To Script node
Step 1 Within Script Editor, place the Go To Script object in the workspace and
right-click to open the properties dialog box.
Step 2 Optionally, use the drop-down list to specify a Business Entity.
Step 3 Use the drop-down list to choose the name of the script you want to execute.
How to open the script referenced by a Go To Script node
Right-click the Go To Script node and choose Open Script from the shortcut
menu. The referenced script appears in a separate window in Browse Mode.

78-11590-04 3-11
Using the Switch Node to Change Branches

The Switch node directs script execution to its active output connection. You can
define multiple output connections from the Switch node; one of them must be
specified as the active connection.
Figure 3-8 Switch Node
Note Only one connection can be active at any time. To change the active branch,
you must re-edit the script and create a new script version.
How to add a Switch node
Step 1 Within Script Editor, place the Switch object in the workspace and set up its target
connections.
Note You must insert targets and connection branches from the Time node
before defining the Switch node’s properties.
Step 2 Right-click to open the properties dialog box.

The Switch tab displays a row for each output branch, initially assigning a label
(A, B, C, etc.) to each branch.
Step 3 Optionally, to rename an output connection, click the Connection label and then
click the Modify Name button. The label name becomes highlighted and you can
make changes.

3-12 78-11590-04
Step 4 To make a connection active, click the Connection label and then click the Make
Active button. The Script Editor displays Active in the State field for the label.
Using the If Node for Conditional Routing

The If node directs script execution to one of two branches based on the result of
an evaluation.
Figure 3-9 If Node
When ICM software executes an If node, it first evaluates the condition specified
in the node Properties dialog box’s Define condition field. If ICM software
determines that the condition is true, control flows through the success output
terminal; if it determines the condition is false, control flows through the failure
output terminal.
How to add an If node
Step 1 Within Script Editor, place the If object in the workspace and open the Properties
dialog box.
Step 2 Specify the Boolean expression to be evaluated in the Define Condition field.
Note If you want, click the Formula Editor button to access the Formula
Editor. See Chapter 5, “Formulas” for information on how to use this
tool to create expressions.

78-11590-04 3-13
Querying an External Database

Step 5 Click OK to apply changes and to close the dialog box. (The Script Editor
evaluates the expression to ensure that it is valid.)

You can query a row of data from an external SQL Server database within an ICM
routing script. For example, if you have a database that contains information about
your customers, you might perform a lookup based on the Calling Line ID (that
is, the billing telephone number) for the call. Once you have retrieved the row of
data, you can reference the columns of that row within the script.
To carry out database lookups of this kind, you must perform the following tasks:
1. Create and populate the external database table.
2. Within the Configuration Manager, enter information about the table and the
columns you want to reference.
3. Within the Script Editor, add a DB Lookup node to a routing script.
4. Within the Script Editor, add nodes (such as an If node) referencing database
columns accessed by the DB Lookup node.
Creating the External Database

Create the external SQL Server database using whatever tools you want. However,
you must designate a single key column as the SQL primary key. This is the
column on which ICM software performs lookups.
After the database table is defined, add data to the table using whatever tools you
want.
You might want to maintain two copies of the database: one located with each side
of the ICM Central Controller. You can then configure the system so that the
active side of the Central Controller always accesses the database located with it.

3-14 78-11590-04
Entering External Database Table Information

Next, in the Configuration Manager, you must define the table and specific
columns within that table that you want to reference within routing scripts.
Note You need not configure columns that you do not plan to reference.
How to define the external database table
Step 1 Within the Configuration Manager, select Tools > Explorer Tools > Database
Lookup Explorer. The Database Lookup Explorer window appears.
Step 2 To enable Add Script Table, click Retrieve.
Step 3 Click Add Script Table. The Script Table property tab appears.
Step 4 In the Name field of the Script Table property tab, enter the database name.
Note The Name field is required. All other fields are optional. For
additional information refer to the online Help.
Step 5 Click Save to apply your changes. The ICM software database manager
automatically generates a unique ScriptTableID for each table you define.
How to define the external database table columns
Step 1 Within the Configuration Manager’s Database Lookup Explorer window, click
Add Column. The Database Lookup: Script Table Column property tab appears.
Step 2 In the Column Name field enter the name of the new column.
Note The Column Name field is required. All other fields are optional. For
additional information refer to the online Help.
Step 3 Repeat the process for each additional column to be added.

78-11590-04 3-15
Step 4 Click Save to apply your changes. The ICM software database manager
automatically generates a unique ScriptTableColumnID for each column you
define.
DB Lookup Node
Within Script Editor, you can use the DB Lookup node to query a specific row of
data from an external database. You can then reference columns from that row.
DB Lookup Node Processing

When ICM software executes a DB Lookup node, it does the following:
• It searches the external database table for a row with a key value that matches
the specified Lookup Value.
• If it finds the record, control passes through the success ( ) output terminal;
otherwise, control passes through the failure (X) terminal.
Figure 3-10 DB Lookup Node
Note Before you can successfully use DB Lookup in a script, information about the
table to be queried must be defined within the Configuration Manager, as
described earlier in this chapter.
After a DB Lookup has successfully retrieved a row from the database,

subsequent nodes in the script can execute references to columns from that row.

3-16 78-11590-04
Note Script nodes with expressions that refer to external database information may
appear in the “success” path extending from the DB Lookup node. In addition,
the script must be set up so that any node that references a database column
appears after a DB Lookup node is executed. Before DB Lookup retrieves the
row, all columns from that table are invalid variables.
Referencing Retrieved Data

To access retrieved data, use the following syntax in nodes that reference a
column:
Database.table-name.column-name
In this syntax:
• table-name is the enterprise name of the table as defined in the Configuration
Manager.
• column-name is the name of a column from that table that has also been
defined in the Configuration Manager.
For example, if the table Customers contains a column named Priority, you would
reference that column in an If expression as follows.
Figure 3-11 If Properties Dialog Box

78-11590-04 3-17
Using Application Gateways
You can also test whether a row has been successfully retrieved before you try to
access the data. In this case, the If node would contain the condition:
Database.table-name.Available > 0
If the return value is true (that, is the value is greater than 0), the database
information is available. If the return value is false (that is, 0), the database
information is not available.
How to enter a DB Lookup node
Step 1 Within Script Editor, place the DB Lookup object in the workspace and
right-click to open the properties dialog box.
Step 2 Enter values in the following fields:
• Table. (Drop-down list.) The enterprise name of the table you want to query.
• Lookup Value. A constant or expression to match the key value in the row
you want to retrieve. The value must be of the appropriate data type to match
the key field in the table. (To help you build an expression, you can click the
Edit Formula button to access the Formula Editor.)
For example, if the key for the table is a column containing customer telephone
numbers, you might enter Call.CallingLineID as the Lookup value.

An application gateway is an optional ICM feature that allows you to invoke an
external application from within a script (using a Gateway node). You can pass
data to the application and receive data in return, which you can then examine and
use for routing decisions.
Before you can use these nodes in a script, you must first configure the gateways.
The application gateway requires connection information to communicate with
the external application. You perform this task using the Configuration Manager.

3-18 78-11590-04
Configuring Application Gateways

You must configure an application gateway for each application you want to
access from within scripts. Configuration information includes data such as:
• The type of application the gateway will interact with: a non-ICM application
or an application on another ICM system
• The form of connection the gateway will use: duplex or simplex
• A fault tolerance strategy for the gateway, described below in Table 3-1
Table 3-1 Application Gateway Fault Tolerance Strategies
Fault Tolerance Strategy Description

Duplicate Request Each request is sent to both sides of the gateway.
Alternate Request Every other request is sent to a different side of the
gateway.
Hot Standby All requests are sent to only the A side of the
gateway unless it fails. Side B is used only if side A
is not available.
None The application gateway is not duplexed.
Once you specify the configuration information, you can define the connection
information for the gateway, such as the network address of the port through
which ICM software communicates with the application.
If your ICM Central Controller is duplexed, you can define separate connection
information for each side of the Central Controller. This allows each side to
communicate with a local copy of the external application.

78-11590-04 3-19
Note For a remote ICM, the address must be the same address specified for the ICRP
NIC on the targeted system. (You may use the hostname in place of the
address.) This address value must be followed by a colon, an instance or
customer number (denoting which ICM to access on the remote system),
another colon, and a letter indicating which side of the NAM system prefers
to use this connection. The preference letters are A (side A of the NAM prefers
this connection), B (side B of the NAM prefers this connection), N (neither
side of the NAM prefers this connection), or R (both sides of the NAM prefer
this connection). For example, the address might be 199.97.123.45:1:A.
How to configure an application gateway
Step 1 Within the Configuration Manager, select Tools > List Tools > Application
Gateway List. The Application Gateway List window appears.
Step 2 To enable Add, click Retrieve.
Step 3 Click Add. The Attributes property tab appears.
Step 4 Complete the Attributes property tab.
Note For additional information refer to the online Help.
Step 5 Click Save to create the application gateway.
Next, configure the connection information for the application gateway.
How to configure an application gateway connection and set the default connection parameters
Step 1 Within the Application Gateway List window, click Retrieve and select the
desired Application Gateway.
Step 2 Complete the Connection property tab(s).
Note For additional information refer to the online Help.

3-20 78-11590-04
Step 3 Click Save to apply your changes.
Using the Gateway Node

After you have configured an application gateway and its connection information,
you can use the Script Editor’s Gateway node to reference the external
application.
Figure 3-12 Gateway Node
The Gateway node allows you to pass data to the application and receive data in
return. You can examine the returned data and use it subsequently in your routing
decisions.
When ICM software encounters a Gateway node during script execution, it sends
a message through the application gateway. Script execution continues as follows:
• If the No Reply option was set on the Gateway node’s Properties Receive
tab—meaning that the external application does not return data to ICM
software—then execution continues immediately through the success
terminal of the Gateway node.
• If the No Reply option was not set on the Receive tab—meaning that the
external application does return data to ICM software—ICM software waits
for the application to return the data before continuing script execution. If the
application does not respond within the timeout threshold for the connection,
then control passes through the failure terminal of the Gateway node.
Otherwise, control passes through the success terminal.

78-11590-04 3-21
How to add a Gateway node
Step 1 Within Script Editor, place the Gateway object in the workspace and right-click
to open the properties dialog box.
Step 2 On the Send tab, specify the following:
• Application gateway. (Drop-down list.) An application gateway you defined
in the Configuration Manager.
• Subtype field. An optional string expression to pass to the application.
• Call variables. (Checkboxes.) Call variables to be sent to the application.
• Expanded call context variables. (Checkbox.) If the box is checked,
Expanded Call Context (ECC) variables are sent to the application.
Step 3 Click the Receive tab and specify the following:
• No Reply. (Checkbox.) Select the No Reply option if the external application
does not return any data to the script.
Note If you select this option, the system will not be able to retrieve any
information from the external application.
• Call variables. (Checkboxes.) Use the checkboxes to indicate which

variables the external application can modify.
• Expanded call context variables. (Checkbox.) If the box is checked, the
external application might return data in the Expanded Call Context (ECC)
variables.

3-22 78-11590-04

Step 6 Click OK to apply the changes and close the dialog box.

78-11590-04 3-23

3-24 78-11590-04

Segmentaion PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Segmentaion PDF

Uploaded by

Copyright:

Available Formats

C H A P T E R 3

This chapter discusses call segmentation in a script. It includes:

Cisco ICM Software Script Editor Guide

Refining Call Type Definition

Cisco ICM Software Script Editor Guide

Figure 3-1 Call Type Definition in Script

Dialed Number (DN) Node

Figure 3-2 Dialed Number Node

Cisco ICM Software Script Editor Guide

How to add a Dialed Number (DN) node

Calling Line ID (CLID) Node

Figure 3-3 Calling Line ID Node

Cisco ICM Software Script Editor Guide

How to add a CLID node

Step 2 Right-click to open the CLID Properties dialog box.

Caller-Entered Digits (CED) Node

Cisco ICM Software Script Editor Guide

Figure 3-4 Caller-Entered Digits Node

How to add a CED node

Step 2 Right-click to open the CED Properties dialog box.

Cisco ICM Software Script Editor Guide

Note Before clicking the No Digits button, choose an option to specify

Step 5 Optionally, modify the Comment tab.

Refining Call Type Schedule

Figure 3-5 Time Node

Cisco ICM Software Script Editor Guide

How to add a Time node

Step 7 Optionally, modify the Comment tab.

Cisco ICM Software Script Editor Guide

Step 9 Click OK to apply changes and to close the dialog box.

Day of Week Node

Figure 3-6 Day of Week Node

How to add a Day of Week node

Cisco ICM Software Script Editor Guide

Changing Script Processing Paths

Using the Go To Script Node to Change to Another Script

Cisco ICM Software Script Editor Guide

Figure 3-7 Go To Script Node

Note The Go To Script node has no output connection.

Note Within an administrative script, you can go to only another administrative

How to add a Go To Script node

How to open the script referenced by a Go To Script node

Cisco ICM Software Script Editor Guide

Using the Switch Node to Change Branches

Figure 3-8 Switch Node

How to add a Switch node

Step 2 Right-click to open the properties dialog box.

Cisco ICM Software Script Editor Guide

Using the If Node for Conditional Routing

Figure 3-9 If Node

How to add an If node

Cisco ICM Software Script Editor Guide

Step 3 Optionally, modify the Comment tab.

Querying an External Database

Creating the External Database

Cisco ICM Software Script Editor Guide

Entering External Database Table Information

How to define the external database table

How to define the external database table columns

Step 3 Repeat the process for each additional column to be added.

Cisco ICM Software Script Editor Guide

DB Lookup Node Processing

Figure 3-10 DB Lookup Node