<bevocal:disconnect>
Extension. Disconnects an outbound call or the inbound call.
Syntax
<bevocal:disconnect
call="js_expression"
/>
Description
To use this tag, the containing <vxml> tag must declare the XML namespace bevocal by including the following attribute:
xmlns:bevocal="http://www.bevocal.com/"
This extended version of <disconnect> can disconnect either an outbound call initiated by a <bevocal:dial> tag, or the user's inbound call that started the current session:
| • | If a call attribute is included, it specifies the outbound call to be disconnected. The inbound call remains connected, allowing the user and the application to continue the session. |
| • | If no call attribute is included, this tag is equivalent to <disconnect>; it performs the following steps: |
| |
| • | Disconnects the inbound call. | | • | If an outbound call is active or on hold, disconnects that call also. | | • | Throws a hang up event (connection.disconnect.hangup in VoiceXML 2.0; telephone.disconnect.hangup in VoiceXML 1.0). If an event handler catches the event, it can perform one last <submit> to notify the server that the call has ended. Because the call is no longer connected, any VoiceXML document returned from the server is ignored. | |
| | The interpreter exits following execution of any event handler (or immediately if no handler catches the hang-up event). |
| • | If the call is no longer active, <bevocal:disconnect> does nothing. |
Note: This and other call-control tags constitute a BeVocal VoiceXML extension. Committees are currently working to standardize call-control features for VoiceXML, and their current approach is different from the BeVocal VoiceXML implementation. Because the approval of any call-control standards will be quite some time in coming, however, BeVocal VoiceXML contains this extension to allow developers to start taking advantage of call-control features. BeVocal will continue to monitor the development within these committees. If the features in the BeVocal VoiceXML extension become a part of VoiceXML or a separate call-control standard, BeVocal VoiceXML will implement that standard. We will then deprecate the current extension and provide developers with information on how to convert their applications to the new standard.
| Attribute |
Description |
call
|
JavaScript expression whose value is a JavaScript object that was initialized by <bevocal:dial>; specifies the call to be disconnected. Optional; if omitted, the inbound call is disconnected.
|
|
|
Tip:
|
| • | If a JavaScript expression contains any of the characters "<", ">", or "&", that character must be replaced with the corresponding escape sequence "<", ">", or "&". For more information, see JavaScript Quick Reference. |
|
Usage
The execution of a <bevocal:disconnect> tag throws an error.semantic event if the call attribute is not a valid JavaScript expression or the expression does not evaluate to an object representing an outbound call.
See Also
[Show Frames] [FIRST] [PREVIOUS] [NEXT]
