TOC PREV NEXT INDEX DOC LIST MASTER INDEX




Task Editor Dialog Box

When the Navigate > Visit or Navigate > Visit In Place command is issued on a selected task object, the Task Editor dialog associated with that task is invoked. This dialog is defined in the task's task kind directory. The dialog is used to examine and modify the information stored in the task. Any changes made to a task's fields are not permanently recorded until either the OK or Apply button is pressed.

Since Task Editors are customizable, the following dialog is only a representative example

Note that some fields of the dialog, such as the State field, may not be properly displayed because no actual task is displayed.

Task Editor Dialog Box Fields:

Domain Field

Displays the task domain in which the task is stored. It cannot be modified.

Id Field

Displays the task id number that was generated when the task was created. It cannot be modified.

Kind Field

Displays the task kind used to create the task. It cannot be modified.

Parent Field

Displays the parent task. If the task has no parent, then this field will not appear. It cannot be modified.

Edit Check Box

Indicates that the fields of the task are to be modified. It is set automatically when an editable field of the task is changed. It can also be set manually to reserve the right to modify the task.

When the Edit check box is set, the task is locked against editing by others. The lock is released and the check box is reset when the OK, Apply, Reset, or Cancel buttons are pressed. If the check box is reset manually, after fields have been changed, but before the changes have been saved, a message box appears asking to confirm whether the changes should be discarded.

State Transition Menu

The field labeled State initially displays the current value of the state field. The popup menu contains a list of potential transitions from the current state to successor states (as defined by the state machine in the task kind). Some state transitions listed may not be selectable because the user does not have the necessary task role privileges to perform that transition.

If a state transition is selected, the transition will be attempted when the OK or Apply button is pressed. The state transition will be carried out only if all preconditions associated with that transition (if any, as defined by the state machine) are successfully performed. If the preconditions succeed, then the state field is set to the new state. Finally, any post-actions associated with the transition are executed. Other task fields changed in the dialog are saved regardless of whether a state transition occurs.

Priority Field

Displays the priority of the task. This field has an enumerated field type so its Alternatives icon lists all the field's legal values.

Assigned Field

Displays the user assigned to the task. This field has an enumerated field type so its Alternatives icon lists all the field's legal values.

Summary Field

Displays a single line summary description of the task.

Pages Menu

Lists a number of dialog pages, that can be individually selected to view additional information about the task, that are too large to present all at once. The available pages are:

Description
Related Tasks
Version History Information

The contents of these pages are:

Description Page

Description Field

Displays a detailed description of the task.

Related Tasks Page

Parent Field

Displays the task's parent task, if any. This is a read-only field. Double-clicking on this window will visit the parent task.

Children Field

Displays any child tasks belonging to the task. This field cannot be changed directly, but new children can be added to the list via the File > New > New Task... (Summit/TM) command and with the New Child button. Double-clicking on a child in this list has the same effect as selecting the child and then clicking the Visit button described below.

New Child Button

Pressing this button activates the New Task dialog which can be used to create a new child task for the task.

Visit Button

This button can be used to visit a selected child task or the parent task. The parent task, if any, is visited when no child is selected. The selected task's Task Editor dialog is invoked. The parent or any child can also be visited by double-clicking on the Parent field or on the child in the Children field, respectively.

Version History Information Page

Version History Information Field

Lists all of the controlled object versions which are currently associated with the task. This list cannot be changed directly, but it can be modified via the various Apex commands which check out, check in and abandon controlled object versions as well as the Tasks > Add (Summit/TM) and Tasks > Remove... (Summit/TM) commands.

Double-clicking on a version in this list has the same effect as selecting the version and then clicking the Visit Current button described below.

Visit Current Button

This button can be used to visit the current version of the selected object in the Version History Information field. Note that the version number from the selection is ignored; instead, the current version in the same view is visited.

Show Version Image Button

This button creates a temporary file containing the image of the exact version selected in the Version History Information and visits it. The object name, history number and version number are used to form the name of the temporary file.

Task History Infomation Page

Task_History Field

The Task_History field is a cumulative log of all task state transitions. For every such transition, it records the current date and time, the user who initiated it, and the name of the new state. This history of state transitions is only maintained if certain task domain customization actions are enabled. See the "Metrics and Reports" section of the Rational Summit/TM Command Reference for details.

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