GetAssessmentResultListByParticipant

Participant_Name

The name of the participant whose results information is required (this parameter is not case sensitive)

String

N

AssessmentResult

Result_ID

This is ignored

String

Assessment_ID

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

String

Write_Answer_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 result

String

Member_Group

The group name of the group that the participant who achieved the result is a member of (defaults to blank if not set)

String

Participant_Details

The participant details for the participant who achieved the 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 result applies is still active (defaults to FALSE if not set)

Boolean

Status

The status of the assessment to which the 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 result applies:

0 - No feedback given 1 - Some feedback given

(defaults is 0 - No feedback given)

Short

Number_Sections

The number of question blocks in the assessment to which the result applies (defaults to 0 if not set)

Short

Max_Score

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

Integer

Total_Score

The actual score for the assessment to which the result applies

Integer

Special_1 to 10

These parameters contain information specific to the outcome of the questions in the assessment to which the 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 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 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 result applies (defaults to 0 if not set)

Integer

Perceptage_Score

The percentage score for the assessment to which the result applies

Short

Schedule_Name

The name of the schedule related to the assessment to which the result applies (defaults to blank if not set)

String

Monitored

This indicates whether the assessment to which the result applies is monitored (defaults to FALSE if not set)

Integer

Monitor_Name

If the assessment to which the 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 (may appear several times)

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 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 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 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 result applies (required each time TopicScoringList is used, optional if TopicScoringList is not used)

Double

Maximum_Score

The greatest attainable score for a topic or subtopic in the assessment to which the 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 result applies (required each time TopicScoringList is used, optional if TopicScoringList is not used)

Integer

When_Started

The date on which the result is created (defaults to the current date if not set)

String

Session_Last_Modified

The date on which the assessment to which the 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 result applies finished, or when it was last updated if it is still going (defaults to the current date if not set)

String

Feedback

The feedback given by the assessment outcome relevant to the assessment to which the result applies (defaults to blank if not set)

String

AnswerList

(may occur several times)

This parameter (if used) is in the form of sets of answer information, as detailed below

Question_ID

The question ID of a question in the assessment to which the 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 result applies (defaults to 1 if not set)

Integer

Occurence

If the same question appears in the assessment to which the result applies more than once, this is the questions occurrence 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 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 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 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 result applies:

0 - Normal 1 - Retired 2 - Incomplete

(defaults to 0 if not set)

Short

Times_Answered

The number of times that a question in the assessment to which the 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 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 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 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 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 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 result applies (defaults to 0 if not set)

Short

Outcome_Exponential

For a question in the assessment to which the 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 (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 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 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 result applies (defaults to blank if not set)

String