修改作用域

此子命令可更改脱机保存并删除作用域的特性。

有关 SOAD 作用域以及 SOAD 如何评估作用域的更多信息,请参阅 Save Offline and Delete 作用域

开始之前

ccm_admin 角色工作时可以编辑作用域。

关于此任务

ccm soad_scope|save_offline_and_delete_scope -m|-modify [-roles role] 
        [-parameters parameters] ([-object four_part_object_name] | 
        [-query query]) [-expand|-expansion_rules expansion_rules] 
        [-exclude|-exclusion_rules exclusion_rules] 
        [-exclude_query|-exclusion_query exclusion_query] 
        [-pn|-package_name package_name] scope_name
-exclude|-exclusion_rules exclusion_rules
指定一个或多个排除规则。排除规则将从初始对象列表中除去相关对象。
例如,您的查询将检索指定发布标识的所有对象,并以发布标识名称作为第一个参数 (release='%1')。您可以通过添加排除规则来除去其他项目使用的作用域文件夹和任务,从而限制作用域。另外还可以除去其他文件夹使用的任务或与其他对象关联的任务,其他非静态项目使用的基线,以及属于其他已保存基线的对象。
-expand|-expansion_rules expansion_rules
指定一个或多个扩展规则。扩展规则将向初始对象列表添加相关对象。
例如,您的查询将检索指定发布标识的所有对象,并以发布标识名称作为第一个参数 (release='%1')。可通过添加扩展规则以包括项目的文件夹和任务、文件夹的任务和任务的对象来扩展作用域。
-exclude_query|-exclusion_query "query_expression"
指定用于从作用域中除去对象的查询。
例如,要从作用域中排除具有属性 requirements 的对象,请指定以下查询表达式:
has_attr('requirements')
SOAD 将添加求反子句,而无论其求值的是对象名称、查询还是规则:
and not has_attr('requirements').
-object four_part_name
指定用于初始对象列表的对象的名称(例如 %1)。生成的扩展字符串必须是具有四个部分的有效对象名。
例如,可使用项目对象名(作为第一个参数 %1 输入),将初始对象列表设置为该项目对象名。
-parameters parameters
提供 -object、 -query 和 -exclude_query 的自变量的标签和定义。
例如,为 指定发布标识的所有对象 作用域中所用查询的一个参数标签发布标识值定义如下所示的作用域:
ccm soad_scope -create "All objects for specified release"
-parameters "Release Value" -query "release='%1'" other_options
然后,在 ccm soad -delete 命令中使用此作用域,其中 2.3 是发布标识值:
ccm soad -delete -scope "All objects for specified release" 2.3
-pn|-package_name package_name
指定“脱机保存”包的名称,将为作用域将对象保存到此包。该包名可以包括关键字。
-query query
指定定义初始对象列表的查询表达式。
例如,要使初始对象列表包括当前用户指定发布标识的所有项目和产品,请指定以下查询表达式:
(cvtype='project' or is_product=TRUE) and owner='%user' and
status='working' and release='%1'
-roles role
指定可以使用作用域的角色。缺省情况下,只有以 ccm_admin 角色工作的用户才能更改作用域。
scope_name
为“脱机保存并删除”指定作用域。
请仅使用操作系统不限制的字符。
此名称用作作用域的文件名。空格和标点符号字符将转换为十六进制编码的下划线。例如,如果将作用域命名为 This is my test scope,那么创建的文件名将为 This_0020is_0020my_0020_test_0020scope.xml

反馈