Australian Electoral Commission
Total Page:16
File Type:pdf, Size:1020Kb
Australian Electoral Commission System: AEC Media Feed Document Type: User Guide Version: 3.0 Released: 8/6/2010 AEC Media Feed User Guide Document Control File Name AEC Media Feed User Guide v3-0.doc Version 3.0 Release 8/6/2010 Date Last Australian Electoral Commission Updated by Acceptance and Release Notice This is a managed document. All copies of this document preceding this release are obsolete and shall be destroyed. This is the AEC Media Feed User Guide Version 3.0 , dated 8/6/2010 . Release Status: Version Date Reason for Release Review No. Number 3.0 8/6/2010 Initial Public Release Date Printed: 08/06/2010 ii Version 3.0 8/6/2010 AEC Media Feed User Guide Table of Contents 1. INTRODUCTION ....................................................................................................... 1 1.1 Audience .............................................................................................................................. 1 1.2 Scope .................................................................................................................................... 1 1.3 Related Documents .............................................................................................................. 1 2. SYSTEM OVERVIEW................................................................................................ 2 2.1 System Diagram ................................................................................................................... 3 3. ACCESSING THE MEDIA FEED SYSTEM ................................................................. 4 3.1 System Requirements .......................................................................................................... 4 3.2 Message Types ..................................................................................................................... 4 3.3 Media Feed FTP Site ........................................................................................................... 5 3.4 Cycle Times ......................................................................................................................... 6 3.5 Estimated Download Times ................................................................................................. 6 3.6 Recommended Feed Usage .................................................................................................. 7 4. FEEDS .................................................................................................................... 10 4.1 Compression ...................................................................................................................... 10 4.2 Media feed file naming convention ................................................................................... 10 4.3 Feed Granularity ................................................................................................................ 10 4.4 Standard Granularity Feeds ............................................................................................... 10 4.5 Detailed Granularity Feeds ................................................................................................ 12 5. MEDIA FEED MESSAGES ...................................................................................... 14 5.1 Message file naming convention ....................................................................................... 14 5.2 White space and Formatting .............................................................................................. 15 5.3 Schema Documentation ..................................................................................................... 15 5.4 Understanding the XML schema ....................................................................................... 15 6. PRELOAD MESSAGES ............................................................................................ 17 6.1 Preload Results Message ................................................................................................... 17 6.2 Election Event Message (EML 110) .................................................................................. 18 6.3 Candidate List Message (EML 230) .................................................................................. 22 6.4 Referendum Options List Message (EML 630)................................................................. 25 6.5 Polling Districts Message .................................................................................................. 26 6.6 Senate Group Voting Tickets Message .............................................................................. 30 6.7 Ballot Paper Message ........................................................................................................ 33 7. RESULTS MESSAGES ............................................................................................. 35 7.1 AEC Results Message ........................................................................................................ 35 7.2 EML Count Message (EML 510) ...................................................................................... 48 7.3 EML Result Message (EML 520) ...................................................................................... 51 8. CHANGES IN VERSION 3.0 .................................................................................... 54 8.1 Introduction ........................................................................................................................ 54 8.2 Passive Mode FTP ............................................................................................................. 54 8.3 Election Mark-up Language (EML) Version 5.0 .............................................................. 54 8.4 XML Schema Files ............................................................................................................ 54 8.5 Polling place classification for pre-poll voting centres ..................................................... 54 8.6 Media Feed Element (File Header) .................................................................................... 55 8.7 Count Message (EML message 510) ................................................................................. 57 8.8 Result Message (EML message 520) ................................................................................ 58 8.9 Cycle Times. ...................................................................................................................... 59 9. FREQUENTLY ASKED QUESTIONS ........................................................................ 60 9.1 Do all AEC messages have the same header? ................................................................... 60 Date Printed: 08/06/2010 iii Version 3.0 8/6/2010 AEC Media Feed User Guide 9.2 How can I determine if the message was generated on Election Night? ........................... 61 9.3 How can I determine if any results have changed since the last feed? .............................. 62 9.4 How can I determine if a division has gone “maverick” on election night? ..................... 63 9.5 Why am I unable to see TCP results for a division(s)? ..................................................... 65 9.6 What are the main differences between the light and verbose messages? ........................ 65 9.7 How can I determine if a Division has been declared? ..................................................... 66 9.8 How can I determine the progress of the count? ............................................................... 68 9.9 How can I determine if the results are finalised? .............................................................. 69 9.10 When are Matched Historic votes available? .................................................................... 70 9.11 Are Polling Place Latitudes and Longitudes available? .................................................... 70 9.12 How can I determine the TCP matched historic for Polling Places that have returned First Preferences? ................................................................................................................................... 71 9.13 How can I determine a Candidate’s position on the ballot paper? .................................... 73 9.14 Is there a message that contains the ballot paper definition? ............................................. 73 9.15 What is the difference between Elected Historic and Incumbent? .................................... 73 Date Printed: 08/06/2010 iv Version 3.0 8/6/2010 AEC Media Feed User Guide 1. INTRODUCTION On election night the AEC delivers a live feed of election results to a number of media organisations and interested third parties. These organisations include the ABC, Nine, Seven, Sky, SBS, AAP and News Limited. The purpose of this publication is to provide information to users of the Media Feed System. 1.1 Audience This document is intended for stakeholders interested in receiving a feed of election results from the AEC during Federal Elections. This document is suitable for use by the following staff working with the AEC, the media or other interested stakeholders: • Business Users • Election Analysts • Business Analysts • Software Developers • Network Managers • Network Engineers 1.2 Scope This document provides information relating to the use of the Media Feed system. The document discusses: 1. Accessing the System 2. Feeds (Compressed Files) 3. XML Messages 4. Frequently Asked Questions 1.3 Related Documents The full schema definition and associated