查询任务

您可以查询在发布标识中、不在发布标识中,或符合指定查询条件或查询表达式的任务。 使用查询找到的任务可设置查询选择集。

关于此任务

ccm task -qu|-query -in_rel|-in_release [-f|-format format] 
         [-nf|-noformat] ([-ch|-column_header] | [-nch|-nocolumn_header])
         [-sep|-separator separator] ([-sby|-sortby sortspec] |
         [-ns|-nosort|-no_sort]) [-gby|-groupby groupformat] 
         [-u|-unnumbered] old_project_spec project_spec
ccm task -qu|-query -in_rel|-in_release [-f|-format format]
         [-nf|-noformat] ([-ch|-column_header] | [-nch|-nocolumn_header])
         [-sep|-separator separator] ([-sby|-sortby sortspec] |
         [-ns|-nosort|-no_sort]) [-gby|-groupby groupformat] 
         [-u|-unnumbered] project_spec
ccm task -qu|-query -not_in_rel|-not_in_release [-f|-format format]
         [-nf|-noformat] ([-ch|-column_header] | [-nch|-nocolumn_header])
         [-sep|-separator separator] ([-sby|-sortby sortspec] |
         [-ns|-nosort|-no_sort]) [-gby|-groupby groupformat] 
         [-u|-unnumbered] project_spec
ccm task -qu|-query [-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))]
         [-f|-format format] [-nf|-noformat] ([-ch|-column_header] |
         [-nch|-nocolumn_header]) [-sep|-separator separator]
         ([-sby|-sortby sortspec] | [-ns|-nosort|-no_sort])
         [-gby|-groupby groupformat] [-u|-unnumbered]
-ch|-column_header
指定在输出格式中使用列标题。请参阅 -ch|-column_header 以获取详细信息。
-cus|-custom custom_query
指定在查询中包括指定的定制查询表达式。
-db|-dbid|-database_iddatabase_spec
当与 -task_scope 选项结合使用时,指定修改通过任务作用域生成的查询的数据库标识。请参阅 数据库规范 以获取更多详细信息。
-f|-format format
指定命令输出格式。请参阅 -f|-format 以获取详细信息。
-gby|-groupby groupformat
指定如何对命令输出分组。请参阅 -gby|-groupby 以获取详细信息。
-in_rel|-in_release old_project_spec project_spec
显示以 project_spec 作为根的项目层次结构中的所有任务。任务列表通过以下方式确定:收集层次结构中所有对象的所有任务以及这些对象的所有祖代的任务,然后减去以 old_project_spec 作为根的层次结构中相似任务的列表。

如果未指定 old_project_spec,那么不会减去任何任务。在没有基线发布标识时,请指定 old_project_spec(产品的首个发布标识除外)。

-nch|-nocolumn_header
指定不要在输出格式中使用列标题。请参阅 -nch|-nocolumn_header 以获取详细信息。
-nf|-noformat
指定不要使用列对齐。请参阅 -nf|-noformat 以获取详细信息。
-ns|-no_sort
指定不对命令输出排序。请参阅 -ns|-nosort 以获取详细信息。
-not_in_rel|-not_in_release project_spec
显示不在以 project_spec 作为根的项目层次结构中的所有任务。
-plat|-platform platform
指定平台。平台必须是有效平台。
-purpose purpose
指定创建文件夹,方式采用包括指定用途的查询的任务查询。请参阅 project_purpose 命令 显示项目用途 以获取各种用途的详细描述。

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

-rel|-release release_spec
指定发布标识。您可以将 release_spec 设置为一个发布标识。有关详细信息,请参阅发布标识规范
-sep|-separator separator
指定其他分隔符。请参阅 -sep|-separator 以获取详细信息。
-sby|-sortby sortspec
指定如何对命令输出排序。请参阅 -sby|-sortby 以获取详细信息。
-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,那么查询将查找具有指定用途的组件任务。

-u|-unnumbered
禁止对输出自动编号(也就是,输出不带编号)。请参阅 -u|-unnumbered 以获取详细信息。

示例

查询发布标识值设置为 3.0 的任务。 设置输出格式,以便其仅显示任务摘要。

ccm task -qu -rel 3.0 -f "%priority %task_synopsis"

1) high Correct formatting of calculating number
2) high Redesign gui for file open dialog
3) high Performance improvement for file close
4) low  Enhance message text

反馈