OSID Logo
OSID Specifications
calendaring rules package
Version 3.0.0
Release Candidate Preview
Interfaceosid.calendaring.rules.OffsetEventEnablerSearchSession
Implementsosid.calendaring.rules.OffsetEventEnablerQuerySession
Description

This session provides methods for searching among OffsetEventEnabler objects. The search query is constructed using the OffsetEventEnablerQuery.

getOffsetEventEnablersByQuery() is the basic search method and returns a list of OffsetEventEnablers. A more advanced search may be performed with getOffsetEventEnablersBySearch(). It accepts an OffsetEventEnablerSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as calendaring. getOffsetEventEnablersBySearch() returns an OffsetEventEnablerSearchResults that can be used to access the resulting OffsetEventEnablerList or be used to perform a search within the result set through OffsetEventEnablerSearch.

This session defines views that offer differing behaviors for searching.

  • federated calendar view: searches include offset event enablers in calendars of which this calendar is an ancestor in the calendar hierarchy
  • isolated calendar view: searches are restricted to offset event enablers in this calendar

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

MethodgetOffsetEventEnablerSearch
Description

Gets an offset event enabler search.

Returnosid.calendaring.rules.OffsetEventEnablerSearchthe offset event enabler search
CompliancemandatoryThis method must be implemented.
MethodgetOffsetEventEnablerSearchOrder
Description

Gets an offset event enabler search order. The OffsetEventEnablerSearchOrder is supplied to an OffsetEventEnablerSearch to specify the ordering of results.

Returnosid.calendaring.rules.OffsetEventEnablerSearchOrderthe offset event enabler search order
CompliancemandatoryThis method must be implemented.
MethodgetOffsetEventEnablersBySearch
Description

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

Parametersosid.calendaring.rules.OffsetEventEnablerQueryoffsetEventEnablerQuerythe offset event enabler query
osid.calendaring.rules.OffsetEventEnablerSearchoffsetEventEnablerSearchthe offset event enabler search
Returnosid.calendaring.rules.OffsetEventEnablerSearchResultsthe returned search results
ErrorsNULL_ARGUMENT offsetEventEnablerQuery or offsetEventEnablerSearch is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
UNSUPPORTED offsetEventEnablerQuery or offsetEventEnablerSearch is not of this service
CompliancemandatoryThis method must be implemented.
MethodgetOffsetEventEnablerQueryFromInspector
Description

Gets an offset event enabler query from an inspector. The inspector is available from an OffsetEventEnablerSearchResults.

Parametersosid.calendaring.rules.OffsetEventEnablerQueryInspectoroffsetEventEnablerQueryInspectoran offset event enabler query inspector
Returnosid.calendaring.rules.OffsetEventEnablerQuerythe offset event enabler query
ErrorsNULL_ARGUMENT offsetEventEnablerQueryInspector is null
UNSUPPORTED offsetEventEnablerQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.