{"type":"doc","content":[{"type":"paragraph","content":[{"text":"AssertThat - BDD & Cucumber for Jira provides a Maven plugin to enable integration with your automated test framework.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download Feature files - downloadFeatures","type":"text","marks":[{"type":"link","attrs":{"href":"https://assertthat.atlassian.net/wiki/spaces/ABTM/pages/728760487/Gradle+plugin#Download-Feature-files---downloadFeatures"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upload test results (cucumber json file) into AssertThat - submitReport","type":"text","marks":[{"type":"link","attrs":{"href":"https://assertthat.atlassian.net/wiki/spaces/ABTM/pages/728760487/Gradle+plugin#Upload-test-results-(cucumber-json-file)-into-AssertThat---submitReport"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mandatory fields","type":"text","marks":[{"type":"link","attrs":{"href":"https://assertthat.atlassian.net/wiki/spaces/ABTM/pages/728760487/Gradle+plugin#Mandatory-fields"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example project","type":"text","marks":[{"type":"link","attrs":{"href":"https://assertthat.atlassian.net/wiki/spaces/ABTM/pages/728760487/Gradle+plugin#Example-project"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"build.gradle","type":"text","marks":[{"type":"link","attrs":{"href":"https://assertthat.atlassian.net/wiki/spaces/ABTM/pages/728760487/Gradle+plugin#build.gradle"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Download Feature files - downloadFeatures","type":"text"}]},{"type":"paragraph","content":[{"text":"The scenarios and feature files can be downloaded from the plugin into your automation test framework using the plugin provided. In addition to using tags to filter the scenarios for execution, the plugin provides 3 optional fields:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JIRA JQL - JQL filters can be developed using the ","type":"text"},{"text":"JIRA's advanced searching functionality","type":"text","marks":[{"type":"link","attrs":{"href":"https://confluence.atlassian.com/jirasoftwarecloud/advanced-searching-764478330.html"}}]},{"text":" e.g. “Sprint = 5”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"mode - This field is set for each scenario in AssertThat and is set as default to Automated - ","type":"text"},{"text":"Automated and Manual tests","type":"text","marks":[{"type":"link","attrs":{"href":"https://assertthat.atlassian.net/wiki/spaces/ABTM/pages/725090428"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"tags - tag expression filter for scenarios e.g. tags = \"(@smoke or @ui) and (not @slow)\". More on tag expressions","type":"text"},{"text":" https://cucumber.io/docs/cucumber/api/#tag-expressions","type":"text","marks":[{"type":"link","attrs":{"href":"https://cucumber.io/docs/cucumber/api/#tag-expressions*/"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Upload test results (cucumber json file) into AssertThat - submitReport","type":"text"}]},{"type":"paragraph","content":[{"text":"The AssertThat - BDD Test Automation in Jira will parse the results of the cucumber json file and load them so that the results can be viewed in Jira alongside the user stories - ","type":"text"},{"text":"Test Execution status for User Stories","type":"text","marks":[{"type":"link","attrs":{"href":"https://assertthat.atlassian.net/wiki/spaces/ABTM/pages/728203292"}}]},{"text":". The automated test results will automatically be linked to existing defects and the results loaded into the reporting tool. The failed tests can then be easily reviewed and assigned for further analysis - ","type":"text"},{"text":"Automated Test Report Analysis","type":"text","marks":[{"type":"link","attrs":{"href":"https://assertthat.atlassian.net/wiki/spaces/ABTM/pages/725385335/Automated+Test+Report+Analysis"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Mandatory fields","type":"text"}]},{"type":"paragraph","content":[{"text":"The only mandatory field required is the projectId. The following parameters are also required however can be passed as environment variables - ","type":"text"},{"text":"ASSERTTHAT_ACCESS_KEY","type":"text","marks":[{"type":"code"}]},{"text":" and the ","type":"text"},{"text":"ASSERTTHAT_SECRET_KEY","type":"text","marks":[{"type":"code"}]},{"text":". All 3 parameters are available from the AssertThat Configuration page - ","type":"text"},{"text":"AssertThat Configuration","type":"text","marks":[{"type":"link","attrs":{"href":"https://assertthat.atlassian.net/wiki/spaces/ABTM/pages/725385217/AssertThat+Configuration"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Usage","type":"text"}]},{"type":"paragraph","content":[{"text":"We recommend running cucumber tests on ","type":"text"},{"text":"integration-test","type":"text","marks":[{"type":"code"}]},{"text":" phase as","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"download features is running on ","type":"text"},{"text":"pre-integration-test","type":"text","marks":[{"type":"code"}]},{"text":" phase","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"report submission on ","type":"text"},{"text":"post-integration-test","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"Alternatively, if you are running your tests on ","type":"text"},{"text":"test","type":"text","marks":[{"type":"code"}]},{"text":" phase, then change features and report phases as follows","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"download features is running on ","type":"text"},{"text":"generate-test-resources","type":"text","marks":[{"type":"code"}]},{"text":" phase","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"report submission on ","type":"text"},{"text":"test","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example project","type":"text"}]},{"type":"paragraph","content":[{"text":"Refer to example project ","type":"text"},{"text":"assertthat-bdd-maven-example","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/assertthat/assertthat-bdd-maven-example"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pom.xml","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n com.assertthat.plugins\n assertthat-bdd-maven-plugin\n 1.7.3\n \n \n \n \n \n \n \n \n \n \n \n \n \n https://mycompanyjira.com\n \n \n \n \n \n src/test/resources/com/assertthat/features\n \n project = XX AND key in ('XXX-1')\n \n automated\n \n (@smoke or @ui) and (not @slow)\n \n cucumber\n \n true\n \n true\n \n features\n \n features\n \n pre-integration-test\n \n \n report\n \n report\n \n post-integration-test\n \n \n target/report/surefire-reports/cucumber/\n \n **/cucumber.json\n \n cucumber\n \n project = XX AND key in ('XXX-1')\n \n true\n \n \n \n","type":"text"}]}],"version":1}