修改文件夹

此子命令可修改指定文件夹。您必须可以修改这些文件夹。

当定义文件夹查询时,-custom-platform-release-subsystem
-task_scope 选项都会影响最终生成的任务查询。可以多次使用
-platform-release-subsystem 选项。当多次使用某个选项时,查询表达式中每个相同选项均以“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')-task_scope 选项还会导致根据指定作用域进行任务查询,这个选项可由任何指定的 -database_id 选项进行修改。最终的任务查询会在一个查询表达式中将所有这些元素组合在一起。

关于此任务

ccm folder -m|-modify [-n|-name folder_name]
          [-mode ((man|manual) | (uq|use_query))]
          [-w|-writable (owner | (build_mgr|build_manager|buildmanager) | 
          all | none)] [-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))]
          [(-at|-add_task|-add_tasks task_spec)...]
          [(-rt|-remove_task|-remove_tasks task_spec)...]
          [-related] [-up|-update] folder_spec...
-at|-add_task|-add_tasks task_spec
向指定文件夹添加指定任务。请参阅任务规范以获取详细信息。
-cus|-custom custom_query
指定将文件夹查询更新为包括指定的定制查询表达式。
-db|-dbid|-database_id database_spec
当与 -task_scope 选项结合使用时,指定数据库标识,它会修改根据任务作用域生成的查询。请参阅 -task_scope数据库规范以获取更多详细信息。
folder_spec
指定要修改的文件夹。请参阅文件夹规范以获取详细信息。
-mode ((man|manual) | (uq|use_query))
指定要将文件夹修改为手动添加任务还是通过使用查询来添加。

如果将文件夹从手动修改为基于查询,并且未定义任务查询,以及未指定任何可用选项,那么文件夹将按基于查询(按如下所示定义的缺省任务查询)的方式来创建。

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

此选项通常适用于使用以下某个作用域指定的组件任务的查询:component_task_projectscomponent_task_productscomponent_task_projects_products

-related
请仅将此选项与 -at|-add_task|-add_tasks 选项或 -rt|-remove_task|-remove_tasks 选项结合使用。当与 -at|-add_task|-add_tasks 选项结合使用时,将添加指定任务的相关任务。在与 -rt|-remove_task|-remove_tasks 选项结合使用时,将除去指定任务的相关任务。
-rel|-release release_spec
指定将文件夹查询更新为使用针对指定发布标识的查询表达式。可以将 release_spec 设置为多个发布标识。请参阅发布标识规范以获取详细信息。
-rt|-remove_task|-remove_tasks task_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,那么查询将查找具有指定用途的组件任务。

-up|-update
指定通过运行文件夹查询来更新基于查询的文件夹。如果指定的文件夹不是基于查询,将报告错误。
-w|-writable (owner | (build_mgr|build_manager|buildmanager) | all | none)
指定可以修改指定文件的人。

示例


反馈