OSID Logo
OSID Specifications
hold rules package
Version 3.1.0
Interfaceosid.hold.rules.IssueEnablerSearchSession
Implementsosid.hold.rules.IssueEnablerQuerySession
Used Byosid.hold.rules.HoldRulesManager
osid.hold.rules.HoldRulesProxyManager
Description

This session provides methods for searching among IssueEnablers. The search query is constructed using the IssueEnablerQuery.

getIssueEnablersByQuery() is the basic search method and returns a list of IssueEnablers. A more advanced search may be performed with getIssueEnablersBySearch().It accepts an IssueEnablerSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. getIssueEnablersBySearch() returns an IssueEnablerSearchResults that can be used to access the resulting IssueEnablerList or be used to perform a search within the result set through IssueEnablerSearch.

This session defines views that offer differing behaviors for searching.

  • federated oubliette view: searches include issue enablers in oubliettes of which this oubliette is an ancestor in the oubliette hierarchy
  • isolated oubliette view: searches are restricted to issue enablers in this oubliette

Issue enablers may have a query record indicated by their respective record types. The query record is accessed via the IssueEnablerQuery.

MethodgetIssueEnablerSearch
Description

Gets an issue enabler search.

Returnosid.hold.rules.IssueEnablerSearch the issue enabler search
Compliancemandatory This method must be implemented.
MethodgetIssueEnablerSearchOrder
Description

Gets an issue enabler search order. The IssueEnablerSearchOrder is supplied to an IssueEnablerSearch to specify the ordering of results.

Returnosid.hold.rules.IssueEnablerSearchOrder the issue enabler search order
Compliancemandatory This method must be implemented.
MethodgetIssueEnablerBySearch
Description

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

Parametersosid.hold.rules.IssueEnablerQueryissueEnablerQuery the issue enabler query
osid.hold.rules.IssueEnablerSearchissueEnablerSearch the issue enabler search
Returnosid.hold.rules.IssueEnablerSearchResults the returned search results
ErrorsNULL_ARGUMENT issueEnablerQuery or issueEnablerSearch is null
OPERATION_FAILED unable to complete request
PERMISSION_DENIED authorization failure
UNSUPPORTED issueEnablerQuery or issueEnablerSearch is not of this service
Compliancemandatory This method must be implemented.
MethodgetIssueEnablerQueryFromInspector
Description

Gets an issue enabler query from an inspector. The inspector is available from an IssueEnablerSearchResults.

Parametersosid.hold.rules.IssueEnablerQueryInspectorissueEnablerQueryInspector an issue enabler query inspector
Returnosid.hold.rules.IssueEnablerQuery the issue enabler query
ErrorsNULL_ARGUMENT issueEnablerQueryInspector is null
UNSUPPORTED issueEnablerQueryInspector is not of this service
Compliancemandatory This method must be implemented.