View Source

The changeset collection Changesets is used by the Repository object and provides access to the list of changesets associated with the current build for each repository. It includes functions to select changesets in the collection. The changesets are sorted by commit date - earliest first, or topographical order for git repositories.

Properties

Name	Description	Return Type	Usage Example
Count	Returns number of changesets in the collection	Integer	$Source.RepoName.Changesets.Count$	2

Functions

Name and Parameters	Description	Return Type	Usage Example
First()	Gets first changeset from the collection	Changeset	$Source.RepoName.Changesets.First().Comment$	"Initial commit"
First(string property, string operator, string value, [bool ignoreCase])	Gets first matching changeset from the collection for given property using given operator. See list of valid operators below.	Changeset	$Source.RepoName.Changesets.First("branch", Equals, "master").Created$	"11/09/2014 1:48:36 AM"
IsEmpty()	Returns true if there are no changesets in the collection	Boolean	$Source.RepoName.Changesets.IsEmpty()$	False
Item(integer index)	Gets a changeset in the collection by zero-based index number	Changeset	$Source.RepoName.Changesets.Item(0).Comment$	"Initial commit"
Last()	Gets last changeset from the collection	Changeset	$Source.RepoName.Changesets.Last().Comment$	"Added readme.md"
Last(string property, string operator, string value, [bool ignoreCase])	Gets last matching changeset from the collection for given property using given operator. See list of valid operators below.	Changeset	$Source.RepoName.Changesets.Last("branch", StartsWith, "Mas", true).Created$	"11/09/2014 2:16:12 AM"
Select(string property)	Returns a string collection of property values	String Collection	$Source.RepoName.Changesets.Select("branch").Join(",")$	"master, dev, feature_x"
Where(string property, string operator, string value, [bool ignoreCase])	Gets matching changesets from collection for given property using given operator. See list of valid operators below.	Changesets Collection	$Source.RepoName.Changesets.Where("branch", Equals, "master").First().Created$	"11/09/2014 1:48:36 AM"

Operators

```
Equals
```
```
DoesNotEqual
```
```
Contains
```
```
DoesNotContain
```
```
StartsWith
```
```
DoesNotStartWith
```
```
EndsWith
```
```
DoesNotEndWith
```
```
IsRegexMatch
```
```
IsNotRegexMatch
```