此子命令可创建发布标识定义。
要为新应用程序或组件创建发布标识,您可以使用唯一组件名称或不使用组件名称。
要基于先前发布标识来创建发布标识,请使用 -from 选项。缺省情况下,使用流程规则以及与先前发布标识中所用特性相对应的其他特性来创建新发布标识。新发布标识还是其所基于的发布标识的后继。先前发布标识用作基线发布标识。
开始之前
您必须是 build_mgr 或 ccm_admin 角色才能使用此子命令。
关于此任务
ccm release -c|-create [-from release_spec] [-bl|-baseline release_spec]
[-desc|-description description]
[-desc_edit|-descriptionedit|-description_edit]
[-desc_file|-descriptionfile|-description_file file_path]
[-manager manager] ([-active] | [-inactive])
([-allow_dcm_transfer] | [-noallow_dcm_transfer])
[-allow_parallel_check_out] [-noallow_parallel_check_out]
[-allow_parallel_check_in] [-noallow_parallel_check_in]
[-groups groups] ([-included_releases included_releases] |
[-included_releases_file included_releases_file])
[-phase phase] ([-process process_spec] |
[(-process_rule process_rule_spec)...])
([-cct|-create_component_tasks] | [-nocct|-nocreate_component_tasks])
release_spec
- -active
- 指定发布标识处于活动状态。此设置是缺省值。
- -allow_dcm_transfer
- 指定发布标识如果包括在发布标识作用域中且查询传输集,那么就有资格进行 DCM 复制。在为新组件创建发布标识时,此选项缺省为 true。当基于先前发布标识创建发布标识时,新发布标识所基于的发布标识的设置为缺省值。
- -allow_parallel_check_in
- 指定允许并行检入带有此发布标识的对象。在创建发布标识时,此设置是缺省值。当基于先前发布标识创建发布标识时,新发布标识所基于的发布标识的设置为缺省值。您必须将 parallel check in 与 parallel
check out 组合使用。
- -allow_parallel_check_out
- 指定允许并行检出带有此发布标识的对象。在创建发布标识时,此设置是缺省值。当基于先前发布标识创建发布标识时,新发布标识所基于的发布标识的设置为缺省值。您必须将 parallel check in 与 parallel
check out 组合使用。
- -baseline release_spec
- 指定用作新发布标识基线的发布标识。当基于先前发布标识创建发布标识时,缺省情况下,先前发布标识将用作基线。在为新组件创建发布标识时,缺省基线发布标识为空。
- -cct|-create_component_tasks
- 指定在为所创建的发布标识定义创建基线时,创建相应的组件任务。例如,如果要创建发布标识定义,并且知道您的团队需要组件任务,请使用此选项。在创建基线时,将自动创建组件任务。此设置是缺省值。
- -desc|-description description
- 指定发布标识的描述。您可以使用转义序列来包括换行符和其他字符。或者也可以使用 -description_file 或 -description_edit 来指定多行描述。如果同时使用 -description、-description_file 和 -description_edit,那么描述将采用 -description 选项值,附加从 -description_file 所指定的文件中读取的描述,并启动当前缺省文本编辑器来显示注释。然后,通过该编辑器保存的文本将用于设置描述。
- -desc_edit|-description_edit
- 启动当前文本编辑器,从而允许以交互方式编辑或组成发布标识描述。通过文本编辑器保存的结果将用于设置描述。请参阅 -desc|-description。
- -desc_file|-description_file file_path
- 指定包含描述的文件的路径。
- -from release_spec
- 指定新发布标识所基于的发布标识。当基于先前发布标识创建发布标识时,该发布标识的许多新设置将从先前发布标识中复制。缺省情况下,先前发布标识将用作基线发布标识。
- -groups groups
- 指定可以修改新发布标识或从其创建后续发布标识的组。当基于先前发布标识创建发布标识时,缺省情况下,新发布标识将与其所基于的发布标识使用相同的组。组值是一列用空格或逗号分隔的一个或多个组名。
- -inactive
- 指定新发布标识处于非活动状态。不活动的发布标识无法被开发者用于开发工作。缺省情况下,新发布标识将创建为活动发布标识。
- -included_releases included_releases
- 指定要包括在发布标识中的一个或多个发布标识。此字符串支持用逗号(和可选空格)分隔的多个发布标识。逗号是必需的;但是不支持带有前导空格或尾随空格的发布标识。或者也可以使用 included_releases_file 选项,并通过文件输入数据。
- 缺省情况下,包括的发布标识仅用于基于对象状态的更新。包括的发布标识用于在更新成员运行期间计算选择得分。
- -included_releases_file file_path
- 指定文件的路径,该文件包含要包括的发布标识。
- -manager manager
- 指定发布标识的产品或组件管理器。创建时的缺省值是创建发布标识定义的用户,且只能是一行字符串。
- -noallow_dcm_transfer
- 指定发布标识没资格进行 DCM 复制。在为新组件创建发布标识时,缺省情况下,该发布标识有资格进行复制。当基于先前发布标识创建发布标识时,新发布标识所基于的发布标识的设置为缺省值。
- -noallow_parallel_check_in
- 指定不允许并行检入带有此发布标识的对象。在创建发布标识时,缺省情况下允许并行检入。当基于先前发布标识创建发布标识时,新发布标识所基于的发布标识的设置为缺省值。您必须将并行检入与并行检出组合使用。
- -noallow_parallel_check_out
- 指定不允许并行检出带有此发布标识的对象。在创建发布标识时,缺省情况下允许并行检出。当基于先前发布标识创建发布标识时,新发布标识所基于的发布标识的设置为缺省值。您必须将并行检入与并行检出组合使用。
- -nocct|-nocreate_component_tasks
- 指定在为所创建的发布标识定义公布基线时,不自动创建组件任务。为发布标识公布基线后,您可以使用为基线创建组件任务子命令手动创建组件任务。
- -phase phasename
- 指定新发布标识的发布标识阶段。缺省情况下,新发布标识以发布标识阶段 New 创建。有效的发布标识阶段在模型属性中定义。出厂缺省值包括 New、Requirements Definition、Function Definition、Implementation、Validation 和 Released。指定的值必须与一个有效的发布标识阶段值匹配,且区分大小写。
- -process process_spec
- 指定发布标识的创建流程。与指定流程的一般流程规则关联的特定于发布标识的流程规则将与新发布标识关联。如果不存在任何特定于发布标识的流程规则,那么将创建这些规则。
- release_spec
- 指定要创建的新发布标识的名称。
示例
- 使用 alphabets/1.0 中的特性创建新发布标识 alphabets/2.0。
Windows:
ccm release -create "alphabets/2.0"
-from "alphabets/1.0" -description_file c:\alphabets_2\features.txt
UNIX:
ccm release -create "alphabets/2.0"
-from "alphabets/1.0" -description_file /usr/john/alphabets_2/features.txt
- 为新组件创建发布标识(不基于现有发布标识),名为 harmony/1.0。
ccm
release -create "harmony/1.0" -desc "new product line to integrate
X and Y" -manager "sue" -active -noallow_dcm_transfer