next up previous contents index
Next: VssLabel Up: Microsoft Visual SourceSafe Tasks Previous: The Tasks   Contents   Index

Task Descriptions

VssGet

Description

Task to perform GET commands to Microsoft Visual SourceSafe.

If you specify two or more attributes from version, date and label only one will be used in the order version, date, label.

Parameters

Attribute Description Required
vsspath SourceSafe path which specifies the project/file(s) you wish to perform the action on. You should not specify the leading dollar-sign - it is prepended by Ant automatically. Yes
login username[,password] - The username and password needed to get access to VSS. Note that you may need to specify both (if you have a password) - Ant/VSS will hang if you leave the password out and VSS does not accept login without a password. No
localpath Override the working directory and get to the specified path No
ssdir directory where ss.exe resides. By default the task expects it to be in the PATH. No
serverPath directory where ss.ini resides. No
writable true or false<; default false/td> No
recursive true or false; default false. Note however that in the SourceSafe UI , there is a setting accessed via Tools/Options/GeneralTab called "Act on projects recursively". If this setting is checked, then the recursive attribute is effectively ignored, and the get will always be done recursively No
version
date
label
a version number to get
a date stamp to get at
a label to get for
No, only one of these allowed
quiet suppress output (off by default) No
autoresponse What to respond with (sets the -I option). By default, -I- is used; values of Y or N will be appended to this. No

Note that only one of version, date or label should be specified

Examples

<vssget localPath="C:\mysrc\myproject"
        recursive="true" 
        label="Release1"
        login="me,mypassword"
        vsspath="/source/aProject"
        writable="true"/>
Does a get on the VSS-Project $/source/myproject using the username me and the password mypassword. It will recursively get the files which are labeled Release1 and write them to the local directory C: ${\backslash}{\backslash}$mysrc ${\backslash}{\backslash}$myproject. The local files will be writable.


next up previous contents index
Next: VssLabel Up: Microsoft Visual SourceSafe Tasks Previous: The Tasks   Contents   Index
Andrew Marlow 2003-07-08