You can create a task and establish a relationship
between it and the task to be fixed. The relationship detects when
a project is using one task without the other, which is called a conflict.
To fix a task with an existing task, see Associating a task with objects, tasks, or change requests.
To fix or enhance a fix task, create another fix task to fix the first
fix task.
The following outlines task requirements
for creating a fix relationship:
- Tasks related to each other can be from different
databases.
- Tasks to be fixed must be in either the completed or excluded state.
- A fix task must be modifiable by the user establishing
the relationship.
- A task can only fix one task.
About this task
ccm task -fix [-exclude] -s|-synopsis synopsis
[-prob|-problem|-change_request change_request_spec]
([-def|-default|-current] | [-register])
[-desc|-description description]
[-desc_edit|-descriptionedit|-description_edit]
[-desc_file|-descriptionfile|-description_file file_path]
[-p|-priority priority] [-plat|-platform platform]
[-r|-resolver resolver] [-rel|-release release_spec]
[-sub|-subsystem subsystem] [-time|-time_estimate time_estimate]
[-date|-date_estimate date_estimate] [-q|-quiet] task_spec...
- -def|-default|-current
- Specifies to set the fix task you are creating as the current
task for this CLI session.
- -desc|-description description
- Specifies a single-line description. The description cannot contain
newline characters.
- -desc_edit|-description_edit
- Specifies to start the default text editor so you can edit or
compose a multi-line description.
- -desc_file|-description_file file_path
- Specifies a path to a file containing a multi-line description.
- -exclude
- Specifies to move the tasks being fixed to the excluded state.
Use this option to exclude them from being automatically included
in future builds.
- -plat|-platform platform
- Specifies the platform. The platform must be a valid platform.
- -p|-priority priority
- Specifies the priority. The priority must be a valid task priority.
The default valid priorities are High, Medium,
and Low.
- -prob|-problem|-change_request change_request_spec
- Specifies to associate the fix task with the specified change
request. The change request must be modifiable by you and in a state
that permits task association. If you do not specify a change request
and the task being fixed is associated with a change request that
is in the assigned state, the new task is also
associated with that change request.
You can set change_request_spec to
one change request. For more details, see Change request specification.
- -quiet
- Specifies that the confirmation messages include only the task
identifier for the fix task.
- -register
- Specifies to create the task in the registered state.
- -rel|-release release_spec
- Specifies the release. You can set release_spec to
one release. For details, see Release specification
- -r|-resolverresolver
- Specifies which user is responsible for resolving the tasks. If
not specified, it is set to the resolver of the task you are fixing.
The resolver must be a valid task resolver.
- -sub|-subsystem subsystem
- Specifies the task subsystem. The subsystem must be a valid task
subsystem.
- -s|-synopsis synopsis
- Specifies the synopsis of the task you are creating. The synopsis
can be any string without newline characters.
- task_spec...
- Specifies the tasks to be fixed. You can set task_spec to
multiple tasks. For more details, see Task specification.
- -time|-time_estimate time_estimate
- Specifies the estimated time to complete the tasks. The time_estimate can
be any string. However, to help with reporting and metrics, be sure
to adopt a consistent convention for format and units.
Example
- Create a relationship
between the fix task (19) and the task to be
fixed (4).
ccm task
-relate 19 -fixes 4
- Break a relationship between the fix task (25)
and the task it fixed (12).
ccm
task -unrelate 25 -fixes 12
- Create a fix task for task 4.
ccm task -fix -s "Create a fix task for task
4" 4
Task 17 created to fix
Task 4.
- Create a fix task and transition the task being
fixed to the excluded state
ccm
task -fix -exclude -s "exclude task 1 and create new for release 1.0"
1
Task 16 created to fix Task
1.