Document toolboxDocument toolbox

Header

(8.3.X) Team City

Qualitia supports Team City, a Java-based build management and continuous integration server. Integrating Team City helps you improve quality of software release with minimal efforts. Reports integrated with CI tools make it easy to analyze defects or failures with detailed information logs. These reports are available on demand and by emails upon completion of test executions. 

You can integrate Qualitia to execute test cases through TeamCity. In order to do so, you must configure your offline package accordingly.  

Team City Installation

In order to use TeamCity as the CI tool, you need to download and install some software packages that help you in executing test cases using Team City.

  1. Download TeamCity and JRE 6, 7/JDK 1.6, 1.7.
  2. Install downloaded JRE /JDK.
  3. Right-click TeamCity setup.exe and select Run as Administrator.
  4. Follow the instructions that appear on the screen.
  5. Post Team City installation, install Team City agent.
  6. Open the Run window, go to services.msc, and stop Team City agent service.
  7. Open the Command Prompt window as administrator and browse to the agent.bat file.
  8. Once the setup is complete, you will see message confirming Team City installation along with URL for further configuration (for example: http://localhost:<port defined while installation>).

On this page:

Team City Configuration

Once TeamCity.exe and JRE/JDK are installed successfully, Team City is now ready for further configurations.

  1. Access the Team City URL and log on to TeamCity using your credentials.
  2. Click the Create project button and Select Manually using the drop-down list.
  3. Enter the Name, Project ID, and Description.
  4. Click Create.
  5. In the Build Configurations section, click the Create build configuration button and select Manually using the drop-down list.
  6. Enter Name and system updates the Build ID accordingly.
  7. Enter Description, if any.
  8. Click Create.
    Build is now successfully created and you can proceed to configure Version Control Settings (VCS).
  9. Click the project name on the top of the screen to view Project Settings.
  10. Click the Edit link adjacent to the build configuration created by you.
    General Setting screen is displayed.
  11. In the Artifact Paths field, type %env.qualitiareportpath%/**/* => Report.
  12. Click Save.
  13. In the left pane, select Version Control Settings and click Attach VCS root button.
  14. In Type of VCS, select Subversion using the drop-down list.
  15. Enter VCS root name. VCS root ID is populated automatically.
  16. In the URL field, enter the SVN URL up to the parent folder where offline package is uploaded.
    Offline Package includes Offline.jar, all the other required files for Offline execution, and XML folder.
  17. Enter SVN Username and Password.
  18. Click Test Connection to test the SVN connection, and click Create.
  19. In the left pane, select Build Steps.
  20. Click the Add build step button.
  21. In the Runner Type field, select Command Line using the drop-down list.
  22. Enter Step name as per your requirements.
  23. In the Run field, select Custom Script using the drop-down list.
  24. In the Custom Script field, enter cd %teamcity.build.checkoutDir% and java -jar <qualitiaofflineJarFileName>.jar
  25. Click Save.
  26. In the left pane, select Parameters.
  27. Click Add New Parameter.
  28. In the Kind field, select Environment variable using the drop-down list.
  29. In the Name field, enter env.qualitiareportpath.

    Do not enter any value in the Value field.

  30. Click Save.

Execute and View Report

Once you are done with Build configuration settings, you can proceed to execute your test cases.

  1. Open the project and build you want to execute from the project's list.
  2. Click the Run button located at the top right corner of the screen.
  3. To check logs, click the in progress builds, and go to build logs section.
  4. Once the build is complete, you can see Build finished at the end in the Build Log section.
  5. In the Artifacts section, click the SummaryReport.html to view the report.



You can even pass arguments and execute same test case with different parameters on different agents simultaneously.

  1. To pass different parameters on different agents simultaneously, access the Build steps section.
  2. Edit the Execute Parameter step.
  3. Add arguments with data followed by SPACE.

Here is an example of how to update the field value along with parameters and the syntax to be used, if the arguments value itself has space.
<path updated in the field>CaptureFailBitMap=False CapturePassBitMap=FalseCreateErrorLog=False sbrowsertype=firefox "xmlPath=f:\\TeamcityOffline
NewExec XMLs" ReleaseNum=2.01 ProjectName=offlinepack LogPath=argreport123
Note: Argument with value consisting space is updated within double inverted comma ("").

Configuring Offline Package to Push Results into the Report Database

You can configure the offline package to push the test execution reports into the report database after the test suite execution. This eliminates the manual process of importing offline package execution results in Qualitia automation studio (Reports section).

Importing these reports automatically into the automation studio will also enable Qualitia user to view test execution results from the web-based dashboards.

Prerequisites:

  1. In order to push results, the machine which you are using to trigger the test case execution must have access to the machine where Qualitia Server is installed.

  2. You must have access to port 8887 from the machine where Qualitia Server is installed.

To configure Qualitia offline package to push results into the report database:

  1. Open the extracted Qualitia Offline folder of the associated offline package.

  2. From the Config Utility folder, open the Qualitia Offline Configuration Manager.

  3. On the Setting tab, enter the Qualitia Server URL address.

Footer