Working on your dashboard

BioT User Token

To begin working with your data, you need to append your BioT user token to the URL.

1. Log in to one of our portals (Console, Manufacturer, or Organization) to copy your user token details.
2. At the top right corner of the page, click on the user icon, then select “Copy token”.

🚧

Do not log out after copying the token, as this will invalidate the token.

Now that you have your token, you'll need to include it as a query parameter in your dashboard URL. The query parameter for the token is &biotUser-token.

🚧

Note: Query parameters are case-sensitive, ensure that you enter them exactly as shown.

Go back to the dashboard you’re working on and append the token to the URL in this format:

https://bi.xxx.biot-med.com/dashboard/new?orgId=1&editPanel=1&biotUser-token='token_value'

Press Enter and your token will be applied, allowing you to continue interacting with your dashboard seamlessly.

Writing queries to interact with Analytics DB

When creating a new dashboard, you'll begin with an empty panel, as shown below:

Step 1: Switching to the "Code" Tab

To start writing queries, switch from the default “Builder” tab (which is not supported at this stage) to the “Code” tab. This allows you to interact directly with the Analytics DB. You can add multiple panels to your dashboard by clicking the “Add Query” button.

Step 2: Writing Queries

Once you're in the "Code" tab, you can write SQL queries to pull data from the Analytics DB.

For example, to retrieve all device IDs, use the following query:

SELECT "_id"
FROM "AnalyticsDB"."DeviceType1_device"

Executing this query will display results like the screenshot below:

You can find more details on how to interact with the Analytics DB, here.

🚧

Please note the following user permissions:

• Manufacturer/Organization Admins: Cannot access PHI (Protected Health Information).
• Caregivers: Can only access data associated with their organization.
• Patients: Have no access to data.

It is the query creator’s responsibility to ensure that the appropriate permissions are respected when viewing PHI details.