Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Pom file: first example, then location, then how to configure

...

Finally, Maven and SonarQube need to be configured with the correct properties to be able to read your Blueriq Model of interest. Maven takes care of this by reading a pom.xml file.

You will have to create the pom.xml yourself, and then configure it for your own Blueriq installation, repository, branch and project(s).

Below, you can seefind

  • An example of a pom.xml
  • The location where to save the pom.xml
  • An explanation of the properties in the pom.xml

An example

...

configuration in this pom file looks like this:

Code Block
languagexml
titleExample
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>SingleModule</groupId>
  <artifactId>singlemodule-test</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <name>SingleModuleTest</name>
  
    <properties>
        <sonar.blueriq.managementservice>http://my-studio-server/Studio/Server/Services/ManagementService</sonar.blueriq.managementservice>
        <sonar.blueriq.repository>RubikTest</sonar.blueriq.repository>
        <sonar.blueriq.branch>Trunk</sonar.blueriq.branch>
        <sonar.blueriq.projects>Kinderbijslag,TestProject</sonar.blueriq.projects>
        <sonar.blueriq.username>admin</sonar.blueriq.username>
        <sonar.blueriq.password>welcome</sonar.blueriq.password>
        <sonar.blueriq.authentication>BASIC</sonar.blueriq.authentication>
        <sonar.blueriq.skipanalysis>false</sonar.blueriq.skipanalysis>
        <sonar.blueriq.workingDir>target/bq</sonar.blueriq.workingDir>
    </properties>
</project>


The correctly configured pom file needs to be placed inside the directory in which Maven’s root directory is installed, for instance:

Image Added

 

The properties in the pom file:

...

PropertyRequiredDefaultDescription

sonar.blueriq.managementservice

Required for managementservice 

Url to the management service, if this property is set then all other managementservice properties must also be set. If this is not set, then the branchexportlocation must be set.

sonar.blueriq.repository

Required for managementservice 

Name of the repository.

sonar.blueriq.branch

Required for managementservice 

Name of the branch.

sonar.blueriq.username

Required for managementservice 

Studio username credential.

sonar.blueriq.password

Required for managementservice 

Studio password credential.

sonar.blueriq.authenticationRequired for managementservice Studio authentication mode, currently only BASIC is supported
sonar.blueriq.branchexportlocationRequired for export file Location of a branch export zip from the studio, if this is set then the managementservice property must not be set.

sonar.blueriq.projects

Required 

A comma separated list of blueriq project names.

sonar.blueriq.workingDirRequired Relative path inside the executing directory where the BMA plugin creates files to index issues and measures.
sonar.blueriq.skipanalysisOptionalfalse

Set to true if the BMA plugin shouldn't be triggered for the current project. This is useful when scanning projects without Blueriq, or when no connection can be made to the management service.

 

The following properties are default SonarQube properties. More information can be found here.

PropertyRequiredDefaultDescription

sonar.host.url

Optional

localhost:9000

Url and port to the sonarQube host.

sonar.projectKeyOptional when using Maven The key for the SonarQube project. In case of Maven the default is based on the Maven project name.
sonar.projectNameOptional when using Maven The name of the SonarQube project. In case of Maven the default is based on the Maven project name.
sonar.branchOptional
Use when importing the results of a feature branch to SonarQube.

 

An example configuration in this pom file looks like this:

Code Block
languagexml
titleExample
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>SingleModule</groupId>
  <artifactId>singlemodule-test</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <name>SingleModuleTest</name>
  
    <properties>
        <sonar.blueriq.managementservice>http://my-studio-server/Studio/Server/Services/ManagementService</sonar.blueriq.managementservice>
        <sonar.blueriq.repository>RubikTest</sonar.blueriq.repository>
        <sonar.blueriq.branch>Trunk</sonar.blueriq.branch>
        <sonar.blueriq.projects>Kinderbijslag,TestProject</sonar.blueriq.projects>
        <sonar.blueriq.username>admin</sonar.blueriq.username>
        <sonar.blueriq.password>welcome</sonar.blueriq.password>
        <sonar.blueriq.authentication>BASIC</sonar.blueriq.authentication>
        <sonar.blueriq.skipanalysis>false</sonar.blueriq.skipanalysis>
        <sonar.blueriq.workingDir>target/bq</sonar.blueriq.workingDir>
    </properties>
</project>

The correctly configured pom file needs to be placed inside the directory in which Maven’s root directory is installed, for instance:Image Removed

The installation is now completed. You should be able to analyse your Blueriq Models now.

...