Cisco Cisco Customer Voice Portal 8.0(1) Developer's Guide
C
HAPTER
9:
C
ONFIGURABLE
E
LEMENTS
C
ISCO
CVP V
OICE
XML 3.1
Programmer
Guide
Common Methods
The methods listed below are defined in
ElementBase
and are common to all configurable
elements no matter what type. All custom CVP VoiceXML classes used by these methods are
defined in the
defined in the
com.audium.server.voiceElement
package. Refer to the Javadocs for more in
depth explanations of these methods and the classes they utilize.
String getElementName()
This returns the display name for the element. This is the name displayed in the Element Pane of
CVP VoiceXML Studio. There are no restricted characters for the display name, though best
practices recommend a short name that avoids spaces and punctuation.
CVP VoiceXML Studio. There are no restricted characters for the display name, though best
practices recommend a short name that avoids spaces and punctuation.
String getDescription()
This returns the description of the element. Studio displays this information in a tooltip when the
cursor is placed above the element’s icon in the Element Pane. There is no restriction on the size
or contents of the description.
cursor is placed above the element’s icon in the Element Pane. There is no restriction on the size
or contents of the description.
String getDisplayFolderName()
This returns the name of the folder in Studio Element Pane in which the element resides. If
null
is returned, the element appears directly under the Elements folder (currently, only the Audio
voice element appears directly under the Elements folder). To support a hierarchy of folders, the
folder name can include a full path and the folder tree will automatically be generated by Studio
(i.e. “
voice element appears directly under the Elements folder). To support a hierarchy of folders, the
folder name can include a full path and the folder tree will automatically be generated by Studio
(i.e. “
MyElements/Financial/Banking/
” would put the element icon inside three levels of
folders). Best practices recommend short folder names that avoid spaces and punctuation.
ExitState[] getExitStates()
This method defines the exit states this element can return. It is necessary in order for Studio to
properly render the exit state dropdown menu when the element is right-clicked. The method
returns an array of
properly render the exit state dropdown menu when the element is right-clicked. The method
returns an array of
ExitState
classes. The
ExitState
class encapsulates the real and display
name for an exit state. The display name is used only by Studio and the real name is used
everywhere else (within code or XML decisions). Note that for configurable action elements, this
method need not be implemented as all action elements automatically have a single exit state
named “done”.
everywhere else (within code or XML decisions). Note that for configurable action elements, this
method need not be implemented as all action elements automatically have a single exit state
named “done”.
ElementData[] getElementData()
This method describes the element data generated by this element. This method returns an array
of
of
ElementData
objects or can be
null
if the element does not create any element data. The
ElementData
object encapsulates the variable’s name and its description. The description exits
for future compatibility when Studio obtains the ability to display a tooltip for element data. Note
that element data does not have a display name.
that element data does not have a display name.
Copyright 2001 - 2005 Audium Corporation. All Rights Reserved. 10/05
50