March 2022 Dashboard Release Notes
Original Release Name - pi.2022-03-31
Patched Release Name - pi.2022-03-31.1
Original Release Date - Apr 7, 2022
Patched Release Date - Apr 12, 2022
We are pleased to present our latest offering of Pi - our March 2022 release! This page helps summarise and familiarise you with the changes we have made, and is supported (where applicable) with useful videos to help explain the changes we have delivered.
Apr 12, 2022 - we have released a patch to the March 2022 Dashboard release. This was to include a Tomcat upgrade to 8.5.78 to provide additional protection for Spring4Shell.
Before upgrading, we recommend taking a backup. You can find more information here.
Here’s what we’ll cover;
- 1 Added
- 1.1 Sub-query (Zendesk#11324,18360)
- 1.2 Multi-Select Parent Filters (Zendesk#11856,12241)
- 1.3 SQream Data Connection (Zendesk#17156)
- 1.4 Configure Session Sync through Config Tool & Environment Variables (Zendesk#16471,18853)
- 1.5 Scrollable Categories (Zendesk#12249,17461,17462,17464,19435)
- 1.6 Power Ring
- 1.7 Clean User Gateway Sessions (Zendesk#18986)
- 1.8 Additional auth check when changing email (Zendesk#19757)
- 1.9 Changing the maximum connections to the dashboard database
- 2 Fixed
- 2.1 Behaviour resetting password when 1 email address shared by 2 users (Zendesk#8632)
- 2.2 Scroll bar on email body section (Zendesk#12987)
- 2.3 Object Replacement - Free Text Category Objects (Zendesk#19038)
- 2.4 Snowflake Data Connections identified as coming from a Panintelligence Dashboard (Zendesk#19344)
- 2.5 Moving between Categories (Zendesk#19307)
- 2.6 Oracle driver (Zendesk#19463,19954,20121,20223,20371)
- 2.7 Ability to access language file without auth (Zendesk#19756)
- 2.8 Category objects being removed when importing a connection (Zendesk#19951)
- 2.9 Fixed errors when drilling down (Zendesk#19988)
- 2.10 User permissions not respected when charts are embedded (Zendesk#20303)
Added
Sub-query (Zendesk#11324,18360)
Charts
Sub-query will enable users to introduce charts as filter values, this means that charts are run as sub-queries which will help build the data of the main chart.
How does Sub-query work:
when using an in/not in operator - the first column of the data from the sub-chart is used (this may contain multiple values)
top/bottom operator - when using a top/ bottom operator, the option to select a chart to filter on will not be available
single value operator e.g. Like - the first data point (first row of the first column) is used as the filter value
After selecting what you want to filter on and the operator you want to use you will then be able to select from data or a chart when picking the value. The type of charts allowed to be used as sub-query are similar to the options that you can select from when using merged charts/ tables. If a chart can be used as a sub-chart of a merged chart or table, it can be used as sub-query. This means that
lines, bars, tables are allowed
pies, special shapes, maps, merged charts/tables and so on can not be used
The ‘Type to filter’ screen has now been split into two sections - Data and Charts. The Data screen is used in the same way as it was previously (please see this page for more information).
Please take a look at this documentation for full details on how to use Sub-query and see a working example.
Multi-Select Parent Filters (Zendesk#11856,12241)
Dashboard
New functionality has been added to support multi-select parent filters for most of the Cartesian chart types and data tables. Users will be able to select multiple chart blocks/ table rows and apply these filters as a list to other elements on the same category, the items selected will be identified on the parent chart with highlighting.
In addition to this, users will also be able to select multiple Legend items on a parent chart as a filter. This will filter all other charts/ data tables on the same category and highlight the selected values on the Legend itself.
Please take a look at this documentation for full details on how to use multi-select parent filters.
SQream Data Connection (Zendesk#17156)
Data Connections
We have added a new data connection type to the dashboard for SQream, allowing you to connect the dashboard to a SQream database. Configuration options include:
Ability to enable SSL
Ability to enable clustering
Ability to specify a service (‘sqream’ is selected by default)
Configure Session Sync through Config Tool & Environment Variables (Zendesk#16471,18853)
Dashboard Configuration
Session synchronisation can now be enabled through Tomcat clustering. A new section has been added to the configuration tool GUI, which will allow the user to specify if they wish to have session sync turned on with the option to specify both Broadcast and Listening Ports:
By default, the session sync is disabled and can only be enabled through the configuration tool or by setting up the following environment variables:
PI_TOMCAT_ENABLE_SESSION_SYNC (boolean value)
PI_TOMCAT_SESSION_SYNC_BROADCAST_PORT (int)
PI_TOMCAT_SESSION_SYNC_LISTENING_PORT (int)
If enabled, a number of .xml files will be amended in the Tomcat folder, which will enable session synchronisation. The files which will be rewritten are as follows;
INSTALLATION_DIR/Dashboard/tomcat/conf/server.xml
INSTALLATION_DIR/Dashboard/tomcat/conf/context.xml
INSTALLATION_DIR/Dashboard/tomcat/webapps/pi/WEB-INF/web.xml
INSTALLATION_DIR/Dashboard/tomcat/webapps/panMISDashboardWebServices/WEB-INF/web.xml
As a part of this feature, a few changes have been made to configuration tool GUI as well, which will now display collapsed Proxy, Session Sync and Advanced options in the tomcat config tab.
Scrollable Categories (Zendesk#12249,17461,17462,17464,19435)
Categories
New functionality in this release will allow users to make categories scrollable. Users will be able to alter the height of a selected category by choosing from Default, 1.5x or 2x height options. If one of the larger sizes is chosen, a scrollbar will be automatically added to the category. This has been introduced to allow users to add more charts to the selected category without having to reduce their size in order to display them.
The option to change category height will be available when creating new categories or editing existing categories.