GetAccessScheduleNotify

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

This method processes a Schedule_ID, a Participant_Name (who must exist already in the Perception database) and a Notify URL. It also returns a URL that will start the assessment with given schedule ID for a participant with the name participant name. The notify URL will notify when the assessment finishes using the PIP file name specified in the PIP parameter.

If the schedule does not exist, a SOAP fault message will be returned.

To use this method you must purchase an additional license for the SAP Connector.

Parameters

Input name   Description Data type Optional field?

Schedule_ID

 

The Schedule_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 must exist in the repository database.

String

N

Notify

 

A URL that is notified that the participant has finished the scheduled assessment

String

Y

PIP

 

This parameter specifies the name of the PIP file that will be used when the URL is generated. If no value is supplied, it defaults to QMWISE.

String

Y

Parameter

       
 

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 perception.dll or perception.php. A notification will also be sent to the URL in the Notify parameter when the assessment finishes.

String

Troubleshooting

Please refer to the Appendix - Error codes section for information about any error codes that are displayed when using this method.

Please note that the errors reported by this method are not always correct.

Error 2040 ("Error occured while trying to get access schedule notify") could be caused by one of the following problems:

  • The schedule has limited attempts and no attempts remain (i.e., caused when attempts are already finished).
  • The schedule has restricted times and has not yet started or has stopped (i.e., when start/end period don't match).
  • The participant has taken the assessment with in Minimum days between attempts (i.e., when next possible start date don't match).