OSID Logo
OSID Specifications
calendaring package
Version 3.0.0
Release Candidate Preview
Interfaceosid.calendaring.CommitmentSearchSession
Implementsosid.calendaring.CommitmentQuerySession
Description

This session provides methods for searching Commitment objects. The search query is constructed using the CommitmentQuery. The commitment record Type also specifies the record for the commitment query.

getCommitmentsByQuery() is the basic search method and returns a list of Commitments. A more advanced search may be performed with getCommitmentsBySearch(). It accepts a CommitmentSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. getCommitmentsBySearch() returns an CommitmentSearchResults that can be used to access the resulting CommitmentList or be used to perform a search within the result set through CommitmentSearch.

This session defines views that offer differing behaviors for searching.

  • federated calendar view: searches include commitments in calendars of which this calendar is a ancestor in the calendar hierarchy
  • isolated calendar view: searches are restricted to commitments in this calendar only

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

MethodgetCommitmentSearch
Description

Gets a commitment search.

Returnosid.calendaring.CommitmentSearchthe commitment search
CompliancemandatoryThis method must be implemented.
MethodgetCommitmentSearchOrder
Description

Gets a commitment search order. The CommitmentSearchOrder is supplied to a CommitmentSearch to specify the ordering of results.

Returnosid.calendaring.CommitmentSearchOrderthe commitment search order
CompliancemandatoryThis method must be implemented.
MethodgetCommitmentsBySearch
Description

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

Parametersosid.calendaring.CommitmentQuerycommitmentQuerythe commitment search query
osid.calendaring.CommitmentSearchcommitmentSearchthe commitment search
Returnosid.calendaring.CommitmentSearchResultsthe commitment search results
ErrorsNULL_ARGUMENT commitmentQuery or commitmentSearch is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
UNSUPPORTED commitmentSearch or commitmentQuery is not of this service
CompliancemandatoryThis method must be implemented.
MethodgetCommitmentQueryFromInspector
Description

Gets a commitment query from an inspector. The inspector is available from an CommitmentSearchResults.

Parametersosid.calendaring.CommitmentQueryInspectorcommitmentQueryInspectora commitment query inspector
Returnosid.calendaring.CommitmentQuerythe commitment query
ErrorsNULL_ARGUMENT commitmentQueryInspector is null
UNSUPPORTED commitmentQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.