Results¶

Results methods can be used to query the delivery database for information about assessment results. There are methods for obtaining an individual result from a result ID, GetResult, or methods for obtaining a list of results by filtering, for example GetResultListByAssessment, GetResultListByGroup and qm:meth:GetResultListByParticipant.

Warning

Questionmark databases may contain many millions of results, some of these methods were designed to work with smaller datasets and may not be suitable for use when the number of results returned is very large. As a rule of thumb, if the returned result set exceeds 1,000 results consider using an alternative API. The deliveryodata.Results OData feed queries the same part of the data model and will accept more filters (including date filters) allowing you to return more precise result sets.

Result Methods¶

Getting Result Information¶

method GetResult (Result_ID string) returns Result ¶

Returns a single result from the database. The string type of the input parameter is an anomaly, the parameter value is required (See String Parameters) and must be the integer value of a result ID present in the database. See A_Result.Result_ID.

The output parameter returned is of type Result2, which is an extension of the basic Result type declared in the WSDL. (See Extension Types.)

Example:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <GetResult xmlns="http://questionmark.com/QMWISe/">
            <Result_ID>218475</Result_ID>
        </GetResult>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <GetResultResponse xmlns="http://questionmark.com/QMWISe/">
            <Result xsi:type="Result2">
                <Result_ID>218475</Result_ID>
                <Assessment_ID>0009962000009962</Assessment_ID>
                <Write_Answer_Data>true</Write_Answer_Data>
                <Participant>miami147</Participant>
                <Member_Group/>
                <Participant_Details/>
                <Hostname/>
                <IP_Address>10.30.6.5</IP_Address>
                <Still_Going>false</Still_Going>
                <Status>9</Status>
                <Feedback>0</Feedback>
                <Number_Sections>1</Number_Sections>
                <Max_Score>3</Max_Score>
                <Total_Score>3</Total_Score>
                <Special_1>Customer</Special_1>
                <Special_2>147</Special_2>
                <Special_3/>
                <Special_4/>
                <Special_5/>
                <Special_6/>
                <Special_7/>
                <Special_8/>
                <Special_9/>
                <Special_10/>
                <Time_Taken>0</Time_Taken>
                <Score_Band_Title>Thank you!</Score_Band_Title>
                <Score_Band_Number>2016515</Score_Band_Number>
                <Percentage_Score>100</Percentage_Score>
                <Schedule_Name/>
                <Monitored>true</Monitored>
                <Monitor_Name/>
                <TopicScoringList>
                    <TopicScoring>
                        <Topic_ID>58275</Topic_ID>
                        <Topic_Name>Printing and Scanning in Miami</Topic_Name>
                        <Description/>
                        <Percentage_Score>100</Percentage_Score>
                        <Actual_Score>3</Actual_Score>
                        <Maximum_Score>3</Maximum_Score>
                        <Num_Questions>3</Num_Questions>
                    </TopicScoring>
                </TopicScoringList>
                <When_Started>2016-04-13T15:28:14</When_Started>
                <Session_Last_Modified>2016-04-12T23:01:33</Session_Last_Modified>
                <When_Finished>2016-04-13T15:28:14</When_Finished>
                <FirstName>Customer</FirstName>
                <LastName>147</LastName>
                <PrimaryEmailAddress/>
                <SubgroupPath/>
                <CourseProperty>Miami2016</CourseProperty>
                <ScoreBandIDProperty>663244283</ScoreBandIDProperty>
            </Result>
        </GetResultResponse>
    </soap:Body>
</soap:Envelope>

method GetResultList () returns ResultList ¶: Returns all results in the repository database. Use of this method is no longer recommended due to the number of result records in a typical repository.

method GetResultListByAssessment (Assessment_ID string) returns ResultList ¶

Returns all results in the repository database associated with a given assessment. Use of this method is no longer recommended if the number of results for the assessment exceeds 10,000 records.

The input parameter is given as type string but it must be the numeric ID of the assessment left-padded with 0s to a fixed length of 16 characters. See Assessment IDs for details.

method GetResultListByGroup (Group_Name string) returns ResultList ¶

Returns all results in the repository database associated with a given Group. Use of this method is no longer recommended if the number of results for the group exceeds 10,000 records.

Notice that the group is identified by name and not by a numeric ID. The name must be the name of a top-level group and is matched against A_Result.Member_Group in the data model.

For backwards compatibility, if the Group_Name input parameter contains the single quote character it is replaced with the back-quote ` before being used to filter the result set.

method GetResultListByParticipant (Participant_Name string) returns ResultList ¶

Returns all results in the repository database associated with a given Participant.

Notice that the participant is identified by name and not by a numeric ID. The name is matched against A_Result.Participant in the data model.

For backwards compatibility, if the Participant_Name input parameter contains the single quote character it is replaced with the back-quote ` before being used to filter the result set.

method GetResultListBySubGroup (Event string) returns EventResultList ¶

Similar to GetResultListByGroup, this returns all results in the repository where A_Result.Member_Sub_Group_1 matches the input parameter. This method imposes the additional constraint that the input parameter must be the name of a group as recorded in G_Group_Tree.Group_Name.

Unlike similar methods, no character transformations are applied to the input parameter.

method GetAssessmentResult (Result_ID string) returns AssessmentResult ¶: Similar to GetResult but returns additional information including the Feedback and the the detailed item-level responses and scores.

method GetAssessmentResult2 (Result_ID string) returns AssessmentResult2 ¶: Similar to GetAssessmentResult but returns some elements missing from the original method by using the AssessmentResult2 type.

method GetAssessmentResultListByAssessment (Assessment_ID string) returns AssessmentResultList ¶: Similar to GetResultListByAssessment but returns additional information including the Feedback and the the detailed item-level responses and scores.

method GetAssessmentResultListByGroup (Group_Name string) returns AssessmentResultList ¶: Similar to GetResultListByGroup but returns additional information including the Feedback and the the detailed item-level responses and scores.

method GetAssessmentResultListByParticipant (Participant_Name string) returns AssessmentResultList ¶: Similar to GetResultListByParticipant but returns additional information including the Feedback and the the detailed item-level responses and scores.

Creating Results¶

The following methods can be used to create results in the repository. The mechanism used by these methods relies on the A_Session_Ex and A_Question_Ex tables in the data model. This is an older data flow that has some issues with the handling of assessment and question revisions. The methods are documented here for backwards compatibility, new projects should consider using the new snapshot-based ‘Attempt’ flow facilitated by the Delivery OData service.

method CreateAssessmentResult (AssessmentResult AssessmentResult) returns string ¶

Creates a single result in the database from the supplied information. This is the base method designed to work with the basic Result and Answer elements.

The method creates a record in A_Result and optionally records in A_TopicScore, A_Answer, A_ScoreBand_Ex and A_Comment. as appropriate.

On input, the Result.Result_ID is ignored, it is recommended to set it to “0”.

The supplied Result.Assessment_ID must correspond to the ID of an assessment in A_Session_Ex in the repository database. Similarly, any uploaded answers must have corresponding records in A_Question_Ex. Before using this method you should familiarise yourself with the purpose of these tables in the data model. It is likely that you will have to call CreateAssessmentResultInfoList and CreateQuestionResultInfoList when creating results for the first time - you can use GetAssessmentResultInfo and GetQuestionResultInfoList to test for the existence of the required records.

If AssessmentResult.Feedback is provided a new record is created in A_ScoreBand_Ex to hold the feebdack. The feedback is not validated against the assessment. It should record the feedback the participant actually saw at the time of delivery. If the result has been created following delivery and scoring via some external system it would be appropriate to set the feedback string to the message provided by that system on submission such as an indication of pass or fail.

Warning

Scored results created with QMWISe are not subject to the same level of validation as results created and scored using the OData deliveryodata.Attempts feed. In particular, care is needed to ensure that answers adhere to the correct format for the question type, as described by A_Answer.Answer_Full. Furthermore, these values must validate against the associated question. Using the correct revision number and ensuring that the indicated When_Started time is consistent with the revision history of the associated questions is important to ensure consistent reporting in Questionmark Analytics.

method CreateAssessmentResult2 (AssessmentResult2 AssessmentResult2) returns string ¶: Extends the basic CreateAssessmentResult to use the updated AssessmentResult2 type.

method CreateAssessmentResult3 (AssessmentResult3 AssessmentResult3) returns string ¶: Extends the basic CreateAssessmentResult to use the language-aware AssessmentResult3 type.

method CreateAssessmentResultInfoList (AssessmentResultInfoList AssessmentResultInfoList) returns int ¶

Creates an entry in A_Session_Ex for each item in the input list if there is no existing entry available. Returns the number of records that were actually created as a result.

Before a result can be created for an assessment the assessment must have an entry in A_Session_Ex. This method can be used to force the creation of a suitable record enabling subsequent calls to CreateAssessmentResult to succeed. (Though see the similar CreateQuestionResultInfoList).

For assessments that have been created using Questionmark tools but have been delivered by an external system you should use GetAssessment to discover the appropriate information to pass.

For assessments that have been created and delivered externally you must create a unique Assessment ID (see MID and LID for important information about the valid set of IDs) that is not currently in use. You may then fill the fields in appropriately to describe the external assessment.

method CreateAssessmentResultInfoList2 (AssessmentResultInfoList2 AssessmentResultInfoList2) returns int ¶

Similar to CreateAssessmentResultInfoList but takes an extended set of elements allowing two extra fields to be set in the database.

Note that the AssessmentResultInfo2.CourseProperty field should contain the name of the folder containing the assessment. This is not easy to discover using QMWISe as GetAssessment returns the ID of the folder (rather than the name) and there is no method to get information about a folder itself from its ID. Given this limitation the field should be treated as more general metadata. The value of this field is copied to the A_Result.Course field for each result created for this assessment.

method CreateAssessmentResultInfoList3 (AssessmentResultInfoList3 AssessmentResultInfoList3) returns int ¶: Similar to CreateAssessmentResultInfoList2 but takes an extended set of elements allowing language information to be set for the assessment.

method CreateQuestionResultInfoList (QuestionResultInfoList QuestionResultInfoList) returns int ¶

Creates an entry in A_Question_Ex for each item in the input list if there is no existing entry available. Returns the number of records that were actually created as a result.

Before an answer record can be created for a question the quesitno must have an entry in A_Question_Ex. This method can be used to force the creation of a suitable record enabling subsequent calls to CreateAssessmentResult to succeed. (Though see the similar CreateAssessmentResultInfoList).

Creating answer records with QMWISe for assessments that have been created using Questionmark tools but have been delivered by an external system is not simple and is discouraged. Generating the outcome information to pass to this method requires detailed knowledge of, and access to, the QML description of the question itself.

Consider using snapshots in combination with the newer deliveryodata.Attempts feed for this type of project. The only exception to this use case would be when the result info record is known to already exist, for example if you are creating a new result after re-scoring an existing one. In that case you would not need to call this method.

For assessments that have been created and delivered externally you must create a unique Question ID (see MID and LID for important information about the valid set of IDs) for each question that is not currently in use. You may then fill the fields in appropriately to describe the externally created question.

method CreateQuestionResultInfoList2 (QuestionResultInfoList2 QuestionResultInfoList2) returns int ¶: Similar to CreateQuestionResultInfoList but takes an extended set of elements allowing language information to be set for the assessment. For use with CreateAssessmentResultInfoList3.

method GetAssessmentResultInfo (Assessment_ID string) returns AssessmentResultInfo ¶

Returns information from A_Session_Ex. Can be used to check that the required information about an Assessment exists before creating results with CreateAssessmentResult and similar methods.

The input parameter is given as type string but it must be the numeric ID of the assessment left-padded with 0s to a fixed length of 16 characters. See Assessment IDs for details.

method GetAssessmentResultInfo2 (Assessment_ID string) returns AssessmentResultInfo2 ¶: As per GetAssessmentResultInfo but with extended information.

method GetAssessmentResultInfo3 (Assessment_ID string, Base boolean, Language string) returns AssessmentResultInfo3 ¶: As per GetAssessmentResultInfo but can be used with translated assessments. For translated assessments the assessment is specified with an additional language code and the flag indicating whether or not the language is the base language for the assessment. In fact, the flag is actually ignored, if the correct value is not known it may be set to false.

method GetAssessmentResultInfoList () returns AssessmentResultInfoList ¶: Returns all records from A_Session_Ex.

method GetAssessmentResultInfoList2 () returns AssessmentResultInfoList2 ¶: Returns all records from A_Session_Ex with additional elements as defined in AssessmentResultInfo2. Note there is not ‘GetAssessmentResultInfoList3’.

method GetQuestionResultInfoList () returns QuestionResultInfoList ¶: Returns all records from A_Question_Ex. Can be used to check that the required information about a Question exists before creating results with CreateAssessmentResult and similar methods.

Warning

Some repository databases have thousands of delivered questions. This method is not intended for use on larger repositories. The use cases for using QMWISe to obtain information from A_Question_Ex are limited to legacy applications and are documented here only for completeness. New applications should use the deliveryodata.Attempts feed in Delivery OData to create externally generated results.

Result Types¶

complexType AssessmentResult¶

The XML datatype that provides complete information about a result.

Result Result optional¶: The summary information for the result. Although marked as optional in the schema this element is always present and must be provided when creating results.

Feedback string optional¶: If present, and non empty, corresponds to the HTML feedback for the result as stored in A_ScoreBand_Ex.Feedback.

AnswerList AnswerList optional¶: The list of answers stored for this result.

complexType AssessmentResult2¶

An alternative type used for complete information about a result.

Note

Despite the name this type is not a simple extension of the similarly named AssessmentResult type.

Result Result2 optional¶: The summary information for the result. Although marked as optional in the schema this element is always present and must be provided when creating results.

Feedback string optional¶: If present, and non empty, corresponds to the HTML feedback for the result as stored in A_ScoreBand_Ex.Feedback.

AnswerList AnswerList2 optional¶: The list of answers stored for this result.

LMSDetails UnencryptedLMSDetails optional¶: Deprecated. This field was originally intended to allow the AICC protocol to notify a learning management system of the new result.

complexType AssessmentResult3¶

An alternative type used for complete information about a result that uses the language-aware Result3 type.

Note

Despite the name this type is not a simple extension of the similarly named AssessmentResult2 type.

Result Result3 optional¶: The summary information for the result. Although marked as optional in the schema this element is always present and must be provided when creating results.

Feedback string optional¶: If present, and non empty, corresponds to the HTML feedback for the result as stored in A_ScoreBand_Ex.Feedback.

AnswerList AnswerList2 optional¶: The list of answers stored for this result.

LMSDetails UnencryptedLMSDetails optional¶: Deprecated. This field was originally intended to allow the AICC protocol to notify a learning management system of the new result.

complexType AssessmentResultList¶

The element type used for a list of assessment results.

AssessmentResult AssessmentResult unbounded optional¶

complexType Result¶

The XML datatype representing a result. This is a base type that is extended by Result2 and further by Result3.

In most cases the fields returned are simply the values from associated record in the A_Result table in the underlying data model.

Result_ID string optional¶: See A_Result.Result_ID.

Assessment_ID string optional¶: See A_Result.Session_MID for more information, the field value here is the combined ID, as per A_Result.Assessment_ID but may be left-padded with 0s. See Assessment IDs for details.

Write_Answer_Data boolean required¶: See A_Result.Write_Answer_Data.

Participant string optional¶: See A_Result.Participant.

Member_Group string optional¶: See A_Result.Member_Group.

Participant_Details string optional¶: See A_Result.Participant_Details.

Hostname string optional¶: See A_Result.Hostname.

IP_Address string optional¶: See A_Result.IP_Address.

Still_Going boolean required¶: See A_Result.Still_Going.

Status short required¶: See A_Result.Status.

Feedback short required¶: See A_Result.Feedback.

Number_Sections short required¶: See A_Result.Number_Sections.

Max_Score int required¶: See A_Result.Max_Score.

Total_Score int required¶: See A_Result.Total_Score.

Special_1 string optional¶: See A_Result.Special_1.

Special_2 string optional¶: See A_Result.Special_2.

Special_3 string optional¶: See A_Result.Special_3.

Special_4 string optional¶: See A_Result.Special_4.

Special_5 string optional¶: See A_Result.Special_5.

Special_6 string optional¶: See A_Result.Special_6.

Special_7 string optional¶: See A_Result.Special_7.

Special_8 string optional¶: See A_Result.Special_8.

Special_9 string optional¶: See A_Result.Special_9.

Special_10 string optional¶: See A_Result.Special_10.

Time_Taken int required¶: See A_Result.Time_Taken.

Score_Band_Title string optional¶: See A_Result.Score_Band_Title.

Score_Band_Number int required¶: See A_Result.Score_Band_Number.

Percentage_Score short required¶: See A_Result.Percentage_Score.

Schedule_Name string optional¶: See A_Result.Schedule_Name.

Monitored boolean required¶: See A_Result.Monitored.

Monitor_Name string optional¶: See A_Result.Monitor_Name.

TopicScoringList TopicScoringList optional¶: A list of topic scores.

When_Started string optional¶: See A_Result.When_Started.

Session_Last_Modified string optional¶: See A_Result.Session_Last_Modified.

When_Finished string optional¶: See A_Result.When_Finished.

complexType TopicScoringList¶

Element used to return a list of topic scores in Result. and EventResult.

TopicScoring TopicScoring unbounded optional¶: Each topic score is contained in its own TopicScoring element.

complexType TopicScoring¶

Element representing a topic score. This information is loaded from the A_TopicScore in the data model.

Topic_ID string optional¶: See A_TopicScore.Topic_ID

Topic_Name string optional¶: See A_TopicScore.Topic

Description string optional¶: See A_TopicScore.Description

Percentage_Score double required¶: See A_TopicScore.Percentage_Score

Actual_Score int required¶: See A_TopicScore.Actual_Score

Maximum_Score int required¶: See A_TopicScore.Maximum_Score

Num_Questions int required¶: See A_TopicScore.Num_Questions

complexType Result2 extends Result ¶

FirstName string optional¶: See A_Result.First_Name.

LastName string optional¶: See A_Result.Last_Name.

PrimaryEmailAddress string optional¶: See A_Result.Primary_Email.

SubgroupPath string optional¶

If the result is associated with a sub-group then this field may contain the path to the subgroup with the top-level group as the first path component. The path separator is the back-slash character.

Whether or not the value of this element is set on a retrieved result will depend on the delivery mode used to create it. See A_Result.Member_Sub_Group_1 for more information.

CourseProperty string optional¶: See A_Result.Course.

ScoreBandIDProperty int required¶: See A_Result.ScoreBand_ID.

complexType Result3 extends Result2 ¶

An extension of the result element type that includes information about the language of the assessment taken. Currently used only for creating results.

Language string optional¶: See A_Result.Lang. When creating results there must be an entry in A_Session_Ex that matches both the Assessment_ID (defined by the base Result type) and the Language.

Base boolean required¶: Indicates if Language is the base language for the assessment or a translation. This field is actually used only for the creation of feedback and, along with Language, is used to set the language information for the ScoreBand (feedback) associated with the result. See A_ScoreBand_Ex.Base for more information.

complexType ResultList¶

The type used to serialize a list of results.

Result Result unbounded optional¶

complexType Answer¶

Fields largely correspond to the similarly named fields in A_Answer.

Question_ID string optional¶: The ID of the Question, calculated from the MID and LID, see A_Answer.Question_MID.

Revision int required¶: See A_Answer.Revision.

Occurrence short required¶: See A_Answer.Occurrence.

Topic_Name string optional¶: See A_Answer.Topic.

Block_Number short required¶: See A_Answer.Block_Number.

Question_Number short required¶: See A_Answer.Question_Number.

Status short required¶: See A_Answer.Status.

Times_Answered short required¶: See A_Answer.Times_Answered.

Max_Score int required¶: See A_Answer.Max_Score.

Actual_Score int required¶: See A_Answer.Actual_Score.

Know_Time_Taken boolean required¶: See A_Answer.Know_Time_Taken.

Time_Taken int required¶: See A_Answer.Time_Taken.

Number_Outcomes short required¶: See A_Answer.Number_Outcomes.

Outcome_Number short required¶: See A_Answer.Outcome_Number.

Outcome_Exponential int required¶: See A_Answer.Outcome_Exponential. Note that the underlying data model allows for 64 outcome bits through the provision of a second field A_Answer.Outcome_Exponential_2 but that this field is not included in the basic Answer element, this omission was corrected with the creation of Answer2.

Answer_Truncated string optional¶: See A_Answer.Answer_Truncated.

Answer_Full string optional¶: See A_Answer.Answer_Full.

Comment string optional¶: The associated participant comment, obtained from the related entity in A_Comment.Comment (if present).

complexType Answer2 extends Answer ¶

A small update to the base class to correct the limitation on the number of reported outcomes for a question.

Outcome_Exponential2Property int required¶: Extends QMWISe to support the full 64-outcomes per question when performing operations on answer records. See A_Answer.Outcome_Exponential_2 and the note above in Answer.Outcome_Exponential.

Note

The name of this element does not conform to the pattern in either the data model or the base type being extended.

complexType AnswerList¶

The type used to serialize a list of answers.

Answer Answer unbounded optional¶

complexType AnswerList2¶

The type used to serialize a list of answers using the updated Answer2 content model.

Answer2 Answer2 unbounded optional¶

complexType AssessmentResultInfo¶

Records information about an assessment that has been used to generate results - used prior to creating results. See CreateAssessmentResultInfoList.

Assessment_ID string optional¶

Revision int required¶

Session_Name string optional¶

Session_Author string optional¶

Whether_Time_Limit boolean required¶

Time_Limit int required¶

Number_Sections short required¶

Description string optional¶

Last_Updated string optional¶

When_Modified string optional¶

complexType AssessmentResultInfo2 extends AssessmentResultInfo ¶

Extends the base class adding the following elements. For usage see CreateAssessmentResultInfoList2.

Assessment_TypeProperty int required¶: Sets the assessment type from one of the constants defined by S_Header_Ex.Assessment_Type.

CourseProperty string optional¶: The name of the assessment folder that contains the assessment.

complexType AssessmentResultInfo3 extends AssessmentResultInfo2 ¶

Extends the base classes with elements for specifying if the assessment has been translated and whether or not this is the base language.

Base boolean required¶: True if the language given is the base language.

Language string optional¶: The language code of the language the assessment was presented in.

complexType AssessmentResultInfoList¶

Element that contains a list of AssessmentResultInfo.

AssessmentResultInfo AssessmentResultInfo unbounded optional¶

complexType AssessmentResultInfoList2¶

Element that contains a list of AssessmentResultInfo2.

AssessmentResultInfo2 AssessmentResultInfo2 unbounded optional¶

complexType AssessmentResultInfoList3¶

Element that contains a list of AssessmentResultInfo3.

AssessmentResultInfo3 AssessmentResultInfo3 unbounded optional¶

complexType QuestionResultInfo¶

Records information about a question that has been used to generate answers - used prior to creating results. See CreateQuestionResultInfoList.

Question_ID string optional¶

Revision int required¶

Question_Description string optional¶

Question_Type string optional¶

Topic_Name string optional¶

Number_Outcomes short required¶

Question_Wording string optional¶

OutcomeList OutcomeList optional¶

Last_Updated string optional¶

complexType Outcome¶

Outcome_Number short required¶

Outcome_Name string optional¶

Feedback string optional¶

complexType OutcomeList¶

Element that contains a list of Outcomes.

Outcome Outcome unbounded optional¶

complexType QuestionResultInfo2 extends QuestionResultInfo ¶

Extends the base QuestionResultInfo to include support for translated questions.

Base boolean required¶

Language string optional¶

complexType QuestionResultInfoList¶

Element that contains a list of QuestionResultInfo.

QuestionResultInfo QuestionResultInfo unbounded optional¶

complexType QuestionResultInfoList2¶

Element that contains a list of QuestionResultInfoList2.

QuestionResultInfoList2 QuestionResultInfoList2 unbounded optional¶

complexType EventResult¶

The XML datatype representing a result as returned by the special method GetResultListBySubGroup.

In most cases the fields returned are simply the values from associated record in the A_Result table in the underlying data model.

Result_ID string optional¶: See A_Result.Result_ID.

Assessment_ID string optional¶: See A_Result.Session_MID for more information, the field value here is the combined ID, as per A_Result.Assessment_ID but may be left-padded with 0s. See Assessment IDs for details.

Write_Answer_Data boolean required¶: See A_Result.Write_Answer_Data.

Participant string optional¶: See A_Result.Participant.

Member_Group string optional¶: See A_Result.Member_Group.

Participant_Details string optional¶: See A_Result.Participant_Details.

Hostname string optional¶: See A_Result.Hostname.

IP_Address string optional¶: See A_Result.IP_Address.

Still_Going boolean required¶: See A_Result.Still_Going.

Status short required¶: See A_Result.Status.

Feedback short required¶: See A_Result.Feedback.

Number_Sections short required¶: See A_Result.Number_Sections.

Max_Score int required¶: See A_Result.Max_Score.

Total_Score int required¶: See A_Result.Total_Score.

Special_1 string optional¶: See A_Result.Special_1.

Special_2 string optional¶: See A_Result.Special_2.

Special_3 string optional¶: See A_Result.Special_3.

Special_4 string optional¶: See A_Result.Special_4.

Special_5 string optional¶: See A_Result.Special_5.

Special_6 string optional¶: See A_Result.Special_6.

Special_7 string optional¶: See A_Result.Special_7.

Special_8 string optional¶: See A_Result.Special_8.

Special_9 string optional¶: See A_Result.Special_9.

Special_10 string optional¶: See A_Result.Special_10.

Time_Taken int required¶: See A_Result.Time_Taken.

Score_Band_Title string optional¶: See A_Result.Score_Band_Title.

Score_Band_Number int required¶: See A_Result.Score_Band_Number.

Percentage_Score short required¶: See A_Result.Percentage_Score.

Schedule_Name string optional¶: See A_Result.Schedule_Name.

Monitored boolean required¶: See A_Result.Monitored.

Monitor_Name string optional¶: See A_Result.Monitor_Name.

topicScoringList TopicScoringList optional¶: Note

The name of this element differs from the corresponding field in Result in the case of the first letter.

ScoreBandID int required¶: Note

The name of this element differs from the corresponding field in Result2.

See A_Result.ScoreBand_ID.

Course string optional¶: Note

The name of this element differs from the corresponding field in Result2.

See A_Result.Course.

Participant_FirstName string optional¶: Note

The name of this element differs from the corresponding field in Result2.

See A_Result.First_Name.

Participant_LastName string optional¶: Note

The name of this element differs from the corresponding field in Result2.

See A_Result.Last_Name.

Result_Value string optional¶

Essentially, this value indicates if the participant achieved the best possible assessment outcome (not to be confused with the maximum possible score). For example, if the assessment defines two outcomes bands for pass and fail then this value would be “1” if the participant passed and “0” if they failed. Similarly, if the assessment had 5 outcome bands representing grades “A” to “E” with “A” being the highest scoring then this field would be “1” if the participant achieved grade A.

“0”: The percentage score in the result was not in the highest scoring outcome band.
“1”: The percentage score in the result was in the highest scoring outcome band.

“”: There was no information about outcome bands available.

Member_Sub_Group_1 string optional¶: See A_Result.Member_Sub_Group_1.

Assessment_Name string optional¶

The name of the Assessement referenced by EventResult.Assessment_ID.

The name is obtained by looking up information in S_AML.

When_Started string optional¶: See A_Result.When_Started.

Session_Last_Modified string optional¶: See A_Result.Session_Last_Modified.

When_Finished string optional¶: See A_Result.When_Finished.

complexType EventResultList¶

The type used to serialize a list of results by GetResultListBySubGroup.

EventResult EventResult unbounded optional¶

complexType UnencryptedLMSDetails extends LMSDetails ¶

Deprecated.

Password string optional¶

complexType LMSDetails¶

Deprecated.

SessionId string optional¶

LmsUrl string optional¶

Results¶

Result Methods¶

Getting Result Information¶

Creating Results¶

Result Types¶

Table of Contents

Related Topics