Importing Cucumber Tests
The following endpoint is provided to import a Cucumber ".feature" file or a zip file containing multiple ".feature" files. The files in the zip file may be in folders/subfolders:
|Cucumber ".feature" file||/rest/raven/1.0/import/feature|
Each ".feature" file will be processed as follows:
- The "Scenario" or "Scenario Outlines" should be imported to Tests, of the Test Type "Cucumber", with the respective Cucumber Type filled out.
- A Test will be uniquely identified by the name of the test case that follows the "Scenario/Scenario Outline" sections. Therefore, if a test is found with the same name, then it will be updated; otherwise, a new Test will be created in JIRA.
The mapping from the Scenario/Scenario Outline present in the .feature files to the Test issues in JIRA would be as follows:
|Scenario/Scenario Outline||Test in JIRA|
|name of the Scenario/Scenario Outline||"Summary" field|
|tags of the Scenario/Scenario Outline||labels|
The "Feature" section is not imported, since the feature itself should exist previously as a JIRA requirement issue (e.g. story).
The exception is the tags before the "Feature: " section; if a requirement issue is found for the specified key, then a "Tests" link is created between the Test and the requirement issue.
If the cucumber feature has background, a Pre-Condition issue will be created containing the information provided in that background. If the background has no name, then the Summary of the Pre-Condition is going to be a string containing the keys of the Tests of that Cucumber feature.
Below is an example of a .feature file containing a Scenario Outline:
Feature: As a user, I can calculate the sum of 2 numbers
@UI @core Scenario Outline: Cucumber Test As a user, I can calculate the sum of 2 numbers Given I have entered <input_1> into the calculator And I have entered <input_2> into the calculator When I press <button> Then the result should be <output> on the screen Examples: | input_1 | input_2 | button | output | | 20 | 30 | add | 50 | | 2 | 5 | add | 7 | | 0 | 40 | add | 40 | | 4 | 50 | add | 54 |