Versions Compared

Old Version 2

changes.mady.by.user Dhiraj Chandanshive

Saved on

compared with

New Version 3

changes.mady.by.user Dhiraj Chandanshive

Saved on

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

In order to use Bitbucket as your version control tool for Qualitia artifacts, you must have:

  1. An active Atlassian account to use Bitbucket
  2. Read and Write access to the repository in which you want to add Qualitia projects or from which you want to access Qualitia projects.

Preparing Local Git Environment

In order to get started with the Bitbucket integration, you need to set up the environment. You can prepare test environment either using Sourcetree or Git Bash. We recommend using SourceTree for interacting with your Bitbucket repositories.

Setting Up Environment Using SourceTree (Recommended)

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.


...

Widget Connector
width700
urlhttps://www.youtube.com/watch?v=3EPT2RMaCrY&feature=youtu.be
height450

SourceTree Installation and Configuration


Info
titleImportant Note

At the end of this topic, Qualitia admin user will be able to install and configure Sourcetree.

...

Multiexcerpt macro
nameInstallandConfigureSourceTree

Install SourceTree and Configure Credentials

In order to start working with your Bitbucket repositories, you must first install and configure sourceTree. 

  1. Download and install SourceTree.
  2. Post installation, launch SourceTree.
  3. From the Tools menu, select Options.
  4. In Authentication, click Add.
    1. Set Hosting Service as Bitbucket.
    2. Enter the Host / IP and port number where Bitbucket server is hosted.
      This option is only available for Bitbucket Server edition. 
    3. Set Prefered Protocol as HTTPS.
    4. Authentication as Basic.
    5. In Username, enter your Bitbucket account username.
    6. Click Refresh Password to authenticate username.

      An Authentication window appears.
    7. Enter your Bitbucket password.
    8. Select the Remember Password option and then click Login.
      SourceTree is now configured for working with the Bitbucket repositories.


Creating a Repository for Qualitia Projects

After you configure SourceTree, you can now create a repository on the local system.

...

Info

This is a one-time activity for each repository you create on Bitbucket. Commiting sample file is mandatory for creating new branches into the repository to add Qualitia project data.


Adding Existing Qualitia Projects to Bitbucket Repository

After you clone the repository, you can now add your existing Qualitia projects to 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:

Multiexcerpt macro
nameCreateBranchBeforeCreatingNewProjects
  1. Launch SourceTree.
  2. On the left hand side, expand Branches and then Checkout master branch.

  3. From the top section, click Branch > New Branch.
  4. Enter the New branch name. The same name should be used while creating a new Qualitia project.
  5. Keep the Checkout New Branch option selected. 
  6. Click Create Branch.
  7. After creating a branch, right-click the branch and select Push > Origin. 
  8. On the subsequent screen, click Push. 
  9. Now you can create new project from Qualitia using the same name which you have used while creating a branch.


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
page(8.3.0 2) SourceTree Installation and Configuration

Clone Bitbucket Repository and Checkout Project

After the initial setup and SourceTree configuration, you can clone the Bitbucket repository and checkout Qualitia projects on your local system.

...

  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.

Getting New Qualitia Projects from Remote Repository

In case you already have the repository cloned at your system and now you want to get new Qualitia project to work on, you need to checkout these projects from the remote repository.

...

Setting Up Environment Using Git Bash

You can set up the environment using Git Bash.


...

Widget Connector
width700
urlhttps://www.youtube.com/watch?v=PHMczK5dp30&feature=youtu.be
height450

Installations and Configurations

GIT Client Installation

Bitbucket is a version control system. You can use Bitbucket to store and manage your Qualitia projects. Before you start working with Bitbucket from Qualitia, you need to prepare your Windows computer.

...

Multiexcerpt macro
nameGitClientInstallation


Update Bitbucket Configuration File
Anchor
UpdateBitbucketConfigurationFile
UpdateBitbucketConfigurationFile

After you install git client, you must add Bitbucket user name and email into the configuration file using command line interface (Git Bash).

...

  1. Launch Git Bash.

  2. To add bitbucket username, enter the following command and press Enter.
    Replace John Doe with your Bitbucket username.

    Code Block
    $ git config --global user.name "johndoe"


  3. To add bitbucket email of the user, enter the following command and press Enter.
    Replace email with your email configured with Bitbucket account.

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


Creating a Repository in Bitbucket

You can create a repository on Bitbucket and add your Qualitia projects to this repository. Bitbucket considers every Qualitia project as a single branch.

...

  1. Log on to your Bitbucket instance.
  2. Click the + icon and create a new repository.
  3. Enter Repository name.
    (info) Repository name should not contain white spaces.
  4. Mark this repository as private selecting the Access Level checkbox.
  5. Select Version Control as Git.
  6. In the Advanced Settings, select Language as XML.
  7. Click Create repository.
    You can now add Qualitia projects to this repository. Every single Qualitia project will be considered as different branch.

Cloning a Repository

After you create a repository in Bitbucket, you must clone it on your local system to start working on it. 

...

  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.

...

Adding the Existing Qualitia Projects to Bitbucket Repository

After you clone the repository and completed initial commit, you can now add the Qualitia projects artifacts to Bitbucket repository. This is a one-time activity. The Bitbucket repository adds each project in different branches so that you can track the changes in Qualitia projects artifacts easily.

...

Creating New Qualitia Projects

Before creating new project in Qualitia, you must first create the project branch in the Bitbucket repository.

...

  1. Launch Git Bash.
  2. Navigate to the Qualitia Project path.
    You will find this location in Settings> Configuration Setting > Dependency section. Assuming this is the path where you have cloned the repository.

  3. Enter the following commands:

    Code Block
    $ git checkout master
$ git branch <ProjectName>
$ git checkout <ProjectName>
$ git push --set-upstream origin <project name>


  4. Create new project from Qualitia Automation Studio with the same name which you have used to create new branch (as mentioned in the command above).

...

Cloning Bitbucket 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 on local system.

...

  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
    page(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.

...

Getting New Qualitia Projects From the Remote Repository

In case you already have the repository cloned at your system and now you want to get new Qualitia project to work on, you need to checkout these projects from the remote 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.

Creating/Editing Tasks/Test Cases

When you work on a project which is shared over a Bitbucket repository, multiple users can access test artefacts (test cases or tasks) based on their requirements. Qualitia locks test artefacts in case multiple users try accessing them at the same time to avoid conflicts and overwrites.

...

When User A

Qualitia

So that

Clicks Test Case ABC to open it

Gets the update for Test Case ABC and all tasks

The latest test is always available to the user.

Tries editing Task A by adding a step or editing a step (from Test Cases or Tasks section)

Gets task and then locks Test Case ABC and Task A and allows User A to edit

Only User A has exclusive rights to edit Test Case ABC and Task A, thus avoiding change conflicts between multiple users.

Edits and saves the test case.

Saves the test case and releases the lock.

Changes are updated and available to other users immediately.

Editing a Task / Test Case

Qualitia validates and opens the latest version of the tasks/test cases while accessing them. Multiple users cannot edit the same task or test case simultaneously. If a user is working on a task, others cannot edit it.

...

A task/test case can be edited by another user only when the first user saves it and navigates to some other screen. This releases the lock on the task/test case.

Suite Execution

At the time of Suite execution, Qualitia checks if the test cases and tasks from the suite have been modified. The latest version of the test cases is taken for the Suite execution.

In case any test case or task is in the edit mode when triggering the suite execution, the corresponding task or test case is skipped while execution.

Scheduler Execution

When the test suites are executed via scheduler, Qualitia takes latest version of the tasks and test cases for execution.

In case any test case or task is in the edit mode, scheduler execution proceeds with the rest of the test cases.

Reports

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

You can unlink the Qualitia project from the Bitbucket repository. 

...