UD_GetAssetResultsExtended

Description

The UD_GetAssetResultsExtended service returns course activity for one user at a time. Results include data for one, or all courses for which the specified user has activity. This service provides the following advantages:

• Dynamically detects and displays both core user profile fields and enabled custom user profile fields
• Results are formatted in XML
• Returns either course or lesson level results

Note: This service only returns the results for courses. It does not return results for Learning Programs, KnowledgeCenters, or Skillsoft Advantage products.

Inputs

Success Response(s)

XML Response

A successful response returns the following data:

• username - user's unique ID
• RegDate - date and time the user registered in Skillport
• Activated - indicates whether or not the user account is activated; true or false
• _sys_lastname - core profile field for user's last name
• _sys_firstname - core profile field for user's first name
• _sys_emailaddress - core profile field for user's email address
• _sys_display_first_name - core profile field for user's display name
• _sys_display_last_name - core profile field for user's display name
• _sys_location - core profile field for user's location
• _sys_image_url - core profile field for user's image link
• {custom user profile fields 0 through n} - only enabled custom fields display
• CourseId - unique ID for the course
• CourseTitle - course title
• FirstAccess - the date and time the user first accessed the course
• LastAccess - the date and time the user last accessed the course
• TimesAccessed - number of times the user accessed the course
• Duration - the total time the user spent in the course
• OverallPreScore - the pre-assessment score, if available
• OverallHighScore - the highest score achieved for the course, if available
• OverallCurrentScore - the assessment score from the last completed attempt, if available
• CourseStatus - course status
• CompletionDate - date the course was completed, if applicable
• TimesDownloaded - number of times the user downloaded the course
• DueDate - the due date for completing the course, if assigned
• scoID - the scoID for the course
• Lesson ID - the lesson within the course
• LessonPreScore - the lesson pre-score, if available
• LessonHighScore - the highest score achieved for the lesson, if available
• LessonLastScore - the assessment score from the last completed attempt, if available

Selection fields display the ID of selected values instead of displaying the localized value.

In the XML output:

• The <userCourse> element contains all data for an individual user including user data, profile fields, and course activity.
  • Each <userCourse> element has one and only one <user> element.
  • Each <userCourse> element can have 0:n <course> elements.
• The <user> element contains user information including elements for user profile fields.
  • Each <user> element will have one and only one <UserProfileFields> element that can have 0:n <ProfileField> elements.
• The <course> element contains all information related to the couse.
  • If summaryLevel=lesson, each <course> element includes a <lesson> element for all lessons related to the course.

Example XML Output

• Example - summaryLevel=lesson

  Note: If summaryLevel=course, <lesson> elements do not display.

  Results

  <RESULTS>

       <UserCourse>

            <user username="tsmith" activated="true" userRole="END_USER" isCustomUser="false" regdate="2013-09-06 10:30:38" selfReg="false" siteLanguage="en_US" >

                 <ProfileFieldValues>

                      <fieldValue id="_sys_firstname">

                           <value>Tom</value>

                      </fieldValue>

                      <fieldValue id="_sys_lastname">

                           <value>Smith</value>

                      </fieldValue>

                      <fieldValue id="_sys_emailaddress">

                           <value/>

                      </fieldValue>

                      <fieldValue id="_sys_display_first_name">

                           <value>Tom</value>

                      </fieldValue>

                      <fieldValue id="_sys_display_last_name">

                           <value>Smith</value>

                      </fieldValue>

                      <fieldValue id="_sys_location">

                           <value/>

                      </fieldValue>

                      <fieldValue id="_sys_image_url">

                           <value/>

                      </fieldValue>

                      <fieldValue id="custom user field1">

                           <value>abc</value>

                      </fieldValue>

                      <fieldValue id="custom user field2">

                           <value/>

                      </fieldValue>                  

                 </ProfileFieldValues>

            </user>

            <Course courseId="COMM0101" courseTitle="Communicate to Develop Relationships" firstAccessDate="2013-09-12 15:15:28" lastAccessDate="2013-09-12 15:19:09" timesAccessed="2" duration="224" overallPrescore="17.0" overallHigScore="17.0" overallCurrentScore="17.0" status="Incomplete" completionDate="" timesDownloaded="0" scoId="" dueDate="">

                 <Lesson lessonId="1" lessonPrescore="33.0" lessonHighScore="33.0" lessonCurrentScore="33.0"/>

                 <Lesson lessonId="2" lessonPrescore="0.0" lessonHighScore="0.0" lessonCurrentScore="0.0"/>

                 <Lesson lessonId="3" lessonPrescore="17.0" lessonHighScore="17.0" lessonCurrentScore="17.0"/>

            </Course>

            <Course courseId="COMM0606" courseTitle="A Rich Tapestry of Cultural Contrasts" firstAccessDate="2013-09-12 15:23:29" lastAccessDate="2013-09-12 15:23:29" timesAccessed="1" duration="27" overallPrescore="n/a" overallHighScore="n/a" overallCurrentScore="n/a" status="Incomplete" completionDate="" timesDownloaded="0" scoId="" dueDate="">

                 <Lesson lessonId="1" lessonPrescore="0.0" lessonHighScore="0.0" lessonCurrentScore="0.0"/>

                 <Lesson lessonId="2" lessonPrescore="0.0" lessonHighScore="0.0" lessonCurrentScore="0.0"/>

                 <Lesson lessonId="3" lessonPrescore="0.0" lessonHighScore="0.0" lessonCurrentScore="0.0"/>

                 <Lesson lessonId="4" lessonPrescore="0.0" lessonHighScore="0.0" lessonCurrentScore="0.0"/>

            </Course>

       </UserCourse>

  </RESULTS>