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