OSID Logo
OSID Specifications
grading package
Version 3.0.0
Release Candidate Preview
Interfaceosid.grading.GradebookColumnSmartGradebookSession
Implementsosid.OsidSession
Description

This session manages queries and sequencing to create "smart" dynamic catalogs. A GradebookColumnQuery can be retrieved from this session and mapped to this Gradebook to create a virtual collection of GradebookColumns. The entries may be sequenced using the GradebookColumnSearchOrder from this session.

This Gradebook has a default query that matches any gradebook column and a default search order that specifies no sequencing. The queries may be examined using a GradebookColumnQueryInspector. The query may be modified by converting the inspector back to a GradebookColumnQuery.

MethodgetGradebookId
Description

Gets the Gradebook Id associated with this session.

Returnosid.id.Idthe Gradebook Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetGradebook
Description

Gets the Gradebook associated with this session.

Returnosid.grading.Gradebookthe Gradebook associated with this session
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanManageSmartGradebooks
Description

Tests if this user can manage smart gradebooks. 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 smart operations.

Returnboolean false if smart gradebook methods are not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodgetGradebookColumnQuery
Description

Gets a gradebook column query.

Returnosid.grading.GradebookColumnQuerythe gradebook column query
CompliancemandatoryThis method must be implemented.
MethodgetGradebookColumnSearchOrder
Description

Gets a gradebook column search order.

Returnosid.grading.GradebookColumnSearchOrderthe gradebook column search order
CompliancemandatoryThis method must be implemented.
MethodapplyGradebookColumnQuery
Description

Applies a gradebook column query to this gradebook.

Parametersosid.grading.GradebookColumnQuerygradebookColumnQuerythe gradebook column query
ErrorsNULL_ARGUMENT gradebookColumnQuery is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
UNSUPPORTED gradebookColumnQuery not of this service
CompliancemandatoryThis method must be implemented.
MethodinspectGradebookColumnQuery
Description

Gets a gradebook column query inspector for this gradebook.

Returnosid.grading.GradebookColumnQueryInspectorthe gradebook column query inspector
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
CompliancemandatoryThis method must be implemented.
MethodapplyGradebookColumnSequencing
Description

Applies a gradebook column search order to this gradebook.

Parametersosid.grading.GradebookColumnSearchOrdergradebookColumnSearchOrderthe gradebook column search order
ErrorsNULL_ARGUMENT gradebookColumnSearchOrder is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
UNSUPPORTED gradebookColumnSearchOrder not of this service
CompliancemandatoryThis method must be implemented.
MethodgetGradebookColumnQueryFromInspector
Description

Gets a gradebook column query from an inspector.

Parametersosid.grading.GradebookColumnQuerygradebookColumnQueryInspectora gradebook column query inspector
Returnosid.grading.GradebookColumnQuerythe gradebook column query
ErrorsNULL_ARGUMENT gradebookColumnQueryInspector is null
UNSUPPORTED gradebookColumnQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.