Chapter 3. Working with issues

This chapter describes the most important functions of the WebIssues system, such as creating and editing issues and searching for information. It should be read by all users of the system.

Client applications

The WebIssues system can be accessed by the WebIssues Web Client, available through a web browser, as well as a dedicated client application — the WebIssues Desktop Client. You can choose a solution that fits your needs better.

The main advantage of the Web Client is that you can use the WebIssues system on any computer (or even a mobile device), anywhere in the world, if the system is available via the Internet. You can use any web browser and you don't need to install any additional software.

The advantage of the Desktop Client is above all that it's much faster and more convenient than the web interface. Searching and filtering works in real time and the program continually updates the statistics for all configured alerts. So it's the best option for those who use the WebIssues system a lot.

This diversity is similar to the use of electronic mail. Some people use email programs installed on their computer, others prefer to use email via a web browser.

Actually there are more similarities, because the main window of the application consists of three panels resembling popular email programs. On the left there is a tree of projects and folders. On the right at the top there is a list of issues in the selected folder. On the right at the bottom there are the details of the selected issue. The selected folder and issue are highlighted, and you can perform various operations with them.

Below is the Web Client window showing a few issues and the history of an issue:

Web Client application
Figure 3.1. Web Client application

Below is the Desktop Client window displaying the same information:

Desktop Client application
Figure 3.2. Desktop Client application

As you can see on these figures, the user interface of both client applications is very similar. The key differences between them are listed below:

  • Commands in the Desktop Client are available through a single toolbar, which varies depending on which panel is currently active. You can also use the contextual menus (available by clicking the right mouse button on the selected item) and keyboard shortcuts. On the other hand, in the Web Client commands are available separately within each of the panels.

  • In the Desktop Client, the whole list of issues and the entire history of the selected issue is available. You can scroll through the contents of individual panels using sliders. The Web Client displays only a limited number of issues and items in the history, so you must navigate between pages to see further issues and history.

  • The Desktop Client automatically refreshes the lists and details of issues, so you can almost immediately see changes made ​​by others. In the Web Client you have to manually refresh the page to see updated information.

  • In the Desktop Client you can open separate windows containing lists of issues and issue details. Just double-click on the folder or issue. This way you can view the contents of multiple folders, or the history of several issues side by side. On the other hand, most browsers give you the ability to open links in a new window or tab, so you can obtain a similar effect in the Web Client.

To make it easier to work with the system, both the names of the functions and the graphic symbols of various objects are the same in both client applications. Below is a list of most important graphic symbols used in the WebIssues system:

Graphic symbols
Figure 3.3. Graphic symbols

Tip

Both applications provide access to commonly used administrative functions, such as managing projects, users and types of issues. However, some administrative functions are only available through the web browser. These include system configuration and the event log.

The Desktop Client can be installed on any computer with Windows (XP or later versions), Linux or Mac OS X. Installation packages exist for these systems. You can also compile and install the application from source — for more information, refer to the INSTALL file attached in the source package.

There is also a WebIssues Portable Client application which you can run from any portable device (e.g. a USB flash drive) or media (e.g. a compact disk) without installing on your computer. It can be used together with the PortableApps.com platform or stand alone. Except for this, it is completely the same as the Desktop Client.