Help
Task Reference
<stcheckin>|
NAntContrib
Help
Task Reference
<stcheckin> |
v0.93-nightly-2012-08-10 |
[This is preliminary documentation and subject to change.]
Task to check in files to StarTeam repositories.
You add files to the repository that are not controlled by setting adduncontrolled.
This task was ported from the Ant task http://jakarta.apache.org/ant/manual/OptionalTasks/starteam.html#stcheckin
You need to have the StarTeam SDK installed for this task to function correctly.
| Attribute | Type | Description | Required |
|---|---|---|---|
| adduncontrolled | bool | if true, any files or folders NOT in StarTeam will be added to the repository. Defaults to "false". | False |
| comment | string | False | |
| unlocked | bool | Set to do an unlocked checkout; optional, default is false; If true, file will be unlocked so that other users may change it. If false, lock status will not change. | False |
| rootstarteamfolder | string | Root StarTeam folder to begin operations on. Defaults to the root of the view. | True |
| excludes | string | Accepts comma de-limited list of expressions to exclude from tree operations. If nothing is specified. NO filespecs are excluded. | False |
| failonerror | bool | Determines if task failure stops the build, or is just reported. The default is true. | False |
| forced | bool | Default : false - force check in/out actions regardless of the status that StarTeam is maintaining for the file. | False |
| if | bool | If true then the task will be executed; otherwise, skipped. The default is true. | False |
| includes | string | Accepts comma de-limited list of expressions to include in tree operations. If nothing is set ALL filespecs are included. | False |
| label | string | Label used for checkout. If no label is set latest state of repository is checked out. | False |
| password | string | The password used for login. | False |
| projectname | string | The name of the StarTeam project to be acted on | False |
| recursive | bool | Default : true - should tasks recurse through tree. | False |
| servername | string | Name of StarTeamServer. | False |
| serverport | string | Port number of the StarTeam connection. | False |
| unless | bool | Opposite of if. If false then the task will be executed; otherwise, skipped. The default is false. |
False |
| url | string | One stop to set all parameters needed to connect to a StarTeam server. | False |
| username | string | The StarTeam user name used for login. | False |
| verbose | bool | Determines whether the task should report detailed build log messages. The default is false. | False |
| viewname | string | The name of the StarTeam view to be acted on. | False |
Recursively checks in all files in the project.
<!--
constructs a 'url' containing connection information to pass to the task
alternatively you can set each attribute manually
-->
<property name="ST.url" value="user:pass@serverhost:49201/projectname/viewname" />
<stcheckin forced="true" rootstarteamfolder="/" recursive="true" url="${ST.url}" />