フォルダー・テンプレートの作成

このサブコマンドは、フォルダー・テンプレートを作成します。

同じオプションを複数回使用すると、それぞれのオプションで使用するクエリー式が「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 -c|-create
       [-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)] name
       (ct_projs|ct_projects|component_task_projects) | 
       (ct_prods|ct_products|component_task_products) | 
       (ct_projs_prods|ct_projects_products | 
       component_task_projects_products))] name
-cus|-custom custom_query
指定されたカスタム・クエリー式を新規のフォルダー・テンプレート・クエリーに含めます。
-desc|-description description
フォルダー・テンプレートからフォルダーを作成するときに、キーワード展開後に使用されるストリングを指定します。説明に改行文字を含めることはできません。description を指定しない場合のデフォルト値は、フォルダー・テンプレート名です。キーワード展開について詳しくは、『folder_template コマンド』を参照してください。
-db|-dbid|-database_id database_spec
作成するフォルダー・テンプレートに関連付けられるデータベース ID を指定します。詳しくは、『データベース仕様』を参照してください。
-mode ((man|manual) | (uq|use_query))
フォルダー・テンプレートの内容を、手動またはクエリー・ベースのいずれかに定義します。

クエリーを定義していない場合、デフォルトのタスク・クエリーが使用されます。

-must_be_local
ローカルで作成されたプロジェクトの更新プロパティーに対して、フォルダー・テンプレートがローカル・フォルダーを使用しなければならないように指定します。デフォルトは -nomust_be_local です。
name
作成する新規フォルダー・テンプレートの名前を指定します。name に改行文字を含めることはできません。
-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)
フォルダー・テンプレートを使用して作成されたフォルダーを修正できるユーザーを指定します。指定しない場合は、デフォルト値は owner に設定され、修正できるのはフォルダーの所有者のみになります。


フィードバック