![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Task Editor Dialog BoxWhen 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 InformationThe contents of these pages are:
Displays a detailed description of the task.
Displays the task's parent task, if any. This is a read-only field. Double-clicking on this window will visit the parent task.
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.
Pressing this button activates the New Task dialog which can be used to create a new child task for the task.
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.
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.
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.
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
Rational Software Corporation http://www.rational.com support@rational.com techpubs@rational.com Copyright © 1993-2001, Rational Software Corporation. All rights reserved. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |