Dashboards |
Content |
||||||||||||
|
Overview |
|
|
"Dashboards" display discrete collections of information within a single page. Dashboards are configured and driven by Gizmos.
NOTE: | If you are upgrading to LabVantage 8.x, be advised that
the "Classic Dashboards" prior to LabVantage 8 are now supported
by the Gizmo-driven Dashboard framework. The "Classic Dashboard"
framework has been retained to ensure backward-compatibility, but it is
hidden from the user interface. The Menu Picker and Sidebar now point to
the Gizmo-driven Dashboard framework.
Also, the SiteMap Gizmo that existed the "Classic Dashboards" prior to LabVantage 8 let you hide individual tramlines and tramstops when the Sitemap was included in the Dashboard. This capability is supported and continues to function when executing the older "Classic Dashboards". However, it is not supported in LabVantage 8 Dashboards. |
OOB Functionality |
|
|
This section describes the preconfigured set of Dashboards that are provided OOB with the LabVantage application.
Accessing OOB Dashboards |
|
LabVantage provides four preconfigured Dashboard
pages, which are accessible from the Sidebar (left) and Menu Picker (right):
|
Sample Dashboard |
The Sample Dashboard uses the SamplesDashboard Gizmo (based on the groupgizmo Gizmo Type) to collect and display Sample information.
![]() |
The Samples Dashboard includes the following Gizmos:
Gizmo | Gizmo Type | Description |
DateRange | parametergizmo | Date range over which data are collected for display by the Gizmos. |
SamplesCompletedPastDueDate | chartgizmo | Breakdown of the number of Samples completed beyond the
due date. Slices are SameDay, NextDay, ThatWeek, ThatMonth, or Longer.
Where Clause: {|createdt between trunc(to_date('[startdate]', 'mm/dd/yy hh:mi:ss am')) and trunc(to_date('[enddate]', 'mm/dd/yy hh:mi:ss am'))+1 and completedt > duedt|} |
SamplesCompleted | chartgizmo | Total number of Samples completed by month over the time
period.
Where Clause: {|coalesce(templateflag,'N') = 'N' and completedt between trunc(to_date('[startdate]', 'mm/dd/yy hh:mi:ss am')) and trunc(to_date('[enddate]', 'mm/dd/yy hh:mi:ss am'))+1|} The OOB SamplesCompleted Gizmo supports Departmental Security and excludes Sample Templates. |
SamplesTimeToCompletion | chartgizmo | Average time to completion (per day) over the time period.
Where Clause: {|templateflag = 'N' and createdt between trunc(to_date('[startdate]', 'mm/dd/yy hh:mi:ss am')) and trunc(to_date('[enddate]', 'mm/dd/yy hh:mi:ss am'))+1 and completedt is not null|} The OOB SamplesTimeToCompletion Gizmo supports Departmental Security and excludes Sample Templates. |
SamplesByProduct | chartgizmo | Breakdown of the number of Samples created by their associated
Product.
Where Clause: {|coalesce(templateflag,'N') = 'N' and completedt between trunc(to_date('[startdate]', 'mm/dd/yy hh:mi:ss am')) and trunc(to_date('[enddate]', 'mm/dd/yy hh:mi:ss am'))+1|} The OOB SamplesByProduct Gizmo supports Departmental Security and excludes Sample Templates. |
SamplesPastDueDate | metergizmo | Total number of current Samples beyond the due date. Thresholds
are "Warning" greater than 1, "Critical" greater than
5.
Where Clause: {|completedt is null and sysdate > duedt|} |
SamplesCreated | chartgizmo | Total number of Samples created by month over the time period.
Where Clause: {|coalesce(templateflag,'N') = 'N' and createdt between trunc(to_date('[startdate]', 'mm/dd/yy hh:mi:ss am')) and trunc(to_date('[enddate]', 'mm/dd/yy hh:mi:ss am'))+1|} The OOB SamplesCreated Gizmo supports Departmental Security and excludes Sample Templates. |
Connection Dashboard |
The Connection Dashboard uses the ConnectionDashboard Gizmo (based on the groupgizmo Gizmo Type) to collect and display Connection information.
![]() |
The Connection Dashboard includes the following Gizmos:
Gizmo | Gizmo Type | Description |
DateRange | parametergizmo | Date range over which data are collected for display by the Gizmos. |
ConnectionsPerDay | chartgizmo | Total number of Connections across all Users over the date
range.
Select and Where Clause: from connectionlog where connectioncreateddt between trunc(to_date('[startdate]', 'mm/dd/yy hh:mi:ss am')) and trunc(to_date('[enddate]', 'mm/dd/yy hh:mi:ss am'))+1 |
AverageSessionDuration | chartgizmo | Average length of the Connection session by User over the
date range.
Select and Where Clause: from connectionlog where connectioncleareddt is not null and connectioncreateddt between trunc(to_date('[startdate]', 'mm/dd/yy hh:mi:ss am')) and trunc(to_date('[enddate]', 'mm/dd/yy hh:mi:ss am'))+1 |
ConnectionsPerUser | chartgizmo | Total number of connections per User over the date range.
Select and Where Clause: from connectionlog where connectioncreateddt between trunc(to_date('[startdate]', 'mm/dd/yy hh:mi:ss am')) and trunc(to_date('[enddate]', 'mm/dd/yy hh:mi:ss am'))+1 |
CurrentConnections | metergizmo | Current number of Connections.
Select and Where Clause: select count(*) as measurevalue from Connection where deletedt is null |
Testing Dashboard |
The Testing Dashboard uses the Testing Dashboard (based on the groupgizmo Gizmo Type) to collect and display information about Tests, Instruments, and Analysts.
![]() |
The Testing Dashboard includes the following Gizmos:
Gizmo | Gizmo Type | Description |
DateRange | parametergizmo | Date range over which data are collected for display by the Gizmos. |
AnalystAssignment | chartgizmo | Shows a count of assignments by Analyst.
Where Clause: s_datasetstatus IN ('Initial','InProgress') and availabilityFlag='Y' AND sdcid = 'Sample' AND EXISTS (SELECT 1 FROM S_SAMPLE S WHERE keyid1=S.s_sampleid AND S.samplestatus NOT IN ('Cancelled','Reviewed','Disposed','Completed') AND coalesce(S.templateflag,'N') = 'N') The OOB AnalystAssignment Gizmo supports Departmental Security. |
TestsPastDueDt | metergizmo | Total number of current Sample Tests beyond the Due Date.
Thresholds are "Warning" greater that 5, "Critical"
greater than 20.
Where Clause: workitemstatus <> 'Completed' and sysdate > duedt|} |
InstrumentCertification | chartgizmo | Number of Instruments pending Certification by InstrumentType.
Where Clause: {|(s.expirationDT < sysdate or s.certificationstatus = 'Invalid') or i.instrumentstatus in ('Initial', 'Unavailable')|} |
InstrumentAssignment | chartgizmo | Number of Data Sets assigned to Instruments.
Where Clause: s_datasetstatus IN ('Initial','InProgress') and AvailabilityFlag='Y' AND sdcid = 'Sample' AND EXISTS (SELECT 1 FROM S_SAMPLE S WHERE keyid1=S.s_sampleid AND S.samplestatus NOT IN ('Cancelled','Reviewed','Disposed','Completed') AND coalesce(S.templateflag,'N') = 'N') The OOB InstrumentAssignment Gizmo supports Departmental Security. |
TestsCompletedPastDueDate | chartgizmo | Breakdown of the number of Tests that were completed beyond
the due date. Slices are SameDay, NextDay, ThatWeek, ThatMonth, or Longer.
Where Clause: createdt between trunc(to_date('[startdate]', 'mm/dd/yy hh:mi:ss am')) and trunc(to_date('[enddate]', 'mm/dd/yy hh:mi:ss am'))+1 and workitemstatus='Completed' and moddt > duedt |
My Dashboard |
My Dashboard uses the MyDashboard Gizmo (based on the groupgizmo Gizmo Type) to collect and display Bulletin, Sitemap, and Workflow information.
![]() |
My Dashboard includes the following Gizmos:
Gizmo | Gizmo Type | Description |
Bulletins | bulletingizmo | Displays the User's Bulletins. |
MyTasks | mytasksgizmo | Shows Workflow Tasks that can be executed by (or are assigned to) the User. |
MySitemap | sitemapgizmo | Personalizes common Tramlines and Tramstops. Note that this is not part of the Menu system. It is a sitemapgizmo configuration. |
TodaysSamples | listgizmo | Opens the Sample List page to show Samples created today. |
Creating and Accessing Dashboards |
|
|
Creating Dashboards using the Menu Picker Gizmo |
Use "Create Dashboard" in the Menu Picker Gizmo to create a new Dashboard as shown below. This creates a new Gizmo Group using the Dashboard node and opens the Gizmo in Admin Mode. You can then add Gizmos to the new Gizmo Group from the lookup as shown below.
By default, new Dashboards are not public. They are restricted to the current User, who becomes the "owner" of the Dashboard. You can use the "Group Creation Role" property in the GUIPolicy to allow Dashboard creation according to Role-Level Access.
![]() |
The "Show Dashboards" property in the menupickergizmo can be used to show/hide Dashboards rendered by the Menu Picker.
Admin Mode |
"Admin Mode" is automatically turned on when creating a new Dashboard. Admin Mode is available only to the owner of the Dashboard or a User who is in the Role assigned to the Dashboard Admin Role. In Admin Mode, the "Manage Dashboard" cog switches from black to red, and the suffix "(Admin)" is appended to the page title. Changes made while in Admin Mode are applied to the root Gizmo definition and are not applied as a User Override, i.e., the changes will apply to all Users. You are prompted to reset the Dashboard if other Users are currently using it. You can also remove Gizmos in Admin Mode using the trashcan icon.
Admin Mode can be toggled on-and-off using the Dashboard cog menu items "Turn On/Off Admin Mode". Admin Mode also provides "Dashboard Options" (see below).
Dashboard Cog Menus |
![]() |
The "Manage Dashboards" cog menu (above left) shows Dashboards accessible by the current User, and offers these options:
Option | Description |
Add Gizmo | Opens the Gizmo lookup to allow selection of a Gizmo. |
Unlock Dashboard
Lock Dashboard |
Toggles between locking the Gizmos in a stationary position and unlocking them to allow movement. |
Reset Dashboard | After issuing a prompt, resets customizations you have made and restores the Dashboard back to its created state. |
Turn On Admin Mode
Turn Off Admin Mode |
Toggles between turning Admin Mode on and off. |
Create Dashboard | Creates a new Dashboard as shown above. |
The "Admin Mode" cog menu (above right) also shows Dashboards accessible by the current User, and offers these options:
Option | Description | |
Add Gizmo | Opens the Gizmo lookup to allow selection of a Gizmo. | |
Turn On Admin Mode
Turn Off Admin Mode |
Toggles between turning Admin Mode on and off. | |
Dashboard Options | Allows changing the Dashboard title and showing/hiding
Gizmo headers on the title. If you make it a "Public Dashboard"
(for viewing by all Users), you can grant permission to "View Only",
"Move Only", or "Fully Editable". These override settings
in the groupgizmo.
|
|
Create Dashboard | Creates a new Dashboard as shown above. |
Dashboards can be inserted into the Sidebar as Gizmo Groups (see LabVantage User Interface → Sidebar).
Parameter Gizmos |
When a Dashboard contains a parametergizmo, the parameter fields are rendered in a docked section at the top of the Dashboard. The OOB Dashboards contain the DateRange Gizmo shown below. Relative dates can be used, e.g., an "Ending Date" of n+1 will update the Gizmos in the Dashboard.
A parametergizmo in a sub-group is rendered in a docked section at the top of the group tile. If a Gizmo requires a parameter in a sub-group, the sub-group is searched first and if not found, the parametergizmo will apply to the parent Dashboard. If a Gizmo requires parameters, it will prompt on load for them through a message on the Gizmo. Parameters can also be passed through the request to the page.
![]() |