blackboard.data.discussionboard.datamanager
Interface DiscussionBoardGradeManager


public interface DiscussionBoardGradeManager

Utility manager to handle discussionboard forum and thread grading

Since:
Bb 7.1

Method Summary
 void createOutcome(blackboard.data.gradebook.impl.OutcomeDefinition ocd, CourseMembership cm, java.lang.String points)
          Create outcome.
 void deleteOutcome(blackboard.data.gradebook.impl.OutcomeDefinition ocd, CourseMembership cm, Id messageId, Id userId)
          Delete outcome.
 float getForumPointsPossible(Id forum_id)
          Given a forum Id, get the maximum score possible for a graded forum
 float getThreadPointsPossible(Id thread_id)
          Given a message Id for a top-level thread, get the maximum score possible for a graded thread
 java.util.Map<java.lang.Integer,java.util.List<java.lang.String>> loadGradeHashByForumId(Id forum_id)
          Given a forum Id, get the user grades for a forum.
 java.util.Map<java.lang.Integer,java.util.List<java.lang.String>> loadGradeHashByForumId(Id forum_id, Id course_id)
          Given a forum Id, get the user grades for a forum.
 java.util.Map<java.lang.Integer,java.util.List<java.lang.String>> loadGradeHashByThreadId(Id thread_id)
          Given a message Id for a top-level thread, get the user grades for a thread.
 blackboard.data.gradebook.impl.OutcomeDefinition loadOutcomeDefinitionByForumIdAndCourseId(Id forum_id, Id course_id)
          Loads the OutcomeDefinition by the forum id and course id.
 

Method Detail

getForumPointsPossible

float getForumPointsPossible(Id forum_id)
                             throws PersistenceException
Given a forum Id, get the maximum score possible for a graded forum

Returns:
the point float number or Float$NaN if forum is not found or not a gradable forum
Throws:
PersistenceException - If there is a database error loading entities needed to retrieve the forum points possible value

getThreadPointsPossible

float getThreadPointsPossible(Id thread_id)
                              throws PersistenceException
Given a message Id for a top-level thread, get the maximum score possible for a graded thread

Returns:
point float
Throws:
PersistenceException

loadGradeHashByForumId

java.util.Map<java.lang.Integer,java.util.List<java.lang.String>> loadGradeHashByForumId(Id forum_id)
                                                                                         throws PersistenceException
Given a forum Id, get the user grades for a forum. The key of the map is the course membership id pk

Returns:
Map
Throws:
PersistenceException

loadGradeHashByForumId

java.util.Map<java.lang.Integer,java.util.List<java.lang.String>> loadGradeHashByForumId(Id forum_id,
                                                                                         Id course_id)
                                                                                         throws PersistenceException
Given a forum Id, get the user grades for a forum. The key of the map is the course membership id pk Also need the couse id to get the correct data.

Returns:
Map
Throws:
PersistenceException

loadGradeHashByThreadId

java.util.Map<java.lang.Integer,java.util.List<java.lang.String>> loadGradeHashByThreadId(Id thread_id)
                                                                                          throws PersistenceException
Given a message Id for a top-level thread, get the user grades for a thread. The key of the map is the course membership id pk

Returns:
Map
Throws:
PersistenceException

createOutcome

void createOutcome(blackboard.data.gradebook.impl.OutcomeDefinition ocd,
                   CourseMembership cm,
                   java.lang.String points)
                   throws PersistenceException,
                          ValidationException
Create outcome.

Parameters:
ocd - OutcomeDefinition
cm - CourseMembership
points - String
Throws:
ValidationException - Will never be thrown
PersistenceException

deleteOutcome

void deleteOutcome(blackboard.data.gradebook.impl.OutcomeDefinition ocd,
                   CourseMembership cm,
                   Id messageId,
                   Id userId)
                   throws PersistenceException
Delete outcome.

Parameters:
ocd - OutcomeDefinition
cm - CourseMembership
Throws:
PersistenceException - If a database error occurred while trying to delete the outcome

loadOutcomeDefinitionByForumIdAndCourseId

blackboard.data.gradebook.impl.OutcomeDefinition loadOutcomeDefinitionByForumIdAndCourseId(Id forum_id,
                                                                                           Id course_id)
                                                                                           throws PersistenceException
Loads the OutcomeDefinition by the forum id and course id.

Throws:
PersistenceException


Copyright © 2012 Blackboard, Inc. All Rights Reserved.