フォルダー・テンプレートの変更

このサブコマンドは、フォルダー・テンプレートを変更するために使用します。 ビルド・マネージャーが、システムの事前定義フォルダー・テンプレートを変更することはできません。

同じオプションを複数回使用すると、それぞれのオプションで使用するクエリー式が「OR」で結合されます。例えば、-release 1.0 -release 2.0 を指定すると、クエリー式は (release='1.0' or release='2.0) になります。

異なる複数のオプションからのクエリー式は、「and」で結合されます。例えば、
-release 1.0 -platform windows と指定すると、クエリー式は (release='1.0') and (platform='windows') となります。

始める前に

フォルダー・テンプレートを変更するには、ユーザーは build_mgr または ccm_admin ロールに属している必要があります。

このタスクについて

ccm ft|folder_temp|folder_template -m|-modify 
        [-w|-writable (owner | (build_mgr|build_manager|buildmanager) |
        all | none)] [-mode ((man|manual) | (uq|use_query))]
        ([-must_be_local] |[-nomust_be_local])
        [-desc|-description description] [-cus|-custom custom_query]
        [(-db|-dbid|-database_id database_spec)...]
        [(-plat|-platform platform)...] [(-purpose purpose)...] 
        [(-rel|-release release_spec)...]
        [(-sub|-subsystem subsystem)...]
        [-ts|-scope|-task_scope (user_defined |
        (all_my_assigned|all_owners_assigned) |
        (all_my_assigned_or_completed|all_owners_assigned_or_completed) |
        (all_my_completed|all_owners_completed) |
        (all_my_tasks|all_owners_tasks) | all_completed | all_tasks)]
        (ct_projs|ct_projects|component_task_projects) | 
        (ct_prods|ct_products|component_task_products) | 
        (ct_projs_prods|ct_projects_products | 
        component_task_projects_products))]
        folder_template_spec...
-cus|-custom custom_query
変更するフォルダー・テンプレート・クエリーに、指定したカスタム・クエリー式を含めるように指定します。
-desc|-description description
フォルダー・テンプレートからフォルダーを変更する場合、キーワード展開の後に使用するストリングを指定します。説明に改行文字を含めることはできません。description を指定しない場合のデフォルト値は、フォルダー・テンプレート名です。キーワード展開について詳しくは、『フォルダー・テンプレート情報の表示』を参照してください。
-db|-dbid|-database_id database_spec
変更するフォルダー・テンプレートに関連付けられたデータベース ID を指定します。詳しくは、『データベース仕様』を参照してください。
folder_template_spec
変更するフォルダー・テンプレートを指定します。詳しくは、『フォルダー・テンプレート仕様』を参照してください。
-mode ((man|manual) | (uq|use_query))
フォルダーに対し、タスクを手動で追加するか、またはクエリーを使用して追加するかを指定します。Rational Synergy は、手動からクエリー・ベースへのモードの変更を以下のように処理します。
  • 手動のフォルダー・テンプレートをクエリー・ベースのフォルダー・テンプレートに変更する場合、クエリーも modify コマンドに定義されていれば、指定されたクエリーが使用されます。
  • 手動のフォルダー・テンプレートをクエリー・ベースのフォルダー・テンプレートに変更し、クエリーがコマンドに指定されていない場合には、以下のようになります。

    * フォルダー・テンプレートが以前はクエリー・ベースだった場合には、その最後のクエリーが使用されます。

    * フォルダー・テンプレートがクエリー・ベースであったことはなく、ユーザー定義クエリー (デフォルト・タスク・クエリー) が定義されている場合には、そのユーザー定義クエリーがクエリーになります。

    * フォルダー・テンプレートがクエリー・ベースであったことはなく、ユーザー定義クエリー (デフォルト・タスク・クエリー) がない場合には、クエリーはyour_user_name に割り当てられたすべてのタスク (All Tasks Assigned to your_user_name)」になります。

-must_be_local
ローカルに作成されたプロジェクトの更新プロパティーにローカル・フォルダーを使用するようにフォルダー・テンプレートを変更します。
-nomust_be_local
ローカルに作成されたプロジェクトの更新プロパティーに非ローカル・フォルダーを使用するようにフォルダー・テンプレートを変更します。
-plat|-platform platform
フォルダー・テンプレート・クエリーを更新するように指定します。新しいクエリーには platform='platform' が組み込まれます。 プラットフォームの選択肢は、CCM_HOME¥etc¥om_hosts.cfg ファイル (Windows の場合)、または $CCM_HOME/etc/om_hosts.cfg ファイル (UNIX の場合) で定義されます。フォルダー・テンプレートを複数のプラットフォームに適用する場合には、プラットフォームの値を設定しないでください。
-purpose purpose
指定した目的のクエリーを含むタスク・クエリーでフォルダーを作成するように指定します。目的について詳しくは、『プロジェクト目的の表示』の project_purpose コマンドを参照してください。

通常このオプションは、スコープ component_task_projectscomponent_task_products、または component_task_projects_products のいずれかで指定されるコンポーネント・タスクのクエリーに適用されます。

-rel|-release release_spec
新しいクエリーでフォルダー・テンプレートを更新するように指定します。このクエリーには release='releasename' が組み込まれます。release_spec を複数のリリースに設定できます。詳しくは、『リリース仕様』を参照してください。
-sub|-subsystem subsystem
新しいクエリーでフォルダー・テンプレートを更新するように指定します。このクエリーには task_subsys='subsystem' が組み込まれます。
-ts|-scope|-task_scope
タスク・クエリーを使用するよう指定します。タスク・クエリーには、指定したスコープに依存するクエリー式が含まれています。指定したスコープに関連付けられたクエリー式は、-database_id オプションにも依存します。 以下のスコープを使用できます。
  • user_defined

    このスコープは、デフォルトのタスク・クエリー・オプションによって定義されます。
    -database_id を指定すると、クエリーには、指定したデータベース内の修正可能なタスクまたは完了したタスクを対象としたクエリー式も含まれます。

  • all_my_assigned|all_owners_assigned

    このスコープのクエリーの対象は、ユーザーに割り当てられたすべてのタスクです。-database_id を指定すると、クエリーはユーザーに割り当てられた、指定したデータベース内で修正可能なすべてのタスクを対象とします。

  • all_my_assigned_or_completed|all_owners_assigned_or_completed

    このスコープのクエリーの対象は、ユーザーに割り当てられたか、またはユーザーが完了したすべてのタスクです。-database_id を指定すると、クエリーは、指定したデータベース内でユーザーに割り当てられた、修正可能なすべてのタスク、または指定したデータベース内でユーザーが完了したすべてのタスクを対象とします。

  • all_my_completed|all_owners_completed

    このスコープのクエリーの対象は、ユーザーが完了したすべてのタスクです。-database_id を指定すると、クエリーは指定したデータベース内でユーザーが完了したすべてのタスクを対象とします。

  • all_my_tasks|all_owners_tasks

    このスコープのクエリーの対象は、ユーザーがタスク担当者であるすべてのタスクです。-database_id を指定すると、クエリーは、ユーザーがタスク担当者となっているタスク、および指定したデータベース内で修正可能なタスクまたは完了したタスクのすべてを対象とします。

  • all_completed

    このスコープのクエリーの対象は、完了したすべてのタスクです。-database_id を指定すると、クエリーは指定したデータベース内で完了したすべてのタスクを対象とします。

  • all_tasks

    このスコープのクエリーの対象は、すべてのタスクです。-database_id を指定すると、クエリーは指定したデータベース内で修正可能なすべてのタスク、または指定したデータベース内で完了したすべてのタスクを対象とします。

  • component_task_projects|component_task_products| component_task_projects_products

    このスコープでのクエリーの対象は、プロジェクト、プロダクト、またはプロジェクトとプロダクト両方のコンポーネント・タスクです。-database_id を指定すると、クエリーは指定したデータベース内に作成されたすべてのコンポーネント・タスクを対象とします。 -purpose を指定すると、クエリーは指定した目的をもつコンポーネント・タスクを対象とします。

-w|-writable (owner | (build_mgr|build_manager|buildmanager) | all | none)
フォルダー・テンプレートの書き込み可能プロパティーを更新するように指定します。 フォルダー・テンプレートから作成され、フォルダー・テンプレートによって制御されるすべてのフォルダーが、新しい許可を反映して更新されます。

フィードバック