GetAssessmentResult2
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
Input name | Description | Data type | ||
---|---|---|---|---|
Result |
|
|
|
|
|
Result_ID |
|
This is ignored |
String |
|
Assessment_ID |
|
The unique assessment ID for the assessment to which the new result applies |
String |
|
Write_Anwer_Data |
|
This indicates whether there is any information in the AnswerList below (defaults to the FALSE if not set) |
Boolean |
|
Participant |
|
The participant name of the participant who achieved the new result |
String |
|
Member_Group |
|
The group name of the group that the participant who achieved the new result is a member of (defaults to blank if not set) |
String |
|
Participant_Details |
|
The participant details for the participant who achieved the new result (defaults to blank if not set) |
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 the new result applies is still active (defaults to FALSE if not set) |
Boolean |
|
Status |
|
The status of the assessment to which the new result applies: 0 - Started 1 - Running 2 - Finished 3 - Expired 4 - Timed out 5 - Quit (defaults 0 - Started if not set) |
Short |
|
Feedback |
|
Indicates whether there is any feedback for the assessment to which the new result applies: 0 - No feedback given 1 - Some feedback given (defaults 0 - No feedback given) |
Short |
|
Number_Sections |
|
The number of question blocks in the assessment to which the new result applies (defaults to 0 if not set) |
Short |
|
Max_Score |
|
The maximum possible score for the assessment to which the new result applies |
Integer |
|
Total_Score |
|
The actual score for the assessment to which the new result applies |
Integer |
|
Special_1 to 10 |
|
These parameters contain information specific to the outcome of the questions in the assessment to which the new result applies (each one defaults to blank if not set) |
String |
|
Time_Taken |
|
The time taken, in seconds, between the start and end of the assessment to which the new result applies, should be set to 0 if the assessment is still active (defaults to 0 if not set) |
Integer |
|
Score_Band_Title |
|
The title of the assessment outcome relevant to the assessment to which the new result applies (defaults to blank if not set) |
String |
|
Score_Band_Number |
|
The number of the assessment outcome relevant to the assessment to which the new result applies (defaults to 0 if not set) |
Integer |
|
Percentage_Score |
|
The percentage score for the assessment to which the new result applies |
Short |
|
Schedule_Name |
|
The name of the schedule related to the assessment to which the new result applies (defaults to blank if not set) |
String |
|
Monitored |
|
This indicates whether the assessment to which the new result applies is monitored (defaults to FALSE if not set) |
Boolean |
|
Monitor_Name |
|
If the assessment to which the new result applies is monitored, this contains the name of the proctor or invigilator who performs the assessment monitoring (defaults to blank if not set) |
String |
|
TopicScoringList |
|
This parameter (if used) is in the form of sets of topic information, as detailed below |
|
|
|
Topic_ID |
The unique Topic ID of the topic or subtopic that a question in the assessment to which the new result applies was selected from (required each time TopicScoringList is used, optional if TopicScoringList is not used) |
String |
|
|
Topic_Name |
The Topic Name of the topic or subtopic that a question in the assessment to which the new result applies was selected from (required each time TopicScoringList is used, optional if TopicScoringList is not used) |
String |
|
|
Description |
A description or comment for a topic or subtopic in the assessment to which the new result applies (defaults to blank if not set) |
String |
|
|
Percentage_Score |
The percentage score for a topic or subtopic in the assessment to which the new result applies (required each time TopicScoringList is used, optional if TopicScoringList is not used) |
Double |
|
|
Actual_Score |
The actual score for a topic or subtopic in the assessment to which the new result applies (required each time TopicScoringList is used, optional if TopicScoringList is not used) |
Integer |
|
|
Maximum_Score |
The greatest attainable score for a topic or subtopic in the assessment to which the new result applies (required each time TopicScoringList is used, optional if TopicScoringList is not used) |
Integer |
|
|
Num_Questions |
The number of questions presented for a topic or subtopic in the assessment to which the new result applies (required each time TopicScoringList is used, optional if TopicScoringList is not used) |
Integer |
|
|
When_Started |
The date on which the new result is created (defaults to the current date if not set) |
String |
|
Session_Last_Modified |
|
The date on which the assessment to which the new result applies was last modified (defaults to the current date if not set) |
String |
|
When_Finished |
|
The date on which the assessment to which the new result applies finished, or when it was last updated if it is still going (defaults to the current date if not set) |
String |
|
ParticipantList |
|
|
String |
|
FirstName |
The first name of the participant |
String |
|
|
LastName |
Last name of the participant |
String |
|
|
PrimaryEmailAddress |
Email address of the participant |
String |
|
|
SubgroupPath |
|
String |
|
CourseProperty |
|
|||
|
ScoreBandIDProperty |
|
Integer |
|
|
Feedback |
|
The feedback given by the assessment outcome relevant to the assessment to which the new result applies (defaults to blank if not set) |
String |
|
AnswerList |
|
|
|
|
|
Question_ID |
The question ID of a question in the assessment to which the new result applies (required each time AnswerList is used, optional if TopicScoringList is not used) |
String |
|
|
Revision |
The Revision number of a question in the assessment to which the new result applies (defaults to 1 if not set) |
Integer |
|
|
Occurence |
If the same question appears in the assessment to which the new result applies more than once, this is the questions cccurrence number (defaults to 1 if not set) |
Short |
|
|
Topic_Name |
The topic name of the topic or subtopic that a question in the assessment to which the new result applies was selected from (required each time AnswerList is used, optional if TopicScoringList is not used) |
String |
|
|
Block_Number |
The number of the question block for a question in the assessment to which the new result applies (required each time AnswerList is used, optional if TopicScoringList is not used) |
Short |
|
|
Question_Number |
The number the participant sees for a question in the assessment to which the new result applies (required each time AnswerList is used, optional if TopicScoringList is not used) |
Short |
|
|
Status |
The status of a question in the assessment to which the new result applies: 0 - Normal 1 - Retired 2 - Incomplete (defaults to 0 Normal if not set) |
Short |
|
|
Times_Answered |
The number of times that a question in the assessment to which the new result applies was answered (defaults to 1 if not set) |
Short |
|
|
Max_Score |
The greatest attainable score for a question in the assessment to which the new result applies (required each time AnswerList is used, optional if TopicScoringList is not used) |
Integer |
|
|
Actual_Score |
The actual score attained for a question in the assessment to which the new result applies (required each time AnswerList is used, optional if TopicScoringList is not used) |
Integer |
|
|
Know_Time_Taken |
This indicates whether the Time_Taken to answer a question in the assessment to which the new result applies is known (defaults to FALSE if not set) |
Boolean |
|
|
Time_Taken |
The number of seconds that the participant took to answer a question in the assessment to which the new result applies (defaults to 0 if not set) |
Integer |
|
|
Number_Outcomes |
The number of distinct question outcomes available for a question in the assessment to which the new result applies (defaults to 0 if not set) |
Short |
|
|
Outcome_Number |
The number of the question outcome first selected for a question in the assessment to which the new result applies (defaults to 0 if not set) |
Short |
|
|
Outcome_Exponential |
For a question in the assessment to which the new result applies, this is calculated as follows:
This field is only calculated when there are not more than 32 outcomes (defaults to 0 if not set) |
Integer |
|
|
Answer_Truncated |
This is the first 50 characters of the answer to a question in the assessment to which the new result applies (defaults to blank if not set) |
String |
|
|
Answer_Full |
This is the complete answer to a question in the assessment to which the new result applies (defaults to blank if not set) |
String |
|
|
Comment |
This is the comment entered by a participant for a question in the assessment to which the new result applies (defaults to blank if not set) |
String |
|
|
Outcome_Expoential2Property |
For a question in the assessment to which the new result applies, this is calculated as follows:
This field is only calculated when there are more than 32 and less than 64 outcomes (defaults to 0 if not set) |
Integer |
|
LMSDetails |
|
|
|
|
|
SessionID |
The session identifier used by the LMS |
String |
|
|
LMSURL |
URL to use in HACP communication with the LMS |
String |
|
|
Password |
An optional LMS password |
String |
Troubleshooting
Please refer to the following page for any error codes that are displayed when using this method.