Questionmark's Open Assessment Platform

How can I test the APIs?

The QMWISe web service APIs are built using technology standards for web service development. The standard used by QMWISe is Simple Objects Access Protocol or SOAP as it is commonly known. The QMWISe implementation uses a Web Services Description Language (WSDL) to describe how the web services are formed and how to access them.

This means you can use a Test Harness that is compatible with SOAP and WSDL. The Test Harness can be used to:

  • View the available QMWISe web services
  • Send data to the server
  • Retrieve the data from the server

There are various Test Harnesses available on the internet. A recommended example is:

soapUI

The Test Harnesses works by interrogating the QMWISe WSDL, which can be found at:

  • Perception 5:
    • http://<Perception server>/qmwise5/qmwise.asmx?wsdl
  • Perception 4:
    • http://<Perception server>/qmwise4/qmwise.asmx?wsdl

...where <Perception server> is the valid domain name of your Perception server.

Once the Test Harness has interrogated the WSDL it will know what web service methods are available and what the parameters are for each. Each QMWISe web service is made of a number of properties Perception interprets depending on the web service used. The results of the interpretation are then passed back to the application that sent the request. When an application interprets a web service it may involve just retrieving some information or may include a process where certain actions are carried out by the application.

Questionmark have also included a Test Harness. However, this Test Harness is basic and is primarily used to generate the necessary MD5 checksums for security.

To find out more, please refer to the following sections: