Cisco Cisco Customer Voice Portal 8.0(1) User Guide

Insert Element Restrictions

The following restrictions apply to a VoiceXML insert element. An insert element conforming
to these restrictions will be assured full integration with the Unified CVP application. These
restrictions will be clarified later.

•

The insert element cannot define its own root document, a root document generated by VXML
Server must be used.

•

The variables to return to VXML Server, including the exit state, must conform to a strict
naming convention.

•

When using the 

 tag, Unified CVP-specified arguments must be returned along

with the custom variables.

• Use a VoiceXML insert element only in a top-level subdialog. You cannot use a VoiceXML
Insert element in a nested subdialog.

Insert Element Inputs

As with any element in the application, an insert element would need to be able to access
information about the call such as element and session data, call data (such as the ANI), and
even information found in the user management database if the application is configured to use
one. Normally, this information is available in the Java or XML API. Since an insert element
is written in VoiceXML, this information must be made available for the insert element to use
from within the VoiceXML.

Unified CVP achieves this by creating VoiceXML variables in the root document containing
all the desired information. The variable names conform to a naming convention so the Insert
element developer can refer to them appropriately. This is one reason why Unified CVP requires
the use of the VXML Server-generated root document.

In order to cut down on the number of variables appearing in the root document, the application
designer is given the option of choosing which input groups are passed to the insert element.
Additionally, the designer can individually choose which element and session data to pass. By
minimizing the inputs to only the data required by the insert element, the overhead involved in
using an Insert element is minimized.

Each input type is listed below:

•

Telephony – This information deals with telephony data. The inputs start with
audium_telephony_.

–

audium_telephony_ani – The phone number of the caller or NA if not sent.

–

audium_telephony_dnis – The DNIS or NA if not sent.

–

audium_telephony_iidigits – The IIDIGITS or NA if not sent.

User Guide for Cisco Unified CVP VXML Server and Cisco Unified Call Studio Release 8.0(1)