The task is used to determine if a workspace name is unique.

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

Notes

Examples

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>