GetAssessmentResult | Questionmark

GetAssessmentResult

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

This method processes a result ID and returns a list giving the full details of the result if the result ID exists, or a SOAP fault message with an error code if it does not. A SOAP fault message will also be returned if a database error occurs at any point during processing the list.

Available in:
  • Version 4.1 +
  • Version 5.1 +

Parameters

Input name Description Data type Optional field?

Result_ID

The result ID of the of the result whose details are required

String

N

Response

Output name     Description Data type

AssessmentResult

 

 

 

 

 

Result_ID

 

The result ID of this result

String

 

Assessment_ID

 

The unique assessment ID for the assessment to which this result applies

String

 

Write_Answer_Data

 

This indicates whether there is any information in the AnswerList below

Boolean

 

Participant

 

The participant name of the participant who achieved this result

String

 

Member_Group

 

The group name of the group that the participant who achieved this result is a member of (can be blank)

String

 

Participant_Details

 

The participant details for the participant who achieved this result (can be blank)

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 to which this result applies is still active

Boolean

 

Status

 

The status of the assessment to which this result applies:

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

Short

 

Feedback

 

Indicates whether there is any feedback for the assessment to which this result applies:

0 - No feedback given, 1 - Some feedback given

Short

 

Number_Sections

 

The number of question blocks in the assessment to which this result applies

Short

 

Max_Score

 

The maximum possible score for the assessment to which this result applies

Integer

 

Total_Score

 

The actual score for the assessment to which this result applies

Integer

 

Special_1 to 10

 

These parameters contain information specific to the outcome of the questions in the assessment to which this result applies (any or all of them can be blank)

String

 

Time_Taken

 

The time taken, in seconds, between the start and end of the assessment to which this result applies, will be 0 if the assessment is still active

Integer

 

Score_Band_Title

 

The title of the assessment outcome relevant to the assessment to which this result applies (can be blank)

String

 

Score_Band_Number

 

The number of the assessment outcome relevant to the assessment to which this result applies

Integer

 

Percentage_Score

 

The percentage score for the assessment to which this result applies

Short

 

Schedule_Name

 

The name of the schedule related to the assessment to which this result applies (can be blank)

String

 

Monitored

 

This indicates whether the assessment to which this result applies is monitored

Boolean

 

Monitor_Name

 

If the assessment to which this result applies is monitored, this contains the name of the proctor or invigilator who performed the assessment monitoring (can be blank)

String

 

TopicScoringList

 

 

 

 

 

Topic_ID

The unique topic ID of the topic or subtopic that a question in the assessment to which this result applies was selected from

String

 

 

Topic_Name

The topic Nname of the topic or subtopic that a question in the assessment to which this result applies was selected from

String

 

 

Description

A description or comment for a topic or subtopic in the assessment to which this result applies (can be blank)

String

 

 

Percentage_Score

The percentage score for a topic or subtopic in the assessment to which this result applies

Double

 

 

Actual_Score

The actual score for a topic or subtopic in the assessment to which this result applies

Integer

 

 

Maximum_Score

The greatest attainable score for a topic or subtopic in the assessment to which this result applies

Integer

 

 

Num_Questions

The number of questions presented for a topic or subtopic in the assessment to which this result applies

Integer

 

When_Started

 

The date on which this result was created

String

 

Session_Last_Modified

 

The date on which the assessment to which this result applies was last modified

String

 

When_Finished

 

The date on which the assessment to which this result applies finished, or when it was last updated if it is still going

String

 

Feedback

 

The feedback given by the assessment outcome relevant to the assessment to which this result applies (can be blank)

String

 

AnswerList

 

 

 

 

 

Question_ID

The question ID of a question in the assessment to which this result applies

String

 

 

Revision

The revision number of a question in the assessment to which this result applies

Integer

 

 

Occurrence

If the same question appears in the assessment to which this result applies more than once, this is the questions occurrence number

Short

 

 

Topic_Name

The name of the topic the question is stored in

String

 

 

Block_Number

The number of the question block for a question in the assessment to which this result applies

Short

 

 

Question_Number

The number the participant sees for a question in the assessment to which this result applies

Short

 

 

Status

The status of a question in the assessment to which this result applies:

0 - Normal, 1 - Retired, 2 - Incomplete

Short

 

 

Times_Answered

The number of times that a question in the assessment to which this result applies was answered

Integer

 

 

Max_Score

The greatest attainable score for a question in the assessment to which this result a

Integer

 

 

Actual_Score

The actual score attained for a question in the assessment to which this result applies

Integer

 

 

Know_Time_Taken

This indicates whether the Time_Taken to answer a question in the assessment to which this result applies is known

Boolean

 

 

Time_Taken

The number of seconds that the participant took to answer a question in the assessment to which this result applies

Integer

 

 

Number_Outcomes

The number of distinct question outcomes available for a question in the assessment to which this result applies

Short

 

 

Outcome_Number

The number of the question outcome first selected for a question in the assessment to which this result applies

Short

 

 

Outcome_Exponential

For a question in the assessment to which this result applies, this is calculated as follows:

  1. For each question outcome, find the question outcome number and call it n
  2. For each question outcome, calculate the value of the exponential 2(n-1)
  3. Add together all of the exponentials calculated for the question outcomes to give the Outcome_Exponential

This field is only calculated when there are not more than 32 outcomes

Integer

 

 

Answer_Truncated

This is the first 50 characters of the answer to a question in the assessment to which this result applies (can be blank)

String

 

 

Answer_Full

This is the complete answer to a question in the assessment to which this result applies (can be blank)

String

 

 

Comment

This is the comment entered by a participant for a question in the assessment to which this result applies (can be blank)

String

Troubleshooting

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

Appendix - Error codes