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 fix only 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 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.