GetAssessmentResult
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.
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:
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.