OSID Logo
OSID Specifications
course program package
Version 3.0.0
Release Candidate Preview
Interfaceosid.course.program.ProgramSearchSession
Implementsosid.course.program.ProgramQuerySession
Description

This session provides methods for searching among Programs. The search query is constructed using the ProgramQuery.

getProgramsByQuery() is the basic search method and returns a list of Programs. A more advanced search may be performed with getProgramsBySearch(). It accepts a ProgramSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. getProgramsBySearch() returns a ProgramSearchResults that can be used to access the resulting ProgramList or be used to perform a search within the result set through ProgramSearch.

This session defines views that offer differing behaviors for searching.

  • federated course catalog view: searches include programs in course catalogs of which this course catalog is an ancestor in the course catalog hierarchy
  • isolated course catalog view: searches are restricted to courses in this course catalog

Programs may have a query record indicated by their respective record types. The query record is accessed via the ProgramQuery.

MethodgetProgramSearch
Description

Gets a program search.

Returnosid.course.program.ProgramSearchthe program search
CompliancemandatoryThis method must be implemented.
MethodgetProgramSearchOrder
Description

Gets a program search order. The ProgramSearchOrder is supplied to a ProgramSearch to specify the ordering of results.

Returnosid.course.program.ProgramSearchOrderthe program search order
CompliancemandatoryThis method must be implemented.
MethodgetProgramsBySearch
Description

Gets the search results matching the given search query using the given search.

Parametersosid.course.program.ProgramQueryprogramQuerythe program query
osid.course.program.ProgramSearchprogramSearchthe program search
Returnosid.course.program.ProgramSearchResultsthe program search results
ErrorsNULL_ARGUMENT programQuery or programSearch is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
UNSUPPORTED programQuery or programSearch is not of this service
CompliancemandatoryThis method must be implemented.
MethodgetProgramQueryFromInspector
Description

Gets a program query from an inspector. The inspector is available from a ProgramSearchResults.

Parametersosid.course.program.ProgramQueryInspectorprogramQueryInspectora program query inspector
Returnosid.course.program.ProgramQuerythe program query
ErrorsNULL_ARGUMENT programQueryInspector is null
UNSUPPORTED programQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.