workItemPublisher
The workItemPublisher task publishes work item information to a build result.
The following table contains workItemPublisher task attributes.
Attribute | Description | Required |
---|---|---|
buildResultUUID |
The UUID of the build result to update. The value of this attribute is typically ${buildResultUUID} because the property is built-in when using the Jazz® Build Engine. |
Yes |
filePath |
For the workItemPublisher task, set to the path to a change set file output from the teamAccept task, or a work item file. A work item file must contain work item IDs one per line. The path can be relative to the base directory of the build file or an absolute path. |
Yes |
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 |
componentName |
The name of the component to which this contribution applies. Used for grouping in the user interface. |
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 |
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 |
inputFileType |
For the workItemPublisher task, this flag indicates whether the filePath attribute indicates a change set file or a work item file. Valid values are CHANGESET and WORKITEM. If this attribute is not specified, the task assumes the filePath attribute points to a changeset file. |
No |
integratedWindows |
Whether to use Integrated Windows Authentication |
No |
kerberos |
Whether to use Windows user credentials using Kerberos/SPNeGO. |
No |
password |
Password for the user ID for authentication to the repository. Either password or passwordFile can be provided, but not both. |
No |
passwordFile |
The password file to use for authentication to the connection. 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 listing 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 |
reuseLoginOption |
The first time an Ant task logs in to a repository, a connection is not terminated at the end of this task. All subsequent tasks reuse this connection as long as they connect to same repository with same user ID. When a task logs in to a different repository or with a different user ID, the previous connection is terminated and a new connection is created and reused. |
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 |
verbose |
Specifies more message output. The default is false. |
No |
Example
<workItemPublisher repositoryAddress="${repositoryAddress}"
userId="${userId}"
password="${password}"
buildResultUUID="${buildResultUUID}"
filePath="changesets.txt" />