org.osid.grading.transform

Interface GradingTransformManager

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable, GradingTransformProfile, OsidManager, OsidProfile, Sourceable

public interface GradingTransformManager
extends OsidManager, GradingTransformProfile

The grading transform manager provides access to grading transform sessions and provides interoperability tests for various aspects of this service. The sessions included in this manager are:

• GradeSystemTransformationSession: a session to convert grades among grade systems
• GradeSystemTransformLookupSession: a session to examine grade system transformation rules
• GradeSystemTransformAdminSession: a session to manage grade system transformation rules
• GradeSystemTransformNotiicationSession: a session to subscribe to grade system transformation notifications

Method Summary

Methods

Modifier and Type	Method and Description
GradeSystemTransformAdminSession	getGradeSystemTransformAdminSession() Gets the OsidSession associated with the grade system transform admin service.
GradeSystemTransformAdminSession	getGradeSystemTransformAdminSessionForGradebook(Id gradebookId) Gets the OsidSession associated with the grade system transform admin service for the given gradebook.
GradeSystemTransformationSession	getGradeSystemTransformationSession(Id sourceGradeSystemId, Id targetGradeSystemId) Gets the session for transforming grades among grade systems.
GradeSystemTransformLookupSession	getGradeSystemTransformLookupSession() Gets the OsidSession associated with the grade system transform lookup service.
GradeSystemTransformLookupSession	getGradeSystemTransformLookupSessionForGradebook(Id gradebookId) Gets the OsidSession associated with the grade system transform lookup service for the given gradebook.
GradeSystemTransformNotificationSession	getGradeSystemTransformNotificationSession(GradeSystemTransformReceiver gradeSystemTransformReceiver) Gets the notification session for notifications pertaining to grade system transform changes.
GradeSystemTransformNotificationSession	getGradeSystemTransformNotificationSessionForGradebook(GradeSystemTransformReceiver gradeSystemTransformReceiver, Id gradebookId) Gets the OsidSession associated with the grade system transform notification service for the given gradebook.

Methods inherited from interface org.osid.OsidManager

changeBranch, initialize, rollbackService

Methods inherited from interface org.osid.binding.java.OsidManager

close

Methods inherited from interface java.io.Closeable

close

Methods inherited from interface org.osid.grading.transform.GradingTransformProfile

getGradeSystemTransformRecordTypes, supportsGradeSystemTransformAdmin, supportsGradeSystemTransformation, supportsGradeSystemTransformLookup, supportsGradeSystemTransformNotification, supportsGradeSystemTransformRecordType, supportsVisibleFederation

Methods inherited from interface org.osid.OsidProfile

getBranch, getBranchId, getDescription, getDisplayName, getId, getLocales, getProxyRecordTypes, getReleaseDate, getVersion, supportsJournalBranching, supportsJournalRollback, supportsOSIDVersion, supportsProxyRecordType

Methods inherited from interface org.osid.Sourceable

getBranding, getBrandingIds, getLicense, getProvider, getProviderId

Method Detail

getGradeSystemTransformationSession

GradeSystemTransformationSession getGradeSystemTransformationSession(Id sourceGradeSystemId,
                                                                   Id targetGradeSystemId)
                                                                     throws NotFoundException,
                                                                            OperationFailedException

Gets the session for transforming grades among grade systems. The available transformations can be examined through the GradeSystemTransformLookupSession.

Parameters:

sourceGradeSystemId - the Id of the source grade system

targetGradeSystemId - the Id of the target grade system

Returns:

a GradeSystemTransformationSession

Throws:

NotFoundException - no transform exists between souceGradebookId and targetGradeSystemId

NullArgumentException - sourceGradeSystemId or targetGradeSystemIdId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsGradeSystemTransformation() is false

Compliance:

optional - This method must be implemented if supportsGradeSystemTransformation() is true.

getGradeSystemTransformLookupSession

GradeSystemTransformLookupSession getGradeSystemTransformLookupSession()
                                                                       throws OperationFailedException

Gets the OsidSession associated with the grade system transform lookup service.

Returns:

a GradeSystemTransformLookupSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsGradeSystemTransformLookup() is false

Compliance:

optional - This method must be implemented if supportsGradeSystemTransformLookup() is true.

getGradeSystemTransformLookupSessionForGradebook

GradeSystemTransformLookupSession getGradeSystemTransformLookupSessionForGradebook(Id gradebookId)
                                                                                   throws NotFoundException,
                                                                                          OperationFailedException

Gets the OsidSession associated with the grade system transform lookup service for the given gradebook.

Parameters:

gradebookId - the Id of the gradebook

Returns:

a GradeSystemTransformLookupSession

Throws:

NotFoundException - gradebookId not found

NullArgumentException - gradebookId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsGradeSystemTransformLookup() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if supportsGradeSystemTransformLookup() and supportsVisibleFederation() are true.

getGradeSystemTransformAdminSession

GradeSystemTransformAdminSession getGradeSystemTransformAdminSession()
                                                                     throws OperationFailedException

Gets the OsidSession associated with the grade system transform admin service.

Returns:

a GradeSystemTransformAdminSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsGradeSystemTransformAdmin() is false

Compliance:

optional - This method must be implemented if supportsGradeSystemTransformAdmin() is true.

getGradeSystemTransformAdminSessionForGradebook

GradeSystemTransformAdminSession getGradeSystemTransformAdminSessionForGradebook(Id gradebookId)
                                                                                 throws NotFoundException,
                                                                                        OperationFailedException

Gets the OsidSession associated with the grade system transform admin service for the given gradebook.

Parameters:

gradebookId - the Id of the gradebook

Returns:

a GradeSystemTransformAdminSession

Throws:

NotFoundException - gradebookId not found

NullArgumentException - gradebookId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsGradeSystemTransformAdmin() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if supportsGradeSystemTransformAdmin() and supportsVisibleFederation() are true.

getGradeSystemTransformNotificationSession

GradeSystemTransformNotificationSession getGradeSystemTransformNotificationSession(GradeSystemTransformReceiver gradeSystemTransformReceiver)
                                                                                   throws OperationFailedException

Gets the notification session for notifications pertaining to grade system transform changes.

Parameters:

gradeSystemTransformReceiver - the grade system transform receiver interface

Returns:

a GradeSystemTransformNotificationSession

Throws:

NullArgumentException - gradeSystemReceiver is null

OperationFailedException - unable to complete request

UnimplementedException - supportsGradeSystemTransformNotification() is false

Compliance:

optional - This method must be implemented if supportsGradeSystemTransformNotification() is true.

getGradeSystemTransformNotificationSessionForGradebook

GradeSystemTransformNotificationSession getGradeSystemTransformNotificationSessionForGradebook(GradeSystemTransformReceiver gradeSystemTransformReceiver,
                                                                                             Id gradebookId)
                                                                                               throws NotFoundException,
                                                                                                      OperationFailedException

Gets the OsidSession associated with the grade system transform notification service for the given gradebook.

Parameters:

gradeSystemTransformReceiver - the grade system transform receiver interface

gradebookId - the Id of the gradebook

Returns:

a GradeSystemTransformNotificationSession

Throws:

NotFoundException - gradebookId not found

NullArgumentException - gradeSystemReceiver or gradebookId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsGradeSystemTransformNotification() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if supportsGradeSystemTransformNotification() and supportsVisibleFederation() are true.