webwork/src/docs soap-attrib.xml,NONE,1.1 soap-invoke.xml,NONE,1.1 soapref.xml,NONE,1.1 vxml-attrib.xml,NONE,1.1 vxml-audio.xml,NONE,1.1 vxml-field.xml,NONE,1.1 vxml-filled.xml,NONE,1.1 vxml-grammar.xml,NONE,1.1 vxml-log.xml,NONE,1.1 vxml-prompt.xml,NONE,1.1 vxmlref.xml,NONE,1.1 community.xml,1.6,1.7 index.xml,1.17,1.18
[email protected] Mon, 20 May 2002 22:27:00 -0700
| Newsgroups | gmane.comp.java.webwork.cvs |
|---|---|
| Message-ID | <[email protected]> |
Update of /cvsroot/webwork/webwork/src/docs
In directory usw-pr-cvs1:/tmp/cvs-serv11834/docs
Modified Files:
community.xml index.xml
Added Files:
soap-attrib.xml soap-invoke.xml soapref.xml vxml-attrib.xml
vxml-audio.xml vxml-field.xml vxml-filled.xml vxml-grammar.xml
vxml-log.xml vxml-prompt.xml vxmlref.xml
Log Message:
-added support for VoiceXML JSP tags
-added support for SOAP JSP tags
-updated documentation
--- NEW FILE: soap-attrib.xml ---
<!--
**********************************************************************
soap attribute definitions
**********************************************************************
-->
<section id="soap-attrib">
<title>SOAP attribute definitions</title>
<sectioninfo>
<title></title>
</sectioninfo>
<sect2>
<title>attribute definitions</title>
<para>
This is an exhaustive list of attributes used by WW SOAP custom tags. All tags except
<literal>id</literal> are WW value expressions or for <literal>test</literal>
attribute a conditional expression which is by its very nature made up of
value expressions. Since they are value expressions, you have the ability
to access data in different scopes, objects, etc. For more information on
the expression language see <xref linkend="expr"/>.
</para>
<orderedlist>
<listitem id="soap-attrib-endpoint">
<literal>endpoint</literal> - This attribute specifies the endpoint URL for the web service.
<para></para>
</listitem>
<listitem id="soap-attrib-id">
<literal>id</literal> - This attribute specifies the id to assign the result (if any) of the invocation.
<para></para>
</listitem>
<listitem id="soap-attrib-namespace">
<literal>endpoint</literal> - This attribute specifies the namespace for the web service.
<para></para>
</listitem>
<listitem id="soap-attrib-operation">
<literal>endpoint</literal> - This attribute specifies the operation name for the web service.
<para></para>
</listitem>
</orderedlist>
</sect2>
</section>
--- NEW FILE: soap-invoke.xml ---
<!--
**********************************************************************
soap invoke
**********************************************************************
-->
<section id="soap-invoke">
<title>invoke</title>
<sectioninfo>
<title></title>
</sectioninfo>
<sect2>
<title>SOAP invoke tag</title>
<para>
A tag that invokes a SOAP-based Web Service, an optionally, returns
a set of data.
</para>
<table frame='all'><title>Attributes</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
<entry>attribute</entry>
<entry>required</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend='soap-attrib-id'>id</link></entry>
<entry>T</entry>
</row>
<row>
<entry><link linkend='soap-attrib-endpoint'>endpoint</link></entry>
<entry>T</entry>
</row>
<row>
<entry><link linkend='soap-attrib-namespace'>namespace</link></entry>
<entry>T</entry>
</row>
<row>
<entry><link linkend='soap-attrib-operation'>operation</link></entry>
<entry>T</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
Example:
</para>
<informalexample>In this example, a Web Service named <literal>echoString</literal> is invoked at the
<literal>http://localhost:8080/axis/services/echo</literal> and the value is returned and assigned
to the id <literal>value</literal>. The SOAP service takes one argument, <literal>Hello,World</literal>.
<programlisting>
<![CDATA[
<soap:invoke id="value"
endpoint="'http://localhost:8080/axis/services/echo'"
operation="'echoString'"
namespace="'http://soapinterop.org/'">
<webwork:param value="'Hello,World'"/>
</soap:invoke>
]]>
</programlisting>
</informalexample>
</sect2>
</section>
--- NEW FILE: soapref.xml ---
<section id="soaptag-ref">
<title>SOAP JSP Tags</title>
<sectioninfo>
<title></title>
<abstract>
<para>
This section provides an exhaustive reference to WW's custom SOAP JSP tag support.
Using WW's SOAP tags, developers can build dynamic applications that access web
services using SOAP.
</para>
</abstract>
<authorgroup>
<author>
<firstname>Jeff</firstname>
<surname>Haynie</surname>
</author>
<email>[email protected]</email>
</authorgroup>
</sectioninfo>
<sect2>
<title>SOAP Support</title>
<para>
The WW SOAP tags provide support for accessing web services using the SOAP protocol.
SOAP support is implemented using <ulink url="http://xml.apache.org/axis">Apache Axis</ulink>.
</para>
<para>
Basic web service invocation support is currently implemented.
More advanced support will be implemented in future releases.
</para>
</sect2>
<sect2>
<title>SOAP Setup</title>
<para>
To test the SOAP support in WW, please follow these steps:
<orderedlist>
<listitem id="soap-install-step1">
Download and Install Apache AXIS from <ulink url="http://xml.apache.org/axis">Apache</ulink>.
<para></para>
</listitem>
<listitem id="soap-install-step2">
Deploy the <literal>echo</literal> service <literal>deploy.wsdd</literal> (found in /samples/echo) using the AdminClient.
<para></para>
</listitem>
<listitem id="soap-install-step3">
Create a simple invocation using WW:
<para>
<programlisting>
<![CDATA[
<soap:invoke id="value"
endpoint="'http://localhost:8080/axis/services/echo'"
operation="'echoString'"
namespace="'http://soapinterop.org/'">
<webwork:param value="'Hello,World'"/>
</soap:invoke>
<webwork:property value="@value"/>
]]>
</programlisting>
</para>
</listitem>
</orderedlist>
</para>
</sect2>
&soap-invoke;
&soap-attrib;
</section>
--- NEW FILE: vxml-attrib.xml ---
<!--
**********************************************************************
vui attribute definitions
**********************************************************************
-->
<section id="vxml-attrib">
<title>VoiceXML attribute definitions</title>
<sectioninfo>
<title></title>
</sectioninfo>
<sect2>
<title>attribute definitions</title>
<para>
This is an exhaustive list of attributes used by WW VoiceXML custom tags. All tags except
<literal>id</literal> are WW value expressions or for <literal>test</literal>
attribute a conditional expression which is by its very nature made up of
value expressions. Since they are value expressions, you have the ability
to access data in different scopes, objects, etc. For more information on
the expression language see <xref linkend="expr"/>.
</para>
<orderedlist>
<listitem id="vxml-attrib-action">
<literal>action</literal> - This attribute specifies the action value of a component. When used in a
<literal>filled</literal> component, the filled when build the appropriate <literal>submit</literal>
to the value of the action URL.
<para></para>
</listitem>
<listitem id="vxml-attrib-actionaudio">
<literal>actionaudio</literal> - This attribute specifies the actionaudio value of a component. If the
actionaudio is specified, the component's fetchaudio attribute will be set.
<para></para>
</listitem>
<listitem id="vxml-attrib-bargein">
<literal>bargein</literal> - This attribute specifies the bargein value of a prompt. Valid values
are <literal>true</literal> or <literal>false</literal>.
<para></para>
</listitem>
<listitem id="vxml-attrib-cond">
<literal>cond</literal> - This attribute specifies the cond value of the component.
<para></para>
</listitem>
<listitem id="vxml-attrib-count">
<literal>count</literal> - This attribute specifies the count value of the component.
<para></para>
</listitem>
<listitem id="vxml-attrib-id">
<literal>id</literal> - This attribute assigns a name to an element.
This name must be unique in a document. This attribute is the standard <literal>id</literal>
supported by JSP <classname>TagSupport</classname> and is therefore always a
string. You do not need to indicate a string literal as you would for the rest
of WW attributes; i.e. - <literal>id="'age'"</literal>.
Instead you should use <literal>id="age"</literal>.
<para></para>
</listitem>
<listitem id="vxml-attrib-expr">
<literal>expr</literal> - This attribute specifies the ECMAScript expression to evaluate for the component.
<para></para>
</listitem>
<listitem id="vxml-attrib-fetchhint">
<literal>fetchhint</literal> - This attribute specifies the fetchhint value for the component. Valid values are
<literal>safe</literal> and <literal>prefetch</literal>.
<para></para>
</listitem>
<listitem id="vxml-attrib-fetchtimeout">
<literal>fetchtimeout</literal> - This attribute specifies the fetchtimeout value for the component.
<para></para>
</listitem>
<listitem id="vxml-attrib-label">
<literal>label</literal> - This attribute specifies the label value of the log component.
<para></para>
</listitem>
<listitem id="vxml-attrib-lang">
<literal>lang</literal> - This attribute specifies the xml:lang value of the component.
<para></para>
</listitem>
<listitem id="vxml-attrib-maxage">
<literal>maxage</literal> - This attribute specifies the maxage value of the component.
<para></para>
</listitem>
<listitem id="vxml-attrib-maxstale">
<literal>maxstale</literal> - This attribute specifies the maxstale value of the component.
<para></para>
</listitem>
<listitem id="vxml-attrib-modal">
<literal>modal</literal> - This attribute specifies the modal value of the field, relative to active
grammars outside the scope of the field.
<para></para>
</listitem>
<listitem id="vxml-attrib-mode">
<literal>mode</literal> - This attribute specifies the mode value of the grammar, which can be either
<literal>voice</literal> (default) or <literal>dtmf</literal>.
<para></para>
</listitem>
<listitem id="vxml-attrib-model">
<literal>model</literal> - This attribute specifies the model of the component.
<para></para>
</listitem>
<listitem id="vxml-attrib-name">
<literal>name</literal> - This attribute specifies the name of the control, which must be a valid
ECMAScript variable name in VoiceXML.
<para></para>
</listitem>
<listitem id="vxml-attrib-namelist">
<literal>namelist</literal> - This attribute specifies the namelist of the control, which must be a valid
space-separated list of ECMAScript variables to use when sending the request to the URI using HTTP parameters
(either GET parameters or POST data).
<para></para>
</listitem>
<listitem id="vxml-attrib-persona">
<literal>persona</literal> - This attribute specifies the persona of the audio. If specified, the name of the
persona will be appended to the prefix of the url to form the URL path. Example: <persona>/test.wav.
<para></para>
</listitem>
<listitem id="vxml-attrib-slot">
<literal>slot</literal> - This attribute specifies the slot value of the field. In form-level grammars,
the slot determines which <literal>field</literal> the grammar result should fill (can be more than one). This
is mainly used in mixed-initiative style dialogs.
<para></para>
</listitem>
<listitem id="vxml-attrib-src">
<literal>src</literal> - This attribute specifies the URL source of the component.
<para></para>
</listitem>
<listitem id="vxml-attrib-timeout">
<literal>timeout</literal> - This attribute specifies the prompt timeout value for a prompt.
<para></para>
</listitem>
<listitem id="vxml-attrib-tts">
<literal>tts</literal> - This attribute specifies the alternate text-to-speech to play if the audio src cannot be found.
<para></para>
</listitem>
<listitem id="vxml-attrib-templateheader">
<literal>templateheader</literal> - This attribute is the JSP the tag will use to render itself (header). Each
control has a default header template.
<para></para>
</listitem>
<listitem id="vxml-attrib-templatefooter">
<literal>templatefooter</literal> - This attribute is the JSP the tag will use to render itself (footer). Each
control has a default footer template.
<para></para>
</listitem>
<listitem id="vxml-attrib-theme">
<literal>theme</literal> - This attribute points to a directory of VUI tags.
This directory will be used to retrieve a UI tag's respective template.
It allows you to group together templates that together represent a "theme".
The default theme is <literal>standard</literal>. The directory <literal>vxml</literal>
will automatically be appended to the theme name.
<para></para>
</listitem>
<listitem id="vxml-attrib-type">
<literal>type</literal> - This attribute specifies the type value when specifying built-in grammars for a
field.
<para></para>
</listitem>
<listitem id="vxml-attrib-weight">
<literal>weight</literal> - This attribute specifies the weight value of the grammar. The default
weight if not specified is usually browser-dependent, but most likely <literal>1.0</literal>.
<para></para>
</listitem>
</orderedlist>
</sect2>
</section>
--- NEW FILE: vxml-audio.xml ---
<!--
**********************************************************************
vui audio
**********************************************************************
-->
<section id="vxml-audio">
<title>audio</title>
<sectioninfo>
<title></title>
</sectioninfo>
<sect2>
<title>VoiceXML audio tag</title>
<para>
An VoiceXML VUI control of type <literal>audio</literal>.
</para>
<table frame='all'><title>Attributes</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
<entry>attribute</entry>
<entry>required</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend='vxml-attrib-theme'>theme</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templateheader'>templateheader</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templatefooter'>templatefooter</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-src'>src</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-expr'>expr</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-tts'>tts</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-persona'>persona</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-fetchhint'>fetchhint</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-fetchtimeout'>fetchtimeout</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-maxage'>maxage</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-maxstale'>maxstale</link></entry>
<entry>F</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
Example:
</para>
<informalexample>In this example, a VoiceXML control of type <literal>audio</literal>
is generated.
<programlisting>
<![CDATA[
<?xml version="1.0"?>
<vxml version="2.0">
<form>
<vui:field name="'foo'">
<vui:prompt>
<vui:audio persona="'female'" src="'test.wav'" tts="'This is a test'"/>
</vui:prompt>
</vui:field>
</form>
</vxml>
]]>
</programlisting>
</informalexample>
</sect2>
</section>
--- NEW FILE: vxml-field.xml ---
<!--
**********************************************************************
vui field
**********************************************************************
-->
<section id="vxml-field">
<title>field</title>
<sectioninfo>
<title></title>
</sectioninfo>
<sect2>
<title>VoiceXML field tag</title>
<para>
An VoiceXML VUI control of type <literal>field</literal>.
</para>
<table frame='all'><title>Attributes</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
<entry>attribute</entry>
<entry>required</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend='vxml-attrib-theme'>theme</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templateheader'>templateheader</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templatefooter'>templatefooter</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-name'>name</link></entry>
<entry>T</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-modal'>modal</link></entry>
<entry>T</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-slot'>slot</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-cond'>cond</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-type'>type</link></entry>
<entry>F</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
Example:
</para>
<informalexample>In this example, a VoiceXML control of type <literal>field</literal>
is displayed. Its ECMAScript field name is <literal>foo</literal>.
<programlisting>
<![CDATA[
<?xml version="1.0"?>
<vxml version="2.0">
<form>
<vui:field name="'foo'">
<prompt>Hello, World</prompt>
</vui:field>
</form>
</vxml>
]]>
</programlisting>
</informalexample>
</sect2>
</section>
--- NEW FILE: vxml-filled.xml ---
<!--
**********************************************************************
vui filled
**********************************************************************
-->
<section id="vxml-filled">
<title>filled</title>
<sectioninfo>
<title></title>
</sectioninfo>
<sect2>
<title>VoiceXML filled tag</title>
<para>
An VoiceXML VUI control of type <literal>filled</literal>.
</para>
<table frame='all'><title>Attributes</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
<entry>attribute</entry>
<entry>required</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend='vxml-attrib-theme'>theme</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templateheader'>templateheader</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templatefooter'>templatefooter</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-action'>action</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-actionaudio'>actionaudio</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-mode'>mode</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-namelist'>namelist</link></entry>
<entry>F</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
Example:
</para>
<informalexample>In this example, a VoiceXML control of type <literal>filled</literal>
is generated.
<programlisting>
<![CDATA[
<?xml version="1.0"?>
<vxml version="2.0">
<form>
<vui:field name="'foo'">
<prompt>Hello, World</prompt>
<vui:filled action="'nextform.action'"/>
</vui:field>
</form>
</vxml>
]]>
</programlisting>
</informalexample>
</sect2>
</section>
--- NEW FILE: vxml-grammar.xml ---
<!--
**********************************************************************
vui grammar
**********************************************************************
-->
<section id="vxml-grammar">
<title>grammar</title>
<sectioninfo>
<title></title>
</sectioninfo>
<sect2>
<title>VoiceXML grammar tag</title>
<para>
An VoiceXML VUI control of type <literal>grammar</literal>.
</para>
<table frame='all'><title>Attributes</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
<entry>attribute</entry>
<entry>required</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend='vxml-attrib-theme'>theme</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templateheader'>templateheader</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templatefooter'>templatefooter</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-name'>name</link></entry>
<entry>T</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-model'>model</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-lang'>lang</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-weight'>weight</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-mode'>mode</link></entry>
<entry>F</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
Example:
</para>
<informalexample>In this example, a VoiceXML control of type <literal>grammar</literal>
is generated.
<programlisting>
<![CDATA[
<?xml version="1.0"?>
<vxml version="2.0">
<form>
<vui:field name="'foo'">
<vui:grammar mode="voice" model="@grammar"/>
</vui:field>
</form>
</vxml>
]]>
</programlisting>
</informalexample>
</sect2>
</section>
--- NEW FILE: vxml-log.xml ---
<!--
**********************************************************************
vui log
**********************************************************************
-->
<section id="vxml-field">
<title>log</title>
<sectioninfo>
<title></title>
</sectioninfo>
<sect2>
<title>VoiceXML log tag</title>
<para>
An VoiceXML VUI control of type <literal>log</literal>.
</para>
<table frame='all'><title>Attributes</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
<entry>attribute</entry>
<entry>required</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend='vxml-attrib-theme'>theme</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templateheader'>templateheader</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templatefooter'>templatefooter</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-label'>label</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-expr'>expr</link></entry>
<entry>F</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
Example:
</para>
<informalexample>In this example, a VoiceXML control of type <literal>log</literal>
is generated.
<programlisting>
<![CDATA[
<?xml version="1.0"?>
<vxml version="2.0">
<form>
<vui:field name="'foo'">
<vui:log>Entering Field foo</vui:log>
</vui:field>
</form>
</vxml>
]]>
</programlisting>
</informalexample>
</sect2>
</section>
--- NEW FILE: vxml-prompt.xml ---
<!--
**********************************************************************
vui prompt
**********************************************************************
-->
<section id="vxml-prompt">
<title>prompt</title>
<sectioninfo>
<title></title>
</sectioninfo>
<sect2>
<title>VoiceXML prompt tag</title>
<para>
An VoiceXML VUI control of type <literal>prompt</literal>.
</para>
<table frame='all'><title>Attributes</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
<entry>attribute</entry>
<entry>required</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend='vxml-attrib-theme'>theme</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templateheader'>templateheader</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-templatefooter'>templatefooter</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-bargein'>bargein</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-timeout'>timeout</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-cond'>cond</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-count'>count</link></entry>
<entry>F</entry>
</row>
<row>
<entry><link linkend='vxml-attrib-lang'>lang</link></entry>
<entry>F</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
Example:
</para>
<informalexample>In this example, a VoiceXML control of type <literal>prompt</literal>
is generated.
<programlisting>
<![CDATA[
<?xml version="1.0"?>
<vxml version="2.0">
<form>
<vui:field name="'foo'">
<vui:prompt bargein="'false'">
<vui:audio src="'welcome.wav'"/>
</vui:prompt>
</vui:field>
</form>
</vxml>
]]>
</programlisting>
</informalexample>
</sect2>
</section>
--- NEW FILE: vxmlref.xml ---
<section id="vxmltag-vui">
<title>VoiceXML JSP Tags</title>
<sectioninfo>
<title></title>
<abstract>
<para>
This section provides an exhaustive reference to WW's custom VoiceXML JSP tag support.
Using WW's (Voice User Interface) VUI tags, developers can build dynamic speech-based applications.
</para>
</abstract>
<authorgroup>
<author>
<firstname>Jeff</firstname>
<surname>Haynie</surname>
</author>
<email>[email protected]</email>
</authorgroup>
</sectioninfo>
<sect2>
<title>VoiceXML Support</title>
<para>
WW VoiceXML tags provide the ability for developers to build dynamic voice user interfaces (VUI).
<ulink url="http://www.voicexml.org">VoiceXML</ulink> is a W3C
<ulink url="http://www.w3.org/Voice">specification</ulink>
for building speech-based applications.
</para>
<para>
WW VoiceXML tags also can be used to generate VoiceXML for a given Voice Browser based on the
browser's <literal>User-Agent</literal> HTTP header value. This allows developers to build
the appropriate VoiceXML template that creates the appropriate tags and attributes based on a
specific vendor and/or version of a Voice Browser. See the file named <literal>vxml.properties</literal>
in <literal>/WEB-INF/classes/vxml.properties</literal> for more information on customizing WW to
work with different browsers.
</para>
<para>
WW VoiceXML tags have been developed and tested with the VoiceXML 2.0 specification using the
<ulink url="http://www.vocalocity.net">Vocalocity</ulink> Voice Platform, VocalOS.
</para>
</sect2>
&vxml-audio;
&vxml-field;
&vxml-filled;
&vxml-grammar;
&vxml-log;
&vxml-prompt;
&vxml-attrib;
</section>
Index: community.xml
===================================================================
RCS file: /cvsroot/webwork/webwork/src/docs/community.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- community.xml 10 Apr 2002 03:09:09 -0000 1.6
+++ community.xml 21 May 2002 05:26:58 -0000 1.7
@@ -47,7 +47,33 @@
<section>
<title>The team</title>
<para>
- TODO
+ <itemizedlist>
+ <listitem>Rickard Oberg</listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>Matt Baldree</listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>Jay Bose</listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>Hristo Stoyanov</listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>Jason Carreira</listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>Jeff Haynie</listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>Kjetil H.Paulsen</listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>Philipp Meier</listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>Low Heng Sin</listitem>
+ </itemizedlist>
</para>
</section>
<section>
Index: index.xml
===================================================================
RCS file: /cvsroot/webwork/webwork/src/docs/index.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -d -r1.17 -r1.18
--- index.xml 26 Apr 2002 23:47:13 -0000 1.17
+++ index.xml 21 May 2002 05:26:58 -0000 1.18
@@ -75,6 +75,19 @@
<!ENTITY expr-prec SYSTEM "expr-prec.xml">
<!ENTITY exprref SYSTEM "exprref.xml">
+ <!ENTITY vxmlref SYSTEM "vxmlref.xml">
+ <!ENTITY vxml-attrib SYSTEM "vxml-attrib.xml">
+ <!ENTITY vxml-audio SYSTEM "vxml-audio.xml">
+ <!ENTITY vxml-field SYSTEM "vxml-field.xml">
+ <!ENTITY vxml-filled SYSTEM "vxml-filled.xml">
+ <!ENTITY vxml-grammar SYSTEM "vxml-grammar.xml">
+ <!ENTITY vxml-log SYSTEM "vxml-log.xml">
+ <!ENTITY vxml-prompt SYSTEM "vxml-prompt.xml">
+
+ <!ENTITY soapref SYSTEM "soapref.xml">
+ <!ENTITY soap-invoke SYSTEM "soap-invoke.xml">
+ <!ENTITY soap-attrib SYSTEM "soap-attrib.xml">
+
<!ENTITY config SYSTEM "configuration.xml">
]><book>
<title>WebWork documentation</title><bookinfo>
@@ -120,6 +133,12 @@
<authorinitials>mb</authorinitials>
<revremark>Modified FAQ</revremark>
</revision>
+ <revision>
+ <revnumber>1.2</revnumber>
+ <date>2002-05-20</date>
+ <authorinitials>jgh</authorinitials>
+ <revremark>Added VoiceXML and SOAP tag references</revremark>
+ </revision>
</revhistory>
</bookinfo><chapter id="fundamentals">
<title>WebWork fundamentals</title>
@@ -175,6 +194,26 @@
a view technology, see <xref linkend="jsp"/>.
</para>
&jspref;
+</appendix>
+
+<appendix id="vxmlref">
+ <title>Custom VoiceXML JSP tag reference</title>
+ <para>
+ A quick reference for WebWork's (WW) JSP
+ tag library for generating VoiceXML. For more complete details concerning JSP as
+ a view technology, see <xref linkend="jsp"/>.
+ </para>
+ &vxmlref;
+</appendix>
+
+<appendix id="soapref">
+ <title>Custom SOAP JSP tag reference</title>
+ <para>
+ A quick reference for WebWork's (WW) JSP SOAP
+ tag library. For more complete details concerning JSP as
+ a view technology, see <xref linkend="jsp"/>.
+ </para>
+ &soapref;
</appendix>
<appendix id="exprref">
_______________________________________________________________
Don't miss the 2002 Sprint PCS Application Developer's Conference
August 25-28 in Las Vegas -- http://devcon.sprintpcs.com/adp/index.cfm