CHAPTER 1: STATE BOARD OF ELECTIONS
PART 219 PROCEDURES FOR IMPLEMENTING THE ELECTRONIC CANVASS
SECTION 219.APPENDIX A ILLINOIS ECANVASS FILE FORMAT
Section 219.APPENDIX A Illinois eCanvass File Format
Master File Record Structure
|
Column Start |
Length |
Date Type |
Ballot Style |
Precinct |
Party |
|
1 |
2 |
Record Type (Integer) |
Record Type = 1 |
Record Type = 2 |
Record Type = 3 |
|
3 |
7 |
Unique System Id (Integer) |
Ballot Style ID [1] |
Precinct ID [6] |
(Vendor) Party ID [9] |
|
10 |
50 |
Name (String) |
Ballot Style Name [2] |
Precinct Name [7] |
Party Name [10] |
|
60 |
20 |
Code (String) |
|
|
|
|
80 |
7 |
Display List Order (Integer) |
|
|
|
|
87 |
7 |
Party ID (Vendor or State Number) |
Ballot Style (Vendor) Party ID [3] |
|
(SBE) Party ID [11] |
|
94 |
1 |
Varies/Record Dependent (Boolean 0 or 1) |
Is Federal [4] 0 = Non-Federal Ballot Style 1 = Federal Ballot Style |
|
|
|
95 |
2 |
Vote For (Integer) |
Proposition Only [5] 00 = No 01 = Yes |
|
|
|
97 |
7 |
Varies/Record Dependent (Integer) |
|
Registration [8] |
|
(Master File Record Structure Cont.)
|
District |
Contest |
Candidate |
|
Record Type = 4 |
Record Type = 5 |
Record Type = 6 |
|
District ID [12] |
(Vendor) Contest ID [15] |
(Vendor) Candidate ID [21] |
|
District Name [13] |
Contest Name [16] |
Candidate Name [22] |
|
|
(SBE) Contest ID [17] |
(SBE) Candidate ID [23] |
|
District List Order [14] |
Contest List Order [18] |
Candidate List Order [24] |
|
|
(SBE) Party ID [11] |
(Vendor) Candidate Party ID [25] |
|
|
Is Proposal [19] 0 = Normal Contest 1 = Proposal |
Is Write-in [31] 0 = Regular Candidate 1 = Write-In Candidate |
|
|
Vote For [20] |
|
|
|
District ID [12] |
(Vendor) Contest ID [15] |
Vote File Record Structure
|
Column Start |
Length |
Date Type |
|
1 |
7 |
Precinct ID (Integer) [6] |
|
8 |
7 |
Ballot Style ID (Integer) [1] |
|
15 |
7 |
(Vendor) Contest ID (Integer) [15] 0 = Turnout Record [26] |
|
22 |
7 |
(Vendor) Candidate Id (Integer) [21] 9999999 = Over Votes [27, 28] 9999998 = Under Votes [27, 29] 9999997 = Blank Ballot [27, 30] 0 = Turnout Record [26] |
|
29 |
7 |
Vote Count (Integer) |
Definitions
1 Ballot Style ID – A unique (to the jurisdiction) numeric identifier for the given ballot style
2 Ballot Style Name – A unique (to the jurisdiction) name assigned to the given ballot style
3 Ballot Style (Vendor) Party ID – Only applicable in a primary election, this party ID identifies the party for a given ballot style
4 Is Federal – Designates if a ballot style contains only federal contests
5 Proposition Only – Only applicable in a primary election, this identifies a ballot style as only having questions of public policy (referenda)
6 Precinct ID – Unique (to the jurisdiction) numeric identifier for the given precinct
7 Precinct Name – A unique (to the jurisdiction) name to identify the precinct
8 Registration – The number of registered voters within a precinct. This number should reflect only the "active" registered voters from that precinct
9 (Vendor) Party ID – Unique Identifier for the political parties active in a given election, assigned by the jurisdiction or tabulation vendor
10 Party Name – Name of a given political party
11 (SBEL) Party ID – ID assigned to a given political party by SBEL; SBEL party ID for a contest will reflect the party for a contest in a primary election; in a General Election this ID will be designated as "99" (Nonpartisan) since the office does not have a party affiliation in a General Election
12 District ID – Unique (to the jurisdiction) ID assigned by the jurisdiction to a given political district/unit of government
13 District Name – A unique text representation of the district/unit of government (e.g., 4TH APPELLATE COURT)
14 District List Order – A hierarchical number representing the order in which districts appear on the ballot
15 (Vendor) Contest ID – A unique ID number assigned to an office/contest by the jurisdiction or tabulation vendor
16 Contest Name – A unique text representation of the contest/office (e.g., 4TH APPELLATE COURT – SMITH VACANCY)
17 (SBEL) Contest ID – ID assigned to a given office/contest by SBEL; should be zero in the case that an ID is not assigned by SBEL for the given contest
18 Contest List Order – A hierarchical number representing the order in which offices/contests appear on the ballot
19 Is Proposal – Designates if a contest/office is actually a question of public policy (referenda)
20 Vote For – Number of candidates to be elected/nominated within a given office/contest
21 (Vendor) Candidate ID – Unique ID assigned to a candidate by jurisdiction/vendor
22 Candidate Name – Name of candidate or position on a referendum question
23 (SBEL) Candidate ID – ID assigned by SBEL for the given candidate; in the event that no ID is assigned by SBEL, this ID shall be zero
24 Candidate List Order – A hierarchical number representing the order in which candidates appear on the ballot
25 (Vendor) Candidate Party ID – ID assigned by the jurisdiction or vendor to the candidate
26 Turnout Record – In the vote file, a turnout record will have a contest ID of zero and a candidate ID of zero, and will have one record per precinct and ballot style combination; the turnout record will effectively report the number of times a ballot style was counted within a particular precinct
27 Reporting of Under Votes, Over Votes and Blank Ballots – Under votes, over votes and blank ballots shall be designated in the candidate ID field with codes of 9999998, 9999999 and 9999997, respectively, and shall have a corresponding contest ID
28 Under Votes – The number of times that the contest was on a tabulated ballot when votes cast are less than the Vote For number
29 Over Votes – The number of times that the contest was on a tabulated ballot when votes cast are more than the Vote For number
30 Blank Ballots – For a given contest, the number of times a ballot is cast when the contest has no candidates
31 Is Write-in – Identifies that the candidate is a write-in candidate
(Source: Amended at 41 Ill. Reg. 12883, effective September 26, 2017)