Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<table class="wysiwyg-macro" data-macro-name="info" data-macro-parameters="icon=false|title=Table of Contents" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2luZm86aWNvbj1mYWxzZXx0aXRsZT1UYWJsZSBvZiBDb250ZW50c30&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body"><p><img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3RvY30&amp;locale=en_GB&amp;version=2" data-macro-name="toc"></p></td></tr></table><p>Being able to monitor how quality evolves is a good start (see <a class="confluence-link" href="/display/SONAR/Historical+Information" data-linked-resource-id="111706387" data-linked-resource-type="page" data-linked-resource-default-alias="Historical Information" data-base-url="http://docs.codehaus.org">Historical Information</a>).</p><p>The next step would be to manage your technical debt on your current developments in order to keep it under control.</p><p>To deal with that, a Differential Services is provided on measures, issues and coverage by unit tests on new code.</p><h1>Differential Views</h1><h2>Differential Views on Measures</h2><p>To activate this service, pick the desired period in the drop down list <em>Time changes...</em></p><p><img class="confluence-embedded-image" src="/download/attachments/231082297/dashboard-list-periods.png?version=1&amp;modificationDate=1371611566503" data-image-src="/download/attachments/231082297/dashboard-list-periods.png?version=1&amp;modificationDate=1371611566503" data-linked-resource-id="231377021" data-linked-resource-type="attachment" data-linked-resource-default-alias="dashboard-list-periods.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082297" title="null > dashboard-list-periods.png"></p><p>When a period is selected, the differential values will appear next to the project measures:</p><p><img class="confluence-embedded-image" src="/download/attachments/231082297/diff-dashboard.png?version=1&amp;modificationDate=1371611566503" data-image-src="/download/attachments/231082297/diff-dashboard.png?version=1&amp;modificationDate=1371611566503" data-linked-resource-id="231377020" data-linked-resource-type="attachment" data-linked-resource-default-alias="diff-dashboard.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082297" title="null > diff-dashboard.png"></p><h2>Differential Views on Issues</h2><p>This service will help you focus your effort of quality on current developments:</p><p><img class="confluence-embedded-image" src="/download/attachments/231082297/diffview_violations1.png?version=1&amp;modificationDate=1371611566502" data-image-src="/download/attachments/231082297/diffview_violations1.png?version=1&amp;modificationDate=1371611566502" data-linked-resource-id="231377019" data-linked-resource-type="attachment" data-linked-resource-default-alias="diffview_violations1.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082297" title="null > diffview_violations1.png"></p><p><img class="confluence-embedded-image" src="/download/attachments/231082297/diffview_violations2.png?version=1&amp;modificationDate=1371611566501" data-image-src="/download/attachments/231082297/diffview_violations2.png?version=1&amp;modificationDate=1371611566501" data-linked-resource-id="231377018" data-linked-resource-type="attachment" data-linked-resource-default-alias="diffview_violations2.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082297" title="null > diffview_violations2.png"></p><p>To determine the creation date of an issue, during each analysis, the following algorithm is executed. For each issue, if there was an issue:</p><ul><li>on the same rule, with the same line number and with the same hash (but not necessarily with the same message) &gt; MATCH</li><li>on the same rule, with the same message and with the same hash (but not necessarily with the same line) &gt; MATCH</li><li>on the same rule, with the same message and with the same line number (but not necessarily with the same hash) &gt; MATCH</li></ul><p>In any other case, the issue is a new one.</p><table class="wysiwyg-macro" data-macro-name="info" data-macro-parameters="title=I am not getting the expected new issues in the Issues drilldown service when a differential view is selected?" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2luZm86dGl0bGU9SSBhbSBub3QgZ2V0dGluZyB0aGUgZXhwZWN0ZWQgbmV3IGlzc3VlcyBpbiB0aGUgSXNzdWVzIGRyaWxsZG93biBzZXJ2aWNlIHdoZW4gYSBkaWZmZXJlbnRpYWwgdmlldyBpcyBzZWxlY3RlZD99&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body"><p>Three reasons can explain this:</p><ol><li>This Issues Drilldown service only shows added issues, not fixed ones. Therefore the number you see in this service can be different from the one displayed on a dashboard through the Rules Compliance widget (that displays added issues - fixed issues).</li><li>The algorithm detecting new issues is very good but still perfectible. Therefore new issues can sometimes appear only because SonarQubedid not recognize it already existed.</li><li><span>You are looking at a period of X days which goes beyond the first analysis made after migration to version 2.5. In this case there can be a discrepancy due to the fact that prior to 2.5, data to build this service were not collected. This issue will disappear as soon as period does not go beyond first analysis.</span></li></ol></td></tr></table><p> </p><h2>Code Coverage on New/Changed Code</h2><p>When activating the <a class="confluence-link" href="/display/SONAR/SCM+Activity+Plugin" data-linked-resource-id="137199861" data-linked-resource-type="page" data-linked-resource-default-alias="SCM Activity Plugin" data-base-url="http://docs.codehaus.org">SCM Activity Plugin</a>, you will be able to separate coverage by unit tests of new code from old (based upon a given cut-off date) in order to track the new code which does not have any/enough unit tests.</p><p><img class="confluence-embedded-image" src="/download/attachments/231082297/new_coverage_widget.jpg?version=1&amp;modificationDate=1371611566496" data-image-src="/download/attachments/231082297/new_coverage_widget.jpg?version=1&amp;modificationDate=1371611566496" data-linked-resource-id="231377017" data-linked-resource-type="attachment" data-linked-resource-default-alias="new_coverage_widget.jpg" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082297" title="null > new_coverage_widget.jpg"></p><p><br />A live example is available on <a href="http://nemo.sonarsource.org/dashboard/index/org.codehaus.sonar:sonar">Nemo</a>.<a href="http://nemo.sonarsource.org/dashboard/index/org.codehaus.sonar-plugins:all"><img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2FuY2hvcjpzZXR0aW5nc0RpZmZlcmVudGlhbFZpZXdzfQ&amp;locale=en_GB&amp;version=2" data-macro-name="anchor" data-macro-default-parameter="settingsDifferentialViews"></a></p><h1>Differential Views Settings</h1><h2>Global Configuration</h2><p>3 periods can be configured globally and will be available and common to all projects. Go to Configuration &gt; General Settings &gt; Differential Views to set these properties.</p><p><img class="confluence-embedded-image" width="800" src="/download/attachments/231082297/timemachine-period-global.png?version=1&amp;modificationDate=1371611566496" data-image-src="/download/attachments/231082297/timemachine-period-global.png?version=1&amp;modificationDate=1371611566496" data-linked-resource-id="231377016" data-linked-resource-type="attachment" data-linked-resource-default-alias="timemachine-period-global.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082297" title="null > timemachine-period-global.png"></p><h2>Project Configuration</h2><p>2 complementary periods can be configured and be specific to the current project. Select your project and go to Settings &gt; Differential Views to set these properties</p><p><img class="confluence-embedded-image" width="800" src="/download/attachments/231082297/timemachine-periods-project.png?version=1&amp;modificationDate=1371611566484" data-image-src="/download/attachments/231082297/timemachine-periods-project.png?version=1&amp;modificationDate=1371611566484" data-linked-resource-id="231377015" data-linked-resource-type="attachment" data-linked-resource-default-alias="timemachine-periods-project.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082297" title="null > timemachine-periods-project.png"></p><p> </p>