The task is used to load the build workspace into the local sandbox. It is included in the rtcEnterpriseBuild.xml build script by the Enterprise Extensions Dependency Build process.

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
deleteMetadata Specifies whether or not the fetch destination directory is to be deleted before the load process starts. Valid values are true or false. The default is false.

Note: Bypassing fetch destination deletion will reduce build time by allowing the file agent to bypass already loaded files and to reuse metadata stored in the fetch destination directory. However, over time, performance will degrade as the continuous accumulation of SCM metadata grows, and therefore, it is advisable to deleted the fetch destination on a regular basis.

No
loadDir The path to the load directory for the build. The value of this attribute is typically ${team.enterprise.scm.fetchDestination} because that property is built-in for a Dependency Build. Yes
operationList The path to the File Agent Operations list, FAOperationList.xml, for the build. The value of this attribute is typically associated with the ${team.enterprise.scm.fetchDestination} property because that property is built-in for a Dependency Build. Yes
prefix Specifies the prefix for the data set names. The value of this attribute is typically the ${team.enterprise.scm.resourcePrefix} property because that property is built-in for a Dependency Build. No
workspaceUUID The UUID of the build workspace. The value of this attribute is typically associated with the ${team.enterprise.scm.workspaceUUID} property because that property is built-in for a Dependency Build. No

Notes

Examples

Load workspace files prior to a build: 

<antz:loadfiles
    deleteMetadata="${team.enterprise.scm.deleteDestinationBeforeFetch}"
    loadDir="${team.enterprise.scm.fetchDestination}"
    operationList="${team.enterprise.scm.fetchDestination}/FAOperationList.xml"
    passwordFile="${passwordFile}"
    prefix="${team.enterprise.scm.resourcePrefix}"
    repositoryAddress="${repositoryAddress}"
    userId="${userId}"
    workspaceUUID="${team.enterprise.scm.workspaceUUID}"/>