OSID Logo
OSID Specifications
offering rules package
Version 3.1.0
Interfaceosid.offering.rules.CanonicalUnitProcessorEnablerSearchSession
Implementsosid.offering.rules.CanonicalUnitProcessorEnablerQuerySession
Used Byosid.offering.rules.OfferingRulesManager
osid.offering.rules.OfferingRulesProxyManager
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.CanonicalUnitProcessorEnablerSearch the canonical unit processor enabler search
Compliancemandatory This 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.CanonicalUnitProcessorEnablerSearchOrder the canonical unit processor enabler search order
Compliancemandatory This method must be implemented.
MethodgetCanonicalUnitProcessorEnablersBySearch
Description

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

Parametersosid.offering.rules.CanonicalUnitProcessorEnablerQuerycanonicalUnitProcessorEnablerQuery the canonical unit processor enabler query
osid.offering.rules.CanonicalUnitProcessorEnablerSearchcanonicalUnitProcessorEnablerSearch the canonical unit processor enabler search
Returnosid.offering.rules.CanonicalUnitProcessorEnablerSearchResults the returned search results
ErrorsNULL_ARGUMENT canonicalUnitProcessorEnablerQuery or canonicalUnitProcessorEnablerSearch is null
OPERATION_FAILED unable to complete request
PERMISSION_DENIED authorization failure
UNSUPPORTED canonicalUnitProcessorEnablerQuery or canonicalUnitProcessorEnablerSearch is not of this service
Compliancemandatory This 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.CanonicalUnitProcessorEnablerQueryInspectorcanonicalUnitProcessorEnablerQueryInspector a canonical unit processor enabler query inspector
Returnosid.offering.rules.CanonicalUnitProcessorEnablerQuery the canonical unit processor enabler query
ErrorsNULL_ARGUMENT canonicalUnitProcessorEnablerQueryInspector is null
UNSUPPORTED canonicalUnitProcessorEnablerQueryInspector is not of this service
Compliancemandatory This method must be implemented.