The task is used to determine if a workspace name is unique.
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 |
| name | The name for the workspace. If name is not specified, the name of the workspace identified by workspaceUUID attribute will be used. | Yes |
| property | The name of the Ant property in which to return the result. If the workspace name is unique, there is one and only one workspace with the specified name, the property is set to true. Otherwise, the property value is set to false. | Yes |
| workspaceUUID | The UUID of the workspace. The value of this attribute is typically ${team.scm.workspaceUUID} because the property is built-in when using the Jazz Build Engine. | No |
| zeroOrOne | Specify true to adjust the result logic to allow no workspaces with the name to be valid. If true is specified and the workspace name is unique - there is only one workspace with the specified name or there are no workspaces with the specified name - then the result property is set to true. This option is useful when attempting to pre-determine if a workspace name will be unique. This attribute is optional. The default is false. | No |
Check if workspace name is unique
<target name="main">
<xt:isworkspacenameunique
repositoryAddress="${repositoryAddress}"
userId="${userId}"
passwordFile="${passwordFile}"
name="IMS14.Service.Buildspace.PI12345"
property="my.property"
workspaceUUID="${team.scm.workspaceUUID}"
/>
<echo>${my.property}</echo>
</target>