requestTeamBuild

The requestTeamBuild task requests a build using a specified build definition. There must be an active engine that supports the build definition in order for the request to succeed.

The table below describes requestTeamBuild task attributes.

Attribute Description Required

buildDefinitionId

For the requestTeamBuild task, the identifier of the build definition to use.

Yes

repositoryAddress

Address of the team repository to use. The value of this attribute is typically ${repositoryAddress} because that property is built-in when using the Jazz Build Engine.

Yes

userId

User ID to use.

Yes

deletePropertiesFile

Path to a properties file. This properties file specifies properties that should be omitted when the build is run. The properties are assumed to exist in the build definition. The path can be a relative path from the base directory of the build file or a full path.

No

failOnError

If true (the default), the task fails if it encounters an error. If false, some errors are ignored and the task is completed.

No

overridePropertiesFile

Path to a properties file. This properties file can add new properties or override existing properties in the build definition. The path can be a relative path from the base directory of the build file or a full path.

No

password

Password for the user ID, a zero-length string by default unless specified.

No

passwordFile

The password file to use for the connection. You can create a suitable password file by invoking the Jazz Build Engine with the -createPasswordFile argument. You can only specify one password file.

No

requestUUIDProperty

Stores the UUID of the retrieved build request. It is set only if a request is found.

No

verbose

Specifies more message output. The default is false.

No

Example

<requestTeamBuild repositoryAddress="${repositoryAddress}"
		                  userId="${userId}"
		                  password="${password}"
		                  buildDefinitionId="${buildDefinitionId}" />

Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug