JAWS Scripts For 3CX
Doug Lee
Last Revised September, 2022

This document describes the JAWS scripts for 3CX and provides tips for using this application with JAWS. This document can be opened from within the application via a double press of JAWSKey+F1 (or Insert+F1) when the scripts are running.

The scripts and this guide were initially written in April, 2015 against 3CX version 12.0.37098, then updated in April, 2020 against version (thanks to Sarah Meyer for access).

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.

Script Features In Brief

The scripts provide the following features:

Tips For Using 3CX With JAWS and the Scripts

This section provides tips for performing several common tasks in 3CX while using JAWS and these scripts. This is not an exhaustive list of tasks nor a replacement for the 3CX user documentation.

Insert+F5 can provide a means to access buttons and other controls that are otherwise not reachable via the keyboard.

The quick keys for handling calls mentioned in the previous section provide fast means of holding, resuming, and transferring a call and identifying the phone number of the contact. Any control or operation not given a quick key can still be accessed via Insert+F5. Attended transfer is an example of such an operation.

Insert+F6 can provide access to screen text that is otherwise hard to find via the keyboard. Most text shown by this command will be field and control labels, but this command is provided in case any other text item must quickly be accessed.

Insert+B is a good way to review the contents of short popup dialogs, such as confirmation boxes and alert messages.

The touch cursor provided by JAWS starting in JAWS 15 can be very handy for finding material in this application that is not reachable via the Tab key.

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.

Insert+F5 and Insert+F6 can be slow and can include many more items than necessary.

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 36, September 22, 2022, tested against application version

Warning: This script author was not able to test this update sufficiently due to lack of access to a testing environment. This message is likely to go away as soon as I hear back from users on how well this update works. In the event of trouble, though trouble is not predicted, the previous released revision (26) is available here.

Revision 26, released April 08, 2020, tested against application version

Revision 16, April 27, 2015, tested against application version 12.0.37098