Indicator data on fabriq

💡 On fabriq, can currently check their teams' performance in the KPIs/Performance section of each team's workspace. Team admins can decide which indicators should be displayed and how frequently they are to be updated.

This short tutorial is aimed at teaching you the ropes about indicators on fabriq as well as the different ways to get us the data.

The basics 🎠

Every team in fabriq has a Performance tab in which a set of Key Peformance Indicators are displayed.

While many indicators may have homonyms (e.g. "OTD%" for team 1 and "OTD%" for team 2, each indicator is a unique data element with a unique ID. It is important to note nonetheless that a given indicator may be displayed to several teams. Case in point: as a site director, you may want to display the overall OTD% (On-Time Delivery) to all of the site's teams.



Finding an indicator's unique ID 🎫

To automate (or semi-automate) the upload of performance data, it will be essential to know the unique ID of each indicator whose data you wish to update.

To find an indicator's ID, simply navigate to the indicator's pop-up by clicking on it. The indicator's ID will just under the name of the indicator:



Conversely, when creating an indicator in the backend admin, the indicator's id will be displayed:



Indicators and data points

To each indicator is attached a series of data points, consisting in:

- An end date (required)
- A value (required)
- A target value (required)
- A true/false variable to indicate whether the target was met (true = target was met)

ℹ️ Note: At this point, fabriq does not prevent more than one data point to exist

Sending us your KPI data 📊

Currently, there are 3 ways to put up indicator data on fabriq. You'll find a basic tutorial below for each.

1. The old fashioned way 🤠

Any indicator may be uploaded manually via the the app. Simply navigate to the indicator's pop-up by clicking on the edit button next to the corresponding indicator in the KPIs section.

ℹ️ Note: this feature requires you to be an admin of one of the teams where the indicator is displayed

From there, you'll access the full series of the indicator's data where you may create, edit and delete data points.



ℹ️ Note: as of today, other users need to refresh the page in order for the new indicator data to be synced

2. Batch upload 🚛

As a client admin, you have access to the batch upload feature. This allows you to upload a .xlsx spreadsheet to the app and add / update any

ℹ️ Note: in the batch upload, any existing data point for a given indicator on a given date will be overwritten if a matching combination is included in the new batch



Simply upload the .xlsx file in the and the data points will be automatically synced. If a data point is not successfully uploaded (e.g. missing data, format issue), an error message will be displayed.

✋ Important: it is very important to precisely follow the template format which can found here ⇒ .XLSX TEMPLATE 💾

ℹ️ Note: as of today, other users need to refresh the page in order for the new indicator data to be synced



3. Connecting to our open API 🔌

(👩‍💻👨‍💻 Developers only 👩‍💻👨‍💻)

IT Teams, please get in touch with us (dev@usefabriq.com) and we will provide you with an API key. Referred to as (YOUR_API_KEY) below.

To create a new data point, please follow the following format below where id denotes the id of the indicator for which you which you wish to post data point(s).

URL

POST
https://api.usefabriq.com/api/indicator/**id**/datapoints/

Authentication header

Authorization: "Bearer YOUR_API_KEY"

Body

Important: 1 call = 1 datapoint. You must call the endpoint as many times as the number of data points you want to upload.

Payload format & example

{
end_date: "2019-07-31" // date string: yyyy-mm-dd
value: "12.00" // decimal – the value of the data point
target: "15.00" // decimal – the target vaue
target_met: false // Boolean(true|false} – target has been met = true
}

That's all folks! 🎬

Questions? Comments? Get in touch at dev@usefabriq.com
Was this article helpful?
Cancel
Thank you!