{"type":"doc","content":[{"type":"paragraph","content":[{"text":"AIO Tests supports importing Robot results through it’s support for JUnit reports. ","type":"text"},{"text":"Robot Framework","type":"text","marks":[{"type":"link","attrs":{"href":"https://robotframework.org/"}}]},{"text":", an open source automation framework, is a widely popular framework. It uses the keyword-driven testing technique approach and testcases are written in a tabular format. Several output files are created when tests are executed in Robot, one of them is an ","type":"text"},{"text":"xUnit compatible report","type":"text","marks":[{"type":"link","attrs":{"href":"https://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#xunit-compatible-result-file"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The JUnit xml file can then be imported into AIO Tests, to report results from Robot runs to AIO Tests. This document provides an overview on how you can generate the Junit report from Robot runs and upload it to AIO Tests. The demo example is based on ","type":"text"},{"text":"SeleniumLibrary","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/robotframework/SeleniumLibrary"}}]},{"text":", which is a web testing library for ","type":"text"},{"text":"Robot Framework","type":"text","marks":[{"type":"link","attrs":{"href":"https://robotframework.org/"}}]},{"text":" that utilizes the ","type":"text"},{"text":"Selenium Webdriver","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.seleniumhq.org/"}}]},{"text":" tool internally","type":"text"}]},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"7cf03592-85fd-4bb7-8502-4951fc9cf34b"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"f05883ac-1f06-497b-b6a1-a4cc095ed320"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Required Robot + Webdriver Setup","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pip install robotframework","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pip install --upgrade robotframework-seleniumlibrary","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the browser driver and set it in PATH ","type":"text"},{"text":"OR","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"pip install webdrivermanager","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Mapping Cases with AIO Tests","type":"text"}]},{"type":"paragraph","content":[{"text":"The below is just a sample test file, which opens the google and queries for a topic.","type":"text"}]},{"type":"paragraph","content":[{"text":"AIO Tests supports creating tests using the reports as well as mapping existing cases.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Mapping existing AIO Tests to automated Robot Tests","type":"text"}]},{"type":"paragraph","content":[{"text":"AIO Tests generates a unique key for each test created in AIO Test, example SCRUM-TC-1. To map an automated case to an existing AIO Test, ","type":"text"},{"text":"the test name can take the testcase key generated in its description. e.g.","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"AT-TC-299 : Login with existing user","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"In the example below, one existing AIO Test has been mapped to a Robot test","type":"text"}]},{"type":"codeBlock","attrs":{"language":"python"},"content":[{"text":"*** Settings ***\nDocumentation Simple AIO Test Integration example using SeleniumLibrary.\nLibrary SeleniumLibrary\n\n*** Variables ***\n${LOGIN URL} https://yourcompany.atlassian.net\n${BROWSER} Chrome\n${VALID USERNAME} yourusername\n${VALID PASSWORD} yourpassword\n${INVALID USERNAME} nothing@noasdf.com\n\n*** Test Cases ***\nAT-TC-299 Login with existing user\n Open Browser To Jira Login Page\n Input Text id:username ${VALID USERNAME}\n Click Button id:login-submit\n Wait Until Element is Visible id:password\n Input Password id:password ${VALID PASSWORD}\n [Teardown] Close Browser\n\nLogin with user not existing\n Open Browser To Jira Login Page\n Input Text id:username ${INVALID USERNAME}\n Click Button id:login-submit\n Wait Until Element is Visible id:displayName1\n [Teardown] Close Browser\n\n*** Keywords ***\nOpen Browser To Jira Login Page\n Open Browser ${LOGIN URL} ${BROWSER}\n\n","type":"text"}]},{"type":"paragraph"},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"This would pull AT-TC-299 in the execution cycle and mark the result AT-TC-299 as passed i.e.","type":"text"},{"text":"”Login with existing user","type":"text","marks":[{"type":"code"}]},{"text":"” against AT-TC-299","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating new cases in AIO Tests from automated Robot Tests","type":"text"}]},{"type":"paragraph","content":[{"text":"If no new key is specified in the spec, then new cases can be created using the results of the tests.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the above code example, the second test has no key mapped and hence this would create a new test in AIO Tests.","type":"text"}]},{"type":"paragraph","content":[{"text":"While importing results, if the Create New Case selection is true, then AIO Tests will use the ","type":"text"},{"text":"classname.methodname","type":"text","marks":[{"type":"code"}]},{"text":" e.g. in the above case, from the Junit results file as a ","type":"text"},{"text":"unique automation key to identify the test to AIO Tests. ","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"In the above example, second test would be created with","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"Test1.Login with user not existing.","type":"text","marks":[{"type":"code"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"AIO Tests key would still be generated of the format SCRUM-TC-xyz, which can then be added to the test name. This would ensure that changes to the description do not end up creating cases where new cases were not intended.","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration and Running ROBOT tests with Junit option","type":"text"}]},{"type":"paragraph","content":[{"text":"Since Robot has added native support for JUnit, no new dependencies need to be added to generate the JUnit report. Tests can be triggered as below with the -x option and the name, that you would like for your results file","type":"text"}]},{"type":"codeBlock","content":[{"text":" robot -x junitresult.xml tests/test1.robot ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sample report file","type":"text"}]},{"type":"paragraph","content":[{"text":"The spec file runs and generates a test-output file under the results folder. A sample JUnit results file looks like below:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\n\n\n\n\n","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":"https://aioreports.atlassian.net/wiki/spaces/NAT/pages/1900880129/Import+Results+-+Automated+upload+using+REST+API"}}]},{"text":" call using multipart form-data to upload file","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cycle options in Cycles Tab inside AIO Tests","type":"text","marks":[{"type":"link","attrs":{"href":"https://aioreports.atlassian.net/wiki/spaces/NAT/pages/1900879982/Import+Results+through+Cycles+Tab"}}]}]}]}]},{"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":"Importing the above file will mark AT-TC-299 as ","type":"text"},{"text":"Passed","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" in the cycle.","type":"text"}]},{"type":"paragraph","content":[{"text":"A new case would be created with title ","type":"text"},{"text":"Login with user not existing","type":"text","marks":[{"type":"code"}]},{"text":" and added to the cycle with a result of ","type":"text"},{"text":"Failed","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]}],"version":1}