Download

Description

Downloads assets or artifacts from a Rational Asset Manager repository

Parameters

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

Parameters specified as nested elements

artifact

Individual artifacts can be specified to be downloaded.

asset

Individual assets can be specified to be downloaded.

assetList

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

BuildInfo is used to specify information about the build that is attached to the downloaded artifacts.

search

When a search is specified, all assets that are returned from the search are downloaded.

Examples

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>