创建文件夹模板

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

当多次使用某个选项时,查询表达式中每个相同选项均以“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 -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
指定与所创建的文件夹模板关联的数据库标识。请参阅Database specification以获取更多详细信息。
-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_productscomponent_task_projects_products

-rel|-release release_spec
为从文件夹模板创建的文件夹指定包含 release='releasename' 的查询。您可以将 release_spec 设置为多个发布标识。请参阅Release specification以获取更多详细信息。
-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,并且仅文件夹所有者可以修改文件夹。

示例


反馈