The task is used to update the specified build results. The buildResultAttribute elements specified within the element designate which build result attribute to update and the new value for that attribute.
The task supports Team Build Attributes, Build Extensions Debugging Attributes, Build Extensions General Attributes, as well as, its own task specific attributes. Click on a link for more information on the common attributes.
The following table describes the task specific attributes for the task:
| Task Specific Attributes | ||
| Attribute | Description | Required |
| buildId | The ID of a build definition. The buildId is used to retrieve all build results for a particular build. All results found for the build will be updated. Either buildId or buildResultUUID can be provided, but not both. | No |
| buildResultUUID | The UUID of the build result. The value of this attribute is typically ${buildResultUUID} because the property is built-in when using the Jazz Build Engine. The ${buildResultUUID} property will be automatically retrieved from the Ant environment if this attribute is not specified. This attribute is used to identify the build result to update. Either buildId or buildResultUUID can be provided, but not both. | No |
A BuildResultAttribute element is specified within the setBuildResult element. Each BuildResultAttribute element identifies a build result attribute value to change. At least one BuildResultAttribute element is required. The following table describes the valid BuildResultAttribute attribute values:
| BuildResultAttribute Attributes | ||
| Attribute | Description | Required |
| name | Name of the build result attribute. | Yes |
| value | New value for the build result attribute. | Yes |
The following table describes the valid build result attributes and the required values for those attributes:
| Build Result Attributes | ||
| Attribute Name | Required Value | Notes |
| buildId | ID of a build definition | The build result is assigned to the specified build definition. |
| deleteAllowed |
truefalse
|
The build result delete allowed setting is updated to the specified value. |
| ignoreWarnings |
truefalse
|
The build result ignore warnings setting is updated to the specified value. |
| label | Text string to be used as the build result label | The build result label is updated to the specified value. |
| personalBuild |
truefalse
|
The build result personal build setting is updated to the specified value. |
| status |
OKINFOWARNINGERROR
|
The build result status is updated to the specified value. |
| tags | Text strings to be used as build result tags | The build result tags are updated to the specified value. |
BuildStatus.ERROR, it cannot be set to BuildStatus.OK. When a result is created, its status is initialized to BuildStatus.OK. Throughout a build, as contributions are added to a result, the result’s status may be updated to a more severe status, but not a less severe status.
Set a build result warning regardless of ignore warnings setting
<xt:setbuildresult
repositoryAddress="${repositoryAddress}"
userId="${userId}"
passwordFile="${passwordFile}"
buildResultUUID="${buildResultUUID}">
<xt:buildresultattribute name="status" value="WARNING"/>
<xt:buildresultattribute name="ignoreWarnings" value="false"/>
</xt:setbuildresult>