Use this entity for defining the status of the election and associated information such as candidates, contests, and vote counts.
Election includes the major elements that are specific to an election:
BallotStyle
, Candidate
, and Contest
. Election
"wraps" occurrences of these elements in container elements for the purpose of
making large instance files easier to manipulate in XML viewers and editors.
Election
includes a required ElectionScopeId
reference to a GpUnit
element for the purpose of identifying the geographical scope of the election.
For example, for an election within a city, ElectionScodeId
would include a
reference to a GpUnit
defined for the city. If it is desired to
include election authority information, the GpUnit
can include
ElectionAdministration
.
The table below describes the elements for Election:
Element | Multiplicity | Type | Description |
---|---|---|---|
BallotStyleCollection |
0 or 1 | Wrapper element for BallotStyle definitions. | |
CandidateCollection |
0 or 1 | Wrapper element for Candidate
definitions. |
|
ContactInformation |
0 or 1 | ContactInformation | For associating various contact information with the election. |
ContestCollection |
0 or 1 | Wrapper element for Contest
definitions. |
|
CountStatus |
0 or more | CountStatus | For providing various counting status on types of ballots or other items. |
ElectionScopeId |
1 | IDREF | Unique identifier for a GpUnit
element. For associating the election with a reporting unit that
represents the geographical scope of the election, for example,
a state, a city, etc. |
ExternalIdentifiers |
0 or 1 | ExternalIdentifiers | For associating an ID with the election. |
Name |
1 | InternationalizedText | For including a name for the election; the name could be the same name as appears on the ballot. |
StartDate |
1 | date | Calendar start date of the election, for example, "2018-11-04". |
EndDate |
1 | date | Calendar end date of the election; for a typical one-day election, the end date is the same as the start date. |
OtherType |
0 or 1 | string | Used when Type is other. |
Type |
1 | ElectionType | Enumerated type of election, for example, partisan-primary, open-primary, etc. |
Examples
XML
<Election> <BallotStyleCollection> <BallotStyle objectId="bs002"> <GpUnitIds>ru_com10000 ru_com10001 ru_com10002</GpUnitIds> <OrderedContest> <ContestId>cc002</ContestId> </OrderedContest> </BallotStyle> </BallotStyleCollection> <ContestCollection> <Contest objectId="cc002" xsi:type="CandidateContest"> <BallotSelection objectId="cs148046" xsi:type="CandidateSelection"> <CandidateIds>can106183</CandidateIds> </BallotSelection> <BallotSelection objectId="cs148047" xsi:type="CandidateSelection"> <CandidateIds>can14543</CandidateIds> </BallotSelection> <BallotTitle> <Text language="fr">Président de la France</Text> </BallotTitle> <Name>President of France</Name> <ElectoralDistrictId>ru_dep_01</ElectoralDistrictId> <OfficeIds>off0001</OfficeIds> </Contest> </ContestCollection> <CandidateCollection> <Candidate objectId="can106183"> ... </Candidate> <Candidate objectId="can14543"> ... </Candidate> </CandidateCollection> <ElectionScopeId>ru0002</ElectionScopeId> <Name> <Text language="fr">Présidentielle 2017</Text> </Name> <StartDate>2017-05-07</StartDate> <EndDate>2017-05-07</EndDate> <Type>runoff</Type> </Election>
JSON
"Election": [ { "BallotStyleCollection": { "BallotStyle": [ { "objectId": "bs002", "GpUnitIds": ["ru_com10000", "ru_com10001", "ru_com10002"], "OrderedContest": [ { "ContestId": "cc002" } ] } ] }, "ContestCollection": { "Contest": [ { "@type": "CandidateContest", "objectId": "cc002", "BallotSelection": [ { "@type": "CandidateSelection", "objectId": "cs148046", "CandidateIds": [ "can106183" ] ... }, { "@type": "CandidateSelection", "objectId": "cs148047", "CandidateIds": [ "can14543" ] ... } ], "BallotTitle": { "Text": [ { "value": "Président de la France", "language": "fr" } ] }, "ElectoralDistrictId": "ru_dep_01", "Name": "President of France", "NumberElected": 1, "OfficeIds": ["off0001"], "VotesAllowed": 1 } ] }, "CandidateCollection": { "Candidate": [ { "objectId": "can106183", ... }, { "objectId": "can14543", ... } ] }, "ElectionScopeId": "ru0002", "Name": { "Text": [ { "value": "Présidentielle 2017", "language": "fr" } ] }, "StartDate": "2017-05-07", "EndDate": "2017-05-07", "Type": "runoff" } ]