OSID Logo
OSID Specifications
grading package
Version 3.0.0
Release Candidate Preview
Interfaceosid.grading.GradeSystemGradebookAssignmentSession
Implementsosid.OsidSession
Description

This session provides methods to re-assign grade systems to Gradebooks. A GradeSystem may map to multiple Gradebooks and removing the last reference to a GradeSystem is the equivalent of deleting it. Each Gradebook may have its own authorizations governing who is allowed to operate on it.

Moving or adding a reference of a GradeSystem to another Gradebook is not a copy operation (eg: does not change its Id ).

MethodcanAssignGradeSystem
Description

Tests if this user can alter grade system/gradebook mappings. A return of true does not guarantee successful authorization. A return of false indicates that it is known mapping methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer assignment operations to unauthorized users.

Returnboolean false if mapping is not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodcanAssignGradeSystemsToGradebook
Description

Tests if this user can alter grade system/gradebook mappings. A return of true does not guarantee successful authorization. A return of false indicates that it is known mapping methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer assignment operations to unauthorized users.

Parametersosid.id.IdgradebookIdthe Id of the Gradebook
Returnboolean false if mapping is not authorized, true otherwise
ErrorsNULL_ARGUMENT gradebookId is null
CompliancemandatoryThis method must be implemented.
MethodgetAssignableGradebookIds
Description

Gets a list of gradebooks including and under the given gradebook node in which any grade system can be assigned.

Parametersosid.id.IdgradebookIdthe Id of the Gradebook
Returnosid.id.IdListlist of assignable gradebook Ids
ErrorsNULL_ARGUMENT gradebookId is null
OPERATION_FAILEDunable to complete request
CompliancemandatoryThis method must be implemented.
MethodgetAssignableGradebookIdsForGradeSystem
Description

Gets a list of gradebooks including and under the given gradebook node in which a specific grade system can be assigned.

Parametersosid.id.IdgradebookIdthe Id of the Gradebook
osid.id.IdgradeSystemIdthe Id of the GradeSystem
Returnosid.id.IdListlist of assignable gradebook Ids
ErrorsNULL_ARGUMENT gradebookId or gradeSystemId is null
OPERATION_FAILEDunable to complete request
CompliancemandatoryThis method must be implemented.
MethodassignGradeSystemToGradebook
Description

Adds an existing GradeSystem to a Gradebook.

Parametersosid.id.IdgradeSystemIdthe Id of the GradeSystem
osid.id.IdgradebookIdthe Id of the Gradebook
ErrorsALREADY_EXISTS gradeSystemId is already assigned to gradebookId
NOT_FOUND gradeSystemId or gradebookId not found
NULL_ARGUMENT gradeSystemId or gradebookId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodunassignGradeSystemFromGradebook
Description

Removes a GradeSystem from a Gradebook.

Parametersosid.id.IdgradeSystemIdthe Id of the GradeSystem
osid.id.IdgradebookIdthe Id of the Gradebook
ErrorsNOT_FOUND gradeSystemId or gradebookId not found or gradeSystemId not assigned to gradebookId
NULL_ARGUMENT gradeSystemId or gradebookId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.