The task changes the name of the specified workspace.

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 new name for the workspace. Yes
property The name of the Ant property in which to return the result. If the new name of the workspace is set, the property is set to true. Otherwise, the property value is set to false. No
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. Yes

Notes

Examples

Set the name of a workspace 

<target name="main">
  
  <xt:setworkspacename
    repositoryAddress="${repositoryAddress}"
    userId="${userId}"
    passwordFile="${passwordFile}"
    name="IMS14.Service.Buildspace.PI12345"
    property="my.property"
    workspaceUUID="${team.scm.workspaceUUID}"
  />
  <echo>${my.property}</echo>
  
</target>