フォルダーの作成

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

同じオプションを複数回使用すると、それぞれのオプションで使用するクエリー式が「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') になります。

このタスクについて

ccm folder -cr|-create -n|-name folder_name ([-qu|-query] |
          [-mode ((man|manual) | (uq|use_query))])
          [-w|-writable (owner | (build_mgr|build_manager|buildmanager) |
          all | none)] [-q|-quiet] [-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))]
-cus|-custom custom_query
指定されたカスタム・クエリー式を新規フォルダー・クエリーに含めるように指定します。
-db|-dbid|-database_id database_spec...
-task_scope オプションと併用して、タスク・スコープから生成されるクエリーを変更するデータベース識別子を指定します。詳しくは、『データベース仕様』を参照してください。
-mode ((man|manual) | (uq|use_query))
新規フォルダーに手動でタスクを追加するか、クエリーを使用してタスクを追加するかを指定します。

-mode または -query を指定しない場合、デフォルト・モードは、クエリー関連のオプションを指定するかどうかで異なります。-custom-dbid-platform-release
-subsystem-task_scope を指定した場合、デフォルト・モードは、クエリー・ベースです。これらのオプションのいずれも指定しない場合、デフォルトは、手動でのフォルダーへのタスクの追加になります。

-mode use_query または -query を指定したが、-custom-dbid
-platform-release-subsystem、または -task_scope を指定しない場合、デフォルトのタスク・クエリーは、次のようになります。

  • デフォルトのタスク・クエリーを定義済みの場合、それが使用される。
  • デフォルト・クエリーを定義していない場合は、タスク・スコープ「割り当てたタスクおよび完了済みタスクのすべて (All my assigned and completed tasks)」が使用される。
-n|-name folder_name
作成する新規フォルダーの名前を指定します。folder_name に改行文字を含めることはできません。
-plat|-platform platform
指定されたプラットフォームのクエリーを含めるように指定します。
-purpose purpose
指定された目的のクエリーを含めるように指定します。目的の詳細については、project_purpose コマンドの説明と用途を参照してください。

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

-qu|-query
新規フォルダーをクエリー・ベースにします (
-mode use_query を使用する場合と同じになります)。詳しくは、『-mode ((man|manual) | (uq|use_query))』を参照してください。
-q|-quiet
作成されたフォルダーの表示名のみを表示するように指定します。表示名には、有効なフォルダー仕様が表示されます。
-rel|-release release_spec
指定されたリリースに対するクエリーを含むタスク・クエリーを作成するように指定します。release_spec を複数のリリースに設定できます。詳しくは、『リリース仕様』を参照してください。
-sub|-subsystem 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)
新規フォルダーを変更できるユーザーを指定します。


フィードバック