Ill. Admin. Code tit. 26 , 219 app A

Current through Register Vol. 48, No. 33, August 16, 2024
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

Ill. Admin. Code tit. 26 , 219 app A

Adopted at 39 Ill. Reg. 4020, effective 2/27/2015.
Amended at 41 Ill. Reg. 12883, effective 9/26/2017