Perforce Shelve Trigger
The Perforce shelve trigger automatically runs a build on detecting a change in shelved files of your Perforce changelists.
The trigger supports Perforce 2018.2 or later.
The trigger monitors all Perforce VCS roots associated with the current build configuration. You can filter monitored changelists by their description. To do this, specify the required keyword to search.
On any change made in shelved files of a matching changelist, TeamCity will start a new personal build with the contents of these files.
If the current build is composite, the whole build chain will be triggered on a change in shelved files.
If stream support is enabled in the Perforce VCS root settings, this trigger will detect the target stream from the changed files and run the personal build in this stream even if the default stream is specified.
Parametrized Shelved Changelist ID
TeamCity provides a configuration parameter
vcsRoot.rootExternalId.shelvedChangelist with the ID of the changelist whose changes triggered this build.
If the VCS Root ID is unavailable/unnecessary, use the
vcsRoot.1.shelvedChangelist configuration parameter.
This trigger logs events to the
teamcity-triggers.log file with the
perforceShelveTrigger logging key.