The changeset tags collection Tags is used by the Changeset object and provides access to the list of tags associated with the changeset. It includes functions to select tags in the collection. The tags are sorted by modified date - earliest first, and then by name.
Properties
| Name | Description | Return Type | Usage Example | |
|---|---|---|---|---|
| Count | Returns number of tags in the collection | Integer | $Source.RepoName.Changesets.First().Tags.Count$ | 3 |
Functions
| Name and Parameters | Description | Return Type | Usage Example | |
|---|---|---|---|---|
| First() | Gets first tag from the collection | Changeset Tag | $Source.RepoName.Changesets.First().Tags.First().Name$ | "v0.9_beta" |
| First(string property, string operator, string value, bool ignoreCase) | Gets first matching tag from the collection for given property using given operator. See list of valid operators below. | Changeset Tag | $Source.RepoName.BuiltChangeset.Tags.First("TaggerName", Contains, "Babbage", True).Name$ | "v1.1_release" |
| IsEmpty() | Returns true if there are no tags in the collection | Boolean | $Source.RepoName.BuiltChangeset.Tags.IsEmpty()$ | False |
| Item(integer index) | Gets a tag in the collection by zero-based index number | Changeset Tag | $Source.RepoName.BuiltChangeset.Tags.Index(0).Modified$ | "11/09/2014 1:48:36 AM" |
| Last() | Gets last tag from the collection | Changeset Tag | $Source.RepoName.BuiltChangeset.Tags.Last().Name$ | "v1.2.3" |
| Last(string property, string operator, string value, bool ignoreCase) | Gets last matching tag from the collection for given property using given operator. See list of valid operators below. | Changeset Tag | $Source.RepoName.BuiltChangeset.Tags.Last("Message", Contains, "fix", True).Name$ | "hotfix_999" |
| Select(string property) | Returns a string collection of property values | String Collection | $Source.RepoName.BuiltChangeset.Tags.Select(Name).Join(",")$ | "tag1, tag2 tag3" |
| Where(string property, string operator, string value, bool ignoreCase) | Gets matching tags from collection for given property using given operator. See list of valid operators below. | Changeset Tags Collection | $Source.RepoName.BuiltChangeset.Tags.Where("Name", Equals, "implemented", True).First().Message$ | "added a deployment tag" |
Operators
Equals
DoesNotEqual
Contains
DoesNotContain
StartsWith
DoesNotStartWith
EndsWith
DoesNotEndWith
IsRegexMatch
IsNotRegexMatch