This tutorial demonstrates how to execute a predefined quality analysis with ConQAT.

Downloading and Installing ConQAT

The first step is to download the ConQAT distribution from the Installation & Download Page. Please choose the full download named ConQAT and follow the installation instructions. Launch the ConQAT IDE by starting the Eclipse executable. (You may also choose to install the ConQAT IDE Plug-ins into an existing Eclipse installation. See the downloads page for details.)

Initial Steps

Before starting with ConQAT, it is recommended to switch to the Dashboard perspective. You can do this via the menu Window->Open Perspective->Dashboard.

Importing Examples

To create import the ConQAT examples, select the menu entry File->New->Example… in the workbench. In the wizard select ConQAT Examples->ConQAT Example Project and complete the dialog by pressing Next and then Finish. The examples should now be available as a project in the Package Explorer on the left.

Opening an Analysis

Open the file intro-example.step1.cqb by double-clicking it in the Package Explorer. This file is a so called block, which defines a quality analysis. A block consists of processors (blue) and blocks (turquois) that specify how an analysis is performed in a pipes-and-filter fashion. A processor is the atomic processing unit of ConQAT. It represents a single analysis step and is implemented in a Java class. Blocks are composite processing units built from processors and blocks.

Workbench Overview

The file you just opened defines a simple analysis that reads the source code of a software system, analyzes the number of lines of code for each file, and produces a table showing the analysis result.

Executing the Analysis

ConQAT Analysis blocks can be executed via ConQAT Run Configurations that are stored in .cqr files. Double click one the file intro-example-step1.cqr that corresponds to the block opened in the editor. The run configuration editor is opened an displays the configuration. Execute the analysis by clicking on Launch ConQAT analysis. ConQAT now launches the analysis and shows the execution status in the ConQAT Execution Progress view and writes status messages to the Console. A full green progress bar indicates that the quality analysis executed sucessfully.

Analysis Execution

ConQAT writes the analysis results to the folder output in the conqat-examples project. Select conqat-examples in the Package Explorer and and refresh its contents by pressing ‘F5’ or selecting Refresh from the context menu. Then open the file index.html in the output folder introduction/step1. Click on Main/LOC in the navigation of the page on the left. The table shows the results of the LOC analysis.

Analysis Result

This concludes the tutorial Getting Started - Part 1: Running an Analysis.