Downloads assets or artifacts from a Rational Asset Manager repository
| Attribute | Description | Required |
| server | The ID of the server that connects to Rational Asset Manager | Yes |
| destdir | The directory where the downloaded asset is saved | No. Default is ${basedir}. |
| extract | If true, the asset is extracted instead of saved as a .ras file. | No. Default is false. |
| failOnError | If false, the build continues execution when an error occurs. Otherwise, the build fails. | No. Default is true. |
| overwrite | If true, any file that has the same name as a file being downloaded or extracted is overwritten. | No. Default is false. |
| preservePath | If true, the path of the artifact within the asset is maintained relative to destdir. | No. Default is false. |
| eclipseproject | An Eclipse project folder. If the project is set up to download artifacts from Rational Asset Manager, those artifacts are downloaded automatically. | No |
Individual artifacts can be specified to be downloaded.
Individual assets can be specified to be downloaded.
AssetLists can be used to specify a list of assets to be downloaded. This list must be in the following format:
guid1/version1;guid2/version2;...
BuildInfo is used to specify information about the build that is attached to the downloaded artifacts.
When a search is specified, all assets that are returned from the search are downloaded.
Download a single asset (.ras file) to the "/tmp" directory
<download server="ramServer" destdir="/tmp">
<asset guid="{0000-1111-2222-3333}" version="1.0" />
</download>
Download an asset that was specified in the script to the "/tmp" directory, extracting the contents and overwriting files
<asset id="myAsset" server="ramServer" guid="{0000-1111-2222-3333}" version="1.0" />
<download server="ramServer" destdir="/tmp" extract="true" overwrite="true">
<asset refid="myAsset" />
</download>
Download a list of assets to ${basedir}
<download server="ramServer">
<assetList>{0000-1111-2222-3333}/1.0;{1111-2222-3333-4444}/1.1</assetList>
</download>
Download all assets that match the "myAsset" query to the "/tmp" directory
<download server="ramServer" destdir="/tmp"> <search query="myAsset" /> </download>