OSID Logo
OSID Specifications
subscription rules package
Version 3.1.0
Interfaceosid.subscription.rules.DispatchConstrainerEnablerSearchSession
Implementsosid.subscription.rules.DispatchConstrainerEnablerQuerySession
Used Byosid.subscription.rules.SubscriptionRulesManager
osid.subscription.rules.SubscriptionRulesProxyManager
Description

This session provides methods for searching among DispatchConstrainerEnablers. The search query is constructed using the DispatchConstrainerEnablerQuery.

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

This session defines views that offer differing behaviors for searching.

  • federated publisher view: searches include dispatch constrainer enablers in publishers of which this publisher is an ancestor in the publisher hierarchy
  • isolated publisher view: searches are restricted to dispatch constrainer enablers in this publisher

Dispatch constrainer enablers may have a query record indicated by their respective record types. The query record is accessed via the DispatchConstrainerEnablerQuery.

MethodgetDispatchConstrainerEnablerSearch
Description

Gets a dispatch constrainer enabler search.

Returnosid.subscription.rules.DispatchConstrainerEnablerSearch the dispatch constrainer enabler search
Compliancemandatory This method must be implemented.
MethodgetDispatchConstrainerEnablerSearchOrder
Description

Gets a dispatch constrainer enabler search order. The DispatchConstrainerEnablerSearchOrder is supplied to a DispatchConstrainerEnablerSearch to specify the ordering of results.

Returnosid.subscription.rules.DispatchConstrainerEnablerSearchOrder the dispatch constrainer enabler search order
Compliancemandatory This method must be implemented.
MethodgetDispatchConstrainerEnablersBySearch
Description

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

Parametersosid.subscription.rules.DispatchEnablerQuerydispatchConstrainerEnablerQuery the dispatch constrainer enabler query
osid.subscription.rules.DispatchConstrainerEnablerSearchdispatchConstrainerEnablerSearch the dispatch constrainer enabler search
Returnosid.subscription.rules.DispatchConstrainerEnablerSearchResults the returned search results
ErrorsNULL_ARGUMENT dispatchConstrainerEnablerQuery or dispatchConstrainerEnablerSearch is null
OPERATION_FAILED unable to complete request
PERMISSION_DENIED authorization failure
UNSUPPORTED dispatchConstrainerEnablerQuery or dispatchConstrainerEnablerSearch is not of this service
Compliancemandatory This method must be implemented.
MethodgetDispatchConstrainerEnablerQueryFromInspector
Description

Gets a dispatch constrainer enabler query from an inspector. The inspector is available from a DispatchConstrainerEnablerSearchResults.

Parametersosid.subscription.rules.DispatchConstrainerEnablerQueryInspectordispatchConstrainerEnablerQueryInspector a dispatch constrainer enabler query inspector
Returnosid.subscription.rules.DispatchConstrainerEnablerQuery the dispatch constrainer enabler query
ErrorsNULL_ARGUMENT dispatchConstrainerEnablerQueryInspector is null
UNSUPPORTED dispatchConstrainerEnablerQueryInspector is not of this service
Compliancemandatory This method must be implemented.