OSID Logo
OSID Specifications
ordering rules package
Version 3.0.0
Release Candidate Preview
Interfaceosid.ordering.rules.PriceEnablerSearchSession
Implementsosid.ordering.rules.PriceEnablerQuerySession
Description

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

getPriceEnablersByQuery() is the basic search method and returns a list of PriceEnablers. A more advanced search may be performed with getPriceEnablersBySearch(). It accepts a PriceEnablerSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. getPriceEnablersBySearch() returns a PriceEnablerSearchResults that can be used to access the resulting PriceEnablerList or be used to perform a search within the result set through PriceEnablerSearch.

This session defines views that offer differing behaviors for searching.

  • federated store view: searches include price enablers in stores of which this store is an ancestor in the store hierarchy
  • isolated store view: searches are restricted to price enablers in this store

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

MethodgetPriceEnablerSearch
Description

Gets a price enabler search.

Returnosid.ordering.rules.PriceEnablerSearchthe price enabler search
CompliancemandatoryThis method must be implemented.
MethodgetPriceEnablerSearchOrder
Description

Gets a price enabler search order. The PriceEnablerSearchOrder is supplied to a PriceEnablerSearch to specify the ordering of results.

Returnosid.ordering.rules.PriceEnablerSearchOrderthe price enabler search order
CompliancemandatoryThis method must be implemented.
MethodgetPriceEnablersBySearch
Description

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

Parametersosid.ordering.rules.PriceEnablerQuerypriceEnablerQuerythe price enabler query
osid.ordering.rules.PriceEnablerSearchpriceEnablerSearchthe price enabler search
Returnosid.ordering.rules.PriceEnablerSearchResultsthe price enabler search results
ErrorsNULL_ARGUMENT priceEnablerQuery or priceEnablerSearch is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
UNSUPPORTED priceEnablerQuery or priceEnablerSearch is not of this service
CompliancemandatoryThis method must be implemented.
MethodgetPriceEnablerQueryFromInspector
Description

Gets a price enabler query from an inspector. The inspector is available from a PriceEnablerSearchResults.

Parametersosid.ordering.rules.PriceEnablerQueryInspectorpriceEnablerQueryInspectora price enabler query inspector
Returnosid.ordering.rules.PriceEnablerQuerythe price enabler query
ErrorsNULL_ARGUMENT priceEnablerQueryInspector is null
UNSUPPORTED priceEnablerQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.