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

This session provides methods for retrieving GradebookColumnCalculationss .

This session defines views that offer differing behaviors when retrieving multiple objects.

  • comparative view: elements may be silently omitted or re-ordered
  • plenary view: provides a complete set or is an error condition
  • isolated gradebook view: All gradebook column calculation methods in this session operate, retrieve and pertain to gradebook column calculations defined explicitly in the current gradebook.
  • federated gradebook view: All gradebook column calculation methods in this session operate, retrieve and pertain to all gradebook column calculations defined in this gradebook and any other gradebooks implicitly available in this gradebook through gradebook inheritence.
  • active gradebook calculation view: All gradebook column calculation lookup methods return active gradebook column calculations.
  • any status gradebook column calculation view: Gradebook column calculations of any active or inactive status are returned from methods.

Gradebook column calculations may have an additional records indicated by their respective record types. The record may not be accessed through a cast of the GradebookColumnCalculation.

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.
MethodcanLookupGradebookColumnCalculations
Description

Tests if this user can perform GradebookColumnCalculation lookups. 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.

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

The returns from the lookup methods may omit or translate elements based on this session, such as authorization, and not result in an error. This view is used when greater interoperability is desired at the expense of precision.

CompliancemandatoryThis method is must be implemented.
MethodusePlenaryGradebookColumnCalculationView
Description

A complete view of the GradebookColumnCalculation returns is desired. Methods will return what is requested or result in an error. This view is used when greater precision is desired at the expense of interoperability.

CompliancemandatoryThis method is must be implemented.
MethoduseFederatedGradebookView
Description

Federates the view for methods in this session. A federated view will include gradebook column calculations in gradebooks which are children of this gradebook in the gradebook hierarchy.

CompliancemandatoryThis method is must be implemented.
MethoduseIsolatedGradebookView
Description

Isolates the view for methods in this session. An isolated view restricts lookups to this gradebook only.

CompliancemandatoryThis method is must be implemented.
MethoduseActiveGradebookColumnCalculationView
Description

Only active gradebook column calculations are returned by methods in this session.

CompliancemandatoryThis method is must be implemented.
MethoduseAnyStatusGradebookColumnCalculationView
Description

All active and inactive gradebook column calculations are returned by methods in this session.

CompliancemandatoryThis method is must be implemented.
MethodgetGradebookColumnCalculation
Description

Gets the GradebookColumnCalculation specified by its Id. In plenary mode, the exact Id is found or a NOT_FOUND results. Otherwise, the returned GradebookColumnCalculation may have a different Id than requested, such as the case where a duplicate Id was assigned to a GradebookColumnCalculation and retained for compatibility.

Parametersosid.id.IdgradebookColumnCalculationId Id of the GradebookColumnCalculation
Returnosid.grading.calculation.GradebookColumnCalculationthe gradebook column calculation
ErrorsNOT_FOUND gradebookColumnCalculationId not found
NULL_ARGUMENT gradebookColumnCalculationId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method is must be implemented.
MethodgetGradebookColumnCalculationsByIds
Description

Gets a GradebookColumnCalculationList corresponding to the given IdList. In plenary mode, the returned list contains all of the gradebook column calculations specified in the Id list, in the order of the list, including duplicates, or an error results if a Id in the supplied list is not found or inaccessible. Otherwise, inaccessible gradeboook column calculations may be omitted from the list.

Parametersosid.id.IdListgradebookColumnCalculationIdsthe list of Ids to retrieve
Returnosid.grading.calculation.GradebookColumnCalculationListthe returned GradebookColumnCalculation list
ErrorsNOT_FOUNDan Id was not found
NULL_ARGUMENT gradeBookColumnCalculationIds is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetGradebookColumnCalculationsByGenusType
Description

Gets a GradebookColumnCalculationList corresponding to the given gradebook column calculation genus Type which does not include gradebook column calculations of genus types derived from the specified Type. In plenary mode, the returned list contains all known gradebook column calculations or an error results. Otherwise, the returned list may contain only those gradebook column calculations that are accessible through this session.

Parametersosid.type.TypegradebookColumnCalculationGenusTypea gradebook column calculation genus type
Returnosid.grading.calculation.GradebookColumnCalculationListthe returned GradebookColumnCalculation list
ErrorsNULL_ARGUMENT gradebookColumnCalculationGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetGradebookColumnCalculationsByParentGenusType
Description

Gets a GradebookColumnCalculationList corresponding to the given gradebook column calculation genus Type and include any additional column calculations with genus types derived from the specified Type. In plenary mode, the returned list contains all known gradebook column calculations or an error results. Otherwise, the returned list may contain only those gradebook column calculations that are accessible through this session.

Parametersosid.type.TypegradebookColumnCalculationGenusTypea gradebook column calculation genus type
Returnosid.grading.calculation.GradebookColumnCalculationListthe returned GradebookColumnCalculation list
ErrorsNULL_ARGUMENT gradebookColumnCalculationGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetGradebookColumnCalculationsByRecordType
Description

Gets a GradebookColumnCalculationList containing the given gradebook column calculation record Type. In plenary mode, the returned list contains all known gradebook column calculations or an error results. Otherwise, the returned list may contain only those gradebook column calculations that are accessible through this session.

Parametersosid.type.TypegradebookColumnCalculationRecordTypea gradebook column calculation record type
Returnosid.grading.calculation.GradebookColumnCalculationListthe returned GradebookColumnCalculation list
ErrorsNULL_ARGUMENT gradebookColumnCalculationRecordType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetGradebookColumnCalculationForGradebookColumn
Description

Gets the GradebookColumnCalculation mapped to a GradebookColumn to which this calculation is applied. In plenary mode, the exact Id is found or a NOT_FOUND results. Otherwise, the returned GradebookColumnCalculation may have a different Id than requested, such as the case where a duplicate Id was assigned to a GradebookColumnCalculation and retained for compatibility.

Parametersosid.id.IdgradebookColumnId Id of a GradebookColumn
Returnosid.grading.calculation.GradebookColumnCalculationthe gradebook column calculation
ErrorsNOT_FOUND gradebookColumnId not found
NULL_ARGUMENT gradebookColumnId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method is must be implemented.
MethodgetGradebookColumnCalculationsForGradebookColumns
Description

Gets a GradebookColumnCalculationList corresponding to the given gradebook column Ids to which this calculation is applied. In plenary mode, the returned list contains all of the gradebook column calculations specified in the Id list, in the order of the list, including duplicates, or an error results if a Id in the supplied list is not found or inaccessible. Otherwise, inaccessible gradeboook column calculations may be omitted from the list.

Parametersosid.id.IdListgradebookColumnIdsa list of gradebook column Ids
Returnosid.grading.calculation.GradebookColumnCalculationListthe returned GradebookColumnCalculation list
ErrorsNOT_FOUNDan Id was not found
NULL_ARGUMENT gradeBookColumnIds is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetGradebookColumnCalculations
Description

Gets all gradebook column calculations. In plenary mode, the returned list contains all known gradebook column calculations or an error results. Otherwise, the returned list may contain only those gradebook column calculations that are accessible through this session.

Returnosid.grading.calculation.GradebookColumnCalculationLista GradebookColumnCalculationList
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.