OSID Logo
OSID Specifications
voting rules package
Version 3.0.0
Interfaceosid.voting.rules.VoteEnablerSearchSession
Implementsosid.voting.rules.VoteEnablerQuerySession
Used Byosid.voting.rules.VotingRulesManager
osid.voting.rules.VotingRulesProxyManager
Description

This session provides methods for searching among VoteEnablers . The search query is constructed using the VoteEnablerQuery .

getVoteEnablersByQuery() is the basic search method and returns a list of VoteEnablers . A more advanced search may be performed with getVoteEnablersBySearch() .It accepts a VoteEnablerSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. getVoteEnablersBySearch() returns a VoteEnablerSearchResults that can be used to access the resulting VoteEnablerList or be used to perform a search within the result set through Vot eEnablerSearch .

This session defines views that offer differing behaviors for searching.

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

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

MethodgetVoteEnablerSearch
Description

Gets a vote enabler search.

Returnosid.voting.rules.VoteEnablerSearchthe vote enabler search
CompliancemandatoryThis method must be implemented.
MethodgetVoteEnablerSearchOrder
Description

Gets a vote enabler search order. The VoteEnablerSearchOrder is supplied to a VoteEnablerSearch to specify the ordering of results.

Returnosid.voting.rules.VoteEnablerSearchOrderthe vote enabler search order
CompliancemandatoryThis method must be implemented.
MethodgetVoteEnablersBySearch
Description

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

Parametersosid.voting.rules.VoteEnablerQueryvoteEnablerQuerythe vote enabler query
osid.voting.rules.VoteEnablerSearchvoteEnablerSearchthe vote enabler search
Returnosid.voting.rules.VoteEnablerSearchResultsthe returned search results
ErrorsNULL_ARGUMENTvoteEnablerQuery or voteEnablerSearch is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
UNSUPPORTEDvoteEnablerQuery or voteEnablerSearch is not of this service
CompliancemandatoryThis method must be implemented.
MethodgetVoteEnablerQueryFromInspector
Description

Gets a vote enabler query from an inspector. The inspector is available from a VoteEnablerSearchResults .

Parametersosid.voting.rules.VoteEnablerQueryInspectorvoteEnablerQueryInspectora vote enabler query inspector
Returnosid.voting.rules.VoteEnablerQuerythe vote enabler query
ErrorsNULL_ARGUMENTvoteEnablerQueryInspector is null
UNSUPPORTEDvoteEnablerQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.