User GuideAPI Reference
ProductUse CasesResource CenterFAQAbout UsBook a DemoSign Up - It's Free
User Guide
ProductUse CasesResource CenterFAQAbout UsBook a DemoSign Up - It's Free

Embedding a Dashboard into the BioT portals

Suggest Edits

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.

🚧

If the shared URL includes a user token, make sure to remove it before clicking share.


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

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

  1. Append "&biotUser-token={{user._refreshToken}}" to the end of the dashboard URL.

For example, the final URL should look like this: https://bi.xxx.biot-med.com/d/bdv75g6oz8etcf/my-first-dashboard?orgId=1&biotUser-token={{user._refreshToken}}


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&biotUser-token={{user._refreshToken}}&kiosk

This will ensure only the dashboard panels are displayed.

Updated 3 days ago