Embedding a Dashboard into the BioT portals

You can embed a Grafana dashboard into either the Organization Portal or the Manufacturer Portal as an external tab. Follow these steps:

Step 1: Obtain the Dashboard Link

1. Navigate to the desired dashboard in Grafana.
2. Click on the “Share” button located next to the settings icon at the top of the dashboard.
3. Copy the link URL.

Step 2: Add a Tab Using the “Portal Builder”

In this example, we will show how to add a tab to the main view. For more detailed instructions on the Portal Builder, refer to this guide

1. Log in to your Console Portal.
2. Go to the Portal Builder.
3. Edit the Main Page for the Organization Portal or the Manufacturer Portal.
4. In the Tabs Section, click on “Add Tab”.
5. Select “External Page” as the tab type.
6. Name the tab and paste the dashboard URL that you copied in Step 1.

Step 3: Dynamically Link the User Token via Cookies

To ensure the dashboard displays data for the logged-in user, you need to dynamically link the user token as a cookie.

7. Click on the "Pencil" icon (Advance Edit) next to the URL and add the cookie "biotUser-token" with the value of "{{user._refreshToken}}". It should look like this:

Step 4: Verify the Embedded Dashboard

1. Log in to the Organization Portal or the Manufacturer Portal.
2. Navigate to the main page where the Grafana tab has been added.
3. Click on the tab to load the embedded dashboard and confirm that it displays the relevant data for the logged-in user.

Note: If you log in as a Manufacturer/Organization Admin or anyone without permission to view PHI, you will not be able to access PHI data, even if it is included in the dashboard.

Step 5: Optional Kiosk- Display Dashboard Content Only

If you prefer to display only the dashboard content—removing menus, headers, and footers—append "&kiosk" to the URL address.

For Example: https://bi.xxx.biot-med.com/d/bdv75g6oz8etcf/my-first-dashboard?orgId=1&kiosk

This will ensure only the dashboard panels are displayed.