Description
Produces a listing of the contents of the StarTeam repository at the specified view and StarTeamFolder. The listing will contain the name of the user, if any, who has the file locked, the size of the file, its lastModifiedDate in the repository, and the name of the file. Unless the rootLocalFolder is specified, listing will also show the status of the local file in the default local directory relative to the repository.
Parameters
See also the required common StarTeam parameters.
Attribute | Description | Required |
rootstarteamfolder | The root of the subtree in the StarTeam repository to be listed. Defaults to the root folder of the view ('/'). | no |
rootlocalfolder | The local folder which will be the root of the tree to which files are compared. If this is not supplied, then the StarTeam "default folder" associated with rootstarteamfolder is used and a status field will appear in the listing. Otherwise, the status field will not appear. | no |
includes | Only list files that match at least one of the patterns in this list. Patterns must be separated by commas. Patterns in excludes take precedence over patterns in includes. | no |
excludes | Do not list files that match at least one of the patterns in this list. Patterns must be separated by commas. Patterns in excludes take precedence over patterns in includes. | no |
label | List files, dates, and statuses as of this label. The label must exist in starteam or an exception will be thrown. If not specified, the most recent version of each file will be listed. | no |
recursive | Indicates if subfolders should be searched for files to list. Defaults to "true". | no |
Examples
<stlist url="WASHINGTON:49201/build" username="auser" password="secret" />The above command might produce the following listing:
[stlist] Folder: Build (Default folder: C:/work/build) [stlist] Folder: dev (Default folder: C:/work/build/dev) [stlist] Out of date Sue Developer 1/1/02 7:25:47 PM CST 4368 build.xml [stlist] Missing George Hacker 1/1/02 7:25:49 PM CST 36 Test01.properties [stlist] Current 1/1/02 7:25:49 PM CST 4368 build2.xml [stlist] Folder: test (Default folder C:/work/build/dev/test) [stlist] Missing 1/1/02 7:25:50 PM CST 4368 build2.xmlwhile adding a rootlocalfolder and an excludes param ...
<stlist url="WASHINGTON:49201/build" username="auser" password="secret" rootlocalfolder="srcdir2" excludes="*.properties" />might produce this listing. The status is missing because we are not going against the default folder.
[stlist] overriding local folder to srcdir2 [stlist] Folder: Build (Local folder: srcdir2) [stlist] Folder: dev (Local folder: srcdir2/dev) [stlist] Sue Developer 1/1/02 7:25:47 PM CST 4368 build.xml [stlist] 1/1/02 7:25:49 PM CST 4368 build2.xml [stlist] Folder: test (Local folder: srcdir2/dev/test) [stlist] 1/1/02 7:25:50 PM CST 4368 build2.xml