Report scores

Many courses offer learners a certain number of retries. If you use server-side review mode, a training manager can specify the maximum attempts the learner has to complete or pass the course successfully (see Connect Enterprise User Guide for details of how course retry works in both server-side and client-side review mode).

This means that a learner can attempt a course multiple times and have multiple scores. In your application, you may want to display only the learner's highest score.

Report a user's highest score on a course or quiz

Get the user's principal-id (see "Get the principal-id of the current user").
Get the sco-id of the course or quiz (see "Find the sco-id of a course or curriculum").

Call report-user-training-transcripts, filtering on the sco-id and sorting on the score:

https://example.com/api/xml?action=report-user-training-transcripts
    &principal-id=2006258745&filter-sco-id=2006334909&sort-score=desc

Parse the response for the highest score, which should be in the first row element in the list:

<row transcript-id="2006335954" sco-id="2006334909" 
            principal-id="2006258745" status="user-passed" score="20" 
            max-score="20" certificate="2006335954" type="content"
            icon="producer">
    <name>Java Data Type Quiz</name> 
    <url-path>/quiz/</url-path> 
    <login>bob@acme.com</login> 
    <date-taken>2006-05-12T11:55:24.940-07:00</date-taken> 
    <principal-name>Bob Smith</principal-name> 
</row>

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/breeze/6/xml_api/03b_tra9.htm