The task is used to identify a group of resources, such as files belonging to a language, and invoke their compile process. It is included in the generated.xml build script for an Enterprise Extensions Dependency Build.

Attributes

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
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. Yes

Buildable Resource Collection

A buildableSet element, which contains a buildable resource collection, must be specified within the element. The buildableSet resource collection is a complete list of buildable files for the build. A resource selector is required to determine which resources in the list are to be processed for a particular compile. Both the resource collection and the resource selector are specified within an Ant restrict element for the task. The following example will select all files in the build that have been assigned to the "ASM" language: 

<restrict>
  <antz:buildableset refid="buildableFileSet"/>
  <antz:langdefselector name="ASM"/>
</restrict>

The following table describes the valid buildableSet element attributes and their options:

Resource Collection Element Attributes
Attribute Description Required
refid Specifies the reference ID for the buildable set that has been generated prior to the invocation of the task. Yes

Resource Selection Elements

One resource selection element must be specified within the restrict element. A resource selection element selects buildable resources based on a criteria. There are four defined resource selection elements defined for the Dependency Build process:

componentSelector The component selector is a resource selector for selecting buildable resources based on the containing SCM component for the resource.
langCodeSelector The language code selector is a resource selector for selecting buildable resources based on the language code for the EE language definition associated with the resource.
langDefSelector The language definition selector is a resource selector for selecting buildable resources based on the name of the EE language definition associated with the resource.
projectSelector The project selector is a resource selector for selecting buildable resources based on the containing EWM project for the resource.

The following table describes the valid resource collection element attributes and their options:

Resource Selection Element Attributes
Attribute Description Required
name

The following describes the value for the name attribute for each of the collector types:

Collector: Value for name:
componentSelector Pattern for the component name.
langCodeSelector Pattern for the language code.
langDefSelector Pattern for the language name.
projectSelector Pattern for the project name.

Patterns are strings against which the resource will be compared. Valid patterns may contain an asterisk (*) representing a string of characters or a question mark (?) representing a single character.

Yes
caseSensitive Specifies whether or not the name attribute is case sensitive. Valid values are true or false. The default is true. No

Notes

Examples

Compile a language: 

<antz:compile
    buildResultUUID="${buildResultUUID}"
    failOnError="false"
    passwordFile="${passwordFile}"
    repositoryAddress="${repositoryAddress}"
    userId="${userId}">
  <restrict>
    <antz:buildableset refid="buildableFileSet"/>
    <antz:langdefselector name="SCRIPT"/>
  </restrict>
</antz:compile>