Custom JAWS Scripts For Dixa
Doug Lee
Last Revised January, 2021

This document describes the scripts for Dixa and provides tips for using this application with JAWS. This document and the scripts cover the Dixa app, not the Dixa website interface.

This document can be opened from within the application via a double press of JAWSKey+F1 (or Insert+F1) when the scripts are running.

Table of Contents

System Requirements For JAWS Users

In addition to any system requirements for the application, the following apply for JAWS users:

Script Installation Instructions

To install these scripts on a new system:

  1. Load JAWS if this has not already been done. This will require administrative privileges on the computer.
  2. Run JAWS as the user for whom the scripts are to be installed. This and the following steps must be performed for each user of the computer who will be using JAWS with these scripts.
  3. Download and run, or run directly, the installer for these scripts; and follow the on-screen directions. Be sure to install the scripts in the currently running JAWS version if a JAWS version list is presented.
  4. To verify successful installation, type Insert+Q from within the application. Part of the JAWS spoken response should be a revision number. If you do not hear a revision number, the scripts are not correctly loaded. In some cases, restarting JAWS may fix this issue.

Key Sequences

These scripts incorporate commands that consist of sequences of keystrokes, all beginning with a common prefix, or "command keystroke." This approach allows many script commands without the risk of conflicting with application keystrokes. See the "Multi-Key Command Sequences" section of the "Common Script Elements" document for further details, including how to explore the available script commands (similar to exploring a menu system), and how to change the Command keystroke if necessary.

By default, the Command keystroke for these scripts is [. This document may refer to this keystroke as [ or Command; so, for example, [ Tab and Command Tab both refer to typing the prefix keystroke, then separately the Tab key. Some sequences may consist of more than two keystrokes, or "levels"; for example, [ d r would refer to typing [, then d, then finally r.

Script Commands and Features

The features of these scripts were reduced in early 2021 because of the addition in Dixa itself of the following keyboard shortcuts. Note that the keystrokes marked with a superscript asterisk (*) may require special handling as indicated.

Dixa keyboard commands
Keyboard ShortcutDescription
Ctrl+Alt+Ncompose new email
Ctrl+Alt+CClaim conversation
Ctrl+Alt+TOpen transfer
Ctrl+Enter *Send reply
/ *open search
Ctrl+Alt+MToggle mute on current call
Ctrl+Alt+HToggle hold on current call
Ctrl+Alt+AAccept conversation offer
Ctrl+Alt+RReject conversation offer
Ctrl+Alt+WToggle presence (Working/Away)
* This keystroke may not work with the JAWS virtual cursor active. Turn off the virtual cursor or precede this keystroke with the JAWS pass-key-through command, Insert+3.

These scripts provide the following commands beyond those provided by the application itself:

These scripts also provide the following features:

Tips For Using This Application With JAWS and the Scripts

To make an outbound call:

To change availability between Away and Working:

To change the phone status between Gray and Green (warning, these directions were written against Dixa 3.12 and no longer apply exactly in later Dixa versions):

To exit the application without using a mouse:

Known Issues

The following issues are known and may be encountered during use of the application with these JAWS scripts. These issues may be fixed in a future update to the scripts or to the application itself.

The system tray menu for this application is not accessible:

Braille support is not well tested and is likely incomplete.

Revision History

This is the revision history of these scripts, most recent revision first:

Revision 55, May 12, 2021, tested against application version

Warning: If you are running an older version of Dixa than the one indicated in the above heading, do not apply this script update as it will cause several commands and features to stop working with your older Dixa installation. Dixa is an evolving product, and the scripts must occasionally evolve with it.

Revision 38, December 30, 2019, tested against application version

Revision 36, December 24, 2019, tested against application version