Copying a task

You can create tasks by copying specified tasks. Copy a task to apply a task that you fixed for one release to a different release. The copied task and the original task might have the same associated objects, different associated objects, or a combination. By default, the objects associated with the existing task are also associated with the corresponding copied task.

About this task

ccm task -cp|-copy [-no_objects] -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...
-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 to make the first task created from the task copy the current task for this CLI session.
-desc|-description description
Specifies a single-line description. The description cannot contain newline characters. The description field is not populated from the source task. If you do not specify the description, it means that the description is blank.
-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.
-no_objects
Specifies that the objects associated with the copied task are not associated with the task created by the copy.
-p|-priority priority
Specifies the priority of the new tasks. If you do not specify the priority, it is set to the priority of the task you are copying. The priority must be a valid task priority. The default valid priorities are High, Medium, and Low.
-plat|-platform platform
Specifies the platform of the tasks being created. If you do not specify the platform, it is set to the platform of the task you are copying. The platform must be a valid platform.
-prob|-problem|-change_request change_request_spec
Specifies to associate the new task with the specified change request. The change request must be modifiable by you and in a state that permits task association. You can set change_request_spec to one change request. For more details, see Change request specification. If you do not specify a change request and the task you are copying is associated with a change request that is in the assigned state, the new task is also associated with that change request.
-quiet
Specifies that the confirmation messages include only the task identifier for each task created.
-register
Specifies to create the task in the registered state. (A task in this state is entered in Synergy, but is not assigned to anyone.) If you do not specify -register, the task is assigned to the same user as the source task or to the user specified by the
-resolver option.
-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 are copying. 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 newline characters.
task_spec...
Specifies the tasks to be copied. 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

Copy task 40, and specify a different synopsis, release, resolver, and description. Do not copy the objects associated with it.

ccm task -copy 40 -synopsis "Fix GUI color problem" -release 2.0 -resolver donho -no_objects -description "check RGB module"

Task hawaii#50 created.


Feedback