Iteration Labeller¶
The Iteration Labeller is similar to the Default Labeller; however, it maintains a revision number that is incremented by one for each iteration from the release start date. For example, if the release start date was June 1, 2005 and the iteration duration was 2 weeks, the iteration number on July 1, 2005 would be 3. This would create a label of
.3.<build number>. h2. Version Available from version 1.0 h2. Examples <pre><code class="xml"><labeller type="iterationlabeller"> <prefix>1.2</prefix> <duration>1</duration> <releaseStartDate>2005/6/24</releaseStartDate> <separator>_</separator> </labeller></code>
Configuration Elements¶
| Element | Description | Type | Required | Default | Version |
| duration | The duration of the iteration in weeks. | Int32 | No | 2 | 1.0 |
| dynamicValues | The dynamic values to use for the labeller. | Dynamic Values array | No | None | 1.5 |
| incrementOnFailure | If true, the label will be incremented even if the build fails. Otherwise it will only be incremented if the build succeeds. | Boolean | No | false | 1.1 |
| initialBuildLabel | Allows you to set the initial build number. This will only be used when on the first build of a project, meaning that when you change this value, you'll have to stop the CCNet service and delete the state file. | Int32 | No | 1 | 1.5 |
| labelFormat | A format applied to the buildnumber. | String | No | 0 | 1.0 |
| postfix | Any string to be put at the end of all labels. | String | No | None | 1.0 |
| prefix | Any string to be put in front of all labels. | String | No | None | 1.0 |
| labelPrefixFile | The location to a file which contains the prefix to be used. If this is filled in, the LabelPrefix setting is ignored, and the value from the file is used instead. This allows other people to set the prefix, without them needing to adjust CCNet.config, or bother a person who has access. Tip : place this file in a separate folder that is shared, so that others do not have direct access to the build server. | String | No | None | 1.7 |
| labelPrefixFileSearchPattern | A reg-ex expression to enforce the data of the contents in LabelPrefixFile. The first match is taken. This allows a bit more userfriendlyness. (skip whitespace, extra lines and so) example : \d\+\.\d\+\.\d\+\. This will enforce a layout of 3 numbers separated by a period ideal for a version prefix | String | No | ||
| releaseStartDate | The start date for the release (the start date of iteration one). | DateTime | Yes | n/a | 1.0 |
| separator | The separator between the iteration number and the build number. | String | No | . | 1.0 |
Notes¶
Contributed by Craig Campbell.
Automatically Generated¶
Documentation generated on Monday, 26 May 2014 at 7:18:00 AM