Page tree
Skip to end of metadata
Go to start of metadata

The build object $Build provides access to the properties of the current build.


NameDescriptionTypeUsage Example
BuildNumberA zero-based auto-incremented integer allocated to the current build (the first build will be build 0, the second build 1, etc)Integer$Build.BuildNumber$100
DurationA set of time periods associated with the current buildBuild Durations$Build.Duration.Total$ "5 seconds"
ErrorAndWarningLogMessages *A list of error and warning messages in the build logLog Messages Collection$Build.ErrorAndWarningLogMessages.IsEmpty()$True
FirstSharedResourceLabelA description of the first shared resource label acquired by the current buildString$Build.FirstSharedResourceLabel$"Server.Testing.Server.QuotaList.A: 1 read lock"
HasErroredStagesHave any errors occurred in any stages of the current build?Boolean$Build.HasErroredStages$ False
HasFailedStagesHave any stages of the current build failed?Boolean$Build.HasFailedStages$False
HasNewChangesIs the current build associated with any new repository changesets which have not previously been built by another build for the same configuration?Boolean$Build.HasNewChanges$True
HasSuccessfulStagesHave any stages of the current build been successful?Boolean$Build.HasSuccessfulStages$True
HasWarningsHave any warnings been logged during the current build?Boolean$Build.HasWarnings$ True
IdA unique integer allocated automatically to this buildInteger$Build.Id$10
IssueIdsA comma-delimited list of issue ids associated with the current buildString$Build.IssueIds$"123,234"
IsFeatureBranchBuildThis expression is set to true when a build is triggered via a Repository Trigger on a non-default branchBoolean$Build.IsFeatureBranchBuild$True
LastSharedResourceLabelA description of the most recent shared resource label acquired by the current buildString$Build.LastSharedResourceLabel$"Server.Testing.Server.QuotaList.B: 1 read lock"
LinkUrlThe URL to the build details pageString$Build.LinkUrl$"http://servername/New_Project_1/ci/builds/view/123"
MetricsA reference object to access to any metrics recorded by build actionsMetrics$Build.Metrics.See Metrics
SharedResourceLabelsA comma-delimited list of shared resource labels acquired by the current buildString$Build.SharedResourceLabels$"Server.Testing.Server.QuotaList.A: 1 read lock", "Server.Testing.Server.QuotaList.B: 1 read lock"
SharedResourcesA list of shared resources acquired by the current buildShared Resources$Build.SharedResources.See Shared Resources
StagesA list of build stages Stages Collection$Build.Stages.See Stages Collection
StartCommentThe first comment logged during the buildString$Build.StartComment$"this is a comment"
StartedByA reference to the user who initiated the buildUser$Build.StartedBy$"mr.twisted.buildstarter@finalbuilder.com"
TailLogMessages *The last fifty messages in the build logLog Messages Collection$Build.TailLogMessages.First().Type$"Error"
VersionA reference to the build versionVersion$Build.Version$1.1.2.333


  • ErrorAndWarningLogMessages and TailLogMessages are only available in build event handler fields.
  • No labels