February 2025 - Dashboard Release Notes

New Release: pi-embed-actions library

We are excited to announce the release of our new JavaScript library, pi-embed-actions, designed to simplify interactions with the embedded pi dashboard. It provides an intuitive API to execute actions directly within the dashboard, minimising manual effort and making integrating pi into your application easier.

Open the Report Editor with Ease

To open the report editor within the embedded window, simply add the pi-embed-actions library to your code, use the API, and provide the required reportId. Here's an example of how to use it:

The library simplifies communication between the iframe and the dashboard by automatically sending instructions via post messages to open a specific report editor. This means you no longer have to manually manage this yourself in code—everything is taken care of seamlessly by the library!

You can also explore a full code example of embedding the report editor using the pi-embed-actions library here:- api-embed-example/static_examples/embed_report_editor.html at main · Panintelligence/api-embed-example

Future Updates

We’re committed to continuously improving the pi-embed-actions library. In the future, we plan to expand its API and capabilities to make embedding even easier and introduce exciting new features. Your feedback is invaluable in helping us make the library even better, so please feel free to share your experiences and suggestions with us!

Additional Resources

For more details about the library, check out the following links:

• pi-embed-actions Library Release

• Source Code

• Documentation

A separate ARM64 docker image has been added to the dashboard. Simply add the “_arm64” suffix to the end of the image you are trying to access to get the correct image for this architecture, for example;

registry.panintelligence.cloud/panintelligence/dashboard/pi:latest_arm64. The original AMD branch will still exist for each release without this suffix.

Within the Chart Configuration screen, an option for ‘Exclude Chart From Cache’ has been available. This option relates to the browser caching of charts - and NOT the configurable Data Connection caching, which had caused some confusion. This option has been renamed from ‘Exclude Chart From Cache’ to become ‘Exclude Chart From Browser Cache’ to clarify its purpose.

To compliment this option, a new option called ‘Exclude Chart From Data Connection Cache’ has been added. The new option prevents a chart from being put into / retrieved from any Cache that has been configured for the relevant Data Connection.

Previously, only the Super Admin could see/use the ‘Save Default Layout For Each Category' button, in the ‘More Options’ menu. This functionality has now been extended to the Organisation Admins too.

Unlike with the Super Admin, this feature will not work on all categories, rather it works for categories that the user has access to in Organisation where they:

• Have the ability to manage that Organisation (i.e. it is not a Parent or detached child of their Owner Organisation)

• Are an Admin User Type

• Have the privileges associated with modifying/saving layouts

Whilst the ability to modify and save default layouts are Designer privileges, we have opted to restrict this functionality to users with a lot of access, as particularly across Organisations this feature can be very powerful.

We have implemented a more efficient CSV export functionality for tables, editable tables and rotated tables. The processing is now done in a more efficient manner reducing memory overheads and the chance of out-of-memory errors. In time the newer mode will apply to all CSV exports. If you experience any issue with this functionality you can temporarily switch back with the beta flag 'NON_SEG_CSV_EXPORT'.

Chart Debug Screen

Added missing translations for the highlighted items below in the chart debug screen:

Open

The following key-value pairs have been added to messagesStatic.properties file to translate the content:

app.debug.track.time.breakdown=breakdown
app.debug.track.time.i18n.and.swap.chart.i18n.micros=Chart i18n (micro-s)
app.debug.track.time.i18n.and.swap.chart.replacement.micros=Chart replacement (micro-s)
app.debug.track.time.i18n.and.swap.chart.step.preparation=preparation
app.debug.track.time.i18n.and.swap.chart.step.chart=chart
app.debug.track.time.i18n.and.swap.chart.step.hierarchy=hierarchy
app.debug.track.time.i18n.and.swap.chart.step.hierarchy.columns=hierarchy-columns
app.debug.track.time.i18n.and.swap.chart.step.chart.columns=chart-columns
app.debug.track.time.i18n.and.swap.chart.step.chart.colours=chart-colours
app.debug.track.time.i18n.and.swap.chart.step.chart.parameters=chart-parameters
app.debug.track.time.i18n.and.swap.chart.step.table.columns=table-columns

Reporting

• Added a missing translation for a ‘Cancel’ button for ‘Insert Link' popup in the report editor. Key - text.editor.insert.link.cancel.button

• Corrected the keys used for the translations for the ‘import’ button tooltip for both reports and schedules. Keys - report.import.instructions and schedule.import.instructions

The ability to use an Index Column in a Sub Query, for Custom Fields has been added.

When merging charts that included the same legend values, this could result in the legend items being duplicated rather than being merged together as should be the case. All duplicated legend items will now be merged on all configurations where 2 or 3 charts are being merged.

When passing the --no-systemd flag to the Configuration Tool, the Dashboard would create and run service files through systemd if the user was root, which should not have occurred.

When performing an Export to Excel, when the Chart Configuration option of “Export As Excel Without Format” having been set, the Titles, Subtitles, Headers and Group Headers were all being successfully translated in the export, however the actual values for these column were not.

When using a language other than English, when using the Reports module and navigating to the Import Report button, it was found that the Tooltip shown when hovering over the button was not being translated.

Open

When using a language other than English, when using the Reports module and navigating to the Report Editor screen, it was found that should you click on the Insert Image icon a dialogue boix would appear - however the Cancel option was not being translated to the chosen language.

Open

To further assist with issue investigations, the dashboard now logs the software version details into the standard log file as part of it’s startup procedure.

The logic used to count licence users value has been updated to take into consideration Organisations users.

Whilst related to licencing, ‘Grace days’ are not needed as a factor when monitoring the last time licences were checked against our ALM. Uses of ‘Grace days’ in this area have been replaced with hardcoded equivalents of the previous defaults.

A further issue with login being disabled prior to exceeding the callback window has also been addressed.

The dashboard styling has been to improved to aid the visibility of content primarily in the Dashboard Reporting and Dashboard Configuration screens.

The min-width has been set to 1520px, to ensure content does not overlap by maintaining a fixed minimum width. As a result, a horizontal scrollbar is available when needed, enhancing navigation and user experience on smaller screens.

Users were unable to copy charts if the Organisation did not have a linked data connection. In this scenario, a parent data connection will be used to attribute the chart to from this version forward.

Addressed an issue with the New Category Objects, where incorrect filter values were being seen, when moving and selecting values between different category objects

The Pirana project has been upgraded to Python 3.11, and the container has been re-based to Debian to reduce the size of the container - to address the CVE-2024-6345 vulnerability.

The Configuration Tool, Scheduler, and Excel Reader projects have received minor upgrades to their ‘Go’ versions (1.23.1 → 1.23.6), to resolve the CVE-2024-45336 and CVE-2024-45341 vulnerabilities.

Added

exclude_chart_from_data_connection_cache to mis_defined_charts

pi#2819

34266