OSID - osid.hold.IssueSearchSession Service Interface Definition

Interface	osid.hold.IssueSearchSession
Implements	`osid.hold.IssueQuerySession`
Description	This session provides methods for searching among `Issue` objects. The search query is constructed using the `IssueQuery.` `getIssuesByQuery()` is the basic search method and returns a list of `Issues.` A more advanced search may be performed with `getIssuesBySearch().` It accepts an `IssueSearch` in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. `getIssuesBySearch()` returns an `IssueSearchResults` that can be used to access the resulting `IssueList` or be used to perform a search within the result set through `IssueSearch.` This session defines views that offer differing behaviors for searching. federated oubliette view: searches include issues in oubliettes of which this oubliette is an ancestor in the oubliette hierarchy isolated oubliette view: searches are restricted to issues in this oubliette Issues may have a query record indicated by their respective record types. The query record is accessed via the `IssueQuery.`
Method	getIssueSearch
Description	Gets an issue search.
Return	`osid.hold.IssueSearch`		the issue search
Compliance	`mandatory`		This method must be implemented.
Method	getIssueSearchOrder
Description	Gets an issue search order. The `IssueSearchOrder` is supplied to an `IssueSearch` to specify the ordering of results.
Return	`osid.hold.IssueSearchOrder`		the issue search order
Compliance	`mandatory`		This method must be implemented.
Method	getIssuesBySearch
Description	Gets the search results matching the given search query using the given search.
Parameters	`osid.hold.IssueQuery`	`issueQuery`	the issue query
Parameters	`osid.hold.IssueSearch`	`issueSearch`	the issue search
Return	`osid.hold.IssueSearchResults`		the issue search results
Errors	NULL_ARGUMENT		`issueQuery` or `issueSearch` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
	UNSUPPORTED		`issueQuery` or `issueSearch` is not of this service
Compliance	`mandatory`		This method must be implemented.
Method	getIssueQueryFromInspector
Description	Gets an issue query. from an inspector. The inspector is available from an `IssueSearchResults.`
Parameters	`osid.hold.IssueQueryInspector`	`issueQueryInspector`	an issue query inspector
Return	`osid.hold.IssueQuery`		the issue query
Errors	NULL_ARGUMENT		`issueQueryInspector` is `null`
Errors	UNSUPPORTED		`issueQueryInspector` is not of this service
Compliance	`mandatory`		This method must be implemented.