Luware BI Template Files
INC Nimbus Power BI Files
✅Luware provides the following Power BI Files. Contact Luware Support or your Customer Success Specialist to get the latest version.
Description | Filenames | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Power BI Template / Report |
Nimbus.pbit / Nimbus.pbix ✅ When using a Template (.pbit), please add your connection parameters and credentials and perform a basic query. Afterwards, save it as a .pbix report, as it will use considerably lower RAM/CPU than a template. |
|||||||||||||||
Paginated Reports |
|
|||||||||||||||
Legacy Template | Nimbus_AppendLegacy.pbix 💡 A special variant to support users coming from our existing LUCS/TM products → As newcomer to "Nimbus" you can skip this info and refer to the "Power BI Template" instead. Learn more...Legacy Template Use cases Legacy support is available for LUCS/TM versions 3.5+
Example BI Template with both Nimbus and legacy data combined 💡 Note: Service names from legacy data sources have original GUIDs and "legacy_" prefix names, as shown highlighted here. You may need this template in 3 scenarios:
🔍 Refer to the → Parameters below for further notes on each scenario. Report parameters The legacy template contains a set of additional parameters for connecting to the LUCS or Team Manager SQL Server database.
Please note in regards to the 3 scenarios above:
Parameter settings in Power BI |
Template Overview
The Nimbus BI template consists several views/tabs:
- Service Overview - Service Session KPI aggregated by service.
- User Overview - User Session KPI aggregated by user.
- Session Details - KPI by service session (can be used to drill down into a KPI from Service Overview).
- User Session Details - KPI by user session (can be used to drill down into a KPI from User Overview).
- Tags-Codes - Tags and Codes as recorded in My Sessions view by users.
- Unified Sessions - Provides the details of the end-2-end concept of a conversation in the business world (e.g. an end-2-end call). A session is a transaction in Nimbus, a unified session can contain one or more service sessions and user sessions.
- User States - Provides duration KPI aggregated by user and state type as well as profile names and not available reasons (if applicable), based on every single state change recorded in User States
- Transfer - Provides a high level view of transfer sessions volume, as well as a grid with details of each transfer.
- Info - Template versioning, session volume and other technical details needed when opening support tickets with Luware.
- Data Load Check - Shows a data count and summary for each main KPI table, as well as the timestamp of first and last session record for each table. This is especially useful with incremental refresh to evaluate the volume of data loaded in the report as well as the completeness and freshness of the data in each KPI table.
🔎 Each tab is described in further detail below. Data shown is based on the Nimbus Reporting Model.
💡 The Nimbus KPI Calculations are completely done in the product itself, the report does only query the results.
Template Tabs
GOOD TO KNOW
To switch between the tabs and views:
- Hold CTRL and left-click on the icons at the left hand sidebar
or - Use the tabs at the bottom of the report to navigate
Also noteworthy:
- In Power BI Desktop you must use CTRL + Click on buttons and links, otherwise you may just select fields in the template for editing.
- CTRL is also used to multi-select filtering options and list entries.
- Arrows indicate Drill-Through possibilities into further data.
Overview pages
Service and User Overview
Service and User Overview provide a general overview of the sessions associated with a user or a service. Here you may find:
💡 You can drill through a selected user session for details as described in the “How to use” chapter below. | |
Session Detail pages
Session Details and User Session Details
Session Detail pages give a closer look on the distinct sessions accrued on the Service / or the User.
💡 You can drill through a selected session for details as described in the “How to use” chapter below.
Tags and Codes
Tags and Codes
Tags and Codes specified by users during (via the My Sessions UI) are shown as a tag cloud in reporting. The bigger the tag shown, the more frequent it has been used.
For example you can click on tags to ...
- ... narrow down data by call sessions that used these tags.
- ... identify months where tags have been used more frequently.
Unified Sessions
Unified Sessions
Lists Caller (customer) data like PSTN or Name, the Caller path and connection times with the final session outcome.
💡 Click on a Session, then CTRL+Click the button on the bottom to show further details. Also see “How to use” chapter below.
User States
User States
This tab lists User States, also referred to as "Team Enability" (e.g. the On/Off Service participation toggle in the Frontend UIs during daily use of Nimbus).
PRECONDITIONS
Contact Center Licensing - please note that reporting on tracked User States is a Contact Center feature.
✅Feature toggles
✅Tenant Admin Feature Toggle - To gather User State data, this feature needs to be enabled for your tenant. This is done via Tenant Administration > Data Privacy > "Persist User States in Reporting" option.
You can learn more about each feature in the Tenant Administration pages.
✅ Power BI parameters - In the Power BI template, the connection parameter “Load User States” must be set to “True” before refreshing the dataset.
☝Impact on your Data Query: Tracking presence states can generate considerable amounts of personal user data. Aside from Power BI query performance considerations on a large userbase you need to consider privacy and EU GDPR compliance before enabling this feature.
🤔 What User States data is being tracked? User, User ID, Organization Unit, Responsibility Profiles (User State), MS Teams Presence Status and all related event changes with timestamps and durations.
✅ Supervisor Role Requirement
User Supervisor Role - The user refreshing the Power BI report must be a Nimbus User Supervisor (this role can only be assigned to a user with a Contact Center license).
- The User States tab in Power BI will not show any information unless you have this role assigned via the User Administration. More infos on this role can be found on User Role (RBAC) Matrix.
- The Nimbus User Supervisor will see user states for all users in the supervised OUs irrespective of whether such users have a Contact Center license or not.
Organization Units dependency - The Nimbus User Supervisor will only see the user states for the users in the Organization Units they are explicitly assigned to (as a Supervisor).
LIMITATION BY DESIGN If a user has only Supervisor and not a Team Owner / Service Admin role, only the "UserStates" dataset in the report will be shown, consisting of: UserStates, StateTypes, ResponsibilityProfile, OU, Users. Other tabs and queries in the BI Report may appear blank.
→ This is intended by design to prevent exposure of individual Service/User/Session data to the wrong audiences. To see a full dataset, the same user also needs a "Service/Team Owner" role assigned.
🤔 What are user states?
User States
For its Reporting Model Nimbus distinguishes sessions by various user state factors (Teams Presence, Duty State, Task Selectability, Task status). A change in either factor has influence on the others, either being a requirement or dependency.
User Factor | Conditions | Nimbus-Tracked User State | ||||||
---|---|---|---|---|---|---|---|---|
Presence in MS Teams |
✅ Online – including status "Busy" or "Away" (individually defined per Distribution Service Settings) |
Online MS-Teams based services will distribute when "Active". |
Online and set "Active" MS-Teams based services will distribute. |
Online and "Active" but Busy/Away Can either be selectable or not ↓ (determined per each Service's Distribution Service Settings) |
||||
✅User is online and has any "On Duty" responsibility profile selected. |
OffDuty An "OffDuty" profile prevents any Contact Center participation. |
On Duty Any "Duty" type responsibility profile allows Contact Center participation. Skills and Responsibilities in that profile must match the service to be "Selectable". This is determined by the individual Distribution Policies assigned to the respective services. |
||||||
Task selectable |
“In Time available” to perform tasks in Nimbus: ✅Online in MS Teams. |
"Selectable" This includes Busy/Selectable and Away/Selectable |
"Non-Selectable" state, either because: … User is not available either due to the MS Teams Presence ↑ OR … … set "inactive" for all Nimbus teams OR … ... any existing or previous Call Status ↓ marks the user as “Not Selectable” |
|||||
Task status |
✅ Currently reserved and blocked for a Nimbus task.
|
Not Available Reason Requested as user changes MS Teams presence (back from idle). |
RONA User flag after not responding to a task, blocked for the next tasks. |
Ringing User reserved for new task, but has not accepted yet |
Connected User accepted task, is blocked by |
ACW User extensible timespan to complete work after a call. |
USER STATE DEPENDENCIES
💡 It is important to note that these user state factors depend on each other. Reading the table vertically from “top to bottom”. Here is an example:
Layer 1: MS Teams Presence
- The MS Teams Presence must meet the criteria of the Distribution Service Settings. This can be individually configured per Service.
- Offline users are not considered to be in any duty state. Nimbus will not distribute tasks.
-
Online users are considered for Nimbus Tasks depending on:
- … the Nimbus features (license) applied to the user and …
- … the services they are part of.
Layer 2: Nimbus Duty State / Task Selectability
Selectability for Nimbus tasks is steered based depending on the Service Types and their varying
Advanced Routing and Enterprise Routing | Contact Center |
---|---|
Scenario: MS-Teams “Team” based services | Scenario: Standalone Services with a varied user base |
Advanced Routing and Enterprise Routing consider Users selectable once they are to “Active” in the Nimbus UI. |
Contact Center services apply the Duty State as a “selectable check” – on top of MS Teams presence. Nimbus evaluates the users's responsibility profile and distributes calls conditionally based on the Skills and Responsibilities behind that profile. The criteria are defined in the service's Distribution Policy. |
LAYER 3: TASK STATUS
These are shared criteria among services
- While "online", "active" and "on duty" a user is “selectable” for tasks by either service, in any modality.
- While being in any blocking call status (e.g being Not Available, already busy when connected or in a task, in ACW or flagged by RONA) will consider the user as "Not selectable" for any service.
Nimbus Reporting and User State Data privacy
🔍 Learning: Users have one deterministic state at a time. Combined user states listed above – and their changes over time – form a "User Session" which is tracked as part of the Nimbus Reporting Model.
GDPR Data privacy setting: Detailed user states can be tracked with timestamps for later evaluation analysis, e.g. in Power BI. This is enabled via Tenant Administration > Data Privacy, and included in historic reporting.
The DataWareHouse distinguishes by the following user states:
- After Call Work
- Connected
- Not Selectable
- Off Duty
- Offline
- Ringing
- Selectable
🔍 Also see Nimbus Reporting Model→ User States table.
Transfers
Transfers
Allows to inspect where sessions are transferred to and to which result, so involved services can be optimized accordingly.
Can be filtered by:
- Start Date Time
- Service From
- Service To
Provides the following Visuals:
- Pie Chart "Transfer by"
- Pie Chart "Transfer by Result"
- Transfer Flow Diagram by Service
- Source Service
- Destination
- Service by Name
- External
- User
- Grid “Transfer Overview”
RELATED NOTES
- For related OData Tables on static dimensions and facts see Nimbus Reporting Model→ “Transfer Sessions”
- If there was more than one transfer session occurring during a single service session, it is stored in the Transfer Sessions table. However:
- If the last logical Workflow Activity of a service session was a transfer, then the "transfer" fields in service sessions table will be populated.
- if the last logical Workflow Activity was not a transfer (e.g. Transfer > Queue in new Service), then "transfer" fields in service sessions table will be left empty.
Info
Info
Shows the template version and (last) connected user that did the data refresh.
Data Load Check
Data Load Check
The Data Load Check page provides the full overview of the amount of data loaded in the tables that can be incrementally refreshed. It shows details of the number of sessions loaded for each of the fact table as well as the earliest and most recent session. This allows the user to get an idea of the amount of data loaded into the report and to verify the most recent available sessions available in the report.
How to use…
Drill ThroughDrill Through buttons provide a convenient way to navigate between entry overviews and detail pages. The drill through possibility is signaled with an arrow:
Example:
|
|
Data SlicersFrom within any tab you can narrow down the data with predefined slicers (filters).
|
Template Troubleshooting
Did you encounter issues with the BI Template? Please refer to Setting Up Power BI > Known Issues and Solutions.