Help
Task Reference
<pvcspromotegroup>|
NAntContrib
Help
Task Reference
<pvcspromotegroup> |
v0.85-rc1 |
[This is preliminary documentation and subject to change.]
Promotes versioned files to the next promotion group.
This task uses the promotegroup PCLI command to promote versioned files.
| Attribute | Type | Description | Required |
|---|---|---|---|
| acrossbranches | bool | Gets or sets a value indicating whether the promotion may occur across branches. | True |
| promotiongroup | string | Gets or sets the promotion group to be promoted. | True |
| entity | string | Gets or sets the entity involved in the operation. | True |
| projectdatabase | string | Gets or sets the project database to utilize during the operation. | True |
| failonerror | bool | Determines if task failure stops the build, or is just reported. The default is true. | False |
| if | bool | If true then the task will be executed; otherwise, skipped. The default is true. | False |
| includesubprojects | bool | Gets or sets a value indicating whether the operation should include subprojects. | False |
| password | string | Gets or sets the password to use when connecting to the project database. | False |
| projectpath | string | Gets or sets the project path to utilize during the operation. | False |
| pvcsbin | string | Gets or sets the location of the PVCS binary command-line tools. | False |
| timeout | int | The maximum amount of time the application is allowed to execute, expressed in milliseconds. Defaults to no time-out. | False |
| unless | bool | Opposite of if. If false then the task will be executed; otherwise, skipped. The default is false. |
False |
| userid | string | Gets or sets the user ID to use when connecting to the project database. | False |
| verbose | bool | Determines whether the task should report detailed build log messages. The default is false. | False |
| workspace | string | Gets or sets the workspace to use when connecting to the project database. | False |
| Attribute | Type | Description | Required |
|---|---|---|---|
| useruntimeengine | bool | Specifies whether the external program should be executed using a runtime engine, if configured. The default is false. | False |
Contains a collection of Argument elements.
Promotes all files in the root of the project database specified by the project-database property. The files are promoted from the DEV promotion group to the next. Promotion will not take place across branches.
<pvcspromotegroup projectdatabase="${project-database}" promotiongroup="DEV" entity="/" acrossbranches="false"/>
Promotes all files in the project database specified by the project-database property. The files are promoted from the SYSTEST promotion group to the next. Promotion will take place across branches.
<pvcspromotegroup projectdatabase="${project-database}" promotiongroup="SYSTEST" entity="/" includesubprojects="true" acrossbranches="true"/>