Kieskring

This document explains the XML structure and its relations to the classes in Java. Provided below are the relations explained and an example structure.

The section titles represent the XML class that it is referring to, below that you will find the representing Java class with a link to the file.

Example

<EML>
    <TransactionId>1</TransactionId>
    <ManagingAuthority>
        <AuthorityIdentifier Id="HSB9">Amsterdam</AuthorityIdentifier>
    </ManagingAuthority>
    <Count>
        <Election>
            <ElectionIdentifier Id="TK2021">
                <ElectionName>Tweede Kamer der Staten-Generaal 2021</ElectionName>
                <ElectionCategory>TK</ElectionCategory>
                <kr:ElectionSubcategory>TK</kr:ElectionSubcategory>
                <kr:ElectionDate>2021-03-17</kr:ElectionDate>
            </ElectionIdentifier>
            <Contests>
                <Contest>
                    <ContestIdentifier Id="9">
                        <ContestName>Amsterdam</ContestName>
                    </ContestIdentifier>
                    <TotalVotes>
                        <Selection>
                            <AffiliationIdentifier Id="1">
                                <RegisteredName>VVD</RegisteredName>
                            </AffiliationIdentifier>
                            <ValidVotes>55445</ValidVotes>
                        </Selection>
                        <Selection>
                            <Candidate>
                                <CandidateIdentifier Id="1"></CandidateIdentifier>
                            </Candidate>
                            <ValidVotes>44039</ValidVotes>
                        </Selection>
                        <Selection>
                            <Candidate>
                                <CandidateIdentifier Id="2"></CandidateIdentifier>
                            </Candidate>
                            <ValidVotes>1501</ValidVotes>
                        </Selection>
                        <Cast>582177</Cast>
                        <TotalCounted>437827</TotalCounted>
                        <RejectedVotes ReasonCode="ongeldig">2136</RejectedVotes>
                        <RejectedVotes ReasonCode="blanco">956</RejectedVotes>
                        <UncountedVotes ReasonCode="geldige volmachtbewijzen">36438</UncountedVotes>
                        <UncountedVotes ReasonCode="geldige kiezerspassen">1661</UncountedVotes>
                        <UncountedVotes ReasonCode="meer getelde stembiljetten">143</UncountedVotes>
                        <UncountedVotes ReasonCode="minder getelde stembiljetten">593</UncountedVotes>
                        <UncountedVotes ReasonCode="meegenomen stembiljetten">55</UncountedVotes>
                        <UncountedVotes ReasonCode="te weinig uitgereikte stembiljetten">9</UncountedVotes>
                        <UncountedVotes ReasonCode="te veel uitgereikte stembiljetten">6</UncountedVotes>
                        <UncountedVotes ReasonCode="geen verklaring">524</UncountedVotes>
                        <UncountedVotes ReasonCode="andere verklaring">93</UncountedVotes>
                        <UncountedVotes ReasonCode="te veel briefstembiljetten">0</UncountedVotes>
                        <UncountedVotes ReasonCode="geen briefstembiljetten">17</UncountedVotes>
                    </TotalVotes>

                    <ReportingUnitVotes>
                        <ReportingUnitIdentifier Id="HSB9::0363">Amsterdam</ReportingUnitIdentifier>
                        <Selection>
                            <AffiliationIdentifier Id="1">
                                <RegisteredName>VVD</RegisteredName>
                            </AffiliationIdentifier>
                            <ValidVotes>55445</ValidVotes>
                        </Selection>
                        <Selection>
                            <Candidate>
                                <CandidateIdentifier Id="1"></CandidateIdentifier>
                            </Candidate>
                            <ValidVotes>44039</ValidVotes>
                        </Selection>
                        <Selection>
                            <Candidate>
                                <CandidateIdentifier Id="2"></CandidateIdentifier>
                            </Candidate>
                            <ValidVotes>1501</ValidVotes>
                        </Selection>
                        <Selection>
                            <Candidate>
                                <CandidateIdentifier Id="3"></CandidateIdentifier>
                            </Candidate>
                            <ValidVotes>1927</ValidVotes>
                        </Selection>
                        <Cast>582177</Cast>
                        <TotalCounted>437827</TotalCounted>
                        <RejectedVotes ReasonCode="ongeldig">2136</RejectedVotes>
                        <RejectedVotes ReasonCode="blanco">956</RejectedVotes>
                        <UncountedVotes ReasonCode="geldige volmachtbewijzen">36438</UncountedVotes>
                        <UncountedVotes ReasonCode="geldige kiezerspassen">1661</UncountedVotes>
                        <UncountedVotes ReasonCode="meer getelde stembiljetten">143</UncountedVotes>
                        <UncountedVotes ReasonCode="minder getelde stembiljetten">593</UncountedVotes>
                        <UncountedVotes ReasonCode="meegenomen stembiljetten">55</UncountedVotes>
                        <UncountedVotes ReasonCode="te weinig uitgereikte stembiljetten">9</UncountedVotes>
                        <UncountedVotes ReasonCode="te veel uitgereikte stembiljetten">6</UncountedVotes>
                        <UncountedVotes ReasonCode="geen verklaring">524</UncountedVotes>
                        <UncountedVotes ReasonCode="andere verklaring">93</UncountedVotes>
                        <UncountedVotes ReasonCode="te veel briefstembiljetten">0</UncountedVotes>
                        <UncountedVotes ReasonCode="geen briefstembiljetten">17</UncountedVotes>
                    </ReportingUnitVotes>
                </Contest>
            </Contests>
        </Election>
    </Count>
</EML>

EML

XML Example

<EML>
    <TransactionId>1</TransactionId>
</EML>

Class used: KiesKring

The TransactionIdis used for this class.
Note: The cast, counted, Contest and ManagingAuthority properties from this class come from other classes listed below.

Data field	Class field
TransactionId [Value]	transactionId [Property]
IssueDate [Value]	issueDate [Property]

ManagingAuthority

XML Example

<ManagingAuthority>
    <AuthorityIdentifier Id="HSB9">Amsterdam</AuthorityIdentifier>
</ManagingAuthority>

Class used: ManagingAuthority

The Id and AuthorityIdentifier text are used for this class.

Data field	Class field
Id [Attribute]	id [Property]
AuthorityIdentifier [Value]	name [Property]

ElectionIdentifier

XML Example

<ElectionIdentifier Id="TK2021">
    <ElectionName>Tweede Kamer der Staten-Generaal 2021</ElectionName>
    <ElectionCategory>TK</ElectionCategory>
    <kr:ElectionDate>2021-03-17</kr:ElectionDate>
</ElectionIdentifier>

Class used: Election

The Id, ElectionName, ElectionCategory and ElectionDate are used for this class.

Data field	Class field
Id [Attribute]	id [Property]
ElectionName [Value]	name [Property]
ElectionCategory [Value]	category [Property]
ElectionDate [Value]	electionDate [Property]

ContestIdentifier

XML Example

<ContestIdentifier Id="9">
    <ContestName>Amsterdam</ContestName>
</ContestIdentifier>

Class used: Contest

The Id and ContestName are used for this class.
Note: The parties property from this class come from other classes listed below.

Data field	Class field
Id [Attribute]	id [Property]
ContestName [Value]	name [Property]

TotalVotes

ReportingUnitVotes

XML Example

<ReportingUnitVotes>
    <ReportingUnitIdentifier Id="HSB9::0363">Amsterdam</ReportingUnitIdentifier>
    <Selection>
        <AffiliationIdentifier Id="1">
            <RegisteredName>VVD</RegisteredName>
        </AffiliationIdentifier>
        <ValidVotes>55445</ValidVotes>
    </Selection>
    <Selection>
        <Candidate>
            <CandidateIdentifier Id="1"></CandidateIdentifier>
        </Candidate>
        <ValidVotes>44039</ValidVotes>
    </Selection>
    <Cast>582177</Cast>
    <TotalCounted>437827</TotalCounted>
    <RejectedVotes ReasonCode="ongeldig">2136</RejectedVotes>
    <UncountedVotes ReasonCode="geldige volmachtbewijzen">36438</UncountedVotes>
</ReportingUnitVotes>

Class used: KiesKringGemeente

The ReportingUnitIdentifier, Cast, TotalCounted, RejectedVotes, UncountedVotes and Id are used for this class.
Note: The candidates and Party property from this class come from other classes listed below.
Note: *Votes -> RejectedVotes or CountedVotes

Data field	Class field
ReportingUnitIdentifier#Id [Attribute]	id [Property]
ReportingUnitIdentifier [Value]	name [Property]
Cast [Value]	cast [Property]
Counted [Value]	counted [Property]
Votes#ReasonCode [Attribute*]	Votes#reason [Property*]
Votes [Value*]	Votes#count [Property*]

Affiliation

XML Example

<Affiliation>
    <!-- Election party information-->
    <AffiliationIdentifier Id="1">
        <RegisteredName>VVD</RegisteredName>
    </AffiliationIdentifier>
</Affiliation>

Class used: ElectionPartyWithVotes

The AffiliationIdentifier and RegisteredName are used for this class.
Note: The candidates property from this class come from other classes listed below.

Data field	Class field
AffiliationIdentifier#Id [Attribute]	id [Property]
RegisteredName [Value]	name [Property]

Candidate

XML Example

<Selection>
    <Candidate>
        <CandidateIdentifier Id="1"></CandidateIdentifier>
    </Candidate>
    <ValidVotes>44039</ValidVotes>
</Selection>

Class used: CandidateWithVotes

The CandidateIdentifier and ValidVotes are used for this class.

Data field	Class field
CandidateIdentifier#Id [Attribute]	id [Property]
ValidVotes [Value]	votes [Property]

---