OSID Logo
OSID Specifications
offering rules package
Version 3.0.0
Release Candidate Preview
Interfaceosid.offering.rules.CanonicalUnitProcessorEnablerSearchSession
Implementsosid.offering.rules.CanonicalUnitProcessorEnablerQuerySession
Description

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

getCanonicalUnitProcessorEnablersByQuery() is the basic search method and returns a list of CanonicalUnitProcessorEnablers. A more advanced search may be performed with getCanonicalUnitProcessorEnablersBySearch(). It accepts a CanonicalUnitProcessorEnablerSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as offering. getCanonicalUnitProcessorEnablersBySearch() returns a CanonicalUnitProcessorEnablerSearchResults that can be used to access the resulting CanonicalUnitProcessorEnablerList or be used to perform a search within the result set through CanonicalUnitProcessorEnablerSearch.

This session defines views that offer differing behaviors for searching.

  • federated catalogue view: searches include canonical unit processor enablers in catalogues of which this catalogue is an ancestor in the catalogue hierarchy
  • isolated catalogue view: searches are restricted to canonical unit processor enablers in this catalogue

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

MethodgetCanonicalUnitProcessorEnablerSearch
Description

Gets a canonical unit processor enabler search.

Returnosid.offering.rules.CanonicalUnitProcessorEnablerSearchthe canonical unit processor enabler search
CompliancemandatoryThis method must be implemented.
MethodgetCanonicalUnitProcessorEnablerSearchOrder
Description

Gets a canonical unit processor enabler search order. The CanonicalUnitProcessorEnablerSearchOrder is supplied to a CanonicalUnitProcessorEnablerSearch to specify the ordering of results.

Returnosid.offering.rules.CanonicalUnitProcessorEnablerSearchOrderthe canonical unit processor enabler search order
CompliancemandatoryThis method must be implemented.
MethodgetCanonicalUnitProcessorEnablersBySearch
Description

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

Parametersosid.offering.rules.CanonicalUnitProcessorEnablerQuerycanonicalUnitProcessorEnablerQuerythe canonical unit processor enabler query
osid.offering.rules.CanonicalUnitProcessorEnablerSearchcanonicalUnitProcessorEnablerSearchthe canonical unit processor enabler search
Returnosid.offering.rules.CanonicalUnitProcessorEnablerSearchResultsthe returned search results
ErrorsNULL_ARGUMENT canonicalUnitProcessorEnablerQuery or canonicalUnitProcessorEnablerSearch is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
UNSUPPORTED canonicalUnitProcessorEnablerQuery or canonicalUnitProcessorEnablerSearch is not of this service
CompliancemandatoryThis method must be implemented.
MethodgetCanonicalUnitProcessorEnablerQueryFromInspector
Description

Gets a canonical unit processor enabler query from an inspector. The inspector is available from a CanonicalUnitProcessorEnablerSearchResults.

Parametersosid.offering.rules.CanonicalUnitProcessorEnablerQueryInspectorcanonicalUnitProcessorEnablerQueryInspectora canonical unit processor enabler query inspector
Returnosid.offering.rules.CanonicalUnitProcessorEnablerQuerythe canonical unit processor enabler query
ErrorsNULL_ARGUMENT canonicalUnitProcessorEnablerQueryInspector is null
UNSUPPORTED canonicalUnitProcessorEnablerQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.