IMPORTANT: Questionmark recommendeds using the Delivery Odata API (click here for documentation) for new integrations, not the QMWISe API. Although we currently continue to issue maintenance updates to this API to support customers with current QMWISe-based integrations, we are no longer adding new methods/functionality to QMWISe. 

GetAccessAssessmentNotify

Applies to the following products: 
Questionmark OnDemand
Questionmark Perception
Questionmark OnPremise
Applies to the following Perception versions: 
Perception 5.7

This method processes an assessment ID, a participant name and a notify URL. It also returns a URL that will start the assessment with the given assessment ID for a participant with the name participant name. The notify URL will notified when the assessment finishes. If the assessment does not exist a SOAP fault message will be returned.

Available in:
  • Version 4.1 +
  • Version 5.1 +

Parameters

Input name   Description Data type Optional field?

Assessment_ID

 

The Assessment_ID of the assessment that will be taken

Integer

N

Participant_Name

 

This is the name of a participant who will take the assessment, and does not have to exist in the repository database

String

N

Notify

 

A callback URL which will receive notification when the assessment finishes

String

N

PIP

 

The optional name of a PIP file to use instead of QMWISe.pip

String

Y

Parameter (zero or more repetitions)

       
 

Name

The name of a parameter that is recognized by the calling system (see note below). This enables the calling system to receive the parameter in the notification, for example a unique identifier may be used by the to track the assessment.

String

Y

 

Value

The value to be assigned to the parameter with the Name above

String

Y

 

Parameters with the following names cannot be used:

  • CALL
  • SESSION
  • NAME
  • NOTIFY
  • EXPIRES
  • ACCESS

Response

Output name Description Data type

URL

A URL that will run the assessment using session.dll or session.php. A notification will also be sent when the assessment is finished.

String

Troubleshooting

Please refer to the following page for any error codes that are displayed when using this method.

Appendix - Error codes