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