Election

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"
      }
    ]