Cisco Voice Provisioning Tool Application Accessibility Notes (for JAWS Accessibility)
Available Languages
Table Of Contents
Cisco Voice Provisioning Tool Application Accessibility Notes (for JAWS Accessibility)
Dynamic Forms and Page Reloading
Add New User and Manage Users Pages
Add New Phone/Profile and Manage Phone/Profile Pages
Summary of JAWS Hints for Use with VPT
Dynamic Forms and Page Reloading
Cisco Voice Provisioning Tool Application Accessibility Notes (for JAWS Accessibility)
Published March 15, 2006
VPT Navigation Overview
To navigate the Cisco Voice Provisioning Tool (VPT), you select options from a list. Depending on the option selected, a specific form or report is activated. When a form is activated, you fill out the appropriate information and submit it; depending on the responses, additional form areas may appear after the information is submitted.
Navigation in VPT is accomplished via two frames:
•
The Tree frame contains the primary navigation mechanism, presented as a multi-level or "tree" control. The Tree frame appears on the left side of the screen.
Within tree controls, there are multiple levels with different names:
–
–
–
–
•
There are two additional frames in VPT, which contain the logo and the page header.
Frame Navigation
JAWS uses the M key to allow you to navigate among frames in a predictable order. Within the VPT application, the M key can be used to navigate among frames in the following order:
1.
2.
3.
4.
From the Tree frame, pressing M twice will bring focus directly to the Content frame. From the Content frame, pressing M twice will bring focus back to the Tree frame.
In JAWS, pressing Insert-F9 will bring up a separate window listing all of the frames on the page, and pressing Insert-F1 will provide a page summary.
Tree Frame Navigation
When nodes in the Tree frame are expanded and collapsed, JAWS does not provide feedback regarding the current expanded or collapsed state. You need to memorize the VPT tree hierarchy.
In VPT version 1.0(1), the tree control has the following static structure:
Node 1: Voice Provisioning
Subnode 1.1: Users
Leaf 1.1.1: Add New User
Leaf 1.1.2: Manage Users
Subnode 1.2: Templates
Sub-subnode 1.2.1: User Templates
Leaf 1.2.1.1: Add New User Template
Leaf 1.2.1.2: Manage User Templates
Sub-subnode 1.2.2: Phone Templates
Leaf 1.2.2.1: Add New Phone Template
Leaf 1.2.2.2: Manage Phone Templates
Subnode 1.3: Bulk Provisioning
Leaf 1.3.1: Bulk Import
Leaf 1.3.2: Bulk Export
Leaf 1.3.3: Manage Bulk Tasks
Subnode 1.4: Phones
Leaf 1.4.1: Add New Phone/Profile
Leaf 1.4.2: Manage Phones/Profiles
Node 2: VPT Administration
Subnode 2.1: Administrators
Leaf 2.1.1: Add New Administrator
Leaf 2.1.2: Manage Administrators
Subnode 2.2: Roles
Leaf 2.2.1: Add New Role
Leaf 2.2.2: Manage Roles
Subnode 2.3: Product Systems
Leaf 2.3.1: Add New Product System
Leaf 2.3.2: Manage Product Systems
Subnode 2.4: Plug-Ins
Leaf 2.4.1: Install New Plug-In
Leaf 2.4.2: Manage Plug-Ins
Leaf 2.5: View Audit Log
Leaf 2.6: Configuration
When navigating the tree control, an easy way to recognize a leaf is to note that it will be prefaced with the word "Link" or the phrase "Visited link," while nodes and subnodes will be prefaced with "This page link." This is because JAWS distinguishes between links that keep you on the same page and links that go to a different page.
The tree maintains a fairly consistent structure, providing two leaf nodes for each of several subnodes, representing object types that can be managed with VPT. The two leaf nodes allow records for the objects in question (for example, users, phones, templates, or roles) to be added and managed. Almost all of the leaf nodes are two levels deep in the tree. The exceptions are User Templates and Phone Templates, which are three levels deep, and View Audit Log and Configuration, which are one level deep.
A tree node can be expanded and collapsed by pressing the Enter key. If the Enter key is pressed when a collapsed tree node has the focus, that node will be expanded and the focus will remain on that node. If the Enter key is pressed when an expanded node has the focus, that node is collapsed—any subnodes or leaf nodes are hidden—and the focus remains on the higher-level node. Because JAWS keeps the focus on a node when you select it, you can determine whether a node is open or closed by pressing Enter and seeing if new information appears or disappears.
Selecting a leaf node (by using the Enter key) will cause the corresponding page to be loaded into the Content frame. The leaf node will retain the focus, and the screen reader will start reading the items below the selected leaf. To move the focus to the Content frame when a leaf has been selected, press Control to stop the screen reader, and then press M twice. The screen reader will then read the title of the Content frame and put the focus within the Content frame. You can then invoke an action (for example, press Tab or Shift-Tab) for the screen reader to begin reading within the Content frame.
To quickly move focus to the Tree frame, press Control-Home to get to the Logo frame and then press M once. This keypress sequence is particularly useful for getting to the top level Voice Provisioning node after you have been exploring the tree for some time. Press the Down Arrow once to bring focus to the Voice Provisioning node.
Each time that you log in to VPT, the tree control starts out in a fully collapsed state. When a subnode is expanded, it will expand only one level. However, as tree nodes and their subnodes are expanded, the expansion state is retained for the remainder of the login session. What this means is that when an expanded node is collapsed, the next time it is expanded, the expansion state of any subnodes is retained. Thus, when a fully expanded tree is collapsed from the root node, and then expanded again from the root node, the tree will appear fully expanded again. If the tree was only partially expanded before collapsing from the root node, then expanding it again will show the tree in the same partially expanded state.
When a login session expires, the state of the tree control is reset to fully collapsed.
Note that if you navigate only the tree control during a session, your navigation actions do not cause the session expiration timer to be reset, which means that the session may time out unexpectedly. Actions such as following a link, pressing a button, or selecting a tree node must be performed in order to reset the session expiration timer. You can avoid untimely session expirations by adjusting the session timeout length in VPT, but doing so must be weighed against the security concerns of allowing sessions to remain open when they are not active.
Menu Bar Navigation
The VPT menu bar, which is a visible part of the VPT user interface, is currently not accessible via the keyboard. However, almost all items in the menu bar are available from buttons or other options within the Content frame. Normal use of Tab and Arrow keys to navigate through the Content frame provides access to all page sections and all buttons.
The menu bar also contains menu items that link to the online Help, which is not accessible any other way from within the VPT user interface. To provide access to the online Help, set up browser shortcuts or bookmarks that link directly to the online Help resources.
Content Frame Navigation
See the following sub-sections:
•
Toggle Sections
The User and Phone pages in VPT display content in multiple sections called toggle sections. Toggle sections can be expanded to show their contents or collapsed to hide their contents, in the same way that the Tree node hierarchy works. When a toggle section is collapsed, only its title is displayed.
Pressing Enter when the focus is on the toggle section title will alternately expand and collapse the section, and focus will remain on the section title. JAWS will preface the toggle section titles by saying "This page link" rather than just saying "Link."
User Pages
For user pages (Add New User, Manage Users, Add New User Template, and Manage User Templates), there are a maximum of three toggle sections, depending on what types of systems are currently selected:
•
•
•
If there are no selections made from the Template Name, Phone System, or Message System select controls, the CallManager User Information and/or the Unity User Information sections may not appear.
Phone Pages
The phone pages (Add New Phones, Manage Phones, Add New Phone Template, and Manage Phone Templates) also use toggle sections, but they are nested into two levels. A typical phone page will have two sections for phone settings (basic and advanced device settings), and then will have a section for each phone line. Within each line section is a nested section for advanced line settings:
Basic Phone Configuration (level 0)
Advanced Phone Configuration (level 0)
Line1 Ex:555/Partition XYZ (level 0)
Line 1 Advanced Line Configuration Ex:555/Partition XYZ (level 1)
Line2 Ex:123/Partition XYZ (level 0)
Line 2 Advanced Line Configuration Ex:123/Partition XYZ (level 1)
...
When the page is first displayed, all of the line sections are collapsed, and the advanced device settings section is also collapsed. Typically, only the basic settings will be needed, so the basic settings section is the only one that is expanded by default.
Note that in the Add New Phone and Add New Phone Template pages, the page is first presented with no Line sections. The Line sections are not displayed until a phone button template has been chosen one or more times, thus determining how many line sections are needed. See the "Dynamic Forms and Page Reloading" section for more information.
Success and Failure Messages
When a form is submitted or an action is performed that causes a page refresh (for example, clicking the save button or another button), and when no additional collapsed or expanded sections are brought up, a success or failure message will appear at the top. The screen reader may not notice that the page has reloaded, and consequently it will not read the success or failure message.
Each time that you perform an action like this, you should press M until you reach the top of the Content frame, and then use the Down Arrow key to listen for an "Operation...failed" or a "Successful" message.
When a failure message appears, it will either result from a form validation error (where a required field was left empty), or an operation error. An operation error will present a link that opens a pop-up window containing complete error information. A form validation error will indicate that there were errors on the current page, but it will not provide a link to additional information. The validation errors are placed adjacent to each specific form field or value that was in error. The entire form must be navigated in order to determine which fields were in error.
Note that if a section is collapsed when an action is taken, and a failure message appears, it cannot provide information on validation errors. The section must be expanded before JAWS can read the validation errors.
Dynamic Forms and Page Reloading
Several of the pages in the VPT application are dynamic in nature, meaning that the content that appears on the page depends on certain selections made while filling in forms. When these selections are made and the page is reloaded, you automatically exit forms mode, and JAWS states that the page is reloading, both of which are indications that the page has changed. However, the feedback is not necessarily definitive about the page status.
You should anticipate dynamic page re-loads and form changes, and should also be aware that when a page is processing, JAWS will not immediately indicate the processing status.
Typically, page changes are triggered by certain select controls (also known as combo boxes). To use select controls, press Enter to enter forms mode.
The page will reload if the select control selection is changed by using the Up Arrow or Down Arrow key. A page reload is triggered each time that you press either the Up Arrow or Down Arrow, and after the page reloads, the focus remains on the select control. Note, however, that occasionally the focus will be lost after the page reloads. When this happens, pressing the Tab key once will usually bring the focus back to the select control (exceptions are noted in the discussion of specific pages below).
To open the select control without causing the page to refresh, press Alt-Down Arrow. The selection list will open. Use the Up Arrow and Down Arrow keys to browse the list, then press Enter to select an item and trigger the page reload.
In general, when you are completing an add operation (for example, add user or add phone), the Content frame will refresh with the corresponding Edit page for the user, phone, or other item added. The Edit page is considered a part of a manage task, so the focus will also change in the tree control, which will switch from the Add tree node to the corresponding Manage tree node.
When information is entered and the page refreshes, the focus may or may not stay on the last field encountered. Additional fields may or may not appear after the refresh. JAWS will not automatically inform you whether additional fields have appeared.
In the following sections, we have noted all instances where the page will reload and have indicated where the focus will move. (This focus information is primarily for the benefit of individuals who provide training on the use of VPT with JAWS.)
•
•
Add New User and Manage Users Pages
On user pages, the following controls will trigger page reloads: Add New User, and Manage Users.
The Add New User page shows a form with only a few elements on it. After a new user is successfully added, the page becomes a Manage Users page, and the focus in the Tree frame moves to Manage Users.
•
•
•
After a page has refreshed once, performing an operation that causes the page to refresh again will keep focus in the Content frame when you press the Tab key. The focus will return to the select control that was accessed immediately before the last refresh.
If no selections were made in the select controls listed above while adding the new user, they can be made when the entered record is called up by using the Manage Users page. Performing an operation that causes the page to refresh again will keep focus in the Content frame when you press the Tab key. The focus will return to the select control that was accessed immediately before the last refresh.
User Template Page
Under the User Template subnode are leaf nodes for Add New User Template and Manage User Templates. The Phone System Select and Messaging System Select controls that refresh the page have names and functions that are identical to those on the Add New User and Manage User pages, and activating these controls routes the focus exactly as on the Users pages. (Note that Template Name is a text field.)
Add New Phone/Profile and Manage Phone/Profile Pages
The Add New Phone/Profile page shows a form with only a few elements on it. After a new user is successfully added, the page becomes a Manage Phones/Profiles page, and the focus in the Tree frame moves to Manage Phones/Profiles.
•
If no value is entered for VPT Phone Template, the other select controls function as follows:
•
•
•
•
All of these controls are required with the exception of the VPT Phone Template. Under Manage Phones/Profiles, the VPT Phone Template appears as a select control with no selectable options. The rest of the fields are shown as uneditable text, except for Phone Button Template.
Phone Template Page
Under the Phone Template subnode are leaf nodes for Add New Phone Template and Manage Phone Templates. The Phone System, Device Class, Device Type, and Phone Button Template controls have names and functions identical to those on the Add New Phone/Profile page. (Note that Phone Template is a text field.)
•
•
•
In each line section, there is a edit control (text box) for the Directory Number and a select control for the Partition. Changing either the Directory Number or the Partition will cause the page to reload so that the system can verify that a line with the same Directory Number and Partition does not already exist. After the page reloads, the focus moves back to the last field that was modified.
Add New Product System Page
The Add New Product System page content will refresh and additional fields will appear after an option is chosen from the Product System Type select control. The fields added are dependent on the option chosen. Focus remains on the Product System Type select control after the page reloads.
Pop-Up Windows
On certain VPT pages, clicking a button opens a modal pop-up browser window that is used to collect additional information. When you have successfully added information or made a selection, the pop-up window will close and transfer the information to the applicable window. You receive no confirmation, other than the presence of the new information in the current window.
Clicking the following buttons will open a modal pop-up window:
•
•
•
•
•
•
•
Summary of JAWS Hints for Use with VPT
Navigation Tree
•
•
•
•
•
Frame Navigation
•
•
Menu Bar
•
Dynamic Forms and Page Reloading
•
•
•
•
Note
The information in this document is accurate for testing done with JAWS 7.0 and Internet Explorer 6.0 on 2/8/06.
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2006 Cisco Systems, Inc. All rights reserved.
Feedback