BLADE - BL Active Data Exchange
- Carrie Warner (Unlicensed)
- Jonathan Schmale
BLADE offers simplified data retrieval contained within a single URL. The BLADE module provides you access to all of your Elector candidates, riding, and party data in XML or JSON formats so that you can use the same dynamic broadcast Election content on any platform. BLADE returns results directly from the Elector database; however, it doesn't push results. Results must be requested in order for the latest data to be made available.
You can generate the URL to access to your data for formatted results in Flow. From the Home page, select System Tools > BLADE.
Candidates URL Generator
Use the Candidates URL Generator to assemble the direct query URL for Elector candidate content.
Specify URL parameters, as defined in the following table.
Click Generate to produce the query string in the specified format based on the parameters you set.
Click Test to generate data in the specified format in a new browser tab based on the parameters you set. Use the Test function to ensure appropriate results and to view the format of the output.
Copy and paste the Query String generated in your platforms as needed.
URL Parameter | Description |
|---|---|
Format | Select the data format. Select from: XML, JSON, JSONP or CSV. |
Results | If the checkbox is not set the then the data will include fields such as:
Checking the box will cause ONLY election day results to be returned with
|
Riding URL Generator
Use the Riding URL Generator to assemble the direct query URL for Elector riding content.
Specify URL parameters, as defined in the following table.
Click Generate to produce the query string in the specified format based on the parameters you set.
Click Test to generate data in the specified format in a new browser tab based on the parameters you set.
Copy and paste the Query String generated in your platforms as needed.
URL Parameter | Description |
|---|---|
Format | Select the data format. Select from: XML, JSON, JSONP or CSV. |
All Ridings | Specify all ridings, a region of ridings or a watchlist of ridings in Elector. |
Results | When the results box is not set the returned data includes:
Checking the box will cause ONLY election day results to be returned with
|
Extended Riding Result URL Generator
Use the Extended Riding Result URL Generator to assemble a direct query URL for additional Elector riding results for ridings where there is a leading candidate. Results are sorted by largest leading party or by party order in case of a tie.
Specify URL parameters, as defined in the following table.
Click Generate to produce the query string in the specified format based on the parameters you set.
Click Test to generate data in the specified format in a new browser tab based on the parameters you set.
Copy and paste the Query String generated in your platforms as needed.
URL Parameter | Description |
|---|---|
Format | Select the data format. Select from: XML, JSON, JSONP or CSV. |
Select Ridings | Choose from:
|
No Vote Ridings | When check it includes ridings that have no results yet and otherwise ridings with no results would be excluded. |
Riding Summary URL Generator
Use the Riding Summary URL Generator to assemble a direct query URL for Elector riding results similar to that found via the Riding Result Summary module.
Specify URL parameters, as defined in the following table.
Click Generate to produce the query string in the specified format based on the parameters you set.
Click Test to generate data in the specified format in a new browser tab based on the parameters you set.
Copy and paste the Query String generated in your platforms as needed.
URL Parameter | Description |
|---|---|
Format | Select the data format. Select from: XML, JSON, JSONP or CSV. |
Filter | Select a Quick Filter Option from the list. These quick filter options are a collection of real-time data filtering tools and collections of candidate Interest Option flags. |
Lead Party Sort | When checked it sorts by putting the parties with the most seats first. |
Ridings Only | When checked it returns only basic riding info: (added in build 12.6.2.4)
|
Party URL Generator
Use the Party URL Generator to assemble the direct query URL for Elector party content. Data is sorted by the party with the most seats leading or elected first, followed by the remaining parties in descending order.
Specify URL parameters, as defined in the following table.
Click Generate to produce the query string in the specified format based on the parameters you set.
Click Test to generate data in the specified format in a new browser tab based on the parameters you set.
Copy and paste the Query String generated in your platforms as needed.
URL Parameter | Description |
|---|---|
Format | Select the data format. Select from: XML, JSON, JSONP or CSV. |
Party Codes | Select from:
Party Codes control the sort order and limit which parties are included. The rest are added as OTH. If any parties are excluded then they may be summarized as “Others”. |
Results | When results are not enabled, only static party fields such as these are included:
Checking the results box will ADD a variety election day results options with data like:
Using party results, you could order the parties based on who has the most votes. The seat count/value in party results include two (2) fields: elected and leading. It represents the data available in Flow via the Manual Election Updates > Update Party Standings module. The BLADE output counts the number of elected candidates for each party and puts that count into the elected field. BLADE then takes the seat count and subtracts the number of elected candidates to come up with the value that it puts into the leading field (which cannot be less than 0). |
Chameleon Compatible Election Results
To generate a URL to export data from Elector and make it available in the same format generated by Flow for Chameleon you use the Chameleon Election URL Generator in the Riding Candidate Results tab.