Content

Overview

OOB Functionality

Accessing OOB Dashboards

Sample Dashboard

Connection Dashboard

Testing Dashboard

My Dashboard

 

Creating and Accessing Dashboards

Creating Dashboards using the Menu Picker Gizmo

Admin Mode

Dashboard Cog Menus

Parameter Gizmos

 

Overview

Top ../images/arwup.gif (846 bytes)

"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

Top ../images/arwup.gif (846 bytes)

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):
Samples Dashboard
Connection Dashboard
Testing Dashboard
My Dashboard

 

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

Top../images/arwup.gif (846 bytes)

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.