Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Bitbucket is Atlassian's web-based version control repository. You can use Qualitia with Bitbucket as a version control system for your Qualitia test artifacts. In order to do so, you must install and configure Git client on your Windows machine. 

Prerequisites for Bitbucket Integration

...

You can set up the environment either using Git Bash or using SourceTree. SourceTree GUI helps you to simplify your interaction with the GIT repositories. In order to use SourceTree, you must first install it on your system.

Setting up an environment is a one-time activity. After the setup is completed, all the changes made to the test cases and tasks are automatically managed in the Bitbucket repository.


...

  1. Navigate into the folder where you have cloned the repository.
  2. Move your existing project folder (<ProjectName>_projectdb) to this location.
    You can get this folder at the location specified in Setting> Configuration Setting > Dependency > Project Path.
  3. Launch SourceTree.
  4. On the left hand side, expand Branches and then Checkout master branch.
  5. Create a new branch with your Qualitia Project name.
    To create a new branch:
    1. Click Branch > New Branch.
    2. Enter New Branch name.
    3. Ensure that Checkout New Branch option is selected.
    4. Click Create Branch.
  6. After creating a branch, right-click the branch and select Push > Origin.
    Image Modified
  7. Stage all files except (.gitrefresh) and add comments, if required.

    Info

    The .gitrefresh file is generated and used by Qualitia for the internal purposes. Please do not add this file into the remote repository while adding your project artifacts.


  8. Select Push changes immediately option and click Commit.
  9. Now copy the directory path of the repository (from local system) and set it as Qualitia Project Path (in Configuration Setting > Dependency).
  10. Also, in Configuration Setting > General, select Version Control as GIT and add Bitbucket username and password.
  11. Restart Qualitia to start working on the projects that are integrated with Bitbucket repository.

Creating New Projects

When you are working with Qualitia projects that are integrated with Bitbucket repository, you need to create a branch in Bitbucket repository before creating new Qualitia projects.

To create new branch in Bitbucket repository:

...

Cloning Repository and Checking-out First Qualitia Project

You can start working on the Qualitia projects which are already added to the Bitbucket repository by other Qualitia user. In order to do so, you need to clone the corresponding repository and checkout corresponding projects on local system.

Info

At the end of this topic, Qualitia users will be able to clone the repository and checkout the desired Qualitia project.


To start working on existing Qualitia projects from Bitbucket:

Table of Contents
maxLevel2
minLevel2

Info

Prerequisites:

  • SourceTree v2.6.10
  • Valid Atlassian account for using Bitbucket 
  • Qualitia Client
  • Read and Write access to the repository in which Qualitia project exists
  • Access to Qualitia project which you want to work on

Multiexcerpt include macro
nameInstallandConfigureSourceTree
pageQASNew:(8.3.0 2) SourceTree Installation and Configuration

...

  1. Launch SourceTree.
  2. From the top section, click Clone.
  3. Enter Source Path / URL.
    This is the Bitbucket repository URL. 
    To get the correct URL, go to bitbucket.org > Select Repository Name > from the right-top corner, click Clone.
  4. In the Destination path, select a folder path where you would like to save and work on your local repository.
  5. Enter the preferred repository name.
  6. In Checkout Branch, select the Qualitia project you want to start working on.
  7. Click Clone.
  8. After you clone, copy the Bitbucket repository path from the local system and add it as a Project Path (in Configuration Setting > Dependency).
  9. Also, in Qualitia Configuration Setting > General, select Version Control as GIT and add Bitbucket username and password.
  10. Restart Qualitia and start working on the Qualitia Projects integrated with Bitbucket repository.

...

Setting Up Environment Using Git Bash

...

  1. Log on to Windows machine where you have installed Qualitia Automation Studio Client.
  2. Navigate to the folder where you want to clone the Bitbucket repository.
  3. Right-click and select the Git Bash Here option.
  4. Enter the following command and press Enter.

    Code Block
    $ git clone <Bitbucket repository URL>

    The repository will be cloned to your local system and you can now add Qualitia projects to this repository. 
    To get the correct URL, go to bitbucket.org > Select Repository Name > from the right-top corner, click Clone.
    Image Modified

Initial Commit

After you clone the repository on your local system, it's time to add files into this repository and create initial commit.

...

  1. Log on to the machine from where you want to work on Qualitia projects.

  2. Expand
    titleInstall Git Client and Git Credential Manager, if not already installed.

    Multiexcerpt include macro
    nameGitClientInstallation
    pageQASNew:(8.3.0 2) Installations and Configurations


  3. Launch Git Bash.

  4. Expand
    titleUpdate the Bitbucket Configuration file, if not already updated.


    Code Block
    $ git config --global user.name "John Doe"
    $ git config --global user.email "John.Doe@yourdomain.com"



  5. Enter the following command to clone the repository.

    Code Block
    $ git clone <Repository URL>

    (info) To get the correct URL, go to bitbucket.org > Repository Name > from the right-top corner, click Clone.

  6. Navigate into the repository and run the following command using Git Bash to get the desired project.

    Code Block
    $ git fetch && git checkout <ProjectName>


  7. After you clone the repository:
    1. Launch Qualitia Automation Studio.
    2. From the Setting menu, click Configuration Setting > Dependency.
    3. Copy the Bitbucket repository path (from the local machine) and set it as Project Path.
    4. In the General section, update database details with respect to new project which you have cloned from Bitbucket repository, if applicable.
    5. In Version Control, select GIT.
    6. Enter Bitbucket Username.
    7. Enter Bitbucket Password.
    8. Click OK.
  8. Restart Qualitia and start working with the desired project from Bitbucket repository.

...

  1. Navigate into the folder where you have cloned the repository on the local system. 
  2. Right-click and select the GIT Bash here option.
  3. Enter the following command to checkout the project branch which you want to work on.

    Code Block
    $ git fetch && git checkout <ProjectName>

    This will checkout the project folder (<ProjectName_projectdb>) into your local repository. 
    You can now start working on the newly checked-out Qualitia project.
    Image Modified


Change Management

Qualitia tightly integrates with the version control systems. We highly recommend using version control integration while you are working in multi-user environments. The complete history of the changes made to Qualitia artifacts such as Test Cases and Tasks are automatically stored and managed in the Bitbucket (Cloud) repository.

...

If any user is working on a test case or task while triggering the suite execution, Qualitia cannot access. Such test cases are not executed and are marked with Not Executed status in the suite execution report.

...

Viewing Change History

You can view the complete history of changes made to Qualitia artifacts, test cases and tasks, in Bitbucket. This gives you ability to trace back every single change made by each and every Qualitia user. 

To view change history:

  1. Log on to your Bitbucket account.
  2. Select desired repository.
  3. From the left-side section, click Commits.

This gives you complete history of changes that were made to the repository, shows commit messages, displays which tasks and test cases were changed, and so forth.

Image Modified

Unlinking Project From Bitbucket Repository

...