Quick Start Guide

• Introduction

• Purpose

• Overview

• Planning Phase Activities

• Design Phase Activities

• Execute Phase Activities

• Reporting Phase Activities

Introduction

Bqurious is a complete Test Automation & Management Suite developed keeping in mind needs of an enterprise running multiple Projects and Applications. It has the following features:

• Single platform to manage all your testing needs from anywhere.

• Define, Manage and track – 

  1. Multiple Projects 

  2. Multiple Releases or Sprints 

  3. Define Requirements or User Stories 

• Automated Test creation can start as soon as screen layout design (wireframes etc.) are done. 

• Create “Programming Less” Automated Functional Test Cases and map to Requirements/Stories and Releases/sprints for easy traceability. 

• Manage Test Data for different environments in a single place. 

• Execute automated Test Cases on one or more platform–browser combinations and Analyze consolidated results with screenshots. 

• Log defect in the system of your choice at the click of a button. 

• Role based security. 

• Support Agile and Waterfall methodologies. 

• Local & Remote Execution in Parallel for Automation Suite. 

• Jira Integration

• Integration with CI/CD tools

Purpose

The purpose of this document is two folds:

1. Get a first time user started with the fundamentals of Bqurious in the shortest possible time.

2. Act as a reference for an experienced user.

Overview

Bqurious Test Automation and Management platform is designed to cover activities of the entire Software Test Life cycle as outlined in the graphic below.

Open

Register a user

1. Access the link https://app.bqurious.com/register

2. Fill in the details :

   1. First Name

   2. Last Name

   3. Email

   4. Organization

   5. Password

   6. Confirm Password

   7. Partner Code (if you have any)

3. Select the checkbox for ‘I agree to the Terms of services’.

4. Click on Create My Account button.
   You will receive an email on the registered email to confirm your account and reset the password if someone from your team created the account for you.

Watch a video :

The below video shows how to register a user on the Bq Platform.

Open

Installing the client

1. Login with your credentials.

2. Click on the user icon, displayed in the top right corner.

3. Click on Download Client.

4. Once the file is downloaded, double click to run it.
   Ensure that you have a valid JRE 1.8+ installed and properly configured on your machine.

5. Select the packs as per your requirement and follow through with the installation as directed in subsequent screenshots.

6. When prompted, enter the credentials to successfully register the client. Select the browsers installed on your machine & click on Next.

7. If you select the In-premise Install option, Bqurious populates the BQ Auth URL and BQ Node Server URL.
   In case, if they are not populated, please set the paths in environment variables and try again.

8. Although BQ client auto detects the proxy settings. In case, you want to enter the proxy settings manually then select the radio button Enter Manually and enter proxy setting manually.

9. Click on the Done button to complete the installation.

Watch a video :

The below video shows how to install a client before automating your tests.

Planning Phase Activities

1. Create User Stories / Requirements.

2. Create Sprints and Assign User Stories to be worked upon in the sprint.

Create Project and Application

1. Click on Setup.

2. Click on Project.

3. Click on Add Project button.

4. Enter details :

   1. Title

   2. Description (Optional)

   3. Start Date (Optional)

   4. End Date (Optional)

5. Click on Save button.

6. Click on Add Application button.

7. Enter details :

   1. Title

   2. Description (Optional)

   3. Methodology : Agile / Waterfall
      If you select Agile, Sprint & User Story will be displayed as options under Plan.
      If you select Waterfall, Release & Requirement will be displayed as options under Plan.
      Please note that though the terminology is different, they work in similarly.

   4. Type : Web / SAP Windows Gui / Mobile Native / ETL

8. Click on Save button.

Watch a video :

The below video shows how to create a project and application within the platform.

Create Sprint

1. Click on Plan from left pane.

2. Click on Sprint.
   This will redirect you to the Sprint Details screen.

3. Click on Add Sprint button.

4. Provide the sprint metadata :

   1. Sprint Name

   2. Sprint Description (Optional)

   3. Sprint Start Date (Optional)

   4. Sprint End Date (Optional)

5. Click on Save button.

Watch a video :

The below video shows how to create a sprint.

Create User Story

1. Click on Plan from left pane.

2. Select User Story option.

3. Click on Add Epic button.

4. Enter Details :

   1. Name

   2. Description (Optional)

5. Click on Save button.

6. Click on Add Story button.
   User Story Details form will be displayed.

7. Enter the user story meta data :

   1. User Story Title

   2. Select sprint from Planned in Sprint drop down in which user story is planned (Optional)

   3. Select sprint from Completed in Sprint drop down in which the user story planned to be completed (Optional)

   4. Select type of user story Functional / Non-functional from Type drop down

   5. Enter description about user story

   6. Define Risk

   7. Define As - a <role>, I Want <feature>, So That <reason> and Acceptance Criteria <Expected>

8. Click on Save button.

Watch a video :

The below video shows how to create an epic and user story.

Design Phase Activities

1. Create Automated Functional Test Cases. 

2. Assign Test Cases to User Stories for end to end traceability.

3. Create Test Suites for future execution.

Create a Test case

1. Click on Design on left panel.

2. Click on Test Case.

3. Click on Add Module button. 
   Module Details form will be displayed. Modules are folders to organize tests. They can be nested to any level.

4. Enter Module meta data :

   1. Enter Module Name

   2. Enter Module Description (Optional)

   3. Enter Module Priority (Optional)

5. Click on Save.

6. Click on Add Test button.
   Test Case Details form will be displayed.

7. Enter Test Case meta data.

   1. Enter the test case Objective : a single liner to define what the test is supposed to test.

   2. Select Automated from the dropdown Manual : Bq supports both Automated and Manual tests.

   3. Select the Priority of the test case

   4. Select the Designer and Reviewer : This is used to send notifications at appropriate stages of the workflow. 

   5.  Enter the test case Summary : Add a description for this test so others can understand what this test is doing.

   6. Select test case Type : UI / API : Bq categorizes tests as either UI or API tests. Any functional test from end user perspective will be a UI test. For testing your backend REST APIs use API tests.

   7. Select the test case Category

   8. Select Test Path

   9. Select the Data file if you are using an external excel file for data.

   10. Select the checkbox(s) for test case category : Smoke, Integration, Regression or Partial Regression

   11. Select Sprint in which the test case is being worked upon.

   12. Select the checkbox for Generate manual steps if you wish to generate the manual steps for the automated test case

8. Click on Save button.

Watch a video :

The below video shows how to create a simple test case.

Record a Test Case

1. Click on the Test Step tab.

2. Click on Record button at the bottom.

3. In the popup that opens,

   1. Leave "Port Number" blank for now

   2. Select "Web" as the Application Type 

   3. Enter the URL of the application you want to create the test for

4. BQ Genie will start with the Recorder and a browser window.

5. Click "Start" button on the Genie window to start capturing your actions.

6. Work on the application as you would manually, performing actions that you want to be recorded.

7. Notice your actions are getting captured in the Genie Recorder Window.

8. As you go along, make sure you keep adding "Friendly Names" and "Screen Names" in the recorder window.

   1. Friendly Name is your key to the UI elements with an easy to remember identifier. Genie makes the best effort to automatically create a name for you, but in situations where it is unable to do so, you will need to add a friendly name.

   2. "Screen Name" is the name of the screen this element appears on. This helps you to keep your Element Repository organized and also helps the Genie Scanner to automatically identify any changes in your screen.

9. After you are done, click on "Save" button in the Genie recorder window. Your test will be saved and the BQ App Window will automatically update to show your recorded steps.

10. Save the Test Case.

Watch a video :

The below video shows how to record test steps for a test case.

Map a Test Case to User Story

1. Click on the Story Mapping tab.
   The created Epic and User story will be displayed under 'Select Story to map with this test' section.

2. Select the checkbox for the desired User Story.
   Story details and type will be displayed.

3. Click on Save button.

Watch a video :

The below video shows how to map a test case to a user story.

Create a Test Suite & add tests in the Suite

1. Click on Design.

2. Click on Test Suite.

3. Click on Add Test Suite button.

4. Add details in Suite Details screen :

   1. Title

   2. Description (Optional)

5. Click on Save button.

6. Click on the Test Cases tab.
   Module with created test cases will be displayed under 'Associate Test Cases to Suite' section.

7. Select the checkbox(s) for the test cases that you wish to add to the Test Suite.

8. Click on Save button.

Watch a video :

The below video shows how to create a test suite and add test to that suite for execution.

Execute Phase Activities

1. Execute Test Suite or Individual Test Cases.

Execute the test case locally to debug

1. Navigate to the test case screen by clicking on DESIGN > Test Case.

2. Select the test case you wish to execute.

3. Click on Test Steps tab.

4. Click on Run button.

5. On the Execution pop up window, select the browser and tag (if any).

6. Click on Go button. 
   The Local Executor window will be displayed with the below buttons :

   1. Play/Pause button : Used to pause the execution at a particular step or resume the execution.

   2. Step Over button : Used to run a single step in order to understand the issue better.

Watch a video :

The below video shows how to perform local execution in order to debug a test.

Execute the test cases via Test Suite

1. Click on Execute.

2. Click on Execute Automated Test.

3. Select the Suite that you wish to execute. You should be able to view the 'list of test cases' under that suite along with its 'Last Execution Details'.

4. Select the test cases that you wish to execute.

5. In the Execution Details section, please enter/select the below details. 

   • Run Name

   • Executing in Sprint (select the sprint in which you are executing the test cases)

   • Build Number

   • Browser instance (the number of browse instances you wish to run the test cases on)

   • Distributed across Machines (select the check box if you wish to distribute tests on various connected machines)

   • Execution Tags (if used any in the test cases)

   • Execute Tag First (if you wish to execute the tests tag wise)

   • Email execution Report To (email id to send the execution report to)

6. If you expand the Advanced Settings section, you will see two options Uninstall App (Mobile) and Clear App Data (Mobile).
   Clear App Data (Mobile) checkbox will be checked by default. 

   The Request Capture section will also be displayed with the following fields :

   1. Enable Proxy checkbox

   2. Proxy Port

   3. Allow URL

7. When you expand the Execution machine(s) section, you will see the Desktop/Device(s) section, where you should be able to view the connected machine's name & the browsers available on that machine (for Web) or the connected simulator/ emulator/ real devices (for Mobile).

8. Select the browser/device on which you wish to execute the test case.

9. Click on Run Selected button (if you have wish to execute selective test cases) or either click on Run All button (if you have wish to execute all test cases in the suite).

Watch a video :

The below video shows how to perform remote execution.

Reporting Phase Activities

1. Generating Reports

Export Execution Results

1. Click on Execute on the left nav.

2. Click on Execution History.

3. Select the execution from left pane.
   Execution Run / Test Case Result will be displayed for that particular run.

4. Click on Export Pdf button (if you wish to generate a report with only the test case status - Pass / Fail)
   This is same as the Export Pdf button available on the Execution Results-bqurious screen.

5. Click on Export HTML button.
   The file will be exported as a .zip file. Extract the file and open it.

Watch a video :

The below video shows how to export reports from execution results.

Generate a specific report

Suppose the application that you wish to generate the report for has five tests

• Demo Test 1 (Test Case status : In-Progress)

• Demo Test 2 (Test Case status : On-Hold)

• Demo Test 3 (Test Case status : Completed)

• Demo Test 4 (Test Case status : Block)

• Demo Test 5 (Test Case status : To Start)

Now suppose you wish to generate a report for “Test Creation“.

1. Click on Analytics.

2. Click on Current Snapshot tab.

3. Click on Run button for Test Creation option.

4. Enter the meta data :

   1. Select Application : The application for which the test completion report needs to be generated

   2. Select x-axis : To generate data on the basis of

   3. Select Filter (optional) : To filter the report
      The select filter appears only when you enter an application in the Select Application field.

5. Click on Run Report button.

Watch a video :

The below video shows how to export reports from Analytics.

Related articles :

https://bqurious.atlassian.net/wiki/spaces/BSD/pages/461930500