CallXML 3.0 Development GuideHome  |  Frameset Home

<onerror>  element

DEPRECATED ELEMENT -- use the <on> handler element instead
When certain errors occur an <onError> event is generated. This gives the CallXML developer a way to handle error conditions that may occur while CallXML actions are executing.


usage
<onerror next="(navigation identifier)" type="(error-event type)">


attributes
nextData Type: (navigation identifier)Default: none - attribute is optional
The 'next' attribute sets the URL the CallXML platform will go to when the container ends.
typeData Type: (error-event type)Default: none - attribute is optional
The 'type' attribute, when used in conjunction with the <onerror> element is used for fine-grained event handling for specific circumstances. When a specific error is thrown, the callXML browser will look for a specific <onerror type> matching the event thrown, and execute the code contained within. If no specific handlers are present, the browser will then execute any generic <onerror> elements that are present and execute the code within.

The allowable values for this atribute are:
  • unknown - General error not fitting into any other category
  • internal - Server error -- alert Voxeo support
  • document - Document was unable to be fetched for all the reasons web servers are unavailable
  • telephony - Unable to issue a telephony event such as <call> or <playaudio> or <ftp>
  • serverbusy - No sessions available on the server for <run> or <answer> etc
  • lineactive  - Trying to issue a telephony event such as <answer> on an already active line
  • linenotactive - Trying to issue a telephony event such as <getdigits> or <playaudio> on a non-active line
  • invalidconference - Bad target conference
  • badnumber - Outbound destination returs a SIT tone
  • event -  When certain errors occur an <onError> event is generated. This gives the CallXML developer a way to handle error conditions that may occur while CallXML actions are executing.



code samples
<DEPRECATED ELEMENT IN CALLXML3.0>
<?xml version="1.0" encoding="UTF-8"?>

<callxml version="3.0">
  <!--

    In CallXML 3.0, this element has been deprecated in favor
    of the more modular 'on' element.

    While we retain backwards compatibility for this particular
    tag in the CallXML3.0 markup, it is advisable to use the 'on'   
    element in your code.

  -->
</callxml>



additional links
none


  ANNOTATIONS: EXISTING POSTS
0 posts - click the button below to add a note to this page

 login


© 2008 Voxeo Corporation  |  Voxeo IVR  |  VoiceXML & CCXML IVR Developer Site