OSID Logo
OSID Specifications
voting rules package
Version 3.1.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.VoteEnablerSearch the vote enabler search
Compliancemandatory This 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.VoteEnablerSearchOrder the vote enabler search order
Compliancemandatory This method must be implemented.
MethodgetVoteEnablersBySearch
Description

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

Parametersosid.voting.rules.VoteEnablerQueryvoteEnablerQuery the vote enabler query
osid.voting.rules.VoteEnablerSearchvoteEnablerSearch the vote enabler search
Returnosid.voting.rules.VoteEnablerSearchResults the returned search results
ErrorsNULL_ARGUMENT voteEnablerQuery or voteEnablerSearch is null
OPERATION_FAILED unable to complete request
PERMISSION_DENIED authorization failure
UNSUPPORTED voteEnablerQuery or voteEnablerSearch is not of this service
Compliancemandatory This method must be implemented.
MethodgetVoteEnablerQueryFromInspector
Description

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

Parametersosid.voting.rules.VoteEnablerQueryInspectorvoteEnablerQueryInspector a vote enabler query inspector
Returnosid.voting.rules.VoteEnablerQuery the vote enabler query
ErrorsNULL_ARGUMENT voteEnablerQueryInspector is null
UNSUPPORTED voteEnablerQueryInspector is not of this service
Compliancemandatory This method must be implemented.