The task is used to create a repository workspace.
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 |
| description | A description of the workspace. | Yes |
| duplicates |
Controls whether or not a workspace with a duplicate name is created if the createWorkspace task finds an existing workspace with the specified name. Valid values are: true or false. The default is false; if a workspace is found with the specified name, a new workspace will not be created and the createWorkspace task will return the UUID of the existing workspace in property.
|
No |
| name | The name of the workspace. | Yes |
| owner | The userid of the owner of the workspace. This attribute is optional. If the attribute is not specified, the build userid will be set as the owner of the workspace. | No |
| property | The name of the Ant property in which to return the UUID of the newly created workspace. | No |
| public |
Sets the read-scope of the workspace. Specify true to set the workspace read-scope to public. Specify false to set the workspace read-scope to private. This attribute is optional. The default is true.
|
No |
Create a workspace
<target name="main">
<xt:createWorkspace
repositoryAddress="${repositoryAddress}"
userId="${userId}"
passwordFile="${passwordFile}"
description="New workspace"
name="workspace.name"
/>
</target>