Use qTest Scenario in Jira for Scenario

With qTest Scenario, teams can easily collaborate on Jira issues to create their features and scenarios through a native Gherkin editor experience.

Some of the benefits of using qTest Scenario editor include:

• Better collaboration and standardization of all feature files connected to your BDD framework.

• Facilitates auto-completion of tags which makes sure your features are organized correctly.

• Facilitates auto-completion at the step level for better reuse of previously implemented steps.

• Syntax checking and error handling directly in Jira keep teams from making mistakes.

Once you install and configure Scenario, you are ready to begin.

1. Navigate to your Jira backlog and select the appropriate project.

2. Create an Issue.

3. Enter your Issue criteria.

   The Description field is unnecessary to complete because your acceptance criteria for your requirements are described as the test.

4. Select Create.

5. Select the newly opened ticket from your backlog.

6. If you have not previously entered your Git information, or haven't done so recently, you will be prompted to re-enter your username and password. This is because the user that is using the Scenario plug-in will be directly changing the Git Repository.

   If you are using SSO, your Git Password with be your Git API Token instead of your personal Git Password.

   

7. In the Feature section of the Scenario plug-in, enter the file name that will create a feature file in your Git repository. The feature file name will auto-complete in the directory. If you are using nested folders, you will include the folder name in your file name.

8. Select your branch.

   /path/here/name.feature

   

   If the feature name directory already exists, qTest Scenario will notify the user upon saving. This helps limit the mistake of overwriting existing feature files in your VCS.
   Users cannot change an already existing feature file's name from within Jira.

9. Enter a description of the Feature.

10. In the Scenario section, enter the name of the Scenario or the name of the Test Case that will display in Manager.

11. Initially, enter the syntax of the Scenario steps to complete the test case, i.e. Given, When, etc. (The second Test Case and beyond, the syntax portion will auto-complete. You will have the option to use an already saved Syntax, or you can write a new one.)

    

12. Select Save.

qTest Scenario Highlights

qTest Scenario has the ability to speed up scenario creation inside of Jira while also maintaining a correct syntax structure. Below are these features:

Auto-complete Steps

The ability to auto-complete scenario steps is a huge time saver for new test scenario creation. Simply begin by typing any word in your Gherkin Given-When-Then steps to see existing steps displayed as suggestions. (These steps are saved after you begin using Scenario. As you continue to use the product, your 'library' of steps will grow.)

Auto-complete Tags

The ability to auto-complete feature tags helps organize your scenarios is an easier manner. Simply begin typing an @ and a letter to see any existing tags displayed as suggestions.

Syntax Checking

To make sure you are following proper Gherkin syntax, as qTest Scenario will enforce syntax checking. This limits the ability to create invalid scenarios in our BDD framework.

Save to Git Repository

Once you save, your feature file will be sent directly to your repository location that was defined when you configured Scenario.

1. Now that you have saved and your Git repository commit has been updated with the file entered in qTest Scenario, any changes that are edited in your Git repository will also be synced back into Jira.

   If you have the triggerJenkins Pulse Rule set up, you could have the rule pick up here to notify Jenkins of a new job.

   

2. View update in VCS.

   

3. Edit the feature file in VCS.

   

4. View update in Jira.