OSID Logo
OSID Specifications
subscription rules package
Version 3.0.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.DispatchConstrainerEnablerSearchthe dispatch constrainer enabler search
CompliancemandatoryThis 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.DispatchConstrainerEnablerSearchOrderthe dispatch constrainer enabler search order
CompliancemandatoryThis method must be implemented.
MethodgetDispatchConstrainerEnablersBySearch
Description

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

Parametersosid.subscription.rules.DispatchEnablerQuerydispatchConstrainerEnablerQuerythe dispatch constrainer enabler query
osid.subscription.rules.DispatchConstrainerEnablerSearchdispatchConstrainerEnablerSearchthe dispatch constrainer enabler search
Returnosid.subscription.rules.DispatchConstrainerEnablerSearchResultsthe returned search results
ErrorsNULL_ARGUMENTdispatchConstrainerEnablerQuery or dispatchConstrainerEnablerSearch is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
UNSUPPORTEDdispatchConstrainerEnablerQuery or dispatchConstrainerEnablerSearch is not of this service
CompliancemandatoryThis 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.DispatchConstrainerEnablerQueryInspectordispatchConstrainerEnablerQueryInspectora dispatch constrainer enabler query inspector
Returnosid.subscription.rules.DispatchConstrainerEnablerQuerythe dispatch constrainer enabler query
ErrorsNULL_ARGUMENTdispatchConstrainerEnablerQueryInspector is null
UNSUPPORTEDdispatchConstrainerEnablerQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.