...
Expression Expansion
To initiate an expansion, simply type the dollar symbol '$' and the expression auto complete will present (note: not all objects are available in all fields).
...
| Name | Description | Type | Usage Examples | |
|---|---|---|---|---|
| N/A | Represents the full path disk location of a buildsbuild's workspace folder. | String | $Workspace$\testfolder | "D:\ContinuaAgent\Ws\19\" |
...
| Name | Description | Type | Usage Example | |
|---|---|---|---|---|
| Id | A unique Integer allocated automatically to this build | String | $Build.Id$ | "10" |
| Version | A reference object for the build version (as defined below). | Version | $Build.VersionVersion$ | N/A |
| StartedBy | The username of the user who initiated the build | String | $Build.StartedBy$ | "peter.toms@finalbuilder.com" |
| IsFeatureBranchBuild | Utilised via build triggers, this . This expression is set to true when a build is triggered on a non-default branch | Boolean | $Build.IsFeatureBranchBuild$ | true |
| BuildNumber | A 0 zero-based auto-incremented integer allocated to this build (the first build will be build 0, the second build 1, etc) | Integer | $Build.BuildNumber$ | 100 |
| Metrics | A reference object to the metrics associated with this build (as defined below). | Metrics | $Build.Metrics$ | N/A |
| HasNewChanges | Does this build contain Changesets changesets which have not been associated with a previous build? | Boolean | $Build.HasNewChanges$ | true |
| LinkUrl | Build details UrlURL | String | $Build.LinkUrl$ | "http:\\SERVERNAME\New_Project_1\ci\builds\view\123" |
...
| Name | Description | Type | Usage Examples | |
|---|---|---|---|---|
| Name | Name of the Configuration configuration (as defined within the Configuration details page) | String | $Configuration.Name$ | "New Configuration 1" |
...
| Name | Description | Type | Usage Example | |
|---|---|---|---|---|
| Port | The Port port number used for agent communication | String | $Agent.Port$ | "9000" |
| Hostname | The Agents Hostnameagents host name | String | $Agent.Hostname$ | "AGENTMACHINE" |
| Now | The current date and time given as local to the agent local | Datetime | $Agent.Now$ | "2014 4:51:44 PM" |
| NowUTC | Thecurrent The current date and time given as UTC | Datetime | $Agent.NowUtc$ | "2014 6:52:25 AM" |
| InstallPath | The installation path of the agent | String | $Agent.InstallPath$ | "C:\Program Files\VSoft Technologies\ContinuaCIAgent\" |
| GetUserEnvironmentVairableGetUserEnvironmentVariable | Gets the specified Windows user Windows environment variable (relative to the agent machine's service user, and relative to the agent machine) | String | $Agent.GetUserEnvironmentVairableGetUserEnvironmentVariable("TEMP")$ | "%USERPROFILE%\AppData\Local\Temp" |
| GetMachineEnvironmentVairableGetMachineEnvironmentVariable | Gets the specified Windows machine Windows environment variable (relative to the agent machine) | String | $Agent.GetMachineEnvironmentVairableGetMachineEnvironmentVariable("NUMBER_OF_PROCESSORS")$ | "8" |
| N/A | Within this the Agent object is a list of the current agent property collectors | Property Collector | $Agent.NuGet.Default.Path$ | "C:\Program Files\NuGet\NuGet.exe" |
...
| Name | Description | Type | Usage Example | |
|---|---|---|---|---|
| Name | The name of the Project for which this the project the current configuration is a part of (as provided on the Project details page) | String | $Project.Name$ | "New Project 1" |
| Description | The description of the Project for which this project the current configuration is a part of (as provided on the Project details page) | String | $Project.Description$ | "This is a description for new project 1" |
| Slug | A shorterned shortened version of the Project project name which is safe to use within Url's URLs and other whitespace sensitive identifiers. | String | $Project.Slug$ | "New_Project_1" |
...
| Name | Description | Type | Usage Example | |||
|---|---|---|---|---|---|---|
| N/A | A | List of the repositories associated with configuration | What follows is a list of repositories associated with the given current configuration | Repository | $Source.Reponame$ | "Mercurial_Test_1" |
...
| Name | Description | Type | Usage Example | |
|---|---|---|---|---|
| Now | The current date and time given as local to the server local | DateTime | $Server.Now$ | "01/01/2014 5:03:18 PM" |
| NowUtc | The date and time given as UTC | DateTime | $Server.NowUtc$ | "01/01/2014 7:04:01 AM" |
| Hostname | The Continua server hostname | String | $Server.Hostname$ | "SERVERMACHINE" |
| InstallPath | The Continua server install path | String | $Server.InstallPath$ | "C:\Program Files\VSoft Technologies\ContinuaCI\" |
| Url | The Server web service URL | String | $Server.Url$ | "http:\\SERVERNAME:8080" |
...
| Name | Description | Type | Usage Example | |
|---|---|---|---|---|
| NewGuid | Create a new randomly generated GuidGUID | Guid | $Utils.NewGuid$ | "da47b2d6-3580-48ed-b27a-f152da2345e6" |
| RandomNumber | Generate a new random integer value If one parameter is provided it designates a random number in the range of greater than or equal to zero and the number provided will be generated If two parameters are provided they designate the range for the generated number. If no parameters are provided an a 32-bit integer greater than or equal to zero and less than int32 Int32 max value (2,147,483,647) will be generated. | Integer | $Utils.RandomNumber("1", "10")$ $Utils.RandomNumber("10")$ $Utils.RandomNumber$ | 5 2 1906529119 |
...
| Name | Description | Type | Usage Example | |
|---|---|---|---|---|
| Branch | The full name of the branch associated with the build for the given Repositoryrepository | String | $Source.RepoName.Branch$ | "/branches/a_test_branch" |
| BranchName | The branch name of the branch associated with the build for the given Repositoryrepository | String | $Source.RepoName.BranchName$ | "a_test_branch" |
| LatestChangeset | A reference object to the Changeset changeset information related to the most recent Changeset changeset for the given Repository repository (as defined below). | Changeset | $Source.RepoName.LatestChangeset.Comment$ | "a comment from the last commit" |
| Path | The disk location of the source associated with the build for the given Repositoryrepository | String | $Source.RepoName.Path$ | "C:\ContinuaAgent\Ws\44\Source\" |
| Tag | The tag name (if one exists) associated with the build for the given Repositoryrepository | String | $Source.RepoName.Tag$ | "v3-release" |
| Type | The Repository repository product being used | String | $Source.RepoName.Type$ | "Mercurial" |
| Url | The Url URL of the repository in question (as defined within the repository preferences) | String | $Source.RepoName.Url$ | "https://github.com/VSoftTechnologies/Delphi-Mocks.git" |
...
| Name | Description | Type | Usage Example | |
|---|---|---|---|---|
| Id | A unique identifier given to this Changesetchangeset | String | $Source.RepoName.LatestChangeset.Id$ | "a4ae66dffe5342e47c3aaf987bced4e9a320559e" |
| Comment | This comment associated with this Changeset changeset | String | $Source.RepoName.LatestChangeset.Comment$ | "This is a test commit" |
| RepositoryusernameRepositoryUsername | The username of the repository user who committed this Changeset changeset | String | $Source.RepoName.LatestChangeset.RepositoryusernameRepositoryUsername$ | "Peter Toms" |
| Branch | The full branch path of the latest Changeset changeset associated with this Repository repository | String | $Source.RepoName.LatestChangeset.Branch$ | "/branches/a_test_branch" |
| BranchnameBranchName | The branch name of the latest Changeset changeset associated with this Repository repository | String | $Source.RepoName.LatestChangeset.BranchnameBranchName$ | "a_test_branch" |
| Created | The created date of this Changeset (date and time when the Changeset changeset was committed or created within the source Repository) repository | Datetime | $Source.RepoName.LatestChangeset.Created$ | "11/09/2014 1:48:36 AM" |
| FilecountFileCount | The number of file changes associated with this commit | Int | $Source.RepoName.LatestChangeset.FilecountFileCount$ | 1 |
| CommitterusernameCommitterUserName | The Username username of the Continua User who committed this changeset (if one exists based on user repository mappings ) | String | $Source.RepoName.LatestChangeset.CommitterusernameCommitterUserName$ | "peter.toms@finalbuilder.com" |
| CommitterfullnameCommitterFullName | The Full full name of the Continua user who committed this changeset (if one exists based on user repository mappings) | String | $Source.RepoName.LatestChangeset.CommitterfullnameCommitterFullName$ | "Peter Toms" |
| Anchor | ||||
|---|---|---|---|---|
|
...
| Name | Description | Type | Usage Example | |
|---|---|---|---|---|
| Compiler.Warning | The total number of compiler warnings for the current build (eg msbuild MSBuild or Visual Studio build warnings) | Integer | $Build.Metrics.Compiler.Warning$ | 5 |
| Compiler.Error | The total number of compiler errors for the current build (eg msbuild MSBuild or Visual Studio build errors) | Integer | $Build.Metrics.Compiler.Error$ | 5 |
| Unit Tests | A reference object for the Unit Test Metric unit test metric details | Unit Tests | $Build.Metrics.UnitTests | N/A |
...
| Name | Description | Type | Usage Example | |
|---|---|---|---|---|
| Default | A reference object for the default version | Default | $Build.Version.Default | N/A |
| DotNet | A reference object for the Dot .Net version | DotNet | $Build.Version.DotNet | N/A |
...
| Name | Description | Type | Usage Example | |
|---|---|---|---|---|
| Major | The version major portion of the version number | Integer | $Build.Version.DotNet.Major$ | "1" (given "1.2.0.1287") |
| Minor | The version minor portion of the version number | Integer | $Build.Version.DotNet.Minor$ | "2" (fromgivengiven "1.2.0.1287") |
| Build | The version build portion of the version number | Integer | $Build.Version.DotNet.Build$ | "0" (given "1.2.0.1287") |
| Revision | The version revision portion of the version number | Integer | $Build.Version.DotNet.Revision$ | "1287" (given "1.2.0.1287") |
| Anchor | ||||
|---|---|---|---|---|
|
| Name | Description | Type | Usage Example | |
|---|---|---|---|---|
| Format | Formats a date or time value using standard or custom .Net formatting strings | string | $Server.Now.Format("hh:mm")$ | "23:55" (given the date time "31/12/2000 23:55:333") |
| ToLower | Converts a string to lowercase | string | $Source.RepoName.Branch.ToLower$ | "version 1.5" (given "Version 1.5") |
| ToUpper | Converts a string to uppercase | Integer | $Project.Name.ToUpper$ | "PROJECT X" (given "Project X") |