Expanded Call Context Variables
Expanded Call Context (ECC) variables are variables that you define and enable in the Configuration Manager to store values for a call. You can specify the variable name and data type. The name must begin with the string "user." ECC variables are in addition to the variables the system software defines for each call (PeripheralVariable1 through PeripheralVariable10, CallerEnteredDigits, CallingLineID, and so on).
An ECC variable name can be up to 33 bytes long (1–32 usable characters). Use the following naming convention when creating an ECC variable:
user.<CompanyName>.<VariableDescription>
In this syntax:
-
<CompanyName> is the name of your company.
-
<VariableDescription> is a descriptive tag for the variable.
For example:
user.Cisco.AcctNum
Using this naming convention prevents naming conflicts with any third-party applications that interface with the system software.
![]() Note |
For a large corporation, you can break <VariableDescription> down to include the Business Unit, Division, or other organizational entities. |
ECC variables follow these size rules:
-
An ECC variable can be either a scalar variable or an array element, each with a maximum length of 210 bytes.
Note
Array types are not supported for an agent request.
-
The maximum number of elements in an array is 255.
-
The maximum buffer size for each scalar variable = 5 + the maximum variable length. The 5 bytes includes 4 bytes to tag the variable and 1 byte for the null terminator.
-
The maximum buffer size for each array = 5 + (1 + the maximum length of an array element) * (the maximum elements in the array). There is a null terminator for each element, and a null terminator for the array as a whole.
-
Since the internal buffer which stores the variables is 2000 bytes, the total sum of all the maximum buffer sizes for each variable and each array cannot exceed 2000.
For example, if you intended to use the following:
-
A scalar ECC variable with a maximum length of 100 bytes
-
A scalar ECC variable with a maximum length of 80 bytes
-
An ECC array with a maximum of 9 elements with each element having a maximum length of 200 bytes
Totaled the buffer size is: (5+100) + (5+80) + (5 + (1+200)*9) = 2004. Because this size is too large, you must change the length of one of the scalar ECC variables or the length of the array ECC variables.
-
ECC Variables for Blended Collaboration or Voice MRDs with Collaboration
ECC variables must be configured in Configuration Manager's Expanded Call Variable List tool (for each integrated application) to route requests using the voice Media Routing Domain.
For Cisco Blended Collaboration or Voice MRDs with Collaboration, the ECC variables are:
-
user.cisco.cmb
-
user.cisco.cmb.callclass
-
user.ece.activity.id
-
user.ece.customer.name
![]() Important |
While their default size is 40 characters, use the Expanded Call Variable List tool in the Configuration Manager to limit the user.cisco.cmb variable to 8 bytes and the user.cisco.cmb.callclass variable to 10 bytes to prevent ECC space limitation issues. |