{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This is the reader that uses the 2022 protocol specification. ","type":"text"},{"type":"hardBreak"},{"text":"For the legacy parser see the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://bannisterlake.atlassian.net/wiki/spaces/EL/pages/492905"}},{"text":" page that uses the previous data specification.","type":"text"}]},{"type":"paragraph","content":[{"text":"Table of Contents:","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"style":{"value":"default"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"e59a76f5-9f73-436b-8d39-14f39da30bc3"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"a38382f0-ab27-44ab-8d11-050e33ace1a8"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"The reader needs to be pointed at the correct database and have the correct authentication (user Id and password) information to make the right connections. To do this use ","type":"text"},{"type":"hardBreak"},{"text":"File menu - Preferences","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":383,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":257,"alt":"image-20250122-221723.png","id":"213d1204-5da8-4fb1-8b86-e8335ee40f9e","collection":"contentId-3595567109","type":"file","height":277}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Import / Synch Ridings, Parties, Candidates","type":"text"}]},{"type":"paragraph","content":[{"text":"The menu item - ","type":"text"},{"text":"File - Synchronize Database","type":"text","marks":[{"type":"strong"}]},{"text":" will connect to the election data server and pull in the riding, party and candidate data. Then it compares it to what is in the selected Elector Database and makes updates and adds missing records as appropriate.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Inserts missing ridings","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Inserts missing parties","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Inserts missing candidates","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Updates candidate ballot order / id values ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"based on riding, party and candidate last name","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Deletes any candidates found in the Elector database that are not in the Consortium data feed.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Running","type":"text"}]},{"type":"paragraph","content":[{"text":"When you have started the reader displays ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The database it’s connected to and the election name and date that it is processing","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"in the bottom status bar: (updates every 5 seconds approximately)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the number of reports in the Queue to be processed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the last report it processed and the time it processed it at","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if the reader is up-to-date or not","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":727,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":453,"alt":"image-20250122-221237.png","id":"a420b46f-b116-41b0-bafd-383641ed16af","collection":"contentId-3595567109","type":"file","height":123}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Logs","type":"text"}]},{"type":"paragraph","content":[{"text":"The logs always start with the version number of the application when it launched.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"Info: \tConsortium Reader for Elector Launched - Version 1.0.1.0","type":"text"}]},{"type":"paragraph","content":[{"text":"When you start the reader it generates a log like:","type":"text"}]},{"type":"codeBlock","content":[{"text":"1/22/2025\t17:10:00\tInfo: \tStarted reading the datafeed\n1/22/2025\t17:10:00\tInfo: \tSELECT ID, cnd_ridingID, cnd_datafeedID FROM elc_candidates WHERE cnd_date = '2025-01-21' AND cnd_datafeedID IS NOT NULL\n1/22/2025\t17:10:00\tInfo: \t{\"recordType\":\"begin\",\"beginServerTime\":\"2025-01-22T17:10:00-0500\",\"electionName\":\"2025 Federal General Election\",\"beginOptions\":{\"heartbeat\":true,\"latestOnly\":false,\"startAt\":1}}","type":"text"}]},{"type":"paragraph","content":[{"text":"When you stop the reader it generates a log like:","type":"text"}]},{"type":"codeBlock","content":[{"text":"1/22/2025\t10:10:06\tInfo: \tStopped reading datafeed","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Heartbeat","type":"text"}]},{"type":"paragraph","content":[{"text":"You may see heartbeat messages logged and these just help to indicate that the parser is still able to receive updates from the server.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"1/22/2025\t16:25:24\tInfo: \t{\"recordType\":\"heartbeat\",\"heartbeatTime\":\"2025-01-22T16:25:24-0500\"}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Final Reports","type":"text"}]},{"type":"paragraph","content":[{"text":"Each time a riding gets its final report (when total polls = polls reporting) it logs the record with its riding number. ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"Final report for 2 with 77 of 77 polls...\n1/22/2025\t16:24:55\tInfo: \t{\n \"ballotOrderVotes\": [\n 631,\n 7250,\n 8227,\n 19467\n ],\n \"dataSourceId\": \"E\",\n \"isAdvancePollCountingComplete\": 0,\n \"isAllCountingComplete\": 1,\n \"leadingParties\": [\n \"LIB\"\n ],\n \"numPolls\": 77,\n \"numPollsFinishedReporting\": 77,\n \"recordType\": \"vote\",\n \"voteDistrictId\": 2,\n \"voteRecordId\": 184,\n \"voteRecordTime\": \"2025-01-21 13:05:22\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Dropped Connections","type":"text"}]},{"type":"paragraph","content":[{"text":"If the application loses it’s connection to the server you may see entries like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"1/22/2025\t9:54:55\tException: \tReadBuffer(): Unable to read data from the transport connection: The connection was closed.\n1/22/2025\t9:54:55\tInfo: \tReadBuffer(): done\n1/22/2025\t9:55:54\tInfo: \tReadBuffer not running. Restarting.\n1/22/2025\t9:55:55\tInfo: \t{\"recordType\":\"begin\",\"beginServerTime\":\"2025-01-22T09:55:55-0500\",\"electionName\":\"2025 Federal General Election\",\"beginOptions\":{\"heartbeat\":false,\"latestOnly\":false,\"startAt\":3431}}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Debug Logging","type":"text"}]},{"type":"paragraph","content":[{"text":"For greater details in the logs - turn on the Debug Logging option in the menu ","type":"text"},{"type":"hardBreak"},{"text":"Help - Diagnostics - Debug Logging","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If there is a checkmark beside it then it is enabled.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Debug Logging Messages","type":"text"}]},{"type":"paragraph","content":[{"text":"When Debug is enabled, it reports each record as it processes it. That way if it has an error in the processing or stops working you can know what it was doing when that happened. Example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"1/22/2025 16:24:54 Debug: [3,{\"ballotOrderVotes\":[27,22,381,372],\"dataSourceId\":\"E\",\"isAdvancePollCountingComplete\":0,\"isAllCountingComplete\":0,\"leadingParties\":[\"NDP\"],\"numPolls\":60,\"numPollsFinishedReporting\":2,\"recordType\":\"vote\",\"voteDistrictId\":6,\"voteRecordId\":3,\"voteRecordTime\":\"2025-01-21 13:02:11\"}]\n1/22/2025 16:24:54 Debug: Processing record: 3","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Exceptions","type":"text"}]},{"type":"paragraph","content":[{"text":"If you see exception type messages in the log - this indicates an unexpected error in processing. The example below happened when the part of the consortium server processes had crashed:","type":"text"}]},{"type":"codeBlock","content":[{"text":"1/22/2025\t10:09:07\tException: \tbgWorkerReadBuffer_DoWork(): Unexpected character encountered while parsing value: <. Path '', line 0, position 0.\n1/22/2025\t10:09:07\tException: \t\n1/22/2025\t10:09:08\tException: \t\n1/22/2025\t10:09:09\tException: \t502 Proxy Error\n1/22/2025\t10:09:10\tException: \t\n1/22/2025\t10:09:11\tException: \t

Proxy Error

\n1/22/2025\t10:09:12\tException: \t

The proxy server received an invalid\n1/22/2025\t10:09:13\tException: \tresponse from an upstream server.
\n1/22/2025\t10:09:14\tException: \tThe proxy server could not handle the request GET /results/elections/9/votes.

\n1/22/2025\t10:09:15\tException: \tReason: Error reading from remote server

\n1/22/2025\t10:09:16\tException: \t

\n1/22/2025\t10:09:17\tException: \t

Apache Server at test2.mediaelections.ca Port 80

\n1/22/2025\t10:09:18\tException: \t","type":"text"}]}],"version":1}

Browser not supported