public interface GradeSystemTransformationSession extends OsidSession
The session defines methods for translating Grades
and
scores among GradeSystems.
This session provides a means
for moving across grade systems but does not perform an articulation based
on content or a specific qualifier.
Modifier and Type | Method and Description |
---|---|
boolean |
canTransformGradeSystems()
Tests if this user can perform grade transformations.
|
Gradebook |
getSourceGradeSystem()
Gets the
Gradebook associated with this session. |
Id |
getSourceGradeSystemId()
Gets the
Gradebook Id associated with
this session. |
Gradebook |
getTargetGradeSystem()
Gets the
Gradebook associated with this session. |
Id |
getTargetGradeSystemId()
Gets the
Gradebook Id associated with
this session. |
Grade |
transformGrade(Id gradeId)
Gets the grade equivalent between the source and target grade systems.
|
java.math.BigDecimal |
transformScore(java.math.BigDecimal score)
Gets the score equivalent between the source and target grade systems.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getSourceGradeSystemId()
Gradebook
Id
associated with
this session. Gradebook Id
associated with this sessionmandatory
- This method must be implemented. Gradebook getSourceGradeSystem() throws OperationFailedException, PermissionDeniedException
Gradebook
associated with this session. Gradebook
associated with this sessionOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. Id getTargetGradeSystemId()
Gradebook
Id
associated with
this session. Gradebook Id
associated with this sessionmandatory
- This method must be implemented. Gradebook getTargetGradeSystem() throws OperationFailedException, PermissionDeniedException
Gradebook
associated with this session. Gradebook
associated with this sessionOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canTransformGradeSystems()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer lookup operations to
unauthorized users. false
if grade transformation methods are not
authorized, true
otherwisemandatory
- This method must be implemented. java.math.BigDecimal transformScore(java.math.BigDecimal score) throws OperationFailedException, PermissionDeniedException
score
- a score from the source grade systemOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. Grade transformGrade(Id gradeId) throws NotFoundException, OperationFailedException, PermissionDeniedException
gradeId
- Id
of a Grade
from the
source grade systemNotFoundException
- no transformation rule found for
gradeId
NullArgumentException
- gradeId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented.