修改文件夹模板

使用此子命令可修改文件夹模板。 构建管理员无法修改系统预定义的文件夹模板。

当多次使用某个选项时,查询表达式中每个相同选项均以“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_mgrccm_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
指定与所修改的文件夹模板关联的数据库标识。请参阅数据库规范以获取更多详细信息。
folder_template_spec
指定要修改的文件夹模板。请参阅文件夹模板规范以获取详细信息。
-mode ((man|manual) | (uq|use_query))
指定以手动方式还是通过使用查询来向文件夹添加任务。Rational Synergy 按以下方式处理从手动变为基于查询的方式。
  • 如果将手动文件夹模板更改为基于查询的文件夹模板,并且在修改命令中还定义了查询,那么将使用指定的查询。
  • 如果将手动文件夹模板更改为基于查询的文件夹模板,并且在修改命令中未指定查询:

    * 如果该文件夹模板先前是基于查询的,那么使用其上次的查询。

    * 如果该文件夹模板始终不是基于查询的,并且有用户定义的查询(缺省任务查询),那么用户定义的查询将变为该查询。

    * 如果该文件夹模板始终不是基于查询的,并且没有用户定义的查询(缺省任务查询),那么该查询将变为分配给 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_productscomponent_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)
指定更新文件夹模板的可写特性。 将更新通过文件夹模板创建且受其控制的所有文件夹,以反映新的许可权。

反馈