org.sakaiproject.service.gradebook.shared
Interface GradebookFrameworkService

public interface GradebookFrameworkService

This service is meant to be used by the framework which manages the Gradebook application. The service provides various administrative functions which aren't handled by the application itself, including creating and removing gradebooks, and managing system-wide grading schemes. Because these aren't operations taken by the application, responsibility for security is left completely up to the client. THERE ARE NO AUTHORIZATION CHECKS. In other words, DO NOT provide open web service access to this service's methods!

Method Summary

void	addGradebook(String uid, String name) Creates a new gradebook with the given UID and name
void	deleteGradebook(String uid) Deletes the gradebook with the given UID, along with all its associated data.
boolean	isGradebookDefined(String gradebookUid) Checks to see whether a gradebook with the given uid exists.
void	setAvailableGradingScales(Collection gradingScaleDefinitions)
void	setDefaultGradingScale(String uid)

Method Detail

addGradebook

void addGradebook(String uid,
                  String name)

Creates a new gradebook with the given UID and name

Parameters:

uid - The UID used to specify a gradebook and its associated data. It is the caller's responsibility to ensure that this is unique within gradebook storage.

name - The name of the gradebook, to be used for logging and other conveniences by the application. This should be the name of the site or the course. It is only used for convenience, and does not need to be unique.

deleteGradebook

void deleteGradebook(String uid)
                     throws GradebookNotFoundException

Deletes the gradebook with the given UID, along with all its associated data.

Throws:

GradebookNotFoundException

isGradebookDefined

boolean isGradebookDefined(String gradebookUid)

Checks to see whether a gradebook with the given uid exists.

Parameters:

gradebookUid - The gradebook UID to check

Returns:

Whether the gradebook exists

setAvailableGradingScales

void setAvailableGradingScales(Collection gradingScaleDefinitions)

Parameters:

gradingScaleDefinitions - A collection of GradingScaleDefinition beans.

setDefaultGradingScale

void setDefaultGradingScale(String uid)

Parameters:

uid - The UID of the grading scale to use as the default for new gradebooks.