OSID - osid.assessment.AssessmentOfferedSearchSession Service Interface Definition

Interface	osid.assessment.AssessmentOfferedSearchSession
Implements	`osid.assessment.AssessmentOfferedQuerySession`
Used By	`osid.assessment.AssessmentManager`
Used By	`osid.assessment.AssessmentProxyManager`
Description	This session provides methods for searching among `AssessmentOffered` objects. The search query is constructed using the `AssessmentOfferedQuery` . `getAssessmentsOfferedByQuery()` is the basic search method and returns a list of `AssessmentOffered` elements. A more advanced search may be performed with `getAssessmentsOfferedBySearch()` . It accepts an `AssessmentOfferedSearch` in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. `getAssessmentsOfferedBySearch()` returns an `AssessmentOfferedSearchResults` that can be used to access the resulting `AssessmentOfferedList` or be used to perform a search within the result set through `AssessmentOfferedSearch` . This session defines views that offer differing behaviors for searching. federated bank view: searches include assessments offered in banks of which this bank is an ancestor in the bank hierarchy isolated bank view: searches are restricted to assessments offered in this bank Assessments offered may have a query record indicated by their respective record types. The query record is accessed via the `AssessmentOfferedQuery` .
Method	getAssessmentOfferedSearch
Description	Gets an assessment offered search.
Return	`osid.assessment.AssessmentOfferedSearch`		the assessment offered search
Compliance	`mandatory`		This method must be implemented.
Method	getAssessmentOfferedSearchOrder
Description	Gets an assessment offered search order. The `AssessmentOfferedSearchOrder` is supplied to an `AssessmentOfferedSearch` to specify the ordering of results.
Return	`osid.assessment.AssessmentOfferedSearchOrder`		the assessment offered search order
Compliance	`mandatory`		This method must be implemented.
Method	getAssessmentsOfferedBySearch
Description	Gets the search results matching the given search query using the given search.
Parameters	`osid.assessment.AssessmentOfferedQuery`	`assessmentOfferedQuery`	the assessment offered query
Parameters	`osid.assessment.AssessmentOfferedSearch`	`assessmentOfferedSearch`	the assessment offered search
Return	`osid.assessment.AssessmentOfferedSearchResults`		the assessment offered search results
Errors	NULL_ARGUMENT		`assessmentOfferedQuery` or `assessmentOfferedSearch` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure occurred
	UNSUPPORTED		`assessmentOfferedQuery` or `assessmentOfferedSearch` is not of this service
Compliance	`mandatory`		This method must be implemented.
Method	getAssessmentOfferedQueryFromInspector
Description	Gets an assessment offered query from an inspector. The inspector is available from an `AssessmentOfferedSearchResults` .
Parameters	`osid.assessment.AssessmentOfferedQueryInspector`	`assessmentOfferedQueryInspector`	an assessment offered query inspector
Return	`osid.assessment.AssessmentOfferedQuery`		the assessment offered query
Errors	NULL_ARGUMENT		`assessmentOfferedQueryInspector` is `null`
Errors	UNSUPPORTED		`assessmentOfferedQueryInspector` is not of this service
Compliance	`mandatory`		This method must be implemented.