StarTeam Source Control Block - CruiseControl.NET

StarTeam Configuration Example

For StarTeam you must specify the executable, project, username and password. You may also specify the host, port and path. The host defaults to 127.0.0.1. The port to 49201. The path to the empty string.

<sourcecontrol type="starteam">
   <executable>c:\starteam\stcmd.exe</executable>
   <project>ccnet</project>
   <username>buildguy</username>
   <password>buildguypw</password>
   <host>thebuildmachine</host>
   <port>49201</port>
   <path>release2.0</path>
   <autoGetSource>true</autoGetSource>
   <folderRegEx>customRegEx</folderRegEx>
   <fileRegEx>customRegEx</fileRegEx>
   <fileHistoryRegEx>customRegEx</fileHistoryRegEx>
   <timeout units="minutes">10</timeout>
</sourcecontrol>

Configuration Elements:

Node	Description	Type	Default	Required
executable	The local path for the StarTeam command-line client (eg. c:\starteam\stcmd.exe)	string	"stcmd.exe"	true
username	StarTeam ID that CCNet should use	string	N/A	true
password	Password for the StarTeam user ID	string	N/A	true
host	The IP address or machine name of the StarTeam server.	string	N/A	false
port	The port on the StarTeam server to connect to.	integer	49201	false
project	The StarTeam project (and view) to monitor (eg. project/view)	string	N/A	true
path	The path to monitor.	string	""	false
autoGetSource	Instruct CCNet whether or not you want it to automatically retrieve the latest source from the repository.	bool	true	false
overrideViewWorkingDir	If set, use the -rp option to use a different View Working Directory	string	false	""
overrideFolderWorkingDir	If set, use the -fp option to use a different Folder Working Directory. Will not be used if `overrideViewWorkingDir` is set.	string	false	""
folderRegEx	Allows you to use your own RegEx to parse StarTeam's folder output. See RegEx's below.	string	false	See below
fileRegEx	Allows you to use your own RegEx to parse StarTeam's file output. See RegEx's below.	string	false	See below
fileHistoryRegEx	Allows you to use your own RegEx to parse StarTeam's file history. See RegEx's below.	string	false	See below
timeout	Sets the timeout period for the source control operation. See Timeout Configuration for details.	Timeout	10 minutes	false

RegEx Configuration

CruiseControl.NET uses StarTeam's command line interface to find changes submitted to Source Control. 3 regular expressions are used in doing this, as specified above. You have the option of changing these regular expressions to choose how your instance of CruiseControl.NET parses StarTeam output. It is recommended if you do this that you download the source version of CruiseControl.NET to see the default RegEx's and how they are used.

One suggested alternative RegEx so far is for the fileHistoryRegEx, as follows:

^Revision: (?<file_revision>\S+) View: (?<view_name>.+) Branch Revision: (?<branch_revision>\S+).\nAuthor: (?<author_name>.*) Date: (?<date_string>.*) \w+\r\n(?<change_comment>.*)

(Note that this is all one line)