{"type":"doc","content":[{"type":"paragraph","content":[{"text":"AIO Tests simplifies the reporting of Robot results by facilitating the import of output.xml, the output file generated during robot test execution. This integration relieves developers from manually entering test cases into AIO Tests. Instead, they can create robot cases, and AIO Tests will automatically import and generate corresponding cases, incorporating their execution results.","type":"text"}]},{"type":"paragraph","content":[{"text":"This article outlines the process of importing Robot’s XML results, allowing for mapping existing cases in AIO Tests or generating new cases when none exist.","type":"text"}]},{"type":"paragraph","content":[{"text":"In this documentation, you’ll understand:","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"none"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"0e60faf5-e6d9-4dd7-8754-08f4eb76511f"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"cef9cd86-20d8-4600-9f54-22cfa93cc8d1"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Robot","type":"text"}]},{"type":"paragraph","content":[{"text":"Robot is a Python-based testing framework that supports. It is designed for acceptance test-driven development (ATDD), behavior-driven development (BDD), and robotic process automation (RPA).","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Robot Reporting","type":"text"}]},{"type":"paragraph","content":[{"text":"Robot Framework furnishes three output files: a log file, a report file, and an output file. The output file captures the test execution results in a machine-readable XML format. When tests are executed, the default name for the output file is \"output.xml.\" This XML file is utilized to import test cases from Robot to AIO Tests.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sample Robot XML Report","type":"text"}]},{"type":"expand","attrs":{"title":"Sample output.xml"},"content":[{"type":"codeBlock","content":[{"text":"\n\n \n \n \n \n ${LOGIN URL}\n ${BROWSER}\n Opens a new browser instance to the optional ``url``.\n Opening browser 'Firefox' to base url 'http://localhost:7272/'.\n \n \n \n Maximizes current browser window.\n \n \n \n ${DELAY}\n Sets the delay that is waited after each Selenium command.\n \n \n \n \n Login Page\n Verifies that the current page title equals ``title``.\n Page title is 'Login Page'.\n \n \n \n \n \n \n \n demo\n \n username_field\n ${username}\n Types the given ``text`` into the text field identified by ``locator``.\n Typing text 'demo' into text field 'username_field'.\n \n \n \n \n \n mode\n \n password_field\n ${password}\n Types the given ``text`` into the text field identified by ``locator``.\n Typing text 'mode' into text field 'password_field'.\n \n \n \n \n \n \n login_button\n Clicks the button identified by ``locator``.\n Clicking button 'login_button'.\n \n \n \n \n \n \n ${WELCOME URL}\n Verifies that the current URL is exactly ``url``.\n Current location is 'http://localhost:7272/welcome.html'.\n \n \n \n Welcome Page\n Verifies that the current page title equals ``title``.\n Page title is 'Welcome Page'.\n \n \n \n \n \n Closes the current browser.\n \n \n \n \n A test suite with a single test for valid login.\n\nThis test has a workflow that is created using keywords in\nthe imported resource file.\n \n \n \n \n All Tests\n \n value\n \n Valid Login\n \n \n \n \n","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Status Mapping Robot → AIO Tests","type":"text"}]},{"type":"table","attrs":{"width":760.0,"localId":"da999148-bf74-4689-9937-758f8a733e0e"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Robot","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"AIO Tests","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"PASS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"PASSED","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"FAIL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"FAILED","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"SKIP","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"NOT RUN","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"NOT RUN","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"NOT RUN","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Mapping Automated Robot Tests to AIO Tests","type":"text"}]},{"type":"paragraph","content":[{"text":"AIO Tests seamlessly integrates the Robot Framework for the import feature without the need for any additional dependencies or coding. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Users can relate their cases with existing AIO cases by tagging the test cases with AIO case keys.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1476,"alt":"image-20200804-121437-20231224-090936.png","id":"d6dece5b-0d4b-4fce-aa15-8b793220f737","collection":"contentId-2036498514","type":"file","height":208},"marks":[{"type":"border","attrs":{"size":2,"color":"#172b4d"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Standalone Test Case Key","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Tags can be used to specify the AIO Tests key. In the example below, “SCRUM-TC-408” has been tagged to a robot test case. This key maps the robot case to an existing case in AIO Tests.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Valid Login\n [Tags] SCRUM-TC-408 \n Open Browser To Login Page\n Input Username demo\n Input Password mode\n Submit Credentials\n Welcome Page Should Be Open\n [Teardown] Close Browser ","type":"text"}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Automation Key","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"AIO Tests will not generate a new case if a Robot case lacks an AIO case key but has already been imported once. Instead, it will utilize the existing case by referencing the automation key. The automation key is derived from the source value and the test case name from the results file.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If the source is changed, the automation key will no longer map to the same case. If this is the case, the case can be marked with the AIO Case key, so that the association doesn’t break.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"orderedList","attrs":{"order":3},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mapping an Automated Case to Multiple Manual Tests","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"A single test case in Robot can also be mapped to multiple cases in AIO Tests. In the example below, the results of the Robot case would be mapped into “SCRUM-TC-408” and “SCRUM-TC-409”.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Valid Login\n [Tags] SCRUM-TC-408 SCRUM-TC-409 \n Open Browser To Login Page\n Input Username demo\n Input Password mode\n Submit Credentials\n Welcome Page Should Be Open\n [Teardown] Close Browser","type":"text"}]},{"type":"orderedList","attrs":{"order":4},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New Case Creation","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Robot test cases that are not tagged by the AIO case keys are also imported. In this case, the test name becomes the case name in AIO tests, and an automation key is generated from the source value and the test case name. The following table shows the mapping of a robot test case to AIO Test case.","type":"text"}]},{"type":"table","attrs":{"width":760.0,"localId":"c8ccb784-d43e-48f6-aad7-ee82b4bee035"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Robot Test Case","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"AIO Test Case","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Test case name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Case Title","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Documentation tag inside the test case","type":"text"}]},{"type":"codeBlock","content":[{"text":"Valid Login\n [Documentation] This is a valid login test and would appear in the case description.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Tag annotated with @JREQ","type":"text"}]},{"type":"paragraph","content":[{"text":"[Tags] @JREQ-SCRUM-1","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Jira requirements","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Mapping Jira Requirements","type":"text"}]},{"type":"paragraph","content":[{"text":"This integration also supports the mapping of Jira requirements to cases. This is achieved by tagging a test case with a Jira requirement key and a prefix @JREQ. In the examples below, test cases get created with the tagged Jira requirements.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mapping a Single Jira Requirement","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"codeBlock","content":[{"text":"Valid Login\n [Tags] @JREQ-SCRUM-1 \n Open Browser To Login Page\n Input Username demo\n Input Password mode\n Submit Credentials\n Welcome Page Should Be Open\n [Teardown] Close Browser ","type":"text"}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mapping Multiple Jira Requirements","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"codeBlock","content":[{"text":"Valid Login\n [Tags] @JREQ-SCRUM-1 @JREQ-SCRUM-2 SCRUM-TC-408 \n Open Browser To Login Page\n Input Username demo\n Input Password mode\n Submit Credentials\n Welcome Page Should Be Open\n [Teardown] Close Browser ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Mapping a Case to a Folder","type":"text"}]},{"type":"paragraph","content":[{"text":"Users have the option to designate a default folder for newly created cases. They can also define a mapping between a case and a folder by simply adding a tag starting with the prefix ","type":"text"},{"text":"@AIO-FOLDER- ","type":"text","marks":[{"type":"code"}]},{"text":"and mentioning the folder hierarchy. Folder hierarchy can be separated using ","type":"text"},{"text":"/","type":"text","marks":[{"type":"code"}]},{"text":" Example - @AIO-FOLDER-Reports/Audit log.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This functionality is applicable only:","type":"text","marks":[{"type":"em"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If a new case is generated through the import process.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the folder structure specified in the tag already exists. ","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Additionally, if configured, this will supersede the default folder setting.","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mapping using the default folder option","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":652,"alt":"Screenshot from 2024-02-14 11-14-14-20240214-052914.png","id":"a7da365d-b5fc-4343-ab49-fe303f219e8f","collection":"contentId-2036498514","type":"file","height":809},"marks":[{"type":"border","attrs":{"size":2,"color":"#172b4d"}}]}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mapping each case using tags","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"codeBlock","content":[{"text":"Valid Login\n [Tags] @AIO-FOLDER-Imports/Robot\n Open Browser To Login Page\n Input Username demo\n Submit Credentials\n Welcome Page Should Be Open\n [Teardown] Close Browser","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Percolating Changes from Automated Tests to AIO Tests","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Force Update Field","type":"text"}]},{"type":"paragraph","content":[{"text":"Enabling the force update of cases entails modifying the case title, description, steps, and Jira requirements for the respective test cases.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":652,"alt":"image-20240214-053319.png","id":"c172fc3f-b1ca-4445-9974-425156c1b202","collection":"contentId-2036498514","type":"file","height":447},"marks":[{"type":"border","attrs":{"size":2,"color":"#172b4d"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Adding or Updating Case Description ","type":"text"}]},{"type":"paragraph","content":[{"text":"This integration also lets users map the test case level documentation to the case description. In the example below, the contents of the documentation tag are mapped to the case description of the case “SCRUM-TC-408”.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Valid Login\n [Tags] @JREQ-SCRUM-1 @JREQ-SCRUM-2 SCRUM-TC-408 \n [Documentation] This is a valid login test and would appear in the case description.\n Open Browser To Login Page\n Input Username demo\n Input Password mode\n Submit Credentials\n Welcome Page Should Be Open\n [Teardown] Close Browser ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Importing Results","type":"text"}]},{"type":"paragraph","content":[{"text":"Post execution of a Robot file, the output.xml file can be uploaded either via","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Import Results - REST API","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/AioTests/pages/2026569775"}}]},{"text":" - REST API call using multipart form-data to upload file","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Import Results- Cycle Tab","type":"text","marks":[{"type":"link","attrs":{"href":"https://aiosupport.atlassian.net/wiki/spaces/AioTests/pages/2026700831"}}]},{"text":" - Importing results file from the Cycles tab of the AIO Tests app","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Please follow the above links to continue to import results using either of the options.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"For further queries and suggestions, feel free to reach out to our customer support 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"}]}]}],"version":1}