...

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.

To install Git client, on your Windows machine:

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).

To add user details:

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.

To create new repository on Bitbucket:

1. Log on to your Bitbucket instance.

2. Click the + icon and create a new repository.

3. Enter Repository name.
    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.

   Image Modified

Cloning a Repository

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

To clone the repository:

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.

To create initial commit:

1. Navigate into the folder where you have cloned the Bitbucket repository.

2. Right-click and select the Git Bash Here option.

3. Enter the following commands one-by-one to create, add, commit a file into the Bitbucket repository.

   Code Block
   $ echo "Earth's Moon" >> locations.txt $ git add locations.txt $ git commit -m "<your comment>"

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.

...

...

To add the existing Qualitia projects to the Bitbucket repository:

1. Navigate to the folder where you have cloned the repository.

2. Move your existing project folder (<ProjectName>_projectdb) to this location.
   You will get this location in Qualitia Configuration Settings > Dependency > Project Path.

3. Launch Git Bash.

4. Enter the following command to checkout the master branch before you add a new branch for the project that you want to add into GIT repository. .

   Code Block
   $ git checkout master

5. Enter the following command to add a separate branch in the Bitbucket repository to store the project, 

   Code Block
   $ git branch <project name>

6. Enter the following command to checkout this newly created branch on the local system.

   Code Block
   $ git checkout <project name>

7. Enter the following commands to add the projects artifacts into the Bitbucket repository:

   Code Block
   $ git add <project name>_projectdb/Tasks/ $ git add <project name>_projectdb/TestCases/ $ git add <project name>_projectdb/project name_QASJavaproject/

...

1. Note: Do not add the Environment Variable folder as it differs for every user.

2. Enter the following commands to add the desktop project artifacts into the Bitbucket repository:

   Code Block
   $ git add <project name>_projectdb/Tasks/ $ git add <project name>_projectdb/TestCases/ $ git add <project name>_projectdb/project name_QASJavaproject/ $ git add <project name>_projectdb/project name_QFDCustomActions/

...

1. Note: Do not add the Environment Variable folder as it differs for every user.

2. After you add the project artifacts, commit and push the changes to the repository by adding the appropriate comments.

   Code Block
   $ git commit -m '<project name> <your comment>' $ git push --set-upstream origin <project name>

3. Now copy the parent directory path in which you have checked-out the project and set it as Qualitia ProjectPath (in Configuration Setting > Dependency).

4. In the General section, select Version Control as GIT and enter your Bitbucket Username and Password.

5. Restart Qualitia to start working on the desired projects.

Creating New Qualitia Projects

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

To create new project branch:

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.

To access existing Qualitia project from Bitbucket repository:

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

...

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

...

1. • Download and install Git client (v2.19.0)

   • Download and install Git credential manager (v1.16.3)

2. Launch Git Bash.

...

...

1. Update 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"

2. Enter the following command to clone the repository.

   Code Block
   $ git clone <Repository URL>

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

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

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

4. 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.

5. 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.

To checkout new Qualitia projects:

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.

The following table illustrates what Qualitia does when a task or test case is created or edited.

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.

In case any other user tries to edit the task/test case, Qualitia gives the following message:

...

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.

...

Unlinking Project From Bitbucket Repository

You can unlink the Qualitia project from the Bitbucket repository. 

To unlink Qualitia project from the Bitbucket repository:

1. Log on to Qualitia Automation Studio.

2. From the Setting menu, click Project Setting.

3. In Version Control, select None.

4. Click OK.

5. Restart Qualitia to start working on the desired project.
   Changes made to the tasks and test cases will now no longer be pushed to the Bitbucket repository.