CandidateContest

CandidateContest extends ContestBase and represents a contest among candidates.

Tag

Data Type

Required?

Repeats?

Description

Error Handling

NumberElected

xs:integer

Optional

Single

Number of candidates that are elected in the contest (i.e. “N” of N-of-M).

If the field is invalid or not present, then the implementation is required to ignore it.

OfficeIds

xs:IDREFS

Optional

Single

References a set of Office elements, if available, which give additional information about the offices. Note: the order of the office IDs must be in the same order as the candidates listed in BallotSelectionIds. E.g., if the various BallotSelectionIds reference CandidateSelection elements which reference the candidate for President first and Vice-President second, the OfficeIds should reference the office of President first and the office of Vice-President second.

If the field is invalid or not present, then the implementation is required to ignore it.

PrimaryPartyIds

xs:IDREFS

Optional

Single

References Party elements, if the contest is related to a particular party.

If the field is invalid or not present, then the implementation is required to ignore it.

VotesAllowed

xs:integer

Optional

Single

Maximum number of votes/write-ins per voter in this contest.

If the field is invalid or not present, then the implementation is required to ignore it.

 1<CandidateContest id="cc20003">
 2   <BallotSelectionIds>cs10961 cs10962 cs10963</BallotSelectionIds>
 3   <BallotTitle>
 4     <Text language="en">Governor of Virginia</Text>
 5   </BallotTitle>
 6   <ElectoralDistrictId>ed60129</ElectoralDistrictId>
 7   <Name>Governor</Name>
 8   <NumberElected>1</NumberElected>
 9   <OfficeId>off0000</OfficeId>
10   <VotesAllowed>1</VotesAllowed>
11</CandidateContest>

ContestBase

A base model for all Contest types: BallotMeasureContest, CandidateContest, PartyContest, and RetentionContest (NB: the latter because it extends BallotMeasureContest).

Tag

Data Type

Required?

Repeats?

Description

Error Handling

Abbreviation

xs:string

Optional

Single

An abbreviation for the contest.

If the field is invalid or not present, then the implementation should ignore it.

BallotSelectionIds

xs:IDREFS

Optional

Single

References a set of BallotSelections, which could be of any selection type that extends BallotSelectionBase.

If the field is invalid or not present, then the implementation should ignore it.

BallotSubTitle

InternationalizedText

Optional

Single

Subtitle of the contest as it appears on the ballot.

If the element is invalid or not present, then the implementation should ignore it.

BallotTitle

InternationalizedText

Optional

Single

Title of the contest as it appears on the ballot.

If the element is invalid or not present, then the implementation should ignore it.

ElectoralDistrictId

xs:IDREF

Required

Single

References an ElectoralDistrict element that represents the geographical scope of the contest.

If the field is invalid, then the implementation is required to ignore the ContestBase element containing it.

ElectorateSpecification

InternationalizedText

Optional

Single

Specifies any changes to the eligible electorate for this contest past the usual, “all registered voters” electorate. This subtag will most often be used for primaries and local elections. In primaries, voters may have to be registered as a specific party to vote, or there may be special rules for which ballot a voter can pull. In some local elections, non-citizens can vote.

If the element is invalid or not present, then the implementation should ignore it.

ExternalIdentifiers

ExternalIdentifiers

Optional

Single

Other identifiers for a contest that links to another source of information.

If the element is invalid or not present, then the implementation should ignore it.

HasRotation

xs:boolean

Optional

Single

Indicates whether the selections in the contest are rotated.

If the field is invalid or not present, then the implementation should ignore it.

Name

xs:string

Required

Single

Name of the contest, not necessarily how it appears on the ballot (NB: BallotTitle should be used for this purpose).

If the field is invalid, then the implementation is required to ignore the ContestBase element containing it.

SequenceOrder

xs:integer

Optional

Single

Order in which the contests are listed on the ballot. This is the default ordering, and can be overrides by data in a BallotStyle element.

If the field is invalid or not present, then the implementation should ignore it.

VoteVariation

VoteVariation

Optional

Single

Vote variation associated with the contest (e.g. n-of-m, majority, et al).

If the field is invalid or not present, then the implementation should ignore it.

OtherVoteVariation

xs:string

Optional

Single

If “other” is selected as the VoteVariation, the name of the variation can be specified here.

If the field is invalid or not present, then the implementation should ignore it.