{"type":"doc","content":[{"type":"paragraph"},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"JUnit to easeTest for Jira Importer","type":"text","marks":[{"type":"strong"}]},{"text":" tool allows you to import the results from the execution of JUnit tests to the executions of one or more test plans in easeTest. The application is able to read multiple XML files at once and map the contained test cases to the Jira issues of the corresponding test plans. The application then creates a new execution for each test plan and sets the status of the included test cases according to that of the corresponding JUnit test execution.","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"7"}},"macroMetadata":{"macroId":{"value":"1de175accfef0f15704d05da0f5b8322"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"e77030af-b358-4e11-968e-c2d9a6788663"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-warning","text":":warning:","shortName":":warning:"}},{"text":" ","type":"text"},{"text":"The importer requires ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"96becb03-7884-4b34-891e-57b3b6f47c39"}}]},{"text":"Java 8, 9 or 11","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"96becb03-7884-4b34-891e-57b3b6f47c39"}},{"type":"strong"}]},{"text":" to be installed on the machine that runs the application.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"96becb03-7884-4b34-891e-57b3b6f47c39"}}]},{"text":" To verify the version of Java, open a new terminal and execute the following command:","type":"text"}]},{"type":"paragraph","content":[{"text":"java -version","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The application itself is a single self-contained jar-file that must be downloaded: ","type":"text"},{"text":"JUnit to Test for Jira Importer","type":"text","marks":[{"type":"link","attrs":{"href":"https://easesolutions.atlassian.net/wiki/download/attachments/271843329/junit-to-test-for-jira-importer.zip?api=v2"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Execution","type":"text"}]},{"type":"paragraph","content":[{"text":"To execute the application, open a new command line terminal in the directory that contains the application jar file and enter the following command:","type":"text"}]},{"type":"paragraph","content":[{"text":"java -jar junit-to-test-for-Jira-importer.jar [arguments]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The arguments that can be passed are of the following form:","type":"text"}]},{"type":"paragraph","content":[{"text":"--argumentName=\"value\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Here is an example:","type":"text"}]},{"type":"paragraph","content":[{"text":"java -jar junit-to-test-for-Jira-importer.jar --plan=\"JUnit Tests\" --project=\"FIR\" --url=\"http://myhost:2990/Jira/\" --user=\"admin\" --pw=\"adminpw\" --xmlFilePath=\"D:/JUnit Results/results*.xml\" --xmlIssueKeyAttrName=\"JiraIssueKey\" --execution=\"JUnit Test Import Execution\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Example batch file “import.cmd”:","type":"text"}]},{"type":"codeBlock","content":[{"text":"@echo off\nREM %1: Jira project key (e.g. MYKJEY) \nREM %2: Test plan name (e.g. Automated Tests)\nREM %3: Execution Name in Jira (e.g. MYKEY#28-2023-01-01_12:00) \nREM %4: Name of file with JUnit-formatted test results, use / instead of backslash\njava -jar junit-to-test-for-jira-importer.jar --plan=%2 --project=%1 --url=\"https://myserver.com/jira/\" --user=\"\" --pw=\"\" --xmlFilePath=\"%4\" --xmlIssueKeyAttrName=\"jira-key\" --execution=%3","type":"text"}]},{"type":"paragraph","content":[{"text":"Example call of batch","type":"text"}]},{"type":"paragraph","content":[{"text":"import MYKEY \"Automated Tests\" \"MYKEY#28-2024-05-13_12:00\" \"./result.xml\"","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Command Line Arguments","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","width":1800.0,"localId":"2326b634-95a4-4f5f-91b7-3df6397317e6"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Argument","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"Explanation","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"plan","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the default test plan in easeTest for which the new execution is to be created. This argument is optional if the ","type":"text"},{"text":"xmlPlanNameAttrName","type":"text","marks":[{"type":"strong"}]},{"text":" argument is provided.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"project","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"The key of the Jira project that contains the test plan.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"url","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"The base-URL of the Jira instance, which should be of the following form: ","type":"text"},{"text":"http(s)://host:port/Jira/","type":"text","marks":[{"type":"link","attrs":{"href":"http://hostport/"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"user","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"The username of the user account that is used to create the new execution.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"pw","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"The corresponding password for the user account.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"token","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"Access token can be used instead of username/password for embedding process into automated imports. This is prioritized over ","type":"text"},{"text":"user ","type":"text","marks":[{"type":"strong"}]},{"text":"and ","type":"text"},{"text":"pw ","type":"text","marks":[{"type":"strong"}]},{"text":"arguments.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"xmlFilePath","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"The path to the JUnit XML result files. The path may contain wildcards to select multiple XML files for one import - for example:","type":"text"}]},{"type":"paragraph","content":[{"text":"D:\\Test Results\\JUnit\\result*.xml","type":"text","marks":[{"type":"code"}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Only XML files are supported. Trying to pass a path to a different file type results in an error. ","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"xmlIssueKeyAttrName","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the \"testcase\" element attribute in the XML files that contain the corresponding issue key for each test case.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"xmlPlanNameAttrName","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the \"testcase\" element attribute in the XML files that contain the corresponding plan name for each test case. This argument is optional if the ","type":"text"},{"text":"plan","type":"text","marks":[{"type":"strong"}]},{"text":" argument is provided.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"execution","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the new execution.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"resultXsltPath","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"The path to an XSL file, which is used to transform the content of the XML files into result messages for failed test executions. This argument is optional. If no path is specified the default XSL file provided with the importer is used.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"version","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"Use this argument without any value and without other arguments to return the version of the application. If any other arguments are used, the application starts as usual.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"testMode","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1116.0]},"content":[{"type":"paragraph","content":[{"text":"Use this argument with an arbitrary value to start the application in test mode. In this mode the application does not import anything, but instead checks the following conditions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"whether the Jira instance can be accessed via the specified url","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"whether the passed user credentials are correct","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"whether the project with the specified project key exists in the Jira instance","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"whether the plan with the specified plan name exists in the project","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"To use the test mode all other arguments except ","type":"text"},{"text":"version","type":"text","marks":[{"type":"strong"}]},{"text":" must be specified.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"JUnit Test Result XML File","type":"text"}]},{"type":"paragraph","content":[{"text":"The JUnit test result XML file should contain one or more test cases. Every test case element must have an attribute containing the Jira key of a test issue. The name of this attribute is specified using the ","type":"text"},{"text":"xmlIssueKeyAttrName","type":"text","marks":[{"type":"strong"}]},{"text":" argument. A test case is ignored if the specified test plan does not include the corresponding Jira issue key. There should be no more than one test case in the file with the same issue key.","type":"text"}]},{"type":"paragraph","content":[{"text":"A test case can have an optional attribute providing the intended test plan and is specified using the ","type":"text"},{"text":"xmlPlanNameAttrName","type":"text","marks":[{"type":"strong"}]},{"text":" argument. If this argument is not provided, the intended plan must be specified using the ","type":"text"},{"text":"plan","type":"text","marks":[{"type":"strong"}]},{"text":" argument.","type":"text"}]},{"type":"paragraph","content":[{"text":"A test case can contain a skipped, error or failure element - or no child elements at all. The following table explains how JUnit test results are translated into easeTest:","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","width":1800.0,"localId":"fd546728-f498-4f1a-936e-ef99d8c55510"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[295.0]},"content":[{"type":"paragraph","content":[{"text":"JUnit","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1048.0]},"content":[{"type":"paragraph","content":[{"text":"easeTest","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[295.0]},"content":[{"type":"paragraph","content":[{"text":"no child elements","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1048.0]},"content":[{"type":"paragraph","content":[{"text":"Passed","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[295.0]},"content":[{"type":"paragraph","content":[{"text":"error or failure element","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1048.0]},"content":[{"type":"paragraph","content":[{"text":"Failed - if the test case is the last test case to be read.","type":"text"},{"type":"hardBreak"},{"text":"Failed Continue - if more test cases follow.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[295.0]},"content":[{"type":"paragraph","content":[{"text":"skipped","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1048.0]},"content":[{"type":"paragraph","content":[{"text":"Skipped test cases are currently ignored.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"086ae7a6-d46b-46c3-89cb-2f7a4099d74f"}},{"type":"em"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The following example of a test results file provides results for three Jira issues, identified as FIR-1, FIR-2 and FIR-3 (","type":"text"},{"text":"Jira keys can be in uppercase, lowercase or mixed case","type":"text","marks":[{"type":"strong"}]},{"text":"):","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n \n \n \n \n \n \n Assertion failed\n \n \n \n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Result Messages","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, the message created by the importer consists of the following two elements:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result message","type":"text","marks":[{"type":"strong"}]},{"text":": If the error or failure element of the test case contains an attribute named “message” the value of this attribute is part of the result message.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Detailed error information","type":"text","marks":[{"type":"strong"}]},{"text":": This part of the message contains the entire body of the error or failure element. The detailed error information is part of the result message.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Currently a result message is only created for failed test cases.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Customizing Result Messages","type":"text"}]},{"type":"paragraph","content":[{"text":"You can customize result messages by providing a custom XSL file to the importer using the ","type":"text"},{"text":"resultXsltPath","type":"text","marks":[{"type":"strong"}]},{"text":" argument.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following simple XSL file causes the same result message to be produced, consisting of the java version as stated in the result XML file.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"dd9c6517-d4c8-4814-b98f-73f46eea9d44"}}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\nEnvironment ------\nJava Version : ","type":"text"}]},{"type":"paragraph","content":[{"text":"To create test case specific result messages, you can use the following two parameters in the XSL file to find the corresponding test case element:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"issueKey","type":"text","marks":[{"type":"strong"}]},{"text":": The corresponding issue key of the test case currently being imported.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"xmlIssueKeyAttrName","type":"text","marks":[{"type":"strong"}]},{"text":": The name of the testcase attribute that contains the issue key of the corresponding Jira issue","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The importer uses the corresponding values for the test case currently being imported. You can use the following code block to retrieve the test case element from the XML result file for the test case currently being imported.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\n \n\t\t\n\t\n","type":"text"}]},{"type":"paragraph"}],"version":1}