The task is used to retrieve a list of semicolon-separated build definition IDs from the Jazz™ repository for a given process area. The list can be limited to a single type of build definition by specifying the ID of the template for the desired build definition type. The list can be used as input to the AntContrib for task to process a series of build definitions defined to a process area with the other Build Extensions Build Definition tasks.

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
processAreaName The name of the EWM™ process area where the builds are defined.

Note: When the process area is a child of a parent process area, like a team area, specify the processAreaName in path format starting with the project area name. For example: /project_area_name/team_area_name/subteam_area_name

Yes
property The name of the Ant property in which to return the build definitions IDs. Yes
templateId Specify the template ID or template alias for the build definitions that are to be retrieved. See the Build Reference section for more information on build template IDs or template aliases. No

Notes

Examples

Get build definitions 

<target name="get" description="Get Build Definitions">
  
  <xt:getbuilddefinitions
    repositoryAddress="${repositoryAddress}"
    userId="${userId}"
    password="${password}"
    processAreaName="${processAreaName}"
    property="ids"
  />
  
  <echo>${ids}</echo>
  
  <xt:getbuilddefinitions
    repositoryAddr  ss="${repositoryAddress}"
    userId="${userId}"
    password="${password}"
    processAreaName="${processAreaName}"
    property="ids"
    templateId="com.ibm.team.enterprise.zos.build.dependency.template"
  />
  
  <echo>${ids}</echo>
  
  <xt:getbuilddefinitions
    repositoryAddress="${repositoryAddress}"
    userId="${userId}"
    password="${password}"
    processAreaName="${processAreaName}"
    property="ids"
    templateId="z/OS Dependency Build - Rational Build Agent"
  />
  
  <echo>${ids}</echo>
  
</target>

Result: 

[echo] Setup 703 dependency build;Setup 703 packaging;Setup 703 deployment;Setup 703 L2 dependency build;Setup 703 promotion;
[echo] Setup 703 dependency build;Setup 703 L2 dependency build;
[echo] Setup 703 dependency build;Setup 703 L2 dependency build;