创建文件夹

此子命令用于创建文件夹。

当多次使用某个选项时,查询表达式中每个相同选项均以“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,那么按以下方式使用缺省任务查询:

  • 如果定义了缺省任务查询,那么将使用此任务查询。
  • 如果尚未定义缺省查询,那么将使用任务作用域我的所有已分配且已完成的任务
-n|-name folder_name
指定要创建的新文件夹的名称。folder_name 不能包含换行符。
-plat|-platform platform
指定包含针对指定平台的查询。
-purpose purpose
指定包含针对指定用途的查询。请参阅 project_purpose 命令描述和使用以获取用途的详细描述。

此选项通常适用于使用以下某个作用域指定的组件任务的查询:component_task_projectscomponent_task_productscomponent_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)
指定可修改新文件夹的人员。

示例


反馈