Properties that you define in the build definition or build engine are written to the output properties file that you specify in the Properties file field in the build definition (for Command Line and Ant builds), and are automatically available to Ant scripts (for Ant builds).
You can use variables in property values by specifying the ${propertyName} format. For example, if you create a build engine property named toolsdir with a value of /home/build/tools, you can reference the property as ${toolsdir} from property fields in the Build Definition editor. Before the build starts, the Jazz™ Build Engine substitutes the property variables and their substituted form is provided to the build script.
| Property name | Description |
|---|---|
buildLabelPrefix |
Specifies a prefix for the build label, such as I for integration. If you define this property in your build definition or build engine, the value is prepended to the label that the Jazz Build Engine generates. For example, I20080215-1234. |
There are several built-in properties available when you use the Jazz Build Engine. You need to use these properties if you use the Jazz Ant tasks to publish information to the repository. For example, you need the repositoryAddress and buildResultUUID properties to use the StartBuildActivityTask.
The table below describes built-in properties that are available when you use the Jazz Build Engine.
| Attribute | Description |
|---|---|
buildLabel |
The build label that was generated by the Jazz Build Engine. For example, 20080215-1234. |
buildResultUUID |
The unique identifier for the build result. Any task that publishes progress or information to a build result must provide this attribute. The value for the attribute is passed to your build script in the ${buildResultUUID} Ant property. For example, you typically see it used like this in the Ant script: buildResultUUID="${buildResultUUID}". |
requestUUID |
The unique identifier for the build request. |
buildDefinitionId |
The friendly identifier for the build definition (not the UUID). |
repositoryAddress |
The address of the Jazz repository where the build request originated. For example, http://example.com/jazz. |
* |
All properties defined in the build engine editor are available to the Ant script. |
* |
All properties defined in the Properties tab of the build definition editor are available to the Ant script. These properties override the build engine properties if there is a property name conflict. |