🧲Dashboard Generation

When creating a Dashboard, a user must have at least one of the following Roles.

Admin
Editor

Create your first Dashboard

Access the ObX Web UI as discussed here.
Login with your Admin or Editor credentials.
From the left bar menu, Hover your mouse to Dashboard -> New Dashboard.
From the newly created Dashboard page, click on the Add a new panelthis will open the Panel's Query editor and it's properties.
From the Query editor at the Top left corner, Select the Datasource you want to pull out the data from. If you have multiple datasources attached to your current organizations, it will be part of the selection.
From the Query editor, click on the Select measurement, and select from the list of tags available in the specific datasources you have selected in step 5.
From fill(null) section, click the null options and select the none option.
You can add more query by clicking the ➕ query at the bottom of query editor, and just repeat the step 6 to step 7.
At the right side corner of the Panel editor, you can view it's different properties, you can play around with these properties to view it's different behaviour.
If you are good, you can click Apply button at the top right of the Panel editor.
Adjust the size of the Panel as for your preferred size, by just clicking and dragging the panel's corner.
You can add more Panel / widget to you dashboard by just clicking the Add panel button (at the top right corner) and then repeat step 4 to step 11.
Once you are good on you Dashboard, just click on Save button at the top right corner of the Dashboard.

Navigation on a Dashboard you have created is pretty straightforward.

Access the ObX Web UI as discussed here.
Login with your valid user credentials.
Once login, at the left bar menu, Goto -> 🔎 Search Dashboard.
This will open list of Dashboard, for instance, you can type in the name of the Dashboard you want to access.
Click on the Dashboard name to navigate on it.

Dashboard Permission

In the ObX WebUI, dashboards are initially accessible to all users. However, in certain scenarios, it may be necessary to restrict access so that only designated users can view specific dashboards. This is achieved through the implementation of dashboard permissions.

There are three (3) ways of assigning permissions on a Dashboard.

Role

By default, when a Dashboard is created, it inherits a set of permissions. These permissions are determined by the User's current role, which can be categorized as Admin, Editor, or Viewer.

User

The Dashboard's access permissions will operate on a per-user basis. This means you can alter a user's existing role specifically for a particular Dashboard. For instance, if a user is currently assigned the role of viewer, you have the ability to designate them as an editor for a specific Dashboard, thereby overriding their default permissions on a per dashboard level.

Team

The permission settings for the Dashboard will operate on a team-centric model, where permissions are assigned to each team. Consequently, all users within a particular team will inherit the permissions designated for that team. For instance, if the Maintenance team is granted the Viewer role for a specific dashboard, all users within that team will only be able to view the dashboard and not make any changes.

Assigning Dashboard Permission by User

You should be an Admin user to edit the permission of a Dashboard.

Access the ObX Web UI as discussed here.
Login with your Admin credentials.
Navigate to a Dashboard you want to edit it's permission.
At the top right corner, click on the ⚙️ Dashboard Settings. This will open the Settings window of the current Dashboard.
From the window at the left, Goto -> Permissions, you'll see here list of permissions of the current Dashboard.

By default, the permissions on a Dashboard is based on by Role. If you want to override this, you have to delete the default permission and add permission based on a User.

Under the Role section, delete the Editor and Viewer permission.
Click on Add a permission button. This will open options for adding permission.
Click on Choose -> then select User.
Choose from the list of Users you want to add.
Assign the Role (Admin, Editor or Viewer) of the selected user
Click Save.

If the default permission by Role is retained without deletion, it will take precedence over the permission set via User. Consequently, users assigned the roles of admin, editor, or viewer will maintain permissions on the dashboard. To restrict dashboard permissions on a per-user basis, it is necessary to remove the permission set via by Role.

Assigning Dashboard Permission by Team

You should be an Admin user to edit the permission of a Dashboard.

Access the ObX Web UI as discussed here.
Login with your Admin credentials.
Navigate to a Dashboard you want to edit it's permission.
At the top right corner, click on the ⚙️ Dashboard Settings. This will open the Settings window of the current Dashboard.
From the window at the left, Goto -> Permissions, you'll see here list of permissions of the current Dashboard.

By default, the permissions on a Dashboard is based on by Role. If you want to override this, you have to delete the default permission and add permission based on a Team.

Under the Role section, delete the Editor and Viewer permission.
Click on the Add a permission button. This will open options for adding permission.
Click on Choose -> then select Team.
Choose from the list of Teams you want to add.
Assign the Role (Admin, Editor or Viewer) of the selected Team.
Click Save.

If the default permission via Role is retained without deletion, it will take precedence over the permission set via by Team. Consequently, users assigned the roles of admin, editor, or viewer will maintain permissions on the dashboard. To restrict dashboard permissions on a per-Team basis, it is necessary to remove the permission set via by Role.

Dashboard Folder

You can categorize and manage your Dashboards by utilizing Dashboard folders. Similar to traditional file organization where files are grouped into folders for better organization, Dashboard folders serve the same purpose. For instance, you can organize your Dashboards based on different criteria such as Area, Plant site, or Department. This feature allows you to efficiently manage and locate specific Dashboards according to your preferred categorization.

The advantageous feature of the dashboard folder is its capability to propagate permissions from the folder level to all dashboards contained within it. This means that when you apply permissions to the folder, all dashboards underneath it automatically inherit those permissions. This simplifies the process of managing permissions for multiple dashboards based on your desired organizational structure.

Access the ObX Web UI as discussed here.
Login with your Admin credentials.
From the left bar menu, Go to -> Dashboards, then select New Folder
Enter the Folder name you want.
Press Create button.

When you initiate the creation of a dashboard folder, the system automatically directs you to that folder and grants you the capability to directly generate a new dashboard within the newly established folder.

Adding Dashboard to Folder

Access the ObX Web UI as discussed here.
Login with your Admin credentials.
From the left bar menu, Go to and Click -> Dashboards
Hover your mouse over the Folder name, you notice a Go to folder option will be visible.
Click on the Go to folder this will open the Folder configuration where you can add dashboards, library panels, permissions and settings.
Click on Create a Dashboard.
Create your Dashboard as discussed here.

When you save a newly generated dashboard, the system will still prompt you to choose a folder for its storage.

PreviousDashboard Introduction NextExcel Addin

Last updated 1 year ago