Tags | Reporting |

ADMIN PRIVILEGES REQUIRED

This documentation is for Stack Overflow for Teams Enterprise. Free, Basic, and Business users can access their documentation here. Find your plan.

Microsoft Power BI (business intelligence) is a data visualization product that allows you to create interactive charts and reports.

There are many ways to connect Stack Overflow to Power BI to create a data dashboard from your Stack Overflow for Teams Enterprise (SOE) data. In this example, you'll use the Stack Overflow API v2, an automation job, Node.js, and Power BI datasets.

NOTE: This document demonstrates just one way to create a Power BI data dashboard. Because of the many variables involved, Stack Overflow does not offer support for connecting your SOE site to Power BI.

A Stack Overflow data dashboard is useful for teams who want to monitor and improve user engagement. The dashboard is a quick and easy way for teams to see how many new questions are asked, how many remain unanswered, etc. There are many insights to be gleaned from your SOE data.

StackOverflow offers an API for data access, but Power BI doesn’t connect directly to APIs. Instead, you'll use an automation job to pull data from the StackOverflow API into a data source. You'll then connect the Power BI dashboard to that data source.

NOTE: These instructions are for Stack Overflow API v2, not API v3. For best results, use API v2 for this application.

Below is an overview of how the Stack Overflow API connects to the Power BI dashboard.

These instructions demonstrate just one of the many ways you can connect your Stack Overflow site to Power BI. For this example, you'll use the following components:

You'll access a Stack Overflow API v2 endpoint with your API access key to programmatically query question data, specifically the number of unanswered questions. (These questions may have responses, but none of the answers are marked as accepted.)

Because Power BI can't access the Stack Overflow API directly, you'll store dashboard data in a different data source. Power BI supports many data sources. In this example, you'll store the data in a local JSON file for simplicity.

You'll use scheduled automation (a cron job) in a Node.js application to pull data from the Stack Overflow API and push it to the data source.

You'll use DataSets and Reports in Power BI Desktop to create your dashboard. The automation cron job will update the data in your file daily.

NOTE: This document assumes you already have Node.js installed locally.

Download and unzip the Node.js cron application from this Google drive. Install the dependencies using the npm ci command. Learn more about npm from the official npm docs.

The cron application contains only a few files, and you'll change just one: the .env.template configuration file. Copy this file, and name the new version .env. Set the following configuration variables in the new .env file:

For more information about API keys, go to https://[your_site].stackenterprise.co/api/docs/authentication on your SOE site.

When you're done editing the .env file, it should look like this:

After setting the .env configuration variables, run the program using the node index.js command. The program will continue to run until it’s stopped. You can stop running the script and cron job at any time by pressing CTRL-C.

When the cron job runs the first time, it will create a JSON file with your SOE data. To pull the data into Power BI:

Power BI will pull the SOE data in and show it in a table.

You can now build reports and visualize your SOE data. Read this Microsoft Power BI quickstart guide for more information on creating reports and charts.

NOTE: You'll need to perform a one-time, manual refresh in Power BI Desktop by clicking Refresh on the "Home" ribbon. When you click Refresh, the data in the file's model is refreshed with updated data from the original data source.

Understanding how the Node.js code works will help you make changes to better meet your own reporting needs. We'll explore the index.js file in depth below to highlight the flexibility (and limitations) of this Power BI implementation.

NOTE: This example shows just one of many possible ways to build a Power BI Dashboard using the Stack Overflow API. This script is flexible, and you can modify it to connect to other visualization tools.

The function buildRequest() builds the API request using the config() install dependencies.

The script differentiates between the Teams and Enterprise product environments based on the variables populated in the .env file. In this example, it will make an API call to your SOE site.

You'll set the API_Route variable to /api/2.3/questions/unanswered in this example to pull the number of unanswered questions. You could pull different data by changing the API_Route variable in the .env config file (see Install and configure the Node.js application above). Learn more about the available API routes at https://[your_site].stackenterprise.co/api/docs.

NOTE: API filters and pagination are beyond the scope of this example. You can set custom filters and pagination by changing the const url and headers variables. Learn more at https://[your_site].stackenterprise.co/api/docs.

The function makeRequest() uses the axios HTTP client to make an asynchronous API call.

Axios uses the data property (resource URL) and automatically stringifies data when sending JavaScript objects to the API. This makes it easy to serialize the data into a JSON string.

The function writeDataToFile() writes the API data to a JSON file. This is the data you'll upload daily into Power BI.

If you choose a different file or database, consider the following:

To accomplish this, the example script does the following in the try statement:

In this example, you used the question_id value to deduplicate the data. Depending on what API route you use, and the data it returns, you may need to set a different unique identifier. If you query articles, for example, you'd likely use the article_id value to eliminate duplicate data.

The cron job calls a function to execute the script. That function is fetchAndWriteData(), which combines the makeRequest() and writeDataToFile() functions. When first called, the fetchAndWriteData() function waits for the results of the API call in the makeRequest() function. It then uses the writeDataToFile() function to prepare (deduplicate) the data and write it to the data file.

The const nodeCron command loads the node-cron library, which is required to schedule an automation job.

You'll then schedule a cron job with nodeCron's schedule() function. In this example, the cron job executes the fetchandWriteData() function every day at midnight.

When setting your cron schedule, consider the rate limit and throttles imposed by the Stack overflow API. You can learn more about API limits and throttling at https://[your_site].stackenterprise.co/api/docs/throttle on your SOE site.

You can use other automation tools to create cron jobs, such as Azure's WebJob when using an Azure SQL database.

This example uses a simple JSON file as the database. We recommend JSON (or another file format) over a database when the data set is relatively small and you can store it in the application cache. For larger data sets, use a database. To use a database (Azure, for example), you'll need to prepare SQL tables for the data and change the function to include SQL queries.

Power BI also connects to workbooks on OneDrive or SharePoint Online, automatically checking hourly for changes to the data. If it detects that the data has changed, Power BI will refresh the data set and reports in the Power BI service.