Dashboard Widget Properties

How to read this table

Properties, Filters and Settings listed below apply for all Dashboard widgets in both Personal Dashboards and Non-Personal Dashboards. 

💡 As the widgets share concepts (e.g. filtering, thresholds), the table below is sorted alphabetically. Use CTRL+F to search for your widget or UI element.

 

INC Dashboard Widget Data Size Limitations

☝FILTER/QUERY SIZE LIMITATIONS

To keep the performance on Dashboards manageable, query limits of 200 users / 200 services each apply on filtering (e.g. when selecting very large Organization Units). This limit applies summed-up across all widgets on the same Dashboard.

💡A warning and counters will be shown when this limit is exceeded and data will not be queried.

💡(Existing) Dashboards that break this limit will not be adjusted retroactively, but also show the warning instead of the actual data query.

 
Property Related Dashboard widgets Description / Usage
Avatar
  • User State Tabular
Picture of the user as defined in the Tenant's user directory. Also shows the → Presence State as a small colored dot.
Background Color
  • Service / User KPI tile widgets

A choice of background colors.

💡 The font color inverts automatically increase contrast on bright colors.

Colors (Value thresholds)
  • Heatmap widgets
  • Any “Tabular” widgets
  • Any “Tile” widgets

Colors can be applied:

  • ...for tabular widgets, color applied to the respective cell / KPI column upon reaching a threshold criteria match.
  • ...for tile widgets, color applied to the whole tile as base and changed upon reaching a threshold criteria match.

On Heatmaps the colors are fixed as follows:

  • <ChartColors.BittersweetRed> 0% - 2% tasks have been handled
  • <ChartColors.BittersweetRedFawnOrangeTransition> 2% - 33% tasks have been handled
  • <ChartColors.FawnOrange> 33% - 63% tasks have been handled
  • <ChartColors.FawnOrangeMountainMeadowTransition> 63% - 98% tasks have been handled
  • <ChartColors.MountainMeadow> 98% - 100% tasks have been handled

🔎 Also see → Thresholds.

Columns
  • Any "Tabular" widgets
  • Service Supervision widgets

Determines which columns get shown in a tabular widget.

💡 To reorder, drag and drop the entries       

During Edit Mode you can do the following:

  • Change the column width by dragging the handles between columns (shown on mouse-over)
  • Change the default column sorting order by clicking on the header.

Content
  • Markdown

Uses → Markdown language to show content of your choice. Supported features are:


☝ Other extended Markdown Syntax may work, but break the widget layout.

Controls
  • Service Supervision

 🔍This column relates exclusively to Supervision widgets.

✅ You require "Supervisor" User Roles to use the controls. Refer to Dashboard Supervision for details.

Data Source
  • All "user" widgets
  • All "service" widgets

☝ Attention: Your previous data source selection is removed when switching between options below. If you need to filter with different sources (e.g. specific users and Organization Units), create two separate widgets instead.

Select a type of data source with the following options:

  • Services - (for "Service" type widgets). Shows all services based on your roles and memberships. → Also see User Administration > Services tab.
  • Users - (for "User" type widgets). Shows all users based on your roles and which are part of your services. → Also see Service Administration > Users tab.

Organization Units - ✅ SUPERVISOR Role: You require a service / user supervisor role granted for the corresponding Organization Unit to see entries.  → Also see User Administration > Roles tab.

Service Type "Supervisor" Role applied
"Service" Type widget OU selection
 
Date and Time (widget)
  • Date and Time

Note: Properties below are unique to the "Current Date and Time" widget:

  • Allows to select a clock type: Digital or Analog design
  • Allows to show and set a time zone (UTC offset)
  • Allows to show current date and set a format
  • Allows to show current time as digits (e.g. in addition to analog format or if only a date should be shown) and set the time format.
  • Allows custom content, can be formatted with markdown. See → Content
Due Date
  • Service Outbound Tasks Tabular

Limit the list of scheduled Outbound Call tasks that only match the due date criteria.

 

🔍 Outbound tasks are created and manipulated via Flow Actions of the Microsoft Power Automate Connector.

Filters    
(Widget Filters)

Filters narrow down entries in widgets. Based on the widget type the following filters are available:

  • Busy Hours (Heatmap Widget) - Hides columns without data, showing only data points with recorded values, down to a minimum of 5h on a day.
  • Duty Profiles → Shows the duty profile of users. 🔍 See Responsibility Profiles and → Skills and Responsibilities.
  • Duty States (Duty, Off Duty) . 🔍 See → "Duty Profile" column in user-type widgets.
  • Level (of Distribution) in .  🔍 See →Distribution Policies.
  • Modality (channel) used for the task. 🔍 See Supported Modalities.
  • MS Teams Presence State (Available, Busy, Away, DND, BRB, Offline)
  • Nimbus Service Task States (In IVR, In Queue, In IVR After Queue, Connected, Parked, Transferring)    
    🔍 Also see → "States" entry in this table.
  • Tasks (All, Handled, Not Handled)    
    🔍 Also see → Nimbus KPI Calculations for details on task resolution.
  • Type (of operator >, >=, <, <=). Used in conjunction to filter e.g. user lists by a certain time in state (e.g. ACW or RONA).

🔍 Notes

  • Filters apply entries selected via → Data Source field. (either Services, Users or Organization Units)
  • You need to be "owner" of services on which you want to apply user filters on.
  • GDPR Refer to User Roles for a detailed overview on which user role can see  the data you showcase in a Dashboard widget.
  • For more clarity you can apply → Thresholds with → Color values to your filters 
 
Height
  • All widgets

Determines grid tiles used by this widget.

💡 widgets may snap back to certain min / max grid sizes depending on widget type, e.g. to allow a minimum of content being shown.

💡 While in "Edit mode" you can also adjust the widget height via the handles on its bottom-right.

Items per Page
  • User State Tabular

For tabular widgets, amount of entries to show before pagination should occur. 

Orientation
  • Service KPI Comparison Chart

For bar chart widgets, shows the bars in either horizontal (X-Axis) or vertical (Y-Axis) direction.

KPI (Metrics)
  • Any "KPI" Type widget

Various Key Performance Indicators (KPI), also used within "Live" Reporting for each service.

  • In queue, TASK(S)
  • Connected, TASK(S)
  • Active, MEMBER(S)
  • Available, MEMBER(S)
  • Not Available, MEMBER(S)
  • Longest waiting task, (hh:)mm:ss  

"Historical" / based on →  TimeFrame

  • Acceptance SLA, % 
  • Accepted by user in SLA, TASK(S)
  • Accepted by user, TASK(S)
  • Handled by System, TASK(S)
  • Handled rate, %
  • Hangup SLA, %
  • Hangup before accept, TASK(S)
  • Hangup by workflow, TASK(S)
  • Hangup in IVR after Queue, TASK(S)
  • Hangup in IVR, TASK(S)
  • Hangup in queue in SLA, TASK(S)
  • Hangup in queue, TASK(S)
  • Not handled, TASK(S)
  • Queued, TASK(S)
  • Reachability, %
  • Total, TASK(S)
  • Transferred by workflow, TASK(S)
  • Voice message, TASK(S)
  • Ø Connected time, (hh:)mm:ss
  • Ø IVR time, (hh:)mm:ss
  • Ø Queue time, (hh:)mm:ss

KPI NOTES ON WIDGET BEHAVIOR

  • Average calculated KPI values are weighted against the total amount of items (Tasks, Handled Calls, Reachability, etc.) within the services specified in your widget → Filter. This is to ensure that - for example - a service with just one failed call showing a 0% handled-rate does not negatively impact overall KPI metrics of services with thousands of calls with a 99% handled-call rate..
  • Selection of a KPI criteria will automatically restrict other fields to the same type. (e.g. tasks, time, percentage) The dropdown list is filtered automatically as you add more KPI to an existing widget.      
    💡 Example: On a comparison chart, picking any KPI of type "Task" will limit further values to be selected to task-based KPIs. This is to keep the axis reference and unit count consistent. → To show different KPIs, either start a separate widget or delete any KPI entries, switching the last entry to a different criterion (percentage, task, user, time, etc.).

💡 Tip: Some widgets allow to display a single KPI name in the → Title field. The placeholder <KPI> will dynamically get replaced with your selected KPI.

 

KPI UNITS AND THRESHOLDS

Some widgets allow to define → Thresholds to react to KPI value changes with color and sound. Note that;

  • Changing your KPI metric type (e.g. from percentage to a flat numbers) will delete any of your defined threshold entries as they are now invalid.
  • Switching to the same type (e.g. from % to %) will retain the thresholds you defined previously.

💡 Tip: If this happens to you by accident you can restore your previous threshold settings by cancelling the widget edit, which discards your changes.

 
Legend
  • All Graph and Chart widgets

Allows to hide or show a KPI legend on any side of the widget.

Options: Hidden, Right, Bottom, Left, Top

💡 When "Hidden" is selected, the legend can be accessed via mouseover on an info-icon in the widget corner.  

Level
  • Live Service Tasks Tabular
  • Service Queue Tabular

Shows the level of call (task) escalation in a service queue. A user's individual Duty State (and associated Responsibility Profile ) determines at which level they are considered for calls. Skills and Responsibilities are defined for each user. Only users matching the criteria are selected for calls. 

→ See Filters .

🔍 Level escalation is defined in a Distribution Policy and applied in the Distribution Service Settings of the respective Contact Center Service

Look Back Chart
  • Service KPI Chart

💡 This widget property can be combined with a → Trend indicator, or used standalone.

  • Toggle (on/off). When enabled, displays a a look back chart.
    • Based on selected lookback options: 30, 14, 7 or 5 days
    • Default: 5d
  • When the "Look Back Chart" is enabled you can can also show/hide a value axis

Look Back Chart with value axis. Detailed datapoints are shown on mouseover

Presence State
  • User State Tabular
  • User State Chart
  • User Supervisor Tabular

Narrows down Users the MS Teams Presence Status (Available, Away, BRB, Busy, DND, Offline, Unknown)

→ See widget Filters .

Primary KPIs
  • Service KPI Graph

Optional KPI to show on the left Y-Axis. Can either be:

  • Tasks
  • Time
  • Percentage

Up to 4 Metrics of the same type can be shown (stacked).

🔍 Also see → KPI for details on each Metric.

Priority
  • Live Service Tasks Tabular
  • Service External Tasks Tabular
  • Service Queue Tabular

Column showing the 🔎 Task Priority of incoming calls. Tasks are distributed in a Round-Robin method.

Note that “Strict” priority tasks take precedence while “None” priority may get starved by any other priority tasks. Read more on this on the Task Priority page.

 

 

Retries Left
  • Service Outbound Tasks Tabular

Limit the list of Outbound Service Call / Call On Behalf tasks that only match the remaining retries criteria. 

💡 A retry is one attempt to distribute an outbound call to a user. If the Nimbus user (Agent) does not respond in time, this number is incremented up until a specified maximum.

🔍 Tasks retries are specified and manipulated via Flow Actions of the Microsoft Power Automate Connector.

Scale      

 
  • Any widget

Text and Element scaling within the widget. 

💡 Does not impact → width or → height of the widget itself. Overflow will result in scroll bars shown inside the widget.

Secondary KPIs
  • Service KPI Graph

Optional KPI to show on the right Y-Axis. Can either be:

  •  
    • Tasks
    • Time
    • Percentage

Up to 4 Metrics of the same type can be shown (stacked).

🔍 Also see → KPI for details on each Metric.

States
  • Live Service Tasks Tabular
  • Service Outbound Tasks Tabular
  • Service External Tasks Tabular

Determines the status of a task, as it used in other views and for Reporting.

  • Outbound Service Calls are filtered by states:
    • Scheduled - while scheduled it can be deleted or properties changed
    • In Progress - while in this state, changes or deletion of the task properties are not possible
  • External Tasks are filtered by states:
    • In IVR, In IVR After Queue, In Queue, Connected

🔍 Tasks are created and manipulated via Flow Actions of the Microsoft Power Automate Connector.

Supervision Active
  • Service Supervision

Status indicator for when Supervision → Controls were used.

🔍 This column relates exclusively to Supervision widgets. Refer to Dashboard Supervision for details.

Threshold (Filters)
  • Live Service Tasks Tabular
  • Service KPI Tabular
  • Service KPI Tile
  • Service Supervision
  • User State Tabular
  • User Supervisor Tabular

Applies an event threshold that reacts to a specified KPI (or column in tabular widgets).

The threshold criteria are as follows:

Rules
  • Rule matching happens from top to bottom upon first "match" the threshold evaluation is aborted.
  • The order can be changed with the drag & drop handles located on the left of already defined threshold list entries.
Values
  • Values depend on the → KPI selected for the threshold (e.g. number of tasks members, or percentage of handled calls).
  • Non-numerical entries (e.g. User Presence State) can also be affected, e.g. when a presence state exceeds a certain "Time in State" threshold. Here is an example:

☝ Note that changing your → KPI metric type (e.g. from percentage to flat numbers) deletes the defined thresholds.

Display Format

The display format is picked based the chosen KPI

  • %: default to "100%"
  • tasks/users: defaults to "0"
  • hh:mm:ss: defaults to "00:00:00" with timepicker
Sound

Plays a sound when the threshold criteria is met coming from either below or above the designated value.

Time Frame / Scope
  • Service KPI Tabular
  • Service KPI Tile
  • Service KPI Graph
  • Service KPI Chart

Narrows down shown data by time: 

  • Today (current)
  • Last 48hours
  • last 7days
  • last 30days

💡 Used mainly for "historical" → KPI , e.g. Task that have concluded with a definite result.

Time in State
  • Live Service Tasks Tabular
  • Service Supervision
  • User State Tabular

Tracks the time (upwards counting) since the Service / User state has changed. Depending on the widget this column tracks different times: 

  • For Tasks it counts the time since the last call task state change in the system: In IVR, In Queue, In IVR After Queue, Connected, Parked, Transferring
  • For Presence States changes it counts the time since the user's MS Teams messenger presence has changed: Available, Busy, Away, DND, BRB, Offline.
  • For Supervision sessions it counts the time since the user is in an active call session that allows for Supervision → Controls to be used.

💡 We recommend to combine this column with → Thresholds to mark entries that have exceeded a certain time limit.

Title
  • Any "<KPI" Type widget
  • Markdown widget
  • "Tabular" widgets
  • "State" widgets

Customizable widget title. Can be hidden for some widgets via "Show Title" Toggle.

💡 Dynamic KPI Title Placeholders: In widgets that show a single KPI the title can include a <KPI name placeholder> and mixed with your text.      
💡 Example"My Service <KPI>" resolves into "My Service Acceptance SLA"

URL (external Website)
  • Embedded Website

Used to specify an embedded website.

 The URL must start https:// - insecure websites are not allowed.

WEBSITE EMBEDDING LIMITATIONS

Some websites prevent IFrame embeds on remote sites, which cannot be circumvented. When you try to embed such protected URLs, errors like 401 (unauthorized) or a "Refused to Connect" message will be shown instead of your desired output.

✅ Possible Workarounds:

  • If available, consult your external source website support to check if any iframe-referrals are allowed. Some services offer specialized data widgets for that purpose or provide authorized token-URLs that you can use.
  • If you have access to whitelists on your source website, try to allow the *.luware.cloud domain.

Learn more...

There are two types of HTTP headers in websites that control iframe loading:

X-Frame-Options: DENY

Content-Security-Policy: frame-ancestors 'none'

The HTTP Content-Security-Policy specifies valid parents that may embed a page using <frame>, <iframe>, <object>, or <embed>.

A website header called x-frame-options specifies the access prevention, determined via the following values: 

  • if set to DENY the site isn't allowed to be loaded in iframe 
  • if set to SAMEORIGIN the page can only be embedded in a frame on a page with the same origin as itself.
  • if set to ALLOW-FROM the page can only be displayed in a frame on the specified origin. This only works in browsers that support this header.

🔍 Related Sources:

 
 
 
Trend Indicator
  • Service KPI Chart

💡 This widget can be combined with a → Look Back Chart, or used standalone.

  • Toggle (on/off). When enabled, displays a Trend Indicator if available for the selected KPI. A trend is calculated as follows:
    • Based on selected lookback options: 30, 14, 7 or 5 days
    • Default: 30d
  • When the Trend Indicator is enabled you can can also configure if "Upward trend is"
    • Positive (Green), Negative (Red), Inconclusive (Blue)
    • Default: Positive

Total Task trend with inverted positive (red color) setting

Type (of widget Filter)
  • Service Outbound Tasks Tabular

The type of service (inbound / outbound).

💡 Depending on the widget this filter may be limited to a preselection.

  • User State Chart

Determines what type of User States the widget should display.

  • User Presence State: Displays the MS Teams Presence Status (Available, Away, BRB, Busy, DND, Offline, Unknown)
  • User Duty State: Displays the Duty States of the user (On Duty: Available, On Duty: Not Available, Off Duty)
  • User Duty Profile: Displays the current Duty Profiles selected by users (Duty, Off Duty)

💡 Note that after selection additional filters to narrow down the states become available.

  • User Supervisor Tabular

Allows to filter entries by inequality operators " >, >=, <, =<" for: 

  • Time spent in ACW (After Call Work).
  • Time spent in Extended ACW.
  • Time spent in RONA state.

All times are specified in hh:mm:ss

🔍 Note that RONA and ACW values can be adjusted via Distribution Service Settings for each Service.

Width
  • All widgets

Determines grid tiles used by this widget.

💡 widgets may snap back to certain min / max grid sizes depending on widget type, e.g. to allow a minimum of content being shown.

💡 While in "Edit mode" you can also adjust the widget width via the handles on the widget's bottom-right corner.

Table of Contents