Page tree
Skip to end of metadata
Go to start of metadata

Java Web Viewer

A Java web viewer, deployed using Java web start, is available for use with the OnePacs system.

Benefits of the Java web viewer include:

  • Full-fledged diagnostic viewer, FDA cleared and CE certified, which may be launched on computers that have Java installed, without installing the full OnePacs study download and workstation software

Cases may be viewed in the Java web viewer in one of three ways:

  • If the Java web viewer is selected as your default viewer in user preferences, clicking on the display icon on the worklist toolbar for a particular study will open the study in the Java web viewer.
  • If the Java web viewer icon, , appears somewhere in the system, such as in the toolbar the top of a report, it may be clicked on to launch the study in the Java web viewer.
  • The Java web viewer may be selected from the right-click context menu for a case on the OnePacs worklist.

Multiple studies may be viewed in the Java web viewer by selecting multiple studies on the worklist and selecting the “Java web viewer” option from the “View” menu at the bottom of the worklist.

When launched, the Java web viewer appears as follows, and provides a full range of DICOM viewing and manipulation tools:

Setting up the Java web viewer

The Java web viewer requires a Java runtime environment and Java web start to be installed.

On Windows machines, the user will be prompted to install the necessary Java software for use of the web viewer, if such software is not already installed.

On Mac OS X machines, Java web start is installed by default on version of Mac OS X 10.4 and later.

Setting up Java web start

Upon viewing a case with the Java web viewer for the first time, the user may be presented with a window reporting a file download and asking what application should be used to open the downloaded file. If this occurs, it is necessary either to install Java, and/or to set up Java web start as the default application for opening web start files, in order to open the requested study in the Java web viewer.


On Windows operating systems, the window in question will appear as follows:

If this window is seen when attempting to view a study with the Java web viewer, Java likely needs to be installed. This will require administrative capabilities on the PC in question.

To install Java on windows, visit the following website and click on the large “Free Java Download” button:

After installing Java, Java web start should be automatically selected as an option the next time a user attempts to view a study using the Java web viewer.

General troubleshooting on Windows (reinstalling viewer)

Should the Java web viewer fail to launch, with an error such as “Unable to create Java virtual machine”, it may be helpful to delete and reinstall the viewer. To do this, open the Java control panel, which will lead to the following screen:

On Windows this can be found by clicking “start” → “Control Panel” and then double clicking the icon for Java or clicking start and typing “java control panel” in the start menu search.

Click on the “Settings…” button in the “Temporary Internet Files” section.

This will bring up a configuration window for “Temporary Internet Files”, as follows:

Click on the “Delete files…” button which is marked in red above. By default, the “Trace and log files” and “Cached applications and applets” will be checked. Click “OK” to delete these items.

When you next select a study to be viewed with the Java web viewer, the viewer will be re-installed.

Mac OS X

On Mac OS X, the window will appear as follows:

If one is presented with this window, it is best to select “Open with” and select Java web start as the application, and additionally to select “Do this automatically for files like this from now on.” This will enable future cases to be opened more quickly, without the need to select the Java web start application. Java web start is pre-installed on Mac OS X versions 10.4 and later, so it is only necessary to select the web start application to use the Java web viewer (i.e., it is not necessary to install Java).

After clicking on the “Open with”… option, it will be necessary to select the Java web start application. (If “Java(TM) Web Start Launcher” is offered as an option, simply select this option; there is no need for further configuration.)

If “Java(TM) Web Start Launcher” is not offered as an option, it will be necessary to find and select the application from within the Mac OS X file system.

The path to the web start application in Mac OS X is

/System/Library/CoreServices/Java Web

When navigating to this file in the file select window, the full file tree will appear as follows:

  • No labels