ccxml elements - dialogterminate

CCXML 1.0 Development Guide

<dialogterminate> element

When any VXML dialog has completed, best practices dictate that it should be 'torn down', (or, more properly, 'destroyed'). This is accomplished by using the <dialogterminate> element. When this tag is encountered and executed, a 'dialog.exit' event is returned to the CCXML layer of the application.

Note that if a dialogterminate request cannot be executed if the launched dialog is not yet in a ready state to receive it and act upon it. If this happens, a 'error.dialog.wrongstate' event will be thrown.

Also be aware that when the CCXML application does a <dialogterminate>, the VXML dialog can return data to the CCXML application using the VoiceXML <exit namelist> element, (inherantly throwing a 'dialog.exit event').

usage

<dialogterminate dialogid="(ECMAScript Expression)" immediate="(true|false)">

attributes

dialogid	Data Type: (ECMAScript Expression)	Default: none - attribute is required
	The dialogid attribute specifies a character string identifying the dialog. This dialogid will have been generated by `<dialogstart>` and stored in the ECMAScript variable identified by the "dialogid" attribute.
immediate	Data Type: (true\|false)	Default: False
	Set to "true" or "false" to specify if the dialog is immediately terminated. Note that only a value of 'true' is supported at this time.

parents

none

children

none

code samples

none

additional links

W3C Specification

ANNOTATIONS: EXISTING POSTS

0 posts - click the button below to add a note to this page