Insiders.coop Power BI Custom Visuals

Documents about INSIDERS.COOP Power BI Custom Visuals

Important notice

On the 10th of March 2025, the version 3.0.0.1 of the Mass Filter has been published on the App Source after being certified by Microsoft. This version is a major update from previous version 2.2.7.1, introducing a small breaking change with the modification of the field bucket's technical name.

This modification results in a report being unable to properly configure the visual. The column/measure being missing, the visual ends up in an inconsistent state, asking to be configured. For authors, there's no problem here, but for viewers, the visual is buggy.

This can be quickly worked around by editing the broken report and re-instating the configured column/measure in the field bucket. No big deal here, except for the pain of having to update loads of reports.

The real thing comes with the roll-out of the visual and the way it is done. The new version of a visual is not available globally at once, it is published progressively across regions, products and probably other criterias. It means that not all users are updated silmutaneously.

Some users may be viewing a report configured with the old version with the latest version of the visual available in their Power BI application, while some others will be viewing updated reports with an obsolete version of the visual, the new one not beaing available for them.

Our recommendation is to update your reports with the latest version of the Mass Filter as soon as it is available to an author. The users will then be gradually updated as the visual becomes available.

We are aware that this is not an ideal situation, especially if you have a lot of reports targeting a large audience worldwide, but we can't figure out many other workarounds.
We sincerely appologize for the inconvenience. Feel free to contact us if further assistance is needed.

For more information about importing and updating Power BI custom visuals, you can read this very interesting blog article from Marco Russo at OKVIZ which describes all the difficulties related to the publication of new versions of custom visuals, as well as the strategic choices when considering their integration.

Mass Filter

Filter your Power BI reports instantly with a list of keywords and a copy/paste.

Use the Mass Filter visual in your Power BI reports to let users filter other visuals on one of your columns/measures with a list of keywords.

The advantage of the Mass Filter is that your users can copy a list of keywords from any external source (Excel, CSV, plain text file…), and paste it in the input box. When they click on the filter buttons, all values are used at once to filter the report instantly.

That’s it! No intermediate steps needed.

The user can switch between inclusive (In) or exclusive (NotIn) filter by clicking on predefined button.

Configuration

Max Term Limit

There is a new Limit setting in the format pane, which allows to set a maximum number of terms a user can paste in the filter box.

The limit setting defaults to 0, which disables the whole feature.
By default there’s no maximum number of terms a user can use to filter a report.

Be aware however that using a high number of filter terms may affect the performances of the report and even impact your global capacity.

When set to a number grater thant 0, the limit is active and a user won’t be able to filter the report with more terms than the number set in the format pane.

Setting a limit unhides another new setting to enable or diable the status bar.
When enabled, a status bar will show above or below the filter box in the visual displaying the current amount of terms in it, as well as the maximum number of terms available.

A new formatting panel will also appear to modify the appearance of the status bar.

As formatting settings, all of these won’t be synchronized between pages.
Pay attention when you change the configuration on synchronized filters.

Cross Page Synchronization

The Mass Filter can now be synchronized between pages like any other slicer.

Just open the synchronization panel and select the pages on which you want the filter to appear and be synchronized.

As formatting settings aren’t synchronized between pages, we suggest to configure your filter on the first page on which you want it to appear, then synchronize it with the synchronization panel and let Power BI duplicate it on selected pages.

Once synchronized and configured, each visual on each page will behave as a standalone visual, unless for the filters which will synchronize.
If you modify any setting from the format pane, you will need to manually replicate the change on every page the visual is synchronized on.

You will encounter incoherent behavior when synchronized Mass Filter visuals don’t share the same maximum term limit.
If a user uses the maximum number of terms available in the visual configured with the higher limit, the visuals with lower limits on other pages will be in error state, and therefore unusable.

Usage

Keywords must be separated by commas or line breaks. Space will not be considered as a term separator.
If your data contain commas or leading/trailing spaces or even line breaks (!!), you can use double quotes (“) around an expression to escape these characters.

Migration 2.2.7.1 => 3.0.0.1

The version 3 of the Mass Filter custom visual is a breaking change.

The capabilities of the visual have changed and, for better naming consistency, the name of the bucket field has been modified.

It results in the need to reconfigure the visual by removing and dropping again the column/measure used in the bucket field.

Unfortunately, if you used the Mass Filter visual in one of your reports, it will automatically update from the App Source as soon as it will be available to you.

The Power BI platform doesn’t leave the choice of which version you’d like to use. Moreover, the version on the App Source prevails on an eventual version you might have in your organization, which also prevails on an eventual local file you’d like to use.

FAQ

No. We did not setup any limit by default. A user can potentially paste as much terms as they want, as far as there are no technical limit with an HTML textbox element or the number of filters a Power BI report can handle.

However, using a high number of filter may affect your report performances, and may even affect the global capacity.

To prevent unexpected behaviors, we recommend to use the limit setting in the format pane.

Note that duplicate terms in the list may be automatically removed after filter buttons are clicked.

Changelog

3.0.0.1

Features

Bug fix