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 –
Multiple Projects
Multiple Releases or Sprints
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:
Get a first time user started with the fundamentals of Bqurious in the shortest possible time.
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.
Before automating the tests, please make sure that the client is up and running.
Please refer to the below documents before starting :
Pre-requisites
/wiki/spaces/BSD/pages/17357665
Register a user
Access the link https://app.bqurious.com/register
Fill in the details :
First Name
Last Name
Email
Organization
Password
Confirm Password
Partner Code (if you have any)
Select the checkbox for ‘I agree to the Terms of services’.
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 :
Installing the client
Login with your credentials.
Click on the user icon, displayed in the top right corner.
Click on Download Client.
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.Select the packs as per your requirement and follow through with the installation as directed in subsequent screenshots.
When prompted, enter the credentials to successfully register the client. Select the browsers installed on your machine & click on Next.
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.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.
Click on the Done button to complete the installation.
Watch a video :
Planning Phase Activities
Create User Stories / Requirements.
Create Sprints and Assign User Stories to be worked upon in the sprint.
Create Project and Application
Click on Setup.
Click on Project.
Click on Add Project button.
Enter details :
Title
Description (Optional)
Start Date (Optional)
End Date (Optional)
Click on Save button.
Click on Add Application button.
Enter details :
Title
Description (Optional)
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.Type : Web / SAP Windows Gui / Mobile Native / ETL
Click on Save button.
Watch a video :
Create Sprint
Click on Plan from left pane.
Click on Sprint.
This will redirect you to the Sprint Details screen.Click on Add Sprint button.
Provide the sprint metadata :
Sprint Name
Sprint Description (Optional)
Sprint Start Date (Optional)
Sprint End Date (Optional)
Click on Save button.
Watch a video :
Create User Story
Click on Plan from left pane.
Select User Story option.
Click on Add Epic button.
Enter Details :
Name
Description (Optional)
Click on Save button.
Click on Add Story button.
User Story Details form will be displayed.Enter the user story meta data :
User Story Title
Select sprint from Planned in Sprint drop down in which user story is planned (Optional)
Select sprint from Completed in Sprint drop down in which the user story planned to be completed (Optional)
Select type of user story Functional / Non-functional from Type drop down
Enter description about user story
Define Risk
Define As - a <role>, I Want <feature>, So That <reason> and Acceptance Criteria <Expected>
Click on Save button.
Watch a video :
Design Phase Activities
Create Automated Functional Test Cases.
Assign Test Cases to User Stories for end to end traceability.
Create Test Suites for future execution.
Create a Test case
Click on Design on left panel.
Click on Test Case.
Click on Add Module button.
Module Details form will be displayed. Modules are folders to organize tests. They can be nested to any level.Enter Module meta data :
Enter Module Name
Enter Module Description (Optional)
Enter Module Priority (Optional)
Click on Save.
Click on Add Test button.
Test Case Details form will be displayed.Enter Test Case meta data.
Enter the test case Objective : a single liner to define what the test is supposed to test.
Select Automated from the dropdown Manual : Bq supports both Automated and Manual tests.
Select the Priority of the test case
Select the Designer and Reviewer : This is used to send notifications at appropriate stages of the workflow.
Enter the test case Summary : Add a description for this test so others can understand what this test is doing.
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.
Select the test case Category
Select Test Path
Select the Data file if you are using an external excel file for data.
Select the checkbox(s) for test case category : Smoke, Integration, Regression or Partial Regression
Select Sprint in which the test case is being worked upon.
Select the checkbox for Generate manual steps if you wish to generate the manual steps for the automated test case
Click on Save button.
Watch a video :
Record a Test Case
Click on the Test Step tab.
Click on Record button at the bottom.
In the popup that opens,
Leave "Port Number" blank for now
Select "Web" as the Application Type
Enter the URL of the application you want to create the test for
BQ Genie will start with the Recorder and a browser window.
Click "Start" button on the Genie window to start capturing your actions.
Work on the application as you would manually, performing actions that you want to be recorded.
Notice your actions are getting captured in the Genie Recorder Window.
As you go along, make sure you keep adding "Friendly Names" and "Screen Names" in the recorder window.
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.
"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.
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.
Save the Test Case.
BqGenie does not capture passwords. The user needs to enter the password manually in the test script.
You can mark the tests as per their status (In-Progress, Completed, On-Hold, Block) by selecting one of these options after clicking on the Mark Test button.
Watch a video :
Map a Test Case to User Story
Click on the Story Mapping tab.
The created Epic and User story will be displayed under 'Select Story to map with this test' section.Select the checkbox for the desired User Story.
Story details and type will be displayed.Click on Save button.
Watch a video :
To verify that the test case has been mapped to the user story, navigate to User Story and click on Associated Test Cases tab.
The Module and mapped Test Case will be displayed.
Create a Test Suite & add tests in the Suite
Click on Design.
Click on Test Suite.
Click on Add Test Suite button.
Add details in Suite Details screen :
Title
Description (Optional)
Click on Save button.
Click on the Test Cases tab.
Module with created test cases will be displayed under 'Associate Test Cases to Suite' section.Select the checkbox(s) for the test cases that you wish to add to the Test Suite.
Click on Save button.
Watch a video :
Execute Phase Activities
Execute Test Suite or Individual Test Cases.
Execute the test case locally to debug
Navigate to the test case screen by clicking on DESIGN > Test Case.
Select the test case you wish to execute.
Click on Test Steps tab.
Click on Run button.
On the Execution pop up window, select the browser and tag (if any).
Click on Go button.
The Local Executor window will be displayed with the below buttons :Play/Pause button : Used to pause the execution at a particular step or resume the execution.
Step Over button : Used to run a single step in order to understand the issue better.
Watch a video :
Execute the test cases via Test Suite
Click on Execute.
Click on Execute Automated Test.
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'.
Select the test cases that you wish to execute.
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)
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 :
Enable Proxy checkbox
Proxy Port
Allow URL
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).
Select the browser/device on which you wish to execute the test case.
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 :
Reporting Phase Activities
Generating Reports
Export Execution Results
Click on Execute on the left nav.
Click on Execution History.
Select the execution from left pane.
Execution Run / Test Case Result will be displayed for that particular run.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.Click on Export HTML button.
The file will be exported as a .zip file. Extract the file and open it.
Please note that HMTL reports do not show screenshots.
Watch a video :
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“.
Click on Analytics.
Click on Current Snapshot tab.
Click on Run button for Test Creation option.
Enter the meta data :
Select Application : The application for which the test completion report needs to be generated
Select x-axis : To generate data on the basis of
Select Filter (optional) : To filter the report
The select filter appears only when you enter an application in the Select Application field.
Click on Run Report button.
The generated report can be exported to .pdf by clicking on the Export icon on top right corner of the generated report.
The exported pdf file can be downloaded / printed easily.
The hierarchal structure (displayed on the bottom of the generated report) is available only for certain reports.
The date range should not exceed 90 days for reports that requite time duration to be generated.
Multiple applications can be selected in the Select Application field.
The generated report will display the data for different applications with different colors to differentiate between them.
Watch a video :
Related articles :
Understanding Bq Genie Recorder
Advanced Recording
Test Parameterization
Debugging Tests
Understanding Execution Screen
How to work with dynamic properties?
/wiki/spaces/BSD/pages/31522823
How to use Loops in a test?
Integrating with CI/CD pipeline
How to integrate with Jira
API Testing
Automating TvOS
How to use multiple technologies in a single Test?
How to use data from MS Excel ?
How to setup mail connection?
How to Run the same test on both Android and iOS
Running tests on real iOS device
Add Comment