Team Build Attributes

The Team Build Attributes are common to all Build Extensions Ant tasks that extend the AbstractTeamBuildTask; any task that communicates with the Jazz™ server.

Attributes

The following table describes the Team Build Attributes:

Attribute Description Required
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 for authentication to the repository. Requires password or passwordFile to be set. Yes
password Password for the user ID for authentication to the repository. Either password or passwordFile can be provided, but not both. No
certificateFile The path to the file that contains the user’s login certificate for authentication. Requires password or passwordFile to be set. You can specify certificateFile or repositoriesFile, but not both. No
integratedWindows Whether to use Integrated Windows Authentication (true or false). No
kerberos Whether to use Windows user credentials using Kerberos/SPNeGO (true or false). No
passwordFile The password file to use for authentication to the repository. You can create a suitable password file by invoking the Jazz Build Engine with the -createPasswordFile argument. You can only specify one password file. Either password or passwordFile can be provided, but not both. No
repositoriesFile The repositories registry file containing a list of repositories and their login credentials. You can specify repositoriesFile or certificateFile, but not both. If you specify repositoriesFile, do not specify either password or passwordFile. The repositories file is created and updated through the use of SCM login and logout commands. No
smartCard Whether to use the connected smart card for authentication (true or false). Requires userId to be set. For more information about smart card authentication, see Connecting to repositories and project areas. 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
reuseLoginOption The first time an Ant task logs into a repository, a connection is created which is not terminated at the end of the task. All subsequent tasks reuse this connection as long as they connect to the same repository with the same user ID. When a task logs into a different repository, or uses a different user ID, the previous connection is terminated and a new connection is created and reused. Valid values: true or false. No
verbose Specifies more message output (true or false). The default is false. No

Login Attribute Combinations

Each login method requires a unique set of attributes. The following summarizes those requirements: