BLADE - BL Active Data Exchange

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.

  1. Specify URL parameters, as defined in the following table.

  2. Click Generate to produce the query string in the specified format based on the parameters you set.

  3. 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.

  4. Copy and paste the Query String generated in your platforms as needed.   

URL Parameter

Description

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:

  • candidate ID

  • First and last name

  • party ID

  • on-air and full insight text

  • candidate interest options set

Checking the box will cause ONLY election day results to be returned with

  • candidate ID

  • candidate votes

  • elected

  • acclaimed

Riding URL Generator

 Use the Riding URL Generator to assemble the direct query URL for Elector riding content.

  1. Specify URL parameters, as defined in the following table.

  2. Click Generate to produce the query string in the specified format based on the parameters you set.

  3. Click Test to generate data in the specified format in a new browser tab based on the parameters you set.

  4. Copy and paste the Query String generated in your platforms as needed. 

URL Parameter

Description

URL Parameter

Description

Format

Select the data format. Select from: XML, JSON, JSONP or CSV.

All Ridings
Region
Watchlist

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:

  • Riding ID

  • Riding Names (all variations)

  • Polls

  • Poll Closing Time

  • Regions

  • Previous Party

  • Notes

Checking the box will cause ONLY election day results to be returned with

  • Riding ID

  • Polls Reporting

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.

  1. Specify URL parameters, as defined in the following table.

  2. Click Generate to produce the query string in the specified format based on the parameters you set.

  3. Click Test to generate data in the specified format in a new browser tab based on the parameters you set.

  4. Copy and paste the Query String generated in your platforms as needed. 

URL Parameter

Description

URL Parameter

Description

Format

Select the data format. Select from: XML, JSON, JSONP or CSV.

Select Ridings

Choose from:

  • All ridings

  • A Region

  • A Watchlist

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.

  1. Specify URL parameters, as defined in the following table.

  2. Click Generate to produce the query string in the specified format based on the parameters you set.

  3. Click Test to generate data in the specified format in a new browser tab based on the parameters you set.

  4. Copy and paste the Query String generated in your platforms as needed.   

URL Parameter

Description

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)

  • Riding ID

  • Riding Name

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.

  1. Specify URL parameters, as defined in the following table.

  2. Click Generate to produce the query string in the specified format based on the parameters you set.

  3. Click Test to generate data in the specified format in a new browser tab based on the parameters you set.

  4. Copy and paste the Query String generated in your platforms as needed. 

URL Parameter

Description

URL Parameter

Description

Format

Select the data format. Select from: XML, JSON, JSONP or CSV.

Party Codes

Select from:

  • all parties (all)

  • parties of interest (mains)

  • custom

    • Example: SP-NDP-LIB-GRN

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:

  • Party ID

  • Party Name

  • Party Code

  • Is Main Party indicator

Checking the results box will ADD a variety election day results options with data like:

  • Elected count (the number of ridings where a candidate is actually marked elected)

  • Leading count (ridings where the candidate is leading but not declared elected)

  • Seat count (ridings where the candidate is leading or elected)

  • Seat change

  • Color

  • Votes for the party

  • Vote percentage

  • Vote percentage change

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.