タスクを作成し、そのタスクと修正対象のタスクとの間に関係を作成できます。プロジェクトが一方のタスクを使用して他方を使用しないことをコンフリクトと呼びますが、この関係によってコンフリクトが検出されます。
あるタスクを既存のタスクによって修正するには、オブジェクト、タスク、または変更依頼とタスクとの関連付けを参照してください。修正タスクを修正または拡張するには、最初の修正タスクを修正するための別の修正タスクを作成します。
修正関係を作成するためのタスク要件の概要は以下のとおりです。
- 異なるデータベースのタスクを相互に関連付けることができる。
- 修正対象のタスクは completed または excluded の状態になっている必要がある。
- 修正タスクは、関係を設定したユーザーにより修正可能でなければならない。
- 1 つのタスクで修正できるタスクは 1 つだけです。
このタスクについて
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
- 作成する修正タスクをこの CLI セッションのカレント・タスクとして設定することを指定します。
- -desc|-description description
- 単一行の説明を指定します。説明に改行文字を含めることはできません。
- -desc_edit|-description_edit
- 複数行の説明を編集または作成するために、デフォルトのテキスト・エディターが起動されるように指定します。
- -desc_file|-description_file file_path
- 複数行の説明を含むファイルへのパスを指定します。
- -exclude
- 修正対象のタスクを excluded 状態に移行することを指定します。このオプションを使用して、これらのタスクが自動的に将来のビルドに組み込まれないよう除外します。
- -plat|-platform platform
- プラットフォームを指定します。有効なプラットフォームを指定する必要があります。
- -p|-priority priority
- 優先度を指定します。有効なタスク優先度を指定する必要があります。デフォルトの有効なタスク優先度は、High、Medium、および Low です。
- -prob|-problem|-change_request change_request_spec
- 指定された変更依頼に修正タスクを関連付けることを指定します。変更依頼は、ユーザー自身で修正可能であり、タスクの関連付けが可能な状態でなければなりません。変更依頼を指定せず、assigned 状態の変更依頼に修正対象タスクが関連付けられている場合、新規タスクもその変更依頼に関連付けられます。
change_request_spec は、1 つの変更依頼に設定できます。詳しくは、『変更依頼仕様』を参照してください。
- -quiet
- 確認メッセージに修正タスクのタスク ID だけを組み込むことを指定します。
- -register
- registered 状態でタスクを作成するように指定します。
- -rel|-release release_spec
- リリースを指定します。release_spec は、1 つのリリースに設定できます。詳しくは、『リリース仕様』を参照してください。
- -r|-resolver resolver
- タスクの解決を担当するユーザーを指定します。指定されていない場合、修正対象のタスクの担当者に設定されます。resolver は有効なタスク担当者でなければなりません。
- -sub|-subsystem subsystem
- タスク・サブシステムを指定します。有効なタスク・サブシステムを指定する必要があります。
- -s|-synopsis synopsis
- 作成するタスクの概要を指定します。概要には、改行文字を含まない任意のストリングを指定できます。
- task_spec...
- 修正対象のタスクを指定します。task_spec は、複数のタスクに設定できます。詳しくは、『タスク仕様』を参照してください。
- -time|-time_estimate time_estimate
- タスクの完了予定時間を指定します。time_estimate には、任意のストリングを指定できます。ただし、レポートとメトリックに役立てるためには、形式と単位に一貫性のある規則を採用するようにしてください。
例
- タスク 4 の修正タスクを作成します。
ccm task -fix -s "Create a fix task for task 4" 4
Task 17 created to fix Task 4.
- 修正タスクを作成し、修正対象タスクを excluded 状態に遷移させます。
ccm task -fix -exclude -s "exclude task 1 and create new for release 1.0" 1
Task 16 created to fix Task 1.