OSID Logo
OSID Specifications
assessment package
Version 3.0.0
Release Candidate Preview
Interfaceosid.assessment.AssessmentTakenBankAssignmentSession
Implementsosid.OsidSession
Description

This session provides methods to re-assign AssessmentTaken objects to Banks. An AssessmentTaken may map to multiple Banks and removing the last reference to an AssessmentTaken is the equivalent of deleting it. Each Bank may have its own authorizations governing who is allowed to operate on it.

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

MethodcanAssignAssessmentsTaken
Description

Tests if this user can alter assessment taken/bank 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 lookup operations to unauthorized users.

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

Tests if this user can alter assessment taken/bank 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 lookup operations to unauthorized users.

Parametersosid.id.IdbankIdthe Id of the Bank
Returnboolean false if mapping is not authorized, true otherwise
ErrorsNULL_ARGUMENT bankId is null
CompliancemandatoryThis method must be implemented.
MethodgetAssignableBankIds
Description

Gets a list of banks including and under the given banks node in which any assessment taken can be assigned.

Parametersosid.id.IdbankIdthe Id of the Bank
Returnosid.id.IdListlist of assignable bank Ids
ErrorsNULL_ARGUMENT bankId is null
OPERATION_FAILEDunable to complete request
CompliancemandatoryThis method must be implemented.
MethodgetAssignableBankIdsForAssessmentTaken
Description

Gets a list of bank including and under the given bank node in which a specific assessment taken can be assigned.

Parametersosid.id.IdbankIdthe Id of the Bank
osid.id.IdassessmentTakenIdthe Id of the AssessmentTaken
Returnosid.id.IdListlist of assignable bank Ids
ErrorsNULL_ARGUMENT bankId or assessmentTakenId is null
OPERATION_FAILEDunable to complete request
CompliancemandatoryThis method must be implemented.
MethodassignAssessmentTakenToBank
Description

Adds an existing AssessmentTaken to a Bank.

Parametersosid.id.IdassessmentTakenIdthe Id of the AssessmentTaken
osid.id.IdbankIdthe Id of the Bank
ErrorsALREADY_EXISTS assessmentTakenId is already assigned to bankId
NOT_FOUND assessmentTakenId or bankId not found
NULL_ARGUMENT assessmentTakenId or bankId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
CompliancemandatoryThis method must be implemented.
MethodunassignAssessmentTakenFromBank
Description

Removes an AssessmentTaken from a Bank.

Parametersosid.id.IdassessmentTakenIdthe Id of the AssessmentTaken
osid.id.IdbankIdthe Id of the Bank
ErrorsNOT_FOUND assessmentTakenId or bankId not found or assessmentTakenId not assigned to bankId
NULL_ARGUMENT assessmentTakenId or bankId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
CompliancemandatoryThis method must be implemented.
MethodreassignAssessmentTakenToBilling
Description

Moves an AssessmentTaken from one Bank to another. Mappings to other Banks are unaffected.

Parametersosid.id.IdassessmentTakenIdthe Id of the AssessmentTaken
osid.id.IdfromBankIdthe Id of the current Bank
osid.id.IdtoBankIdthe Id of the destination Bank
ErrorsNOT_FOUND assessmentTakenId, fromBankId, or toBankId not found or assessmentTakenId not mapped to fromBankId
NULL_ARGUMENT assessmentTakenId, fromBankId, or toBankId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.