Table of Contents

...

Platform 2.0 offers a completely REST'ful architecture to interact with the core services. This REST-ful architecture is realized by the FHIR module and the REST-WS module. Although unit-tests in these modules confirm that the controller methods behave as expected but in order to exercise the end-to-end scenario based integration testing for the platform's REST API, we plan to manually hit these endpoints on uat-paltform.openmrs.org and ensure they behave appropriately.

How to help test Platform 2.0 Beta

...

Steps to Contribute to "REST endpoint Testing"

As descibed in the Introduction section, we plan to manually test the REST-enpoints defined by the REST-WS and FHIR modules.

Add a Test Case

1. Pick up a REST endpoint from the documentations of REST Web Services API For Clients or FHIR: OpenMRS Strategy, Tools, FHIR API, and Help. You might also find REST Web Service Resources in OpenMRS 1.9 useful
2. Head over to the Test Cycles for Platform JIRA project
3. From the Menu, choose Tests->Create a Test
   Image Added
   
   • Describe a Test Case in the 'Summary' field. Summary must include functionality name and short summary of the Test Case (in case of complicated Test Cases)
   • In the 'Description' field you can also add more details e.g. user story or leave it empty if 'Summary' field provides enough information
   • In 'Attachment' field you can add screen shot or short movie to help localize the issue
   • 'Label' field should contain key words used for search purposes
   • If the Test Case is meant for an automated test, add a link to automated test code in 'Automated' field
4. Follow Step 2 descibed by the QA team in How to create a Test Case  
5. Note the Issue No of the Test you just created and head back to the Test Cycles for Platform JIRA project page
6. Click the configure button on the right hand side of Platform 2.0 Release Tests test cycle and click Add Test from the drop down menu
   Image Added
7. Enter the Issue Number of the test you just created to add it to the Plarform 2.0 Release Tests Test Cycle
   Image Added
   
   

Execute a Test Case

1. If you haven't already, watch this 15 min video to get used to Zephyr
2. Click on an un-executed test (Column name : Issue Key )from Test Cycle named : Platform 2.0 Release Tests
   1. This should open up the Test Case page which should look like
      Image Added
3. Scroll down to the Test Execution Section and click the E button on the  rightmost end of the row containing Test Cycle value as Platform 2.0 Release Tests
   Image Added
4. Open up the execution environment i.e uat-platform.openmrs.org/openmrs in a new tab/window
5. Follow steps 5 and 6 described by the QA team on How to execute a Test Case