90 lines
4.6 KiB
HTML
Executable File
90 lines
4.6 KiB
HTML
Executable File
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<title>CruiseControl.NET : File Labeller</title>
|
|
<link rel="stylesheet" href="styles/site.css" type="text/css" />
|
|
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
</head>
|
|
|
|
<body>
|
|
<table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff">
|
|
<tr>
|
|
<td valign="top" class="pagebody">
|
|
<div class="pageheader">
|
|
<span class="pagetitle">
|
|
CruiseControl.NET : File Labeller
|
|
</span>
|
|
</div>
|
|
<div class="pagesubheading">
|
|
This page last changed on Sep 01, 2008 by <font color="#0050B2">rosspatterson</font>.
|
|
</div>
|
|
|
|
<h3><a name="FileLabeller-FileLabeller"></a>File Labeller</h3>
|
|
|
|
<p>The File Labeller is used to generate labels based on the content of a disk file. The labeller is configured with the location of the file, and it reads the file content to generate the label for CCNet. The file is read just before the first pre-build task is executed.</p>
|
|
|
|
<p>The following configuration would prefix all labels with the string 'Foo-', so the if the file contains '213', the build would be labelled 'Foo-213'.</p>
|
|
|
|
<p><div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
|
|
<pre class="code-xml"><span class="code-tag"><project></span>
|
|
<span class="code-tag"><labeller type=<span class="code-quote">"fileLabeller"</span>></span>
|
|
<span class="code-tag"><labelFilePath></span>xxx<span class="code-tag"></labelFilePath></span>
|
|
<span class="code-tag"><prefix></span>Foo-<span class="code-tag"></prefix></span>
|
|
<span class="code-tag"><allowDuplicateSubsequentLabels></span>true<span class="code-tag"></allowDuplicateSubsequentLabels></span>
|
|
<span class="code-tag"></labeller></span>
|
|
<span class="code-tag"><span class="code-comment"><!-- Other project configuration to go here --></span></span>
|
|
<span class="code-tag"></project></span></pre>
|
|
</div></div><br clear="all" /> <br clear="all" />
|
|
<br clear="all" /></p>
|
|
|
|
<h3><a name="FileLabeller-ConfigurationElements%3A"></a>Configuration Elements:</h3>
|
|
|
|
<table class='confluenceTable'><tbody>
|
|
<tr>
|
|
<th class='confluenceTh'> Node </th>
|
|
<th class='confluenceTh'> Description </th>
|
|
<th class='confluenceTh'> Type </th>
|
|
<th class='confluenceTh'> Required </th>
|
|
<th class='confluenceTh'> Default </th>
|
|
</tr>
|
|
<tr>
|
|
<td class='confluenceTd'> prefix </td>
|
|
<td class='confluenceTd'> Any string to be put in front of all labels </td>
|
|
<td class='confluenceTd'> string </td>
|
|
<td class='confluenceTd'> false </td>
|
|
<td class='confluenceTd'> empty string <br clear="all" /> </td>
|
|
</tr>
|
|
<tr>
|
|
<td class='confluenceTd'> labelFilePath </td>
|
|
<td class='confluenceTd'> The pathname of the file to read. This can be the absolute path or one relative to the project's working directory. <br clear="all" /> </td>
|
|
<td class='confluenceTd'> string </td>
|
|
<td class='confluenceTd'> true </td>
|
|
<td class='confluenceTd'> n/a </td>
|
|
</tr>
|
|
<tr>
|
|
<td class='confluenceTd'> allowDuplicateSubsequentLabels </td>
|
|
<td class='confluenceTd'> If true, , a label which matches the immediately previous label will be generated as is. Otherwise it will have a version number appended (<em>e.g.</em>, <em>prefix</em><em>label</em>-1, <em>prefix</em><em>label</em>-2). </td>
|
|
<td class='confluenceTd'> boolean </td>
|
|
<td class='confluenceTd'> false </td>
|
|
<td class='confluenceTd'> true </td>
|
|
</tr>
|
|
</tbody></table>
|
|
<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>The File Labeller was added in build 1.3.0.2870, and given the finishing touch in 1.3.0.2955. It is available in CCNet 1.3 and later.</td></tr></table></div>
|
|
<p><br clear="all" /></p>
|
|
|
|
<p><br clear="all" /></p>
|
|
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
|
<tr>
|
|
<td height="12" background="http://confluence.public.thoughtworks.org//images/border/border_bottom.gif"><img src="images/border/spacer.gif" width="1" height="1" border="0"/></td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><font color="grey">Document generated by Confluence on Mar 14, 2009 02:55</font></td>
|
|
</tr>
|
|
</table>
|
|
</body>
|
|
</html> |