Cisco Cisco Customer Voice Portal 8.0(1) Developer's Guide

C

HAPTER 

2:

 

C

ISCO 

U

NIFIED 

CVP

 

API

 

I

NTRODUCTION

V

OICE

XML

 

P

ROGRAMMING 

G

UIDE 

 

 

 

FOR 

C

ISCO 

U

NIFIED 

C

USTOMER 

V

OICE 

P

ORTAL 

R

ELEASE 

4.0(1) 

 

 

 

5

 

Unified CVP VoiceXML Studio provides a location to place components that are to be shared 
across all applications: 

VoiceXML 

Studio/eclipse/plugins/com.audiumcorp.studio.library.common_5.1.0

. Individual 

classes are placed in the 

classes

 subdirectory and JAR file archives are placed in the 

lib

 

subdirectory. Note that the only classes that need to be placed here are custom configurable 
elements and Say It Smart plugins since all other components have no Unified CVP VoiceXML 
Studio interface and hence require deployment only on the VoiceXML Server. Once deployed in 
this folder, custom configurable elements will appear in the element pane directly under the 
“Elements” folder alongside with Unified CVP-provided elements. 

For component classes that apply to a specific application only, a developer uses the 

deploy/java

 directory found in that application’s project folder. Within VoiceXML Studio, 

compiled classes and/or JAR files can be dragged from outside VoiceXML Studio to the 
appropriate subdirectory in the 

deploy/java

 folder. An alternative method that does not require 

VoiceXML Studio to be running would be to copy the files into the appropriate subdirectory of 
the 

deploy/java

 folder using the file system. The application project folder can be found in 

VoiceXML Studio/eclipse/workspace

 (unless the developer set the workspace to be a custom 

directory) and the 

deploy/java

 folder within the application will appear here exactly as it 

appears in the VoiceXML Studio application project window. This can also be done while 
VoiceXML Studio is running, though to view the copied files in VoiceXML Studio, the 

deploy

 

folder should be selected and the Refresh option chosen from the contextual menu.  

Custom configurable elements placed in the 

deploy/java

 directory will appear in Unified CVP 

VoiceXML Studio’s element pane under the folder named “Local Elements”. The call flow 
editor for that application must be closed and reopened in order for newly copied local elements 
to appear in the element pane. 

When the application is deployed from within VoiceXML Studio, the VoiceXML Server folder 
created for that application will contain a folder named 

java

 whose contents is identical to the 

deploy/java

 folder in the VoiceXML Studio project. 

When an application is deployed through Unified CVP VoiceXML Studio, a folder is created 
that encapsulates all the information for that application, including all Java code the developer 
placed in the VoiceXML Studio project as per the instructions given in the previous section. If 
the application is to change in any way, from changes to the call flow, to the addition or 
subtraction of required Java files, those changes must be done through VoiceXML Studio and 
then redeployed to the VoiceXML Server. 

One deployment requirement that must be performed by the developer is to ensure that the Java 
components and utility libraries stored in the 

VoiceXML 

Studio/eclipse/plugins/com.audiumcorp.studio.library.common_5.0.0

 folder are also 

placed in the VoiceXML Server 

common

 folder. When an application is deployed from 

VoiceXML Studio, only that application’s files are created, any common code is not included.