OSID Logo
OSID Specifications
calendaring rules package
Version 3.0.0
Release Candidate Preview
Interfaceosid.calendaring.rules.RecurringEventEnablerSearchSession
Implementsosid.calendaring.rules.RecurringEventEnablerQuerySession
Description

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

getRecurringEventEnablersByQuery() is the basic search method and returns a list of RecurringEventEnablers. A more advanced search may be performed with getRecurringEventEnablerBySearch(). It accepts a RecurringEventEnabler in addition to the query for the purpose of specifying additional options affecting the entire search, such as calendaring. geRecurringEventEnablersBySearch() returns a RecurringEventEnablerSearchResults that can be used to access the resulting RecurringEventEnablerList or be used to perform a search within the result set through RecurringEventEnablerSearch.

This session defines views that offer differing behaviors for searching.

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

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

MethodgetRecurringEventEnablerSearch
Description

Gets a recurring event enabler search.

Returnosid.calendaring.rules.RecurringEventEnablerSearchthe recurring event enabler search
CompliancemandatoryThis method must be implemented.
MethodgetRecurringEventEnablerSearchOrder
Description

Gets a recurring event enabler search order. The RecurringEventEnablerSearchOrder is supplied to a RecurringEventEnablerSearch to specify the ordering of results.

Returnosid.calendaring.rules.RecurringEventEnablerSearchOrderthe recurring event enabler search order
CompliancemandatoryThis method must be implemented.
MethodgetRecurringEventEnablersBySearch
Description

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

Parametersosid.calendaring.rules.RecurringEventEnablerQueryrecurringEventEnablerQuerythe recurring event enabler query
osid.calendaring.rules.RecurringEventEnablerSearchrecurringEventEnablerSearchthe recurring event enabler search
Returnosid.calendaring.rules.RecurringEventEnablerSearchResultsthe returned search results
ErrorsNULL_ARGUMENT recurringEventEnablerQuery or recurringEventEnablerSearch is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
UNSUPPORTED recurringEventEnablerQuery or recurringEventEnablerSearch is not of this service
CompliancemandatoryThis method must be implemented.
MethodgetRecurringEventEnablerQueryFromInspector
Description

Gets a recurring event enabler query from an inspector. The inspector is available from a RecurringEventEnablerSearchResults.

Parametersosid.calendaring.rules.RecurringEventEnablerQueryInspectorrecurringEventEnablerQueryInspectora recurring event enabler query inspector
Returnosid.calendaring.rules.RecurringEventEnablerQuerythe recurring event enabler query
ErrorsNULL_ARGUMENT recurringEventEnablerQueryInspector is null
UNSUPPORTED recurringEventEnablerQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.