GTD Parameters and Fields Mapped to VoiceXML Variables

The following table describes GTD parameters and fields that are supported in Cisco VVB.

Note

A GTD parameter can be sent or received in any GTD message.

GTD Parameter and Field

GTD Parameter.Field

CGN.noa

CGN.npi

CGN.cni

CGN.pi

CGN.si

CGN.#

UUS.pd

UUS.dat

DIS.info

To create, modify, and read GTDs, the following Cisco objects are used:

  • com.cisco.objclass.gtd

    This is a Cisco-specific JavaScript object class that is used to create new GTD messages. To create an object of a specific class (instantiate) for creating a new GTD message, use:

    X= new com.cisco.objclass.gtd()

    Later, the GTD message can be represented in a format similar to:

    X.message_type = "'IAM'"
    Note

    IAM is used only as an example

  • com.cisco.signal.gtdlist

    This is a Cisco-specific session variable that represents an array of GTD objects (each object representing a GTD message) for signaling events arriving on the incoming leg. The elements of this array can be accessed in read-only mode. The VoiceXML script accesses the GTD parameters and their fields from this session variable, which is indexed by the signaling event as shown in the following format:

    com.cisco.signal.gtdlist["setup_indication"] where

    The elements of this array are read-only.

    The VoiceXML/ECMA script can access the GTD parameters and their fields from com.cisco.signal.gtdlist indexed by the signaling event as in:

    X = com.cisco.signal.gtdlist["setup_indication"] where X is read-only.

    dat1 = X.UUS[0].dat for the dat field in the first instance of the UUS parameter.

    Another Object can be created from com.cisco.signal.gtdlist using the new operation in com.cisco.objclass.gtd as in:

    Y = new com.cisco.objclass.gtd(com.cisco.signal.gtdlist["setup_indication"])

    In this case, the new object Y contains a copy of the GTD message that arrived with the Setup Ind event and is a read-write object. Y can now be used for modifying GTD parameters.

  • <transfer-name>$.com.cisco.signal.gtdlist

    This is a Cisco-specific shadow variable that is used by the VoiceXML script to access GTD parameters on the outgoing leg after the <transfer> is complete. The shadow variable consists of the transfer name and "$" prepended to com.cisco.signal.gtdlist.

    In <transfer name= "gtd_xfer"..../>, gtd_xfer$.com.signal.gtdlist is an array of GTD objects for the outgoing leg indexed by signaling event names mentioned in gtd_xfer$.com.cisco.signal.gtdlist["<event-name>"]