startBuildActivity 任务为一个构建启动新的构建活动。在任何时候,一个构建都可以有多个进行中的活动。您可以水平地组织活动。启动活动时,可以为其指定现有的父活动。可以显式地完成活动(请参阅 completeBuildActivity),也可以通过设置 autoComplete 属性自动完成活动。
下表描述 startBuildActivity 任务属性。
| 属性 | 描述 | 必需 |
|---|---|---|
buildResultUUID |
要更新的构建结果的 UUID。此属性的值通常是 ${buildResultUUID},这是因为,使用 Jazz Build Engine 时,此属性是内置的。 |
是 |
repositoryAddress |
要使用的团队存储库的地址。此属性的值通常是 ${repositoryAddress},这是因为,使用 Jazz Build Engine 时,此属性是内置的。 |
是 |
userId |
要使用的用户标识。 |
是 |
label |
对于 startBuildActivity,这是用于描述构建活动的标签。如果未指定此属性,那么 activityID 的值将用作标签。 |
是 |
activityIdProperty |
存储新启动的活动的唯一标识。仅当调用程序打算显式地使用 completeBuildActivity 任务来完成此活动,或者将此活动用作子活动的父代时,此属性才是必需的。 |
否 |
autoComplete |
对于 startBuildActivity 任务,指定在下列任何情况下是否自动完成活动:父活动完成、下一个对等活动启动或者构建完成。缺省值为 false。 |
否 |
failOnError |
如果设置为 true(缺省值),那么任务遇到错误时将失败。如果设置为 false,那么某些错误将被忽略,任务将完成。 |
否 |
parentActivityID |
要用作父代的现有活动的标识。具有此标识的活动必须存在,并且不能已完成。 |
否 |
password |
用户标识的密码,缺省情况下,除非另有指定,否则是长度为零的字符串。 |
否 |
passwordFile |
用于建立连接的密码文件。您可以通过在调用 Jazz Build Engine 时指定 -createPasswordFile 参数来创建适当的密码文件。只能指定一个密码文件。 |
否 |
verbose |
指定更多消息输出。缺省值为 false。 |
否 |
<startBuildActivity repositoryAddress="${repositoryAddress}"
userId="${userId}"
password="${password}"
activityIdProperty="activityId"
label="compiling"
autoComplete="false"
verbose="true"
buildResultUUID="${buildResultUUID}" />