OSID Logo
OSID Specifications
learning package
Version 3.0.0
Release Candidate Preview
Interfaceosid.learning.ProficiencyNotificationSession
Implementsosid.OsidSession
Description

This session defines methods to receive notifications on adds/changes to Proficiency objects in this ObjectiveBank. This also includes existing proficiencies that may appear or disappear due to changes in the ObjectiveBank hierarchy, This session is intended for consumers needing to synchronize their state with this service without the use of polling. Notifications are cancelled when this session is closed.

The two views defined in this session correspond to the views in the ProficiencyLookupSession.

MethodgetObjectiveBankId
Description

Gets the ObjectiveBank Id associated with this session.

Returnosid.id.Idthe ObjectiveBank Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetObjectiveBank
Description

Gets the ObjectiveBank associated with this session.

Returnosid.learning.ObjectiveBankthe obective bank
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanRegisterForProficiencyNotifications
Description

Tests if this user can register for Proficiency notifications. 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 notification operations.

Returnboolean false if notification methods are not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethoduseFederatedObjectiveBankView
Description

Federates the view for methods in this session. A federated view will include proficiencies in objective banks which are children of this objective bank in the obective bank hierarchy.

CompliancemandatoryThis method is must be implemented.
MethoduseIsolatedObjectiveBankView
Description

Isolates the view for methods in this session. An isolated view restricts notifications to this objective bank only.

CompliancemandatoryThis method is must be implemented.
MethodreliableProficiencyNotifications
Description

Reliable notifications are desired. In reliable mode, notifications are to be acknowledged using acknowledgeProficiencyNotification() .

CompliancemandatoryThis method is must be implemented.
MethodunreliableProficiencyNotifications
Description

Unreliable notifications are desired. In unreliable mode, notifications do not need to be acknowledged.

CompliancemandatoryThis method is must be implemented.
MethodacknowledgeProficiencyNotification
Description

Acknowledge a proficiency notification.

Parametersosid.id.IdnotificationIdthe Id of the notification
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForNewProficiencies
Description

Register for notifications of new proficiencies. ProficiencyReceiver.newProficiencies() is invoked when a new Proficiency appears in this objective bank.

ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForNewProficienciesByGenusType
Description

Register for notifications of new proficiencies with the given genus type. ProficiencyReceiver.newProficiencies() is invoked when a new Proficiency appears for the given resource in this objective bank.

Parametersosid.type.TypeproficiencyGenusTypethe genus type of a proficiency to monitor
ErrorsNULL_ARGUMENT proficiencyGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForNewProficienciesForObjective
Description

Register for notifications of new proficiencies. ProficiencyReceiver.newProficiencies() is invoked when a new Proficiency appears for the given objective in this objective bank.

Parametersosid.id.IdobjectiveIdthe Id of a resource to monitor
ErrorsNULL_ARGUMENT objectiveId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForNewProficienciesForResource
Description

Register for notifications of new proficiencies. ProficiencyReceiver.newProficiencies() is invoked when a new Proficiency appears for the given resource in this objective bank.

Parametersosid.id.IdresourceIdthe Id of a resource to monitor
ErrorsNULL_ARGUMENT resourceId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedProficiencies
Description

Registers for notification of updated proficiencies. ProficiencyReceiver.changedProficiencies() is invoked when a proficiency in this objective bank is changed.

ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedProficienciesByGenusType
Description

Registers for notification of updated proficiencies of the given genus type. ProficiencyReceiver.changedProficiencies() is invoked when a proficiency in this objective bank is changed.

Parametersosid.type.TypeproficiencyGenusTypethe genus type of the Proficiency to monitor
ErrorsNULL_ARGUMENT proficiencyGenusTYpe is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedProficienciesForObjective
Description

Registers for notification of an updated proficiency. ProficiencyReceiver.changedProficiencies() is invoked when the specified proficiency related to the given objective is changed in this objective bank.

Parametersosid.id.IdobjectiveIdthe Id of the Objective to monitor
ErrorsNULL_ARGUMENT objectiveId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedProficienciesForResource
Description

Registers for notification of an updated proficiency. ProficiencyReceiver.changedProficiencies() is invoked when the specified proficiency related to the given resource is changed in this objective bank.

Parametersosid.id.IdresourceIdthe Id of the Resource to monitor
ErrorsNULL_ARGUMENT resourceId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedProficiency
Description

Registers for notification of an updated proficiency. ProficiencyReceiver.changedProficiencies() is invoked when the specified proficiency in this objective bank is changed.

Parametersosid.id.IdproficiencyIdthe Id of the Proficiency to monitor
ErrorsNULL_ARGUMENT proficiencyId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedProficiencies
Description

Registers for notification of deleted proficiencies. ProficiencyReceiver.deletedProficiencies() is invoked when a proficiency is deleted or removed from this objective bank.

ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedProficienciesByGenusType
Description

Registers for notification of deleted proficiencies of the given genus type. ProficiencyReceiver.deletedProficiencies() is invoked when a proficiency is deleted or removed from this objective bank.

Parametersosid.type.TypeproficiencyGenusTypethe genus type of the Proficiency to monitor
ErrorsNULL_ARGUMENT proficiencyGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedProficienciesForObjective
Description

Registers for notification of a deleted proficiency. ProficiencyReceiver.deletedProficiencies() is invoked when the specified proficiency related to the objective is deleted or removed from this objective bank.

Parametersosid.id.IdobjectiveIdthe Id of the Objective to monitor
ErrorsNULL_ARGUMENT objectiveId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedProficienciesForResource
Description

Registers for notification of a deleted proficiency. ProficiencyReceiver.deletedProficiencies() is invoked when the specified proficiency related to the resource is deleted or removed from this objective bank.

Parametersosid.id.IdresourceIdthe Id of the Resource to monitor
ErrorsNULL_ARGUMENT resourceId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedProficiency
Description

Registers for notification of a deleted proficiency. ProficiencyReceiver.deletedProficiencies() is invoked when the specified proficiency is deleted or removed from this objective bank.

Parametersosid.id.IdproficiencyIdthe Id of the Proficiency to monitor
ErrorsNULL_ARGUMENT proficiencyId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.