diff --git a/Gazelle-Master-Model/user.md b/Gazelle-Master-Model/user.md index 3a33c3ea99f3e6e67614de7860b0c519ac414bd7..d3a286bc4ff3338683a20db0f8c1a443d160b021 100755 --- a/Gazelle-Master-Model/user.md +++ b/Gazelle-Master-Model/user.md @@ -266,20 +266,7 @@ Once you have chosen the roles involved in your test, you will be asked, for eac * **Card Max**: (cardinality) how many (at most) systems with this role can be involved in the test * **Optionality**: Require means that the test is required for that Role Optional means that the test is optional for that role. -## CTT Result -To help integrate CTT result from the CTT tool, an improvement has been done to allow a vendor to upload on Gazelle Test Management the CTT report. -An uploading Rest Api is integrated in order to save the report to the test instance. - -### CTT Token - -When the "Is CTT" attribute is set, a token provider appears on the test instance page. It creates a unique token value referring to the test instance. - -### CTT API - -In order to upload a file on a CTT Test Instance, the user needs to provide to the webservice the token value of the Test Instance. - -Once the file is uploaded, the status of the Test instance wiil be set to "To be verified" and a message will be sent to the monitor. ## Test Steps diff --git a/Test-Management/installation.md b/Test-Management/installation.md index dbd1eabe3e01d1630f2320ac2b0eb0250ec2adae..1d7178a43c7a4c1785bbae4b2ef06911b4ed3f16 100755 --- a/Test-Management/installation.md +++ b/Test-Management/installation.md @@ -4,7 +4,7 @@ subtitle: Gazelle Test Management author: Nicolas BAILLIET function: Engineer releasedate: 18/05/2021 -toolversion: 5.15.x +toolversion: 5.16.x version: 1.02 status: Approved document reference: KER1-MAN-IHE-TEST_MANAGEMENT_INSTALLATION-1_02 diff --git a/Test-Management/media/TokenProvider.png b/Test-Management/media/TokenProvider.png new file mode 100644 index 0000000000000000000000000000000000000000..9e3496e23821d25018c1ac17b3343be8ff4315da Binary files /dev/null and b/Test-Management/media/TokenProvider.png differ diff --git a/Test-Management/release-note.md b/Test-Management/release-note.md index 164475bd1b7c89301d282258a5a7d4dbd815e800..0d740ac989b8cd3309f20084fc81673d504f0f7d 100644 --- a/Test-Management/release-note.md +++ b/Test-Management/release-note.md @@ -1,16 +1,28 @@ --- title: Release note subtitle: Test Management -toolversion: 5.14.3 -releasedate: 2021-05-06 +toolversion: 5.16.0 +releasedate: 2021-05-18 author: Anne-Gaëlle BERGE function: Software Engineer customer: IHE Europe reference: KER1-RNO-IHE-TEST_MANAGEMENT --- -# 5.15.0 +# 5.16.0 +_Release date: 2021-05-18_ + +** Story +* \[[GZL-4956](https://gazelle.ihe.net/jira/browse/GZL-4956)\] - - External test report publication in test instance +* \[[GZL-4957](https://gazelle.ihe.net/jira/browse/GZL-4957)\] -- Token for uploading files must have a validity period +* \[[GZL-4958](https://gazelle.ihe.net/jira/browse/GZL-4958)\] - - Prevent upload of logs and report in "finished" test instance +* \[[GZL-4960](https://gazelle.ihe.net/jira/browse/GZL-4960)\] - - Show a green or red icon next to a test-report in a test instance. +** Improvement +* \[[GZL-4959](https://gazelle.ihe.net/jira/browse/GZL-4959)\] - - Add comment in chat room at token generation and any upload (Audit). + + +# 5.15.0 _Release date: 2021-05-18_ __Warning__ : this release diff --git a/Test-Management/user.md b/Test-Management/user.md index dceea61581a4c11f04648fc6db87f46326fae8a6..05dd0b4c0da71c23dd302247d0453bd43d7a0aed 100644 --- a/Test-Management/user.md +++ b/Test-Management/user.md @@ -4,7 +4,7 @@ subtitle: Gazelle Test Management author: Guillaume THOMAZON function: Engineer releasedate: 18/05/2021 -toolversion: 5.15.x +toolversion: 5.16.x version: 2.01 status: To be verified reference: KER1-MAN-IHE-TEST_MANAGEMENT_USER-2_01 @@ -2016,6 +2016,33 @@ the changes and import them into the Gazelle Test Management instance. If someth Changes will not be made on the tools data and you will be able to upload another document. +## External Testing Tool + +In the context of the Continual Testing Tool, we have developed a web service to upload result from an external tool. + +On a Test Definition, the preference "Is External Tool", allow to generate a token on a testInstance of the related test. +A token is unique for **a given user** and **a given testInstance**. It has an 8-hours validity period. Also the token value is a unique key value randomly generated. + +In the section generate Authentication Token, it allows user to generate a token for this testInstance. If there is an existing valid token, it will be filled by this value. +If user regenerates a new Token, it will overwrite the value and renew the validity for 8 hours. + + +There are two webservices to upload result : +- *"/rest/testinstances/files/logs"* give the ability to upload test-logs (a zip file) using the generated Token on the related testInstance. (**Warning** this web service can consume only *application/octet-stream*). This archive file shall contain all details of the executed external test suite. +- *"/rest/testinstances/files/report"* give the ability to upload test-report (an XML file) using the generated Token on the related testInstance. (**Warning** this web service can consume only *application/octet-stream* and *application/xml*). The test-report shall contain a summary of the executed external test suite. It has to pass an XSD validation to be uploaded on the test instance. + +Uploaded files are available in the section *Files*. A valid upload file is saved using the type (test-logs or test-report) and the token value. + +A user can upload those file manually. He has to upload a file that match the required pattern. 2 patterns exist in the case of External Test : +- "test-report-<tokenValue>.xml" +- "test-logs-<tokenValue>.zip" + +If file doesn't mach the pattern it will not be uploaded as result for the testInstance. + +Once the test-report upload is done, it is parsed on page loading. A green or red circle shall be displayed following the overall status with a short summary in the label. + +Also, the status of the test instance has been updated and set to "To Be Verified". It's not allow uploading on a testInstance which the status is "Verified","Failed" or "Aborted", or the testingSession is closed. + ## Systems Management ### Permanent link to system @@ -2035,3 +2062,4 @@ This permanent link has this form : Gazelle Test Management release notes can be found on the JIRA pages of the project at the following URL : [*https://gazelle.ihe.net/jira/browse/GZL\#selectedTab=com.atlassian.jira.plugin.system.project%3Achangelog-panel*](https://gazelle.ihe.net/jira/browse/GZL#selectedTab=com.atlassian.jira.plugin.system.project%3Achangelog-panel) +