XML and JavaScript Introduction

1. XML and JavaScript Introduction

2. XML Brief Introduction:- 1) Understanding XML Documents:- An XML document is comprised of one or more named elements organized into a nested hierarchy. An element is an opening tag, some data, and a closing tag. A tag is an element name preceded by a less-than symbol (<) and followed by a greater-than (>) symbol. For any given element, the name of the opening tag must match that of the closing tag. A closing tag is identical to an opening tag except that the less-than symbol is immediately followed by a forward-slash (/). Tag names are case-sensitive. <welcome>Welcome to IVR</welcome> 2) Using Comments:- A comment begins with the combination of characters "<!--" and ends with the combination of characters "-->". Comments may appear as a child of any element in an XML document. They can also appear before or after the root element. A comment may span multiple lines but cannot be nested. Ex: <!-- comment sample -->

3. Reserved characters and CDATA sections:- XML reserves certain characters, including less-than (<), greater than (>), and ampersand (&). To express these characters in your document data, use the equivalent character entity:

4. Using JavaScript:- Programmers can use JavaScript anywhere an expr attribute or cond attribute is allowed in VoiceXML. For example, both the var element and the assign element supports an expr attribute and expects a JavaScript expression. <assign name="ui_path" expr="'ui/'" /> <assign name="class_prompt" expr="ui_path + Math.floor(Math.random()*10) + '.wav'" /> <audio expr="class_prompt" /> Because several of the operators in JavaScript (<, >, &, &&) have special significance in XML, enclose your script in a CDATA section.

5. <?xml version="1.0"?> <vxml version="2.1" xmlns="http://www.w3.org/2001/vxml"> <var name="utc_month" /> <var name="utc_day" /> <var name="utc_year" /> <script> <![CDATA[ // explicitly declare d using var var d = new Date(); // store the month utc_month = d.getUTCMonth(); // store the day of the month utc_day = d.getUTCDate(); // store the year including the century utc_year = d.getUTCFullYear(); ]]> </script> </vxml>

6. iCurrentMonth here is a VXML Variable Accessing VoiceXML variables:- <block> <var name="iCurrentMonth" /> <script> var d = new Date(); iCurrentMonth = d.getUTCMonth()); </script> <!-- The current month is... --> <audio src="curmonth.wav"/> <audio expr="'ui/months/' + iCurrentMonth + '.wav'"/> </block> Javascript using iCurrentMonth vxml variable

7. VoiceXML

8. VoiceXML is a markup language derived from XML for writing telephone-based speech applications. Users call applications by telephone. They listen to spoken instructions and questions instead of viewing a screen display; they provide input using the spoken word and the touchtone keypad instead of entering information with a keyboard or mouse. VoiceXML:- Just as a web browser renders HTML documents visually, a VoiceXML interpreter renders VoiceXML documents audibly. You can think of the VoiceXML interpreter as a telephone-based voice browser. As with HTML documents, VoiceXML documents have web URIs and can be located on any web server. Yet a standard web browser runs locally on your machine, whereas the VoiceXML interpreter is run remotely--at the VoiceXML hosting site, for example. And you use your telephone to access the VoiceXML interpreter.

9. Environment:- In order to support a telephone interface, the VoiceXML interpreter runs within an execution environment that includes a telephony component, a text-to-speech (TTS) speech-synthesis component, and a speech-recognition component. The VoiceXML interpreter transparently interacts with these infrastructure components as needed. For example: • Text strings in output elements are rendered using TTS. • Connection issues (picking up the incoming call, detecting a hang-up, transferring a call) are handled by the telephony component. • Listening to spoken input from the user and identifying its meaning is handled by the speech-recognition component.

10. VoiceXML Interpreter:- VoiceXML language as any XML languages needs an interpreter that interprets VoiceXML commands. This interpreter is now the ground of dialog management in interactive voice response systems. The main advantage of interpreted programming language is that its code need not be compiled. This is especially useful by dynamic generation of VoiceXML pages, when we work with often changing content.

11. Application structure:- A VoiceXML application consists of a set of VoiceXML documents, and each VoiceXML document contains one or more dialogs describing a specific interaction with the user. Dialogs may present the user with information or prompt the user to provide information, and when complete, they can redirect the flow of control to another dialog in that document, to a dialog in another document in the same application, or to a dialog in another application entirely. At the root of every VoiceXML document is a root element, the vxml element. This element should contain one or more elements representing dialogs. VoiceXML 2.x provides two types of dialogs: 1)form and 2)menu.

12. Tags and Elements:- VoiceXML uses markup tags and plain text. A tag is a keyword enclosed by the angle bracket characters (< and >). A tag may have attributes inside the angle brackets. Each attribute consists of a name and a value, separated by an equal sign (=) and the value must be enclosed in quotes. Tags occur in pairs; corresponding to the start tag <keyword> is the end tag </keyword>. Between the start and end tag, other tags and text may appear. Everything from the start tag to the end tag, is called an element. For example, the following three lines constitute a prompt element: <prompt> What is your telephone number? </prompt> If there are no other tags or text between the start and end tag, a syntactic shorthand is permitted. You can precede the closing angle bracket ( > ) of the start tag with a slash ( / ) and omit the end tag. For example, instead of writing a value element as: <value expr="result"></value> you can use the shorthand notation: <value expr="result"/>

13. If one element contains another, the containing element is called the parent element of the contained element. The contained element is called a child element of its containing element. The parent element may also be called a container. Terminologies and Concepts:-- • Documents • Applications • Dialogs

14. Documents:- An executable VoiceXML file is called a document. The VoiceXML interpreter loads a document file to execute it. Every VoiceXML document must start with header information that conforms to the XML standard: <?xml version="1.0" ?> <!DOCTYPE vxml PUBLIC "-//W3C/DTD VoiceXML 2.0//EN" "http://www.w3.org/TR/voicexml20/vxml.dtd"> <vxml version="2.0" xmlns="http://www.w3.org/2001/vxml"> indicates that the document is an XML document. This tag is required. The first 4 characters of any XML file (including a VoiceXML document) must be: <?xm identifies the Document Type Definition (DTD), which is used to validate that the contents represent well-formed VoiceXML. This tag is optional. identifies the version of VoiceXML used in this document and the designated namespace for VoiceXML. This tag is required.

15. Applications:- A VoiceXML application consists of one or more documents. Any multidocument application has a single application root document. Each document in an application identifies the application root document with the application attribute of the <vxml> tag: <vxml version="2.0" xmlns="http://www.w3.org/2001/vxml" application="myAppRoot.vxml" > Whenever the interpreter executes a document, it loads that document. If the document specifies an application root document, that document is also loaded. Here “myAppRoot.vxml” is a application root document

16. Dialogs :- Within a document, a user interacts with dialogs, in which the application produces auditory output, typically asking for information. The user provides input by speaking or pressing keys on the telephone. User speech must be recognized and its meaning interpreted. The telephone key input is interpreted as a sequence of tones in the Dual Tone Multifrequency (DTMF) signalling system. VoiceXML has two kinds of dialogs: 1) forms, and 2) menus. • The main elements of a document (within the <vxml> element) are forms. VoiceXML forms are analogous to web forms; you use them to collect input from the user. A form interacts with the user to fill in a number of fields. Every field has an associated variable, called its input-item variable, or just input variable. Initially, the variable has a value of undefined. It is filled in when the speech-recognition engine recognizes a valid response in a user utterance. The VoiceXML <form> tag defines a form and the <field> tag defines a field in a form. You specify the name of the input variable with the name attribute of the <field> tag. <field name="num" type="number"> <assign name="result" expr="factorial(num)" />

17. Menus:- A menupresents the user with a number of choices; it transitions to a different dialog based on the user's selection. The <menu> tag defines a menu; each choice consists of a <choice> element. The next attribute of a <choice> element specifies the destination dialog to which the interpreter should transition when the user selects that choice. If a <form> or <menu> element is to be the destination of a transition, the id attribute for the destination dialog should specify a unique identifier. For example, the following menu consists of three choices. <menu> <prompt> Please choose one of <enumerate/> </prompt> <choice next="#MovieForm"> local movies </choice> <choice next="localBroadcast.vxml#RadioForm"> local radio stations </choice> <choice next="http://www.nationTV.org/tv.vxml"> national TV listings </choice> </menu>

18. The prompt in this menu includes an <enumerate> tag. This tag lets you set up a template for an automatically generated description of the choices. By default, the <enumerate> template simply lists all the choices. In the previous example, the prompt is "Please choose one of local movies, local radio stations, national TV listings." The destination dialog specified by the next attribute can be in the current document or in a different document: • If the user says "local movies", the interpreter transitions to the dialog named MovieForm in the same document. • If the user says "local radio stations", the interpreter transitions to the dialog named RadioForm in the document localBroadcast.vxml. • If the user says "national TV listings", the interpreter transitions to the first dialog in the document tv.vxml in the national TV web site.

19. Handling Events:- An event is a significant occurrence in a system or application. In a desktop application, events occur as a result of a user action such as a key press or the clicking of a mouse button. Understanding event types: VoiceXML places events in two categories - 1) pre-defined events, and 2) application-defined events. Pre-defined events are events thrown by the Platform and are divided into two subcategories - normal events and error events. Application-defined events are custom events that are both thrown and caught by the voice application.

20. 1.1 Pre-defined normal events: The following table describes the pre-defined normal events defined in the VoiceXML 2.0 specification. help Thrown when the user requests help. noinput Thrown within an interactive call state when the user has said nothing within the timeout period. nomatch Thrown when the user utters something outside the active grammars. connection.disconnect.hangup Thrown when the user disconnects or is disconnected. Post-hang-up processing is limited to 5 seconds. If you need to do extensive processing, your event handler should execute a submit to your Web server to perform any additional processing. Prior to Revision 1, this event was telephone.disconnect.hangup. cancel Thrown when the user has requested the current prompt be canceled. exit Thrown when the user has asked to exit. maxspeechtimeout Thrown when the user input exceeded the 'maxspeechtimeout' property. connection.disconnect.transfer Thrown when the user has been transferred unconditionally to another line and will not return. Prior to Revision 1, this event was telephone.disconnect.transfer.

21. 1.2. Pre-defined error events: The following table describes pre-defined error events defined in the VoiceXML 2.0 specification: error.semantic Thrown when the VoiceXML interpreter detects a run-time error. error.badfetch Thrown when an HTTP request for a VoiceXML document, external grammar, or external script fails. If the VoiceXML document that required the fetch contains semantic errors, the badfetch event is thrown to the container element that attempted to navigate to the document. Because the Tellme VoiceXML interpreter loads scripts on demand, a badfetch event that results from the fetch of a script is not thrown until the script element is encountered by the VoiceXML interpreter. error.noauthorization Thrown when the user is not authorized to perform the requested operation. error.unsupported.format Thrown when the requested resource is in an unsupported format. error.unsupported.language Thrown when the Platform doesn't support the specified language. error.unsupported.element Thrown when the Platform doesn't support the given VoiceXML element.

22. Handling events:- To handle events, use the catch element and set the event attribute to the name of the desired event. For example, the following nomatch handler queues some audio and then listens for user input: <catch event="nomatch"> I'm sorry. I didn't get that. </catch> <!-- catch all other errors --> <catch event="error"> I'm sorry, but an error has occurred. <!-- _event stores the complete event name --> <log>Application error: <value expr="_event"/></log> <disconnect /> </catch>

23. Understanding event handler selection In the previous section you learned that the VoiceXML interpreter executes an event handler whose name matches that of the event that was thrown. This is an oversimplified explanation. The interpreter uses a number of additional criteria when selecting an event handler. These include: * the location of the handlers in the document hierarchy, also known as scope. * the location of the handlers relative to one another within a single container, also known as document source order. * the value of the count attribute of the event handlers and the number of times the event has fired. * the value of the cond attribute of the event handlers

24. Understanding event scoping: In the introductory section on handling events, you learned to declare a handler within a field element to catch events such as a noinput or a nomatch. The field defines an anonymous scope, and the event handler has access to all the variables, scripts, and data declared within that scope in addition to those scopes defined by containing elements including the form also known as dialog scope, the vxml element also known as document scope, and the application root document also known as application scope. In addition to defining variables, scripts, and data at dialog, document, and application scope, you can also define event handlers at these scopes. When the VoiceXML interpreter begins the event handler selection process, it considers the handlers defined within the current anonymous scope as well as the outer containing scopes. The following diagram illustrates the scopes the VoiceXML interpreter searches for an appropriate event handler when an event is thrown from within a field:

25. Building VoiceXML applications:- A voice application is a collection of one or more VoiceXML documents. A VoiceXML document is composed of one or more dialogs. A single VoiceXML document serves as the application entrypoint. This is the VoiceXML document that the Tellme VoiceXML interpreter fetches when a customer dials the telephone number associated with your voice application. Upon execution of that document, the interpreter fetches dependencies including grammars, scripts, recorded audio, XML data, and additional VoiceXML documents as required by your application. The documents in a voice application share a common application root document. An application root document is a VoiceXML document that can contain variable declarations, scripts, links, grammars, event handlers, and properties that are available throughout the application.

26. The following diagram depicts a simple voice application. The application consists of a main document, "doc1" that serves as the application entrypoint, an application root document, "app_root", that provides shared application resources, and two additional VoiceXML documents, "doc2" and "doc3". * "doc1" references the external grammar located in the file "gram1". * "doc2" refers to the external grammars located in the files "gram2" and "gram3". * "doc3" refers to the external grammar located in the file "gram4". * The application flows from "doc1" to "doc2" and from "doc2" to "doc3".

27. Using Subdialogs:- A subdialog is a self-contained, reusable VoiceXML component. To maintain encapsulation, subdialogs do not have access to the execution context of their user. The execution context includes the variables defined in the calling dialog as well as the resources defined in the application root document pointed to by the VoiceXML document containing the calling dialog. The subdialog element allows you to call a self-contained VoiceXML dialog. In addition to passing parameters to the called dialog via param elements, the called dialog can return values to the caller via the return element. Whether or not you return data from a subdialog, you should always include the return element in the dialog called by the subdialog element to properly return to the execution context of the caller. Just before the subdialog is executed the VoiceXML interpreter suspends the execution context of the caller including all event handlers, grammars, links, scripts, and variables in any scope (dialog, document, application). The VoiceXML interpreter creates a new execution context for the subdialog while it executes. This context is destroyed when the subdialog returns.

28. Table 1: VoiceXML Elements:-