Cisco Cisco Customer Voice Portal 8.0(1) 개발자 가이드

C

HAPTER 

6:

 

D

YNAMIC 

E

LEMENT 

C

ONFIGURATIONS

 

 

V

OICE

XML

 

P

ROGRAMMING 

G

UIDE 

 

 

 

FOR 

C

ISCO 

U

NIFIED 

C

USTOMER 

V

OICE 

P

ORTAL 

R

ELEASE 

4.0(1) 

 

 

 

30

 

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 
VoiceXML Element Specifications for Cisco Unified Customer Voice Portal document for 
the full Java class names of all Unified CVP elements. The 

serial 

attribute is used by 

Unified CVP VoiceXML Studio and can be safely ignored here. 

   

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

executing the dynamic configuration. The VoiceXML 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, count (for those audio groups that can have 

counts greater than 1), and the language that it encapsulates. 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.