{"type":"doc","content":[{"type":"paragraph","content":[{"text":"AIO Tests allows easy reporting of JUnit results by supporting the import of the TEST-feature-results.xml (the output file of a JUnit execution).","type":"text"}]},{"type":"paragraph","content":[{"text":"With AIO Tests JUnit integration, developers will not need to write manual cases inside AIO Tests. They can write JUnit cases which will be imported (created) in AIO Tests along with their execution results. This results in a holistic view of the coverage of requirements (unit to manual to functional and end-to-end automated tests).","type":"text"}]},{"type":"paragraph","content":[{"text":"This article discusses how to import JUnit XML results and map them to existing cases in AIO Tests or generate new cases in AIO, in the absence of existing cases.","type":"text"}]},{"type":"paragraph","content":[{"text":" In this documentation, you’ll understand:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JUnit","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#JUnit"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JUnit Reporting","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/NAT/pages/1900879520#JUnit-Reporting"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sample JUnit XML Report","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#Sample-JUnit-XML-Report"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generating JUnit XML Report","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#Generating-JUnit-XML-Report"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Maven Surefire","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#Maven-Surefire"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JUnit 4 Settings","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/NAT/pages/1900879520#JUnit-4-Settings"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JUnit 5 Settings","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/NAT/pages/1900879520#JUnit-5-Settings"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ant","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#Ant"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JUnit 4 - JUnit Task","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#JUnit-4---JUnit-Task"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JUnit 5 - JUnitlauncher Task","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/NAT/pages/1900879520#JUnit-5---JUnitlauncher-Task"}}]}]}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Status Mapping JUnit → AIO Tests","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#[hardBreak]Status-Mapping-JUnit-%E2%86%92-AIO-Tests"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mapping automated JUnit tests to AIO Tests","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#[hardBreak]Mapping-automated-JUnit-tests-to-AIO-Tests"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Examples","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#Examples"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mapping using JUnit5 @DisplayName (when settings are done as shown above for DisplayName in SureFire/ANT task)","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#Mapping-using-JUnit5-@DisplayName-(when-settings-are-done-as-shown-above-for-DisplayName-in-SureFire/ANT-task)"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mapping one automated case with multiple manual cases with JUnit5 @DisplayName","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#Mapping-one-automated-case-with-multiple-manual-cases-with-JUnit5-@DisplayName"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mapping JUnit 4 case to existing manual case(s)","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#Mapping-JUnit-4-case-to-existing-manual-case(s)"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parametrized Named Cases Convention","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#Parametrized-Named-Cases-Convention"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parametrized Non-Named Cases","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#Parametrized-Non-Named-Cases"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Importing Results","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/NAT/pages/1900879520/JUnit#Importing-Results"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"JUnit","type":"text"}]},{"type":"paragraph","content":[{"text":"JUnit is one of the most widely used open-source Unit Testing frameworks for ","type":"text"},{"text":"JAVA","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" and has been a key player in promoting test-driven development.","type":"text"}]},{"type":"paragraph","content":[{"text":"The latest version of JUnit, ","type":"text"},{"text":"JUnit 5","type":"text","marks":[{"type":"link","attrs":{"href":"https://junit.org/junit5/docs/current/user-guide/"}}]},{"text":" has introduced many new features, new APIs, and the concept of a test engine to simplify test automation (e.g. @DisplayName, @BeforeXX, @ParametrizedTest, etc.).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"JUnit Reporting","type":"text"}]},{"type":"paragraph","content":[{"text":"JUnit’s ","type":"text"},{"text":"XML","type":"text","marks":[{"type":"link","attrs":{"href":"https://junit.org/junit5/docs/current/user-guide/#launcher-api-listeners-reporting"}}]},{"text":" report comes through the ","type":"text"},{"text":"Maven Surefire ","type":"text","marks":[{"type":"link","attrs":{"href":"https://maven.apache.org/surefire/maven-surefire-plugin/index.html"}}]},{"text":"plugin or through an ANT task.","type":"text"}]},{"type":"paragraph","content":[{"text":"Being one of the earliest testing frameworks and with a huge community base, JUnit’s XML report has gained widespread adoption. Many continuous integration servers accept JUnit XML reports as their de facto standard for reporting test results.","type":"text"}]},{"type":"paragraph","content":[{"text":"The report format gradually became ubiquitous for test results reporting and frameworks across languages like PyTest, Cucumber, Fitnesse, RSpec, Katalon, etc. All these have reporting extensions that generate the JUnit XML report, which implies cases from any of these frameworks can be imported into AIO Tests.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Sample JUnit XML Report","type":"text"}]},{"type":"expand","attrs":{"title":"TEST-FeatureTests.xml"},"content":[{"type":"codeBlock","content":[{"text":"\n\n \n \n ....\n \n \n expected: <10> but was: <1>\n at com.aio.tests.junit5.ForestCreatorTests.testCreateForest(ForestCreatorTests.java:24)\n]]>\n \n \n \n \n \n","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Generating JUnit XML Report","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Maven Surefire","type":"text"}]},{"type":"paragraph","content":[{"text":"The Maven surefire plugin is required to generate the JUnit XML Report.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"JUnit 4 Settings","type":"text"}]},{"type":"expand","attrs":{"title":"JUnit 4 pom.xml setting"},"content":[{"type":"codeBlock","content":[{"text":"\n \n \n org.apache.maven.plugins\n maven-surefire-plugin\n 3.0.0-M5\n \n ...\n \n","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"JUnit 5 Settings","type":"text"}]},{"type":"paragraph","content":[{"text":"If the JUnit 5 features are being utilized, the junit-jupiter-engine needs to be added with additional configurations for fine-grained configuration of reports.","type":"text"},{"type":"hardBreak"},{"text":"Tests need to be annotated with @DisplayName and ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" fields need to be set to true as shown below.","type":"text"}]},{"type":"paragraph","content":[{"text":"For more info, refer to ","type":"text"},{"text":"Maven Surefire - Using JUnit 5","type":"text","marks":[{"type":"link","attrs":{"href":"https://maven.apache.org/surefire/maven-surefire-plugin/examples/junit-platform.html"}}]}]},{"type":"expand","attrs":{"title":"JUnit 5 - Support for DisplayNames - Value in DisplayName would come as Method name."},"content":[{"type":"codeBlock","content":[{"text":"\n org.apache.maven.plugins\n maven-surefire-plugin\n 3.0.0-M5\n \n \n org.junit.jupiter\n junit-jupiter-engine\n 5.7.0-M1\n \n \n \n \n false\n 3.0\n true\n true\n true\n true\n \n.....\n \n ","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Ant","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are using Ant, the following tasks need to be used to generate the report.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"JUnit 4 - JUnit Task","type":"text"}]},{"type":"expand","attrs":{"title":"Task JUnit + JUnit report"},"content":[{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n \n\n\n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"JUnit 5 - JUnitlauncher Task","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the ","type":"text"},{"text":"junitlauncher","type":"text","marks":[{"type":"code"}]},{"text":" task allows launching the JUnit 5 test launcher and building the test requests to be executed by the test engine(s) supported by JUnit 5. For more information, please refer to ","type":"text"},{"text":"JUnitLauncher","type":"text","marks":[{"type":"link","attrs":{"href":"https://ant.apache.org/manual/Tasks/junitlauncher.html"}}]},{"text":".","type":"text"}]},{"type":"expand","attrs":{"title":"JUnit 5 ANT task"},"content":[{"type":"codeBlock","content":[{"text":"\n \n \n\n \n \n\n \n \n \n \n \n \n \n\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"XML generated by this formatter can be used as-is by the ","type":"text"},{"text":"junitreport","type":"text","marks":[{"type":"code"}]},{"text":" task.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"hardBreak"},{"text":"Status Mapping JUnit → AIO Tests","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","width":760.0,"localId":"c06b782c-8b93-4ad8-9940-6e27f0c23c35"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[157.0]},"content":[{"type":"paragraph","content":[{"text":"JUnit XML","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[350.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"AIO Tests Mapping","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[157.0]},"content":[{"type":"paragraph","content":[{"text":"No tag inside means Passed","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[350.0]},"content":[{"type":"paragraph","content":[{"text":"Passed case","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"Passed","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[157.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[350.0]},"content":[{"type":"paragraph","content":[{"text":"Skipped case either by @Ignore or others","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"Not Run","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[157.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[350.0]},"content":[{"type":"paragraph","content":[{"text":"Indicates that the test failed. A failure is a test which the code has explicitly failed by using the mechanisms for that purpose. e.g., via an assertEquals.","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"Failed","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[157.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[350.0]},"content":[{"type":"paragraph","content":[{"text":"Indicates that the test errored. An errored test is one that had an unanticipated problem. e.g., an unchecked throwable;","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"Failed","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Mapping automated JUnit tests to AIO Tests","type":"text"}]},{"type":"paragraph","content":[{"text":"In going with the simplicity advantage of AIO Tests, the JUnit integration has been designed as a simple and non-intrusive integration, without any extra dependency or coding required.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1476,"alt":"image-20200804-121437.png","id":"632d2875-a584-4153-8d1e-2d3feb9b5dc6","collection":"contentId-2026602633","type":"file","height":208},"marks":[{"type":"border","attrs":{"size":2,"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"There are 4 ways that a JUnit case is mapped to an AIO Case.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JUnit 5: ","type":"text","marks":[{"type":"strong"}]},{"text":"@DisplayName","type":"text","marks":[{"type":"code"}]},{"text":" gives a way to specify generic information in the test name instead of the hard rule-based Java method names. This can be used to specify an existing AIO Case Key.","type":"text"},{"type":"hardBreak"},{"text":"For example, ","type":"text"},{"text":"@DisplayName(\"SCRUM-TC-1973 : Test forest gets created.\")","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Testcase Key in Underscores:","type":"text","marks":[{"type":"strong"}]},{"text":" Since Java and Python, do not allow hyphens in their method signatures, AIO Tests allows case keys with underscores as valid mapping. The AIO Test key can be used in the method name by replacing the hyphen with underscores. eg. if AT-TC-123 is being automated by a test, the test method can be named ","type":"text"},{"text":"verifyNotNullType_AT_TC_123","type":"text","marks":[{"type":"code"}]},{"text":" and the results of this method will be marked against AT-TC-123.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Automation Key: ","type":"text","marks":[{"type":"strong"}]},{"text":"The mapping of an AIO Case to an automated JUnit case can happen through a field Automation Key, which can be specified in the Case in AIO Tests app as shown below. The automation key is the fully qualified name of the test method i.e. packagename.classname.methodname. ","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This can be useful at places where you do not want to add AIO case keys in the name or annotations or where automation is happening first without a manual case being created in AIO Tests.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1248,"alt":"image-20230217-193533.png","id":"7cd15fe5-fc9d-4fa2-aaa6-bc02dd08ce17","collection":"contentId-2026602633","type":"file","height":127}}]},{"type":"orderedList","attrs":{"order":4},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New Case Creation: ","type":"text","marks":[{"type":"strong"}]},{"text":"If no case key (e.g. SCRUM-TC-xx) or automation key is found with existing cases, a new case is created with:","type":"text"},{"type":"hardBreak"},{"text":"- Title as the ","type":"text"},{"text":"name","type":"text","marks":[{"type":"code"}]},{"text":" value from tag of the JUnit report","type":"text"},{"type":"hardBreak"},{"text":"- Automation key as ","type":"text"},{"text":"classname.name","type":"text","marks":[{"type":"code"}]},{"text":" from the JUnit report. ","type":"text"},{"type":"hardBreak"},{"text":"- Status as Published","type":"text"},{"type":"hardBreak"},{"text":"- Automation status as Automated","type":"text"},{"type":"hardBreak"},{"text":"- Automation owner as a user uploading the results","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The following flow summarizes the logic of JUnit case mapping when a key is not found via @DisplayName and via the Automation key.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1350,"alt":"image-20200825-054456.png","id":"9279767a-c409-4f15-abd0-93652555bd61","collection":"contentId-2026602633","type":"file","height":1264},"marks":[{"type":"border","attrs":{"size":2,"color":"#172b4d"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Below are a few examples that show the results of testing the ForestCreator.java class.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Mapping using JUnit5 @DisplayName (when settings are done as shown above for DisplayName in SureFire/ANT task)","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"1f58a","text":"🖊","shortName":":pen_ballpoint:"}},{"text":" ","type":"text"},{"text":"Add case key to Display name","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"@DisplayName(\"SCRUM-TC-2309 : Verify positive case - all trees get planted\")\n@Test\npublic void testPlantTree() {\n ForestCreator fc = new ForestCreator();\n int plantedTrees = fc.plantTrees(10);\n Assertions.assertEquals(plantedTrees, 10, \"Verify all trees get planted\");\n}\n\nReport:\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Output: ","type":"text","marks":[{"type":"strong"}]},{"text":"On import of the above report in AIO Tests, SCRUM-TC-2309 is updated. If case doesn’t exist then an appropriate error would be thrown","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Mapping one automated case with multiple manual cases with JUnit5 @DisplayName","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"1f58a","text":"🖊","shortName":":pen_ballpoint:"}},{"text":" ","type":"text"},{"text":"Add all case keys as part of the Display name","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"@DisplayName(\"SCRUM-TC-2307, SCRUM-TC-2308,SCRUM-TC-2350 : Verify positive case - all trees get planted\")\n@Test\npublic void testCreateForest() {\n ForestCreator fc = new ForestCreator();\n fc.plantTrees(1);\n fc.waterThePlants();\n fc.removeWeeds();\n Assertions.assertEquals(fc.getHealthyTreeCount(), 1, \"Verify end to end plant growth\");\n}\n\nReport:\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Output: ","type":"text","marks":[{"type":"strong"}]},{"text":"On import of the above report in AIO Tests, 3 cases are updated with the result of the above execution → ","type":"text"},{"text":"SCRUM-TC-2307, SCRUM-TC-2308 and SCRUM-TC-2350","type":"text","marks":[{"type":"code"}]},{"text":". If the case doesn’t exist then an appropriate error would be thrown","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Mapping JUnit 4 case to existing manual case(s)","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"1f58a","text":"🖊","shortName":":pen_ballpoint:"}},{"text":" ","type":"text"},{"text":"Method name can contain","type":"text","marks":[{"type":"em"}]},{"text":" case key with underscores:","type":"text"}]},{"type":"paragraph","content":[{"text":"plantTree_should_returnNumberOfTrees_AT_TC_222.","type":"text","marks":[{"type":"code"}]},{"text":"OR","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"1f58a","text":"🖊","shortName":":pen_ballpoint:"}},{"text":" The ","type":"text"},{"text":"Automation Owner would have to mark the automated key value in an existing case to ","type":"text","marks":[{"type":"em"}]},{"text":"com.aio.tests.junit4.ForestCreatorTests.plantTree_should_returnNumberOfTrees","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"1f58a","text":"🖊","shortName":":pen_ballpoint:"}},{"text":" If a single automated JUnit case needs to update multiple cases, then the automated key needs to be updated in multiple AIO Tests automation key values.","type":"text"}]},{"type":"codeBlock","content":[{"text":"@Test\npublic void plantTree_should_returnNumberOfTrees() {\n ForestCreator fc = new ForestCreator();\n int plantedTrees = fc.plantTrees(10);\n Assertions.assertEquals(plantedTrees, 10, \"Verify all trees get planted\");\n}\n\nReport:\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Output: ","type":"text","marks":[{"type":"strong"}]},{"text":"On import of the above report in AIO Tests, the automation key with ","type":"text"},{"text":"com.aio.tests.junit4.ForestCreatorTests.plantTree_should_returnNumberOfTrees","type":"text","marks":[{"type":"code"}]},{"text":" would be searched for and the cases marked with this key would be added to the cycle and updated.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Parametrized Named Cases Convention","type":"text"}]},{"type":"paragraph","content":[{"text":"With the release of the data-driven feature, it is now possible to create cases with datasets from JUnit cases.","type":"text"}]},{"type":"paragraph","content":[{"text":"The convention for creating data parameters with names is ","type":"text"},{"text":"(params: parameterName1={0}, parameterName2={1}, parameterName1={2})","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"eg.","type":"text"}]},{"type":"paragraph","content":[{"text":"(params: userType={0},profile={1},income={2})","type":"text","marks":[{"type":"code"}]},{"text":". This example would create a case with 3 data parameters: userType, profile, and income and create datasets based on the Junit source values","type":"text"}]},{"type":"paragraph","content":[{"text":"The below example would create a test case with ","type":"text"},{"text":"5 datasets ","type":"text","marks":[{"type":"code"}]},{"text":"and a data parameter named ","type":"text"},{"text":"month","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"expand","attrs":{"title":"JUnit 5"},"content":[{"type":"codeBlock","content":[{"text":"@ParameterizedTest(name=\"(params: month={0})\")\n@EnumSource(value=Month.class, names = {\"APRIL\", \"JUNE\", \"SEPTEMBER\", \"NOVEMBER\", \"FEBRUARY\"},\n mode = EnumSource.Mode.INCLUDE) \nvoid getValueForAMonth_IsAlwaysBetweenOneAndTwelve(Month month) {\n int monthNumber = month.getValue();\n assertTrue(monthNumber >= 1 && monthNumber <= 9);\n}","type":"text"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"expand","attrs":{"title":"JUnit 4"},"content":[{"type":"codeBlock","content":[{"text":"@Parameterized.Parameters(name=\"(params : numberA={0},numberB={1})\")\npublic static Collection data() {\n Object[][] obj = new Object[2][3];\n Random r = new Random();\n for (int i = 0; i < 2; i++) {\n Integer[] insert = {r.nextInt(10), r.nextInt(10), r.nextInt(20)};\n obj[i] = insert;\n }\n return Arrays.asList(obj);\n}\n\n@Test\npublic void test_addTwoNumbers() {\n assertEquals(calculator.add(numberA, numberB), expected);\n}","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"1f58a","text":"🖊","shortName":":pen_ballpoint:"}},{"text":" ","type":"text"},{"text":"A new flag has been introduced ","type":"text","marks":[{"type":"em"}]},{"text":"updateDatassets","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":". This flag controls, whether the change in datasets should be used to update the Junit datasets case or not. The value can be set to false, when a subset of datasets are being run to avoid removal of datasets. If set to true, this flag affects only existing datasets cases.","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Parametrized Non-Named Cases","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"1f58a","text":"🖊","shortName":":pen_ballpoint:"}},{"text":" ","type":"text"},{"text":"If the name is not specified, and a default report is generated, AIO Tests generates new parameter names for JUnit 5 reports, which elaborate on user data. However, on JUnit 4, in the absence of data in the report, cases would continue to work as individual cases.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"In the below case, AIO Tests would create a parameter named Parameter 1 and would create 5 datasets with the numbers [1, 3, 5, -3, and 15] as values.","type":"text"}]},{"type":"expand","attrs":{"title":"JUnit 5 Default report sample"},"content":[{"type":"codeBlock","content":[{"text":"\n \n \n \n ","type":"text"}]}]},{"type":"codeBlock","content":[{"text":"@RunWith(Parameterized.class)\npublic class ParametrizedRunTest {\n\n @Parameterized.Parameters\n public static Iterable planTrees() {\n return Arrays.asList(new Object[][] {\n { \"Baobab\" }, \n { \"Rainbow Eucalyptus\" },\n { \"Banyan\" }\n });\n }\n \nReport: \n\n\n but was:<[Rainbow Eucalyptus]>\n at com.aio.tests.ParametrizedRunNonNamedTest.plantTree(ParametrizedRunNonNamedTest.java:33)\n]]>\n\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Output:","type":"text","marks":[{"type":"strong"}]},{"text":" The case with automation key of ","type":"text"},{"text":"com.aio.tests.ParametrizedRunNonNamedTest.plantTree","type":"text","marks":[{"type":"code"}]},{"text":" would be updated - 3 runs would be created with 1st and 3rd run showing pass and 2nd run showing Failed status","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Importing Results","type":"text"}]},{"type":"paragraph","content":[{"text":"Post execution of a JUnit suite, the TEST-.xml file can be uploaded either via","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AIO Tests REST API ","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AioTests/pages/2026569775"}}]},{"text":"calls using multipart form data to upload file","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cycle options in the Cycles Tab inside AIO Tests","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AioTests/pages/2026700831"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Please follow the above links to continue to import results using either of the options.","type":"text"}]},{"type":"paragraph","content":[{"text":"For further queries and suggestions, please feel free to reach out to our customer support service via ","type":"text","marks":[{"type":"strong"}]},{"text":"help@aiotests.com","type":"text","marks":[{"type":"underline"},{"type":"strong"},{"type":"link","attrs":{"href":"mailto:help@aiotests.com"}}]},{"text":".","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph"}],"version":1}

Browser not supported