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. 
  1. Questionmark QMWISe API Guide
  2. Web service methods
  3. Snapshots
  4. ScoreAssessmentSnapshot

ScoreAssessmentSnapshot

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

This method takes the responses from a printed assessment snapshot and uses the saved scoring assessment snapshot to score all the questions, calculate assessment and topic scoring and record all the results in the Perception answer database. The ID of the record created in the A_Results table is returned in the response. The participant must be identified, by name or any ID schema used by the external system; this is what will be shown in reporting. Participant details may also be specified, as may the group they are part of. Up to 10 special fields may also be specified to be used for demographic data for reporting purposes. The facility to send an email at the end of an assessment that exists when assessments are delivered via session.dll does not happen when this method is called.

This method requires a QMWISe license with snapshots enabled for it to function. If the method is used without the appropriate license an error message will be returned.

 

Available in:
  • Version 4.3 +
  • Version 5.1 +

Parameters

Input name   Description Data type Optional field?

Snapshot_ID

  

The unique snapshot ID

Integer

N

Participant

  

The participant name or ID

String

N

Member_Group

  

The group that the participant was in when the assessment was taken

String

Y

Participant_Details

  

The value that should be written to the A_Result.Participant_Details column

String

Y

When_Finished

  

Time and date the assessment was completed

Date/Time

Y

Monitor_Name

  

Name of the instructor who administered the assessment

String

Y

Special_1 to Special_10

  

Special fields 1 to 10 used to store demographic data

String

Y

ResponseList

  

This parameter consists of sets of response information, as detailed below.

  

N
  Choice      
  id An id for the choice String

N
  Comment Comments associated with the choice String

N
  id An id for the choice String

N
 

choice_type

Can be one of the following:

  • id
  • string
  • number
  • coord

String

N
 

choice_max

The maximum number of choices accepted

Integer

N
 

choice_num

The number of choices in the question

Integer

N
FirstName   First name of the participant String

Y
LastName   Last name of the participant String

Y
EmailAddress   The email address of the participant String

Y
MemberSubGroup1-9   The sub group(s) the participant is a member of String

Y

Response

Output name Description Data type

Result_ID

Returns the Result_ID of the record inserted in A_Result

Integer

Troubleshooting

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

Appendix - Error codes