Election Authority Results Reports

[Tim Bovee <tbovee@ap.org>]

Following is a list of fields that could be used for election authority
reports of election results. The specific content limits are fairly
broad in this draft, because of the need for internationalization. I
would envision a need for country-level standards that would override
portions of this scheme.

Besides internationalization, my main concern has been to draft this so
it will work well with news media election systems. The following scheme
is not definitive, and we may well want to weigh in with proposed
changes as we assess the implications for our systems.

The following makes no pretense at being valid XML. The intent is to
list fields for our consideration.

This scheme is laid out as a flat-file database. Most election systems
use a relational model, linking results to static data, such as
candidate, contest and office info. The vote reports layout used by the
California Secretary of State is a good example. See 
http://www.ss.ca.gov/media/

I don't yet have a clear opinion of which model works best, given modern
system speeds and bandwidth.

Tim
-- 
Tim Bovee, Director of Projects/Technology
The Associated Press, Washington
202-776-9465, tbovee@ap.org
--

Draft DTD for election authority reports of results (9/4/2001)

<!ELEMENT Sequence-Number(#PCDATA)-->
<!ELEMENT Source (Internet-Code, Name, URI)>
	<!ELEMENT Name (#PCDATA)>
	<!ELEMENT URI ( #PCDATA)>
	<!ELEMENT Validation (#PCDATA)> <!-- Ex: PGP signature -->
	<!ELEMENT Contact (Name, Title, Email, Phone)-->
		<!ELEMENT Name (#PCDATA)>
		<!ELEMENT Title (#PCDATA)>
		<!ELEMENT Email(#PCDATA)>
		<!ELEMENT Phone(#PCDATA)>
	<!ELECTION Official-Results (TRUE | FALSE)-->
<!ELEMENT Date-Time (Universal, Local)>
	<!ELEMENT Universal (Year, Month, Date, Hour, Minute, Second,
GMT-Offset)>
		<!ELEMENT Gregorian-Year (0001..9999)>
		<!ELEMENT Gregorian-Month (01..12)>
		<!ELEMENT Date (01..31)>
		<!ELEMENT Hour (00..23)>
		<!ELEMENT Minute (00..59)>
		<!ELEMENT Second (00..59)>
		<!ELEMENT GMT-Offset (+|-, 0..12)>
	<!ELEMENT Local (Year, Month, Date, Hour, Minute, Second, AMPM,
TimeZone)>
	<!--The following #PCDATA content should be overridden by country-local
standardsą
		<!ELEMENT Local-Year (#PCDATA)> <!-- Ex: AH 1423 , Heisei 12 in
Shift-JIS ą
		<!ELEMENT Local-Month (#PCDATA)> <!-- Ex: Rabi' al-awwal,
Ju-ichi-gatsu as Shift-JIS, Jan.-->
		<!ELEMENT Local-Date (#PCDATA)> <!-- Ex: 3, nano-ka as Shift-JIS -->
		<!ELEMENT Local-Hour (#PCDATA)>
		<!ELEMENT Local-Minute (#PCDATA)>
		<!ELEMENT Local-Second (#PCDATA)>
		<!ELEMENT AMPM (#PCDATA)>
		<!ELEMENT TimeZone (#PCDATA)> <!-- Ex: EDT, CST, JST-->
	<!-- End override-->
<!ELEMENT Report (Office-Report*)>
	<!ELEMENT Correction (TRUE|FALSE)ą
	<!ELEMENT Office-Report *(Office-ID, Candidate-Report*)
		<!ELEMENT Office-ID (Office, Election-Type, Party, Unit*, Office-Name,
Election-Type-Name, Party-Name*, Unit-Name*)>
		<!-- The following #PCDATA content should be overridden by
country/jurisdiction-specific standards-->
		<!ELEMENT Office-Code (#PCDATA)>
			<!ELEMENT Election-Type-Code (#PCDATA)> <!-- AP = G(eneral), S(pecial
General), P(rimary), R(unoff) -->
			<!ELEMENT Party-Code (#PCDATA)> <!-- U.S. Possibilities:
MULT(iparty), DEM(ocrat), REP(ublican)-->
			<!ELEMENT Jurisdiction-Type (#PCDATA)> <!--U.S. examples: State,
Congressional District, Delegate District-->
			<!ELEMENT Unit-Code* (#PCDATA)> <!-- US Possibility = "AZ, 1" for
Arizona first House District-->
		<!-- End override-->
			<!ELEMENT Office-Name (#PCDATA)>
			<!ELEMENT Election-Type-Name (#PCDATA)>
			<!ELEMENT Party-Name* (#PCDATA)>
			<!ELEMENT Unit-Name* (#PCDATA)>
			<!ELEMENT Voting-Unit (Type, Total, Reporting-Count,
Reporting-Percent)>
				<!ELEMENT Unit-Type (#PCDATA)> <!-- Ex: Precinct, County-->			
			 	<!ELEMENT Vote-Venue (#PCDATA)> <!-- Ex: Absentee, Polling Place,
Early Pickup, After Close-->
	<!ELEMENT Total-Reporting-Count (#PCDATA)> <!-- Numeric -->	
				<!ELEMENT Reporting-Count (#PCDATA)> <!--Numeric -->
				<!ELEMENT Reporting-Percent(#PCDATA)> <!--Numeric-->
				<!ELEMENT Total-Registered-Voters (#PCDATA)> <!--Numeric-->
	<!ELEMENT Candidate-Report* (Candidate-ID, Result-Report*)>
		<!ELEMENT Candidate-ID (Candidate-Code, Candidate-Name, Party*,
Winner)>
			<!ELEMENT Candidate-Code (0000..9999)> <!-- Assigned by the reporting
authority-->
			<!ELEMENT Candidate-Name (Prefix*, Personal-Name*, Family-Name*,
Suffix*, Additional-Info*)>
					<!ELEMENT Prefix* (#PCDATA)> <!--Mr., the Hon., Sir)-->
<!ELEMENT Personal-Name* (#PCDATA)>				<!ELEMENT Family-Name* (#PCDATA)> 
<!ELEMENT Suffix* (#PCDATA)> <!--Jr., III, Esq.-->
<!ELEMENT Additional-Candidate-Info* (MIME-Type, Info-Content>
	<!ELEMENT MIME-Type (#PCDATA)> <!-- image/jpeg, text/html-->
	<!ELEMENT Info-Content (ANY)>
				<!ELEMENT Party (#PCDATA)>
				<!ELEMENT Winner (WON | RUNOFF)> 
			<!ELEMENT Result-Report* <Result-Type, Result-Number,
Result-Percentage)>
				<!ELEMENT Result-Type (#PCDATA)> <!-- Override with local standards;
U.S. = Vote, Electoral-Vote, Delegate)-->
				<!ELEMENT Result-Count (#PCDATA)><!--Numeric-->
				<!ELEMENT Result-Percentage (#PCDATA)><!--Numeric-->