OSID Logo
OSID Specifications
course plan package
Version 3.0.0
Release Candidate Preview
Interfaceosid.course.plan.LessonAnchoringSession
Implementsosid.OsidSession
Description

This session provides a way of "anchoring" lessons with a plan. Lessons correspond to their corresponding Docents laid out along the related Activities. The LessonAnchor ties a Lesson to a specific Activity or at a specific time offet within the specific Activity.

Automatic generation of Lessons should be constrained around the LessonAnchors.

MethodgetCourseCatalogId
Description

Gets the CourseCatalog Id associated with this session.

Returnosid.id.Idthe CourseCatalog Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetCourseCatalog
Description

Gets the CourseCatalog associated with this session.

Returnosid.course.CourseCatalogthe course catalog
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanAnchorLessons
Description

Tests if this user can anchor lessons. 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 these operations.

Returnboolean false if plan anchoring methods are not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethoduseFederatedCourseCatalogView
Description

Federates the view for methods in this session. A federated view will include plans in course catalogs which are children of this course catalog in the course catalog hierarchy.

CompliancemandatoryThis method is must be implemented.
MethoduseIsolatedCourseCatalogView
Description

Isolates the view for methods in this session. An isolated view restricts retrievals to this course catalog only.

CompliancemandatoryThis method is must be implemented.
MethodgetLessonAnchorsForPlan
Description

Gets all lesson anchors for a plan.

Parametersosid.id.IdplanIda plan Id
Returnosid.course.plan.LessonAnchorLista list of lesson anchors
ErrorsNOT_FOUND planId is not found
NULL_ARGUMENT planId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetLessonAnchorsForLesson
Description

Gets all lesson anchors for a lesson.

Parametersosid.id.IdlessonIda lesson Id
Returnosid.course.plan.LessonAnchorLista list of lesson anchors
ErrorsNOT_FOUND lessonId is not found
NULL_ARGUMENT lessonId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodaddLessonAnchor
Description

Adds a lesson anchor.

Parametersosid.id.IdlessonIda lesson Id
osid.id.IdactivityIdan activity Id
osid.calendaring.Durationoffseta time offset
ErrorsNOT_FOUND lessonId or activityId is not found, or activityId is not related to lessonId
NULL_ARGUMENT lessonId, activityId, or offset is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodclearLessonAnchorsForPlan
Description

Clears all lesson anchors for an entire plan.

Parametersosid.id.IdplanIda plan Id
ErrorsNOT_FOUND planId is not found
NULL_ARGUMENT planId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodclearLessonAnchorsForLesson
Description

Clears all lesson anchors in a lesson.

Parametersosid.id.IdlessonIda lesson Id
ErrorsNOT_FOUND lessonId is not found
NULL_ARGUMENT lessonId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodclearLessonAnchorsForLessonByOffset
Description

Clears all lesson anchors within the given offset range inclusive.

Parametersosid.id.IdlessonIda lesson Id
osid.calendaring.Durationstarta starting time offset
osid.calendaring.Durationendan ending time offset
ErrorsINVALID_ARGUMENT start is greater than end
NOT_FOUND lessonId is not found
NULL_ARGUMENT lessonId, start, or end is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.