OSID Logo
OSID Specifications
hold rules package
Version 3.0.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.IssueEnablerSearchthe issue enabler search
CompliancemandatoryThis 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.IssueEnablerSearchOrderthe issue enabler search order
CompliancemandatoryThis method must be implemented.
MethodgetIssueEnablerBySearch
Description

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

Parametersosid.hold.rules.IssueEnablerQueryissueEnablerQuerythe issue enabler query
osid.hold.rules.IssueEnablerSearchissueEnablerSearchthe issue enabler search
Returnosid.hold.rules.IssueEnablerSearchResultsthe returned search results
ErrorsNULL_ARGUMENTissueEnablerQuery or issueEnablerSearch is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
UNSUPPORTEDissueEnablerQuery or issueEnablerSearch is not of this service
CompliancemandatoryThis method must be implemented.
MethodgetIssueEnablerQueryFromInspector
Description

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

Parametersosid.hold.rules.IssueEnablerQueryInspectorissueEnablerQueryInspectoran issue enabler query inspector
Returnosid.hold.rules.IssueEnablerQuerythe issue enabler query
ErrorsNULL_ARGUMENTissueEnablerQueryInspector is null
UNSUPPORTEDissueEnablerQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.