On Disconnect

Nodes and Palette Options > Detailed Palette Option Descriptions > On Disconnect

	On Disconnect

Type

Event handler

Available from

AppRoot node (see Setting Global Application Properties: AppRoot Node)

Announce Node

Prompt and Collect Node

Blind Transfer Node

Bridged Transfer Node

Record Node

Menu Node

Form Node

Purpose

When a caller hangs up or otherwise gets disconnected from the system before the application is done executing, the system throws an On Disconnect event. The On Disconnect event handler makes it possible to specify how the system responds when these On Disconnect events are thrown.

Behavior

Within the scope defined for it, the On Disconnect event handler waits for an On Disconnect event to be thrown. When such an event is thrown, the On Disconnect event handler responds according to the options you use with it. See the next section, "Properties."

The On Disconnect event handler responds to an On Disconnect event anywhere within the scope of the handler. For example, if you place the On Disconnect event handler in the AppRoot node, it acts as a global event handler for On Disconnect events. It can catch On Disconnect events no matter where in the application the events are thrown. If you place the On Disconnect event handler in another node, however, it can catch an On Disconnect event only if it is thrown while in that node. If you place the On Disconnect event handler underneath a node item, it can catch the On Disconnect event only if it is thrown within that node item.

An On Disconnect event handler at the node item level overrides an On Disconnect event handler at the node level. Likewise, an On Disconnect event handler at the node level overrides an On Disconnect event handler at the AppRoot, or global, level.

Note:

This event handler is one of the default event handlers defined by the W3C VoiceXML 2.0 Recommendation and is identified as a connect.diconnect event handler.

The On Disconnect event handler does not allow any child items to be added to it.

Properties

Next - Directs the application to the designated node.

Submit - (True/False). When true, the application variables are submitted to the application server. If On Disconnect is added on the AppRoot node, then the Submit property is not available.

By throwing an event within an event handler, you can transfer control to a different part of the application, for example, to the AppRoot node. For more information about throwing events and handling events, see Throw or Working with Event Types.