TOC PREV NEXT INDEX DOC LIST MASTER INDEX




Select Tasks Dialog Box (Summit/TM)

The Select Tasks dialog is used to build a list of tasks. It is invoked via the Navigator icon on other dialogs wherever a field accepts one or more task names such as the Parent field of the New Tasks dialog and the Associate Tasks field of the Check Out dialog. The Tasks Field of this dialog initially lists the tasks that were in the task entry field of the base dialog (such as Check Out).

Select Tasks Dialog Box Fields:

The set of tasks in the Selected Tasks list box can be modified. These tasks are transferred to the original task entry field when the OK or Apply button is selected.

The top part of the Select Tasks dialog manages the list of selected tasks. The bottom part of the dialog contains an options menu (labeled Select Tasks From > ) that displays different dialog pages to assist in the selection of tasks from different sources:

Domain - Selects tasks from a domain. This is the default page. It initially displays the tasks in the default domain.

Task List - Selects tasks from a task list file.

Task Query - Executes a task query and selects tasks from those matching the query.

Selected Tasks Area

The top part of the dialog that manages the list of selected tasks. These are the tasks transferred to the task entry field when the OK or Apply button is pressed.

Selected Tasks List Box

The selected tasks. The buttons on the right are related to the list box:

Task Id / Summary Fields

The name of a task to be selected. The Summary field displays the value of the Summary field of the task. The Summary field of the dialog is not editable.

The Navigator icon invokes the File Selector dialog in the context of the task domain specified by the text field in the Domain page below. If this field is empty, the default task domain is used.

The Alternatives icon displays the tasks in the user's "to do" task list (file ~/.Rational/todo.tasklist) and their Summary field values.

The following buttons are associated with the Task Id and Summary fields:

Select Tasks From: Pages

The lower part of the dialog is variable. The page displayed is selected from the Select Tasks From > options menu.

Each of the pages (Domain, Task List, and Task Query) includes a list box in which the tasks (in the domain, in the task list, or matching the query, respectively) may be displayed. By default, the tasks are displayed in this list box, for example, in the Tasks in Domain list box on the Domain page. Alternatively, the tasks may be displayed in a separate window.

When a task in the list box is selected, its task id and Summary field value are automatically displayed in the Task Id / Summary fields above. The task can then be added to the Selected Tasks list using the Add > button next to the Task Id field.

In addition, the Add Selected Tasks button just above the list box adds all selected tasks to the Selected Tasks list box directly.

The Display Options near the bottom of the dialog determine which task fields are displayed and whether they are displayed in the list box or in a separate summary window. The display options are described in more detail later.

Domain Page

Selects tasks from a domain. The text field names the domain. By default, the tasks are displayed in the Tasks in Domain list box. Initially, the default domain is displayed.

The Alternatives icon displays the domains in the user's task domain path. The buttons immediately below the domain text field are:

Task List Page

Select tasks from a task list. The text field names the task list file. By default, the tasks in the list are displayed in the Tasks in List list box.

If no extension is specified, the .tasklist extension is assumed. If a simple name is specified, the user's ~/.Rational directory is assumed. The Alternatives icon displays the simple names of the task list files in that directory. The buttons immediately below the task list field are:

Task Query Page

Selects tasks from those that match a task query. The text field names a task query file. By default, the tasks matching the query are displayed in the Tasks from Query list box.

If no extension is specified, the .taskquery extension is assumed. If a simple name is specified, the search rules described in "Task Query Files" in the Rational Summit/TM User's Guide apply. In particular, the search includes user's ~/.Rational directory, the domain views in the task domain path and the associated task kind directories. The Alternatives icon displays the task query files that are visible via their simple names.

The buttons immediately below the task query field are:

Display Options

The Display Options near the bottom of the dialog control how tasks are displayed for the Select Tasks From > pages.

The following options control which task fields are displayed:

By default, only the task ids are displayed. Whenever, the Summary or the default field values are requested, the task query mechanism is invoked to retrieve the field values. This may take several seconds if a large number of tasks are involved.

The following options control where the tasks are displayed:

Usually, it is convenient to display the tasks in the list box, since they can easily be selected and added to the Selected Tasks list box. However, sometimes it may be desirable to display multiple sources of tasks at the same time, for example several task lists. The In a Window option will create an independent summary window for each set of tasks.

To select tasks from a summary window and add them to the Selected Tasks list box, use the drag and drop mechanism as follows:

1. . Select the desired tasks in the summary window (using the control key to select more than one).

2. . Press the middle mouse button with the mouse positioned over one of the selected tasks.

3. . While keeping the mouse button depressed, drag the mouse to the Task Id field and release the button. This drops a space-separated list of the selected tasks into that field.

4. . Press the Add > button next to the Task Id field to add the tasks to the Selected Tasks list box.

Summit/TM is described in the Summit/TM User's Guide and the Summit/TM Customization Guide.

Additional Topics

For additional information, refer to these topics:


Rational Software Corporation 
http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX TECHNOTES APEX TIPS