OSID - osid.grading.transform.GradeSystemTransformationSession Service Interface Definition

Interface	osid.grading.transform.GradeSystemTransformationSession
Implements	`osid.OsidSession`
Used By	`osid.grading.transform.GradingTransformManager`
Used By	`osid.grading.transform.GradingTransformProxyManager`
Description	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.
Method	getSourceGradeSystemId
Description	Gets the `Gradebook` `Id` associated with this session.
Return	`osid.id.Id`		the `Gradebook Id` associated with this session
Compliance	`mandatory`		This method must be implemented.
Method	getSourceGradeSystem
Description	Gets the `Gradebook` associated with this session.
Return	`osid.grading.Gradebook`		the `Gradebook` associated with this session
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	getTargetGradeSystemId
Description	Gets the `Gradebook` `Id` associated with this session.
Return	`osid.id.Id`		the `Gradebook Id` associated with this session
Compliance	`mandatory`		This method must be implemented.
Method	getTargetGradeSystem
Description	Gets the `Gradebook` associated with this session.
Return	`osid.grading.Gradebook`		the `Gradebook` associated with this session
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	canTransformGradeSystems
Description	Tests if this user can perform grade transformations. A return of true does not guarantee successful authorization. A return of false indicates that it is known all 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 lookup operations to unauthorized users.
Return	`boolean`		`false` if grade transformation methods are not authorized, `true` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	transformScore
Description	Gets the score equivalent between the source and target grade systems.
Parameters	`decimal`	`score`	a score from the source grade system
Return	`decimal`		the target score
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method is must be implemented.
Method	transformGrade
Description	Gets the grade equivalent between the source and target grade systems.
Parameters	`osid.id.Id`	`gradeId`	`Id` of a `Grade` from the source grade system
Return	`osid.grading.Grade`		the target grade
Errors	NOT_FOUND		no transformation rule found for `gradeId`
	NULL_ARGUMENT		`gradeId` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method is must be implemented.