Developer's Guide

CHAPTER 7: STANDARD ACTION ELEMENTS VOICEXML PROGRAMMING GUIDE

FOR CISCO UNIFIED CUSTOMER VOICE PORTAL RELEASE 4.0(1)

new_data – This tag holds the element and session data this standard action element is to

create. Any number of <set_element> and <set_session> tags can appear, one for each

element and session data variable to be created. The log attribute of <set_element> sets

whether the value of the variable is stored in the activity log. The optional

type attribute is

used to specify the data type of the variable and can be string, int, float, or boolean. The

create attribute found in both tags determines when the variable is created, before the

element is entered (before_enter), or after the element exits (after_exit).

set_uid – This tag is used to associate the call with a UID in the user management system.

The content of the tag should be the integer UID.

set_flag – This tag is used to make the action element act like a flag when visited. If it

appears, a flag with the same name as the action element will be considered triggered and

that fact will be noted in the activity log.

log – This tag is used to trigger logger events when this standard action element is executed.

Any number of <custom> tags can appear, denoting the triggering of a custom event. The

name attribute holds the name of the data, and the <custom> tag encapsulates the value. Any

number of <warning> tags can appear, denoting the triggering of a warning event. The

<warning> tag encapsulates the warning message.

set_default_path – This tag is used to change the default audio path from this point onwards

for this call.

set_maintainer – This tag is used to change the maintainer e-mail address from this point

onwards for this call.

set_timeout – This tag allows the timeout length set for this session to be changed. The

contents of the tab must be an integer representing the number of minutes in the timeout.

set_main_doc_content – This tag allows the encoding and language settings for the

application to be changed from this point onwards for this call. The <language> tag content

is formatted according to the specification for using languages in VoiceXML (e.g. “en-US”).

The

<encoding> tag content is formatted according to the specification for encoding XML

pages (e.g. “UTF-8”).

invalidate_session – This tag, if included in the XML, will prompt Unified CVP VoiceXML

Server to invalidate the call session it retains in memory, call the end of call class or URI (if

defined), and free up the VoiceXML Server port utilized by the call. The session is

invalidated only after the execution method of the standard action element is completed. This

tag is rarely used and would be needed in a few circumstances where some external process

takes the call away from the VoiceXML Server such as when using a CTI system to transfer

the call to an agent.