Creating Expanded Call Variables

To create an expanded call variable:
  1. In Resource Manager, in the Folder Tree panel, select the folder where you want to create the expanded call variable.

  2. In the Folder Tree panel, click Resource, and then click Expanded Call Variable.

  3. Complete the remaining fields as described in the Expanded Call Variable Fields section. Active from and to dates can be set in the Advanced tab.

  4. Click Save.

Expanded Call Variable Fields

This table shows the tabs and fields available for expanded call variables.

 

Field

Description

Entry

Default

Required

Details Tab

Name

A unique name for the call variable.

Unique. Up to 27 characters, letters, numbers, periods, and underscore characters only. Must begin with letter or number. Will be automatically prefixed with ‘user.’ by the system.

Null

Yes

Description

A description of the call variable.

Up to 255 characters.

Null

No

Path

Only shown when resource is first created. The location in the folder tree where the resource is to be created.

Click on the drop-down arrow to show the folder tree, then select the required location.

Current location in folder tree.

Yes

Maximum Length

The maximum length of the value of the call variable, in bytes.

A whole number between 1 and 210.

Null

Yes

Provided by Cisco

Whether the call variable provided by Cisco. This is normally determined by the system.

Check box

Cleared

No

Persistent

Whether the variable is written to the historical database with the TCD/RCD record.

Check box

Cleared

No

Enabled

Whether the call variable is currently enabled.

Check box

Cleared

No

ECC Array

Whether the variable is an array.

Check box

Cleared

No

Maximum Array Size

The maximum number of elements in the array represented by the call variable.

Up to 255

Null

If ECC Array checked

Note: The total amount of space used by all expanded call variables on an instance must not exceed 2000 bytes. Each scalar (non-array) variable uses 5 + Maximum Length bytes. Each array variable uses 5 + (Maximum Length + 1) x Maximum Array Size bytes.The number of bytes used by a variable may be more than the number of characters or digits in the variable value. For example, a scalar variable may contain 10 characters, but occupy 15 bytes.

Advanced Tab

Active From Date

The date from which this variable will be active within the system.

Select date from calendar.

Current Date

Yes

Active To Date

The date after which this variable will be deleted from the system.

Either leave Forever checked, or uncheck Forever and select date from calendar.

Forever

No

Custom Data Tab

Key

The key for this custom data item.

Unique. Up to 50 characters, alphanumeric, period, and underscore characters only. Must begin with alphanumeric.

If this resource type has default keys defined in a custom data template, there will be a an initial entry for each default key.

Either an entry for each default key, or null if no default keys.

No

Value

The value to associate with this key.

Up to 500 characters.

To add a new custom data key-value pair, complete both fields, and click Add. You can have a maximum of ten custom data key-value pairs.

To edit an existing key-value pair, rest the mouse briefly on the entry, select the edit icon ( ) and make your changes. Then select the tick to confirm the change, or the cross to undo the change.

To delete an existing key-value pair, rest the mouse briefly on the entry, select the delete icon ( ), then click OK to confirm the deletion.

Note: For predefined default keys you cannot delete the entry or edit the key field. You can only edit the value field.

Null

No, for predefined default keys. Yes if new key being defined.

Related Information