76 lines
6.3 KiB
HTML
Executable File
76 lines
6.3 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 Merge Task</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 Merge Task
|
|
</span>
|
|
</div>
|
|
<div class="pagesubheading">
|
|
This page last changed on Mar 14, 2009 by <font color="#0050B2">dcameron</font>.
|
|
</div>
|
|
|
|
<p>Most build processes interact with external tools that write their output to file (<em>e.g.</em> NUnit, FxCop, or NCover). To make the output of these tools available to CruiseControl.NET to be used in the build process or displayed in the CruiseControl.NET web page or included in CruiseControl.NET emails, these files need to be merged into the CruiseControl.NET integration.</p>
|
|
|
|
<p>To merge these files, you need to include a <b>File Merge Task</b> in your CruiseControl.NET project. To do so, you need to modify your <b>ccnet.config</b> file as follows:</p>
|
|
|
|
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
|
|
<pre class="code-xml"><span class="code-tag"><cruisecontrol></span>
|
|
<span class="code-tag"><project name=<span class="code-quote">"project"</span>></span>
|
|
...
|
|
<span class="code-tag"><publishers></span>
|
|
<span class="code-tag"><merge></span>
|
|
<span class="code-tag"><files></span>
|
|
<span class="code-tag"><file></span><span class="code-tag"><span class="code-comment"><!-- path to NUnit test file --></span></span><span class="code-tag"></file></span>
|
|
<span class="code-tag"><file></span><span class="code-tag"><span class="code-comment"><!-- path to FxCop file --></span></span><span class="code-tag"></file></span>
|
|
<span class="code-tag"></files></span>
|
|
<span class="code-tag"></merge></span>
|
|
<span class="code-tag"></publishers></span>
|
|
<span class="code-tag"></project></span>
|
|
<span class="code-tag"></cruisecontrol></span></pre>
|
|
</div></div>
|
|
|
|
<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>You should place your File Merge Tasks in the <publishers /> section of your <a href="Project Configuration Block.html" title="Project Configuration Block">Project Configuration Block</a> before your <a href="Xml Log Publisher.html" title="Xml Log Publisher">Xml Log Publisher</a>.</td></tr></table></div>
|
|
<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 files processed by File Merge Task must be in XML format.</td></tr></table></div>
|
|
|
|
<p>Modify the contents of the <b><files></b> element to contain the path of the files that you wish to merge. The file can be specified using an asterisk ("*") wildcard in order to include multiple files that match the specified pattern (ie. "*<b>-results.xml</b>" will merge all files ending with the suffix "<b>-results.xml</b>"). The asterisk wildcard can only be used in the filename, not in the path.</p>
|
|
|
|
<p>If a relative <tt><file></tt> location is specified, this is relative to the <a href="Project Configuration Block.html#ProjectConfigurationBlock-workingDirectory">Project Working Directory</a>.</p>
|
|
|
|
<h3><a name="FileMergeTask-WhyarethemergedresultsnotshowingupintheProjectReportWebApplication%3F"></a>Why are the merged results not showing up in the Project Report Web Application?</h3>
|
|
|
|
<p>If you have set up the configuration for the <b>File Merge Task</b> as described above and you are still not ending up with the appropriate results showing up within the web application, please try the following steps:</p>
|
|
<ol>
|
|
<li>Click the <b>original log</b> link and check to see if the merged content is included in the xml. If it is missing then got onto step 2. If it is present and is still not showing up in the web page then try emailing the <a href="mailto:ccnet-user@googlegroups.com">CCNet users list </a>.</li>
|
|
<li>Have you put the File Merge Tasks in the <publishers /> section of your <a href="Project Configuration Block.html" title="Project Configuration Block">Project Configuration Block</a> before your <a href="Xml Log Publisher.html" title="Xml Log Publisher">Xml Log Publisher</a>?</li>
|
|
<li>Check the folder that contains the files that should be merged. If they are not there then you need to dig into your build script to find out why they aren't getting created.</li>
|
|
<li>If the files are there but aren't getting merged, double-check your <b>ccnet.config</b> file. Is the configuration specified correctly as specified above? Remember that case matters in XML tag and attribute names.</li>
|
|
<li>Check the <b>ccnet.log</b> file. You should see Info-level log messages stating that the files have been merged.</li>
|
|
<li>Does the file contain valid XML data? The File Merge Task only expects to process XML files. It will attempt to clean up non-XML files and write errors to the <b>ccnet.log</b> file, but it isn't always successful.</li>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
</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> |