Interface | osid.course.CourseOfferingLookupSession | ||
---|---|---|---|
Implements | osid.OsidSession | ||
Description |
This session defines methods for retrieving course
offerings. A This lookup session defines several views:
The methods Courses may have an additional records indicated by their
respective record types. The record may not be accessed
through a cast of the | ||
Method | getCourseCatalogId | ||
Description |
Gets the | ||
Return | osid.id.Id | the CourseCatalog Id associated with this session | |
Compliance | mandatory | This method must be implemented. | |
Method | getCourseCatalog | ||
Description |
Gets the | ||
Return | osid.course.CourseCatalog | the course catalog | |
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | canLookupCourseOfferings | ||
Description |
Tests if this user can perform | ||
Return | boolean | false if lookup methods are not authorized, true
otherwise | |
Compliance | mandatory | This method must be implemented. | |
Method | useComparativeCourseOfferingView | ||
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. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | usePlenaryCourseOfferingView | ||
Description |
A complete view of the | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useFederatedCourseCatalogView | ||
Description |
Federates the view for methods in this session. A federated view will include course offerings in catalogs which are children of this catalog in the course catalog hierarchy. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useIsolatedCourseCatalogView | ||
Description |
Isolates the view for methods in this session. An isolated view restricts retrievals to this course catalog only. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useEffectiveCourseOfferingView | ||
Description |
All course offering methods return course offerings where the current date falls within the effective dates inclusive. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useAnyEffectiveCourseOfferingView | ||
Description |
All methods return course offerings of any effective or expired status. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getCourseOffering | ||
Description |
Gets the In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.id.Id | courseOfferingId | the Id of the CourseOffering to retrieve |
Return | osid.course.CourseOffering | the returned CourseOffering | |
Errors | NOT_FOUND | no CourseOffering found with the given Id | |
NULL_ARGUMENT | courseOfferingId is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsByIds | ||
Description |
Gets a In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.id.IdList | courseOfferingIds | the list of Ids to retrieve |
Return | osid.course.CourseOfferingList | the returned CourseOffering list | |
Errors | NOT_FOUND | an Id was not found | |
NULL_ARGUMENT | courseOfferingIds is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsByGenusType | ||
Description |
Gets a In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.type.Type | courseOfferingGenusType | a course offering genus type |
Return | osid.course.CourseOfferingList | the returned CourseOffering list | |
Errors | NULL_ARGUMENT | courseOfferingGenusType is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsByParentGenusType | ||
Description |
Gets a In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.type.Type | courseOfferingGenusType | a course offering genus type |
Return | osid.course.CourseOfferingList | the returned CourseOffering list | |
Errors | NULL_ARGUMENT | courseOfferingGenusType is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsByRecordType | ||
Description |
Gets a In plenary mode, the returned list contains all known courses or an error results. Otherwise, the returned list may contain only those course offerings that are accessible through this session. In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.type.Type | courseOfferingRecordType | a course offering record type |
Return | osid.course.CourseOfferingList | the returned CourseOffering list | |
Errors | NULL_ARGUMENT | courseOfferingRecordType is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsOnDate | ||
Description |
Gets all In plenary mode, the returned list contains all known course offerings or an error results. Otherwise, the returned list may contain only those course offerings that are accessible through this session. In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.calendaring.DateTime | from | start of date range |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.course.CourseOfferingList | a list of CourseOfferings | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | from or to is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsForCourse | ||
Description |
Gets all In plenary mode, the returned list contains all known course offerings or an error results. Otherwise, the returned list may contain only those course offerings that are accessible through this session. In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.id.Id | courseId | a course Id |
Return | osid.course.CourseOfferingList | a list of CourseOfferings | |
Errors | NULL_ARGUMENT | courseId is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsForCourseOnDate | ||
Description |
Gets all In plenary mode, the returned list contains all known course offerings or an error results. Otherwise, the returned list may contain only those course offerings that are accessible through this session. In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.id.Id | courseId | a course Id |
osid.calendaring.DateTime | from | start of date range | |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.course.CourseOfferingList | a list of CourseOfferings | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | courseId, from, or to is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsForTerm | ||
Description |
Gets all In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.id.Id | termId | a term Id |
Return | osid.course.CourseOfferingList | a list of CourseOfferings | |
Errors | NULL_ARGUMENT | termId is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsForTermOnDate | ||
Description |
Gets all In plenary mode, the returned list contains all known course offerings or an error results. Otherwise, the returned list may contain only those course offerings that are accessible through this session. In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.id.Id | termId | a term Id |
osid.calendaring.DateTime | from | start of date range | |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.course.CourseOfferingList | a list of CourseOfferings | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | termId, from, or to is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsForCourseAndTerm | ||
Description |
Gets all In plenary mode, the returned list contains all known course offerings or an error results. Otherwise, the returned list may contain only those course offerings that are accessible through this session. In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.id.Id | courseId | a course Id |
osid.id.Id | termId | a term Id | |
Return | osid.course.CourseOfferingList | a list of CourseOfferings | |
Errors | NULL_ARGUMENT | courseId or termId is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsForCourseAndTermOnDate | ||
Description |
Gets all In plenary mode, the returned list contains all known course offerings or an error results. Otherwise, the returned list may contain only those course offerings that are accessible through this session. In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.id.Id | courseId | a course Id |
osid.id.Id | termId | a term Id | |
osid.calendaring.DateTime | from | start of date range | |
osid.calendaring.DateTime | to | end of date range | |
Return | osid.course.CourseOfferingList | a list of CourseOfferings | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | courseId, termId, from, or to is null
| ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferingsByNumberForTerm | ||
Description |
Gets all In plenary mode, the returned list contains all known course offerings or an error results. Otherwise, the returned list may contain only those course offerings that are accessible through this session. In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Parameters | osid.id.Id | termId | a term Id |
string | number | a course offering number | |
Return | osid.course.CourseOfferingList | a list of CourseOfferings | |
Errors | NULL_ARGUMENT | termId or number is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCourseOfferings | ||
Description |
Gets all In plenary mode, the returned list contains all known course offerings or an error results. Otherwise, the returned list may contain only those courses that are accessible through this session. In effective mode, course offerings are returned where the current date falls within the effective dates inclusive. In any effective mode, effective and expired course offerings are returned. | ||
Return | osid.course.CourseOfferingList | a list of CourseOfferings | |
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. |