OSID Logo
OSID Specifications
provisioning rules package
Version 3.1.0
Interfaceosid.provisioning.rules.QueueConstrainerEnablerSearchSession
Implementsosid.provisioning.rules.QueueConstrainerEnablerQuerySession
Used Byosid.provisioning.rules.ProvisioningRulesManager
osid.provisioning.rules.ProvisioningRulesProxyManager
Description

This session provides methods for searching among QueueConstrainerEnablers. The search query is constructed using the QueueConstrainerEnablerQuery.

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

This session defines views that offer differing behaviors for searching.

  • federated distributor view: searches include queue constrainer enablers in distributors of which this distributor is an ancestor in the distributor hierarchy
  • isolated distributor view: searches are restricted to queue constrainer enablers in this distributor

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

MethodgetQueueConstrainerEnablerSearch
Description

Gets a queue constrainer enabler search.

Returnosid.provisioning.rules.QueueConstrainerEnablerSearch the queue constrainer enabler search
Compliancemandatory This method must be implemented.
MethodgetQueueConstrainerEnablerSearchOrder
Description

Gets a queue constrainer enabler search order. The QueueConstrainerEnablerSearchOrder is supplied to a QueueConstrainerEnablerSearch to specify the ordering of results.

Returnosid.provisioning.rules.QueueConstrainerEnablerSearchOrder the queue constrainer enabler search order
Compliancemandatory This method must be implemented.
MethodgetQueueConstrainerEnablersBySearch
Description

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

Parametersosid.provisioning.rules.QueueEnablerQueryqueueConstrainerEnablerQuery the queue constrainer enabler query
osid.provisioning.rules.QueueConstrainerEnablerSearchqueueConstrainerEnablerSearch the queue constrainer enabler search
Returnosid.provisioning.rules.QueueConstrainerEnablerSearchResults the returned search results
ErrorsNULL_ARGUMENT queueConstrainerEnablerQuery or queueConstrainerEnablerSearch is null
OPERATION_FAILED unable to complete request
PERMISSION_DENIED authorization failure
UNSUPPORTED queueConstrainerEnablerQuery or queueConstrainerEnablerSearch is not of this service
Compliancemandatory This method must be implemented.
MethodgetQueueConstrainerEnablerQueryFromInspector
Description

Gets a queue constrainer enabler query from an inspector. The inspector is available from a QueueConstrainerEnablerSearchResults.

Parametersosid.provisioning.rules.QueueConstrainerEnablerQueryInspectorqueueConstrainerEnablerQueryInspector a queue constrainer enabler query inspector
Returnosid.provisioning.rules.QueueConstrainerEnablerQuery the queue constrainer enabler query
ErrorsNULL_ARGUMENT queueConstrainerEnablerQueryInspector is null
UNSUPPORTED queueConstrainerEnablerQueryInspector is not of this service
Compliancemandatory This method must be implemented.