Catch

The catch element associates a catch with a document dialog, or form item. This element is a specific type of XML Events handler that acts as an observer of its parent element. It contains executable content. The event attribute specifies the event or events to catch. A space-separated list of events may be specified, indicating that this <catch> element catches all the events named in the list. In such a case a separate event counter (see "count" attribute) is maintained for each event. If the attribute is unspecified, all events are to be caught. The count attribute (defaults to 1), and indicates the occurrence of the event. The count allows you to handle different occurrences of the same event differently. Each <form>, <menu>, and form item maintains a counter for each event that occurs while it is being visited; these counters are reset each time the <menu> or form item's <form> is re-entered. The form-level counters are used in the selection of an event handler for events thrown in a form-level <filled>. Counters are incremented against the full event name and every prefix matching event name; for example, occurrence of the event "event.foo.1" increments the counters associated with handlers for "event.foo.1" plus "event.foo" and "event". The con attribute defaults to true, and is an expression that must evaluate to true after conversion to Boolean in order for the event to be caught.

Related links

• Event Handler - Plum IVR Glossary
• Attribute - Plum IVR Glossary
• Boolean Built-in Grammar - Plum IVR Glossary