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. 

GetResultListByAssessment

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 and returns a list giving the full details of all the results obtained by participants who have taken that assessment if the assessment exists and has any results associated with it. If not, an empty list is returned.

Available in:
  • Version 4.1 +
  • Version 5.1 +

Parameter

Input name Description Data type Optional field?

Assessment_ID

This is the assessment ID of the assessment whose result details are required

String

N

Response

Output name   Description Data type

Result_ID

 

The result ID of the result

String

Assessment_ID

 

The assessment ID of the assessment that generated the result

String

Write_Answer_Data

 

This indicates whether answer data is written to the repository database for the result (if it is, it will be in the table A_Answer )

Boolean

Participant

 

This is the name of the participant who took the assessment that generated the result

String

Member_Group

 

If the participant who took the assessment that generated the result belonged to a group when they took the assessment, this is the name of the group

String

Participant_Details

 

The general details of the participant who took the assessment that generated the result

String

Hostname

 

Hostname of participant (if available) at the start of the session.

String

IP_Address

 

IP address of participant (if available) at the start of the session.

String

Still_Going

 

This indicates whether or not the assessment that generated the result is still active

Boolean

Status

 

0 - Started, 1 - Running, 2 - Finished, 3 - Expired, 4 - Timed out, 5 - Quit

Short

Feedback

 

0 - No feedback given

1 - Some feedback given

Short

Number_Sections

 

The number of question blocks in the assessment that generated the result for which replies have been received

Short

Max_Score

 

The maximum score of all questions answered in the question blocks in the assessment that generated the result

Integer

Total_Score

 

The participant's actual score for all questions answered in the question blocks in the assessment that generated the result

Integer

Special_1 to 10

 

These parameters contain information specific to the outcome of the question that generated the result

String

Time_Taken

 

The time taken, in seconds, between the start and end of the assessment that generated the result (zero if the assessment is still active)

Integer

Score_Band_Title

 

The title of assessment outcome at end of the assessment that generated the result

String

Score_Band_Number

 

The number of assessment outcome defined in the assessment that generated the result

Integer

Percentage_Score

 

The percentage score achieved by the participant for the assessment that generated the result

Short

Schedule_Name

 

The name of the schedule that the result was generated through, or blank if the assessment was not scheduled

String

Monitored

 

Indicates whether or not the result came from a monitored schedule or assessment

Boolean

Monitor_Name

 

If Monitored is set, this is the name of the user (or proctor) performing assessment monitoring

String

TopicScoringList

 

 

 

 

Topic_ID

The Topic_ID for the topic associated with the result

String

 

Topic_Name

The full name of the topic associated with the result

String

 

Description

A short description of the topic associated with the result

String

 

Percentage_Score

The percentage score for the topic associated with the result

Double

 

Actual_Score

The actual score for the topic associated with the result

Integer

 

Maximum_Score

The maximum score for the topic associated with the result

Integer

 

Num_Questions

The number of questions from the topic associated with the result

Integer

When_Started

 

Date when the result was first written to the database

String

Session_Last_Modified

 

This is the date when the assessment to which the result applies was last modified

String

When_Finished

 

The date when the assessment that generated the result finished, or when last updated if it is still going

String

Troubleshooting

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

Appendix - Error codes