Cisco Cisco Customer Voice Portal 8.0(1) Entwickleranleitung

C

HAPTER 

6:

 

D

YNAMIC 

E

LEMENT 

C

ONFIGURATIONS

 

 

C

ISCO 

CVP V

OICE

XML 3.1

 

 

The tags in this XML document are: 

• 

– The root tag. The 

class

 attribute refers to the Java class defining the 

configurable voice element whose configuration is being dynamically produced. Refer to the 
Element Specifications document for the full Java class names of all CVP VoiceXML 
elements. The 

serial 

attribute is used by CVP VoiceXML Studio and can be safely ignored 

here. 

• 

– This tag reports to CVP VoiceXML Server that an error occurred while executing the 

dynamic configuration. The Server will then throw an exception whose message is contained 
in the 

<error>

 tag. This allows the XML API to throw exceptions just as the Java API does. 

• 

– This tag holds an element setting, the name appearing in the 

name

 attribute and the 

value of the setting contained within the 

<setting>

 tag. It is repeated for each setting 

included in the base configuration. No 

<setting>

 tags appear if the base configuration 

contains no settings or the element itself defines no settings. 

• 

– This tag holds information on substitution. Substitution is typically used in static 

configurations and since static and dynamic configuration XML documents share the same 
DTDs, it appears here. Substitution would not normally be used with dynamic 
configurations. The substitution tag contents are fully described in the section entitled 
“Substitution XML format” at the end of this chapter. 

• 

– This tag holds a VoiceXML property, the name appearing in the 

name

 

attribute and the value of the property contained within the 

<vxml_property>

 tag. It is 

repeated for each VoiceXML property referred to in the base configuration. 

• 

– This tag holds all the audio items for a single audio group. Attributes to 

<audio_group>

 set its name, bargein preference and count (for those audio groups that can 

have counts greater than 1). Each audio item is represented as a single 

<audio>

 or 

<say_it_smart>

 tag.  

o 

The 

<audio>

 tag defines a name for the audio item, the source of the audio file (optional 

if no audio file is being referenced), whether to use the default audio path (the 

use_default_path

 attribute may be true or false), and encapsulates the TTS backup 

message.  

o 

The 

<say_it_smart>

 tag’s attributes define the name of the audio item, the output 

format to represent the data, and Java class name of the Say It Smart plugin. Its contents 
encapsulate a 

<value>

 tag representing either a static value or a value from a variable. 

The 

format

 attribute of 

<value>

 defines the input format of the data. The 

<variable>

 

tag contains tags for obtaining the data from element data, session data or call data. The 

var_name

 attribute can contain the following values: ani, dnis, iidigits, uui, start_date, 

start_time, and application_name. Note that one can avoid using the 

<variable>

 tag by 

referring to a substitution string in the contents of the 

<value>

 tag. This also allows for 

the substitution of content in addition to element, session, and call data. The 

<variable>

 

tag remains for backwards compatibility and for those not willing to use substitution. 

 

 

Copyright 2001 - 2005 Audium Corporation.  All Rights Reserved. 10/05

 

38