OSID Logo
OSID Specifications
recognition package
Version 3.0.0
Release Candidate Preview
Interfaceosid.recognition.ConvocationSmartAcademySession
Implementsosid.OsidSession
Description

This session manages queries and sequencing to create "smart" dynamic catalogs. A ConvocationQuery can be retrieved from this session and mapped to this Academy to create a virtual collection of Convocations. The awards may be sequenced using the ConvocationSearchOrder from this session.

This Academy has a default query that matches any convocation and a default search order that specifies no sequencing. The queries may be examined using a ConvocationQueryInspector. The query may be modified by converting the inspector back to a ConvocationQuery.

MethodgetAcademyId
Description

Gets the Academy Id associated with this session.

Returnosid.id.Idthe Academy Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetAcademy
Description

Gets the Academy associated with this session.

Returnosid.recognition.Academythe Academy associated with this session
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanManageSmartAcademies
Description

Tests if this user can manage smart academies. A return of true does not guarantee successful authorization. A return of false indicates that it is known 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 operations to unauthorized users.

Returnboolean false if smart academy management is not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodgetConvocationQuery
Description

Gets a convocation query.

Returnosid.recognition.ConvocationQuerythe convocation query
CompliancemandatoryThis method must be implemented.
MethodgetConvocationSearchOrder
Description

Gets a convocation search order.

Returnosid.recognition.ConvocationSearchOrderthe convocation search order
CompliancemandatoryThis method must be implemented.
MethodapplyConvocationQuery
Description

Applies a convocation query to this academy.

Parametersosid.recognition.ConvocationQueryconvocationQuerythe convocation query
ErrorsNULL_ARGUMENT convocationQuery is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
UNSUPPORTED convocationQuery not of this service
CompliancemandatoryThis method must be implemented.
MethodinspectConvocationQuery
Description

Gets a convocation query inspector for this academy.

Returnosid.recognition.ConvocationQueryInspectorthe convocation query inspector
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
CompliancemandatoryThis method must be implemented.
MethodapplyConvocationSequencing
Description

Applies a convocation search order to this academy.

Parametersosid.recognition.ConvocationSearchOrderconvocationSearchOrderthe convocation search order
ErrorsNULL_ARGUMENT convocationSearchOrder is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
UNSUPPORTED convocationSearchOrder not of this service
CompliancemandatoryThis method must be implemented.
MethodgetConvocationQueryFromInspector
Description

Gets a convocation query from an inspector.

Parametersosid.recognition.ConvocationQueryInspectorconvocationQueryInspectora query inspector
Returnosid.recognition.ConvocationQuerythe convocation query
ErrorsNULL_ARGUMENT convocationQueryInspector is null
UNSUPPORTED convocationQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.