Modifying a task

You can modify many attributes of a task, such as the synopsis, the platform, the priority, and the resolver. You must have task assignment privileges and be able to modify the task. Modifying any custom attributes (which you may have created on the task type) also requires the assigner role.

About this task

ccm task -mod|-modify [-s|-synopsis synopsis]
         [-desc|-description description]
         [-desc_edit|-descriptionedit|-description_edit]
         [-desc_file|-descriptionfile|-description_file file_path]
         [-desc_replace|-descriptionreplace|-description_replace]
         [-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] task_spec...
-date|-date_estimate date_estimate
Specifies the estimated completion date of the tasks you are creating. If you do not specify the date estimate, it is set to the date estimate of the task you are copying. The date_estimate must be a valid date.
-desc|-description description
Specifies a single-line description. The description cannot contain new line characters.
-desc_edit|-description_edit
Specifies to start the default text editor so you can edit or compose a multiline description.
-desc_file|-description_file file_path
Specifies a path to a file containing a multiline description.
-desc_replace|-descriptionreplace|-description_replace
Specifies to replace the existing task description with the specified description. By default, the description is appended to the existing task description. The description cannot contain new line characters.
-date|-date_estimate date_estimate
Specifies the estimated completion date of the tasks you are creating. If you do not specify the date estimate, it is set to the date estimate of the task you are copying. The date_estimate must be a valid date.
-def|-default|-current
Specifies that the first task created from the task copy will become the current task for this CLI session.
-desc|-description description
Specifies a single-line description. The description cannot contain new line characters.
-desc_edit|-description_edit
Specifies to start the default text editor so you can edit or compose a multiline description.
-desc_file|-description_file file_path
Specifies a path to a file containing a multiline description.
-rel|-release release_spec
Specifies the release for the created tasks. If you do not specify a release, it is set to the release of the task you are copying. You can set the release_spec to one release. For details, see Release specification
-r|-resolver resolver
Specifies which user is responsible for resolving the tasks. If not specified, it is set to the resolver of the task you're modifying. The resolver must be a valid task resolver.
-sub|-subsystem subsystem
Specifies the task subsystem for the created tasks (for example, Any, GUI code, CLI code, or documentation). If you do not specify a subsystem, it is set to the subsystem of the task you are copying. The subsystem must be a valid task subsystem.
-s|-synopsis synopsis
Specifies the synopsis of the task you are copying. The synopsis can be any string without new line characters.
task_spec...
Specifies the tasks to be modified. You can set the task_spec to multiple tasks. For more details, see Task specification.
-time|-time_estimate time_estimate
Specifies the estimated duration or effort to complete the created tasks. If you do not specify a time estimate, it is set to the time estimate of the task you are copying. 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

Change the release for task 68 to 4.1.

ccm task -modify -release 4.1 68


Feedback