## Starteam

### Description

Checks out files from a StarTeam project.

The includes and excludes attributes function differently from other tasks in Ant. Multiple patterns must be separated by spaces, not commas. See the examples for more information.

This program makes use of functions from the StarTeam API. As a result this task is only available to licensed users of StarTeam. You must have `starteam-sdk.jar` in your classpath to run this task. For more information about the StarTeam API and how to license it, see the StarBase web site.

### Parameters

Attribute | Description | Required
servername | The name of the StarTeam server. | yes
serverport | The port number of the StarTeam server. | yes
projectname | The name of the StarTeam project. | yes
viewname | The name of the view in the StarTeam project. | yes
username | The username of the account used to log in to the StarTeam server. | yes
password | The password of the account used to log in to the StarTeam server. | yes
targetfolder | The folder to which files are checked out. What this precisely means is determined by the targetFolderAbsolute param. | yes
targetFolderAbsolute | Determines how targetfolder is interpreted, that is, whether the StarTeam "default folder" for the project is factored in (false) or whether targetFolder is a complete mapping to foldername (true). If "true", the target tree will be rooted at targetfolder+"default folder". If false, the target tree will be rooted at targetfolder. Defaults to "false". | no
foldername | The subfolder in the project from which to check out files. | no
force | Overwrite existing folders if this is set to "true". Defaults to "false". | no
recursion | Indicates if subfolders should be searched for files to check out. Defaults to "true". | no
verbose | Provides progress information. Defaults to "false". | no
includes | Only check out files that match at least one of the patterns in this list. Patterns must be separated by spaces. Patterns in excludes take precedence over patterns in includes. | no
excludes | Do not check out files that match at least one of the patterns in this list. Patterns must be separated by spaces. Patterns in excludes take precedence over patterns in includes. | no

### Examples

      <starteam servername="STARTEAM"
                serverport="49201"
                projectname="AProject"
                viewname="AView"
                username="auser"
                password="secret"
                targetfolder="C:\dev\buildtest\co"
      />

The minimum necessary to check out files out from a StarTeam server. This will check out all files in the AView view of the AProject project to `C:\dev\buildtest\co`.

      <starteam servername="STARTEAM"
                serverport="49201"
                projectname="AProject"
                viewname="AView"
                username="auser"
                password="secret"
                targetfolder="C:\dev\buildtest\co"
                foldername="\Dev"
                excludes="*.bak *.old"
                force="true"
      />

This will checkout all files from the Dev folder and below that do not end in .bak or .old. The force flag will cause any existing files to be overwritten by the version in StarTeam.

      <starteam servername="STARTEAM"
                serverport="49201"
                projectname="AProject"
                viewname="AView"
                username="auser"
                password="secret"
                targetfolder="C:\dev\buildtest\co"
                includes="*.htm *.html"
                excludes="index.*"
      />

This is an example of overlapping includes and excludes attributes. Because excludes takes precedence over includes, files named `index.html` will not be checked out by this command.

     <starteam servername="STARTEAM"
                serverport="49201"
                projectname="AProject"
                foldername="src/java"
                viewname="AView"
                username="auser"
                password="secret"
                targetfolder="C:\dev\buildtest\co"
                targetfolderabsolute="true"
      />

     <starteam servername="STARTEAM"
                serverport="49201"
                projectname="AProject"
                foldername="src/java"
                viewname="AView"
                username="auser"
                password="secret"
                targetfolder="C:\dev\buildtest\co"
                targetfolderabsolute ="false"
      />

     <starteam servername="STARTEAM"
                serverport="49201"
                projectname="AProject"
                foldername="src/java"
                viewname="AView"
                username="auser"
                password="secret"
                targetfolder="C:\dev\buildtest\co\src\java"
                targetfolderabsolute="true"
      />

In the preceding three examples, assuming that the AProject project has a default folder of "AProject", the first example will check the files located in starteam under src/java out to a tree rooted at C:\dev\buildtest\co, the second to a tree rooted at C:\dev\buildtest\co\AProject\src\java and the third to a tree rooted at C:\dev\buildtest\co\src\java.

Copyright © 2000,2001 Apache Software Foundation. All rights Reserved.