Guide to upgrade the preview version of Smart Filter Pro
All posts   Organizational Custom Visuals smart-filter update

Upgrading the preview version of Smart Filter Pro requires a particular procedure. This will be not required in any future updates of OKViz custom visuals. We included a detailed guide to make sure you will not lose any property of the custom visual you must upgrade.

Upgrade Smart Filter Pro in the Organizational Custom Visuals (OCV)

First, it is important that you do not remove existing versions of Smart Filter Pro from the Organizational Custom Visuals (OCV) before you complete the update of all the reports.

If you imported Smart Filter Pro in the OCV during the preview, follow these steps – otherwise you can skip this section:

  1. Download the new version of Smart Filter Pro.
  2. Import the new version of Smart Filter Pro (v2.0.5) into the OCV.
  3. Make sure you have both old and new versions in the OCV.
  4. Update all the existing reports (see next section). IMPORTANT: do not continue to step 5 until you upgraded all the reports!
  5. After you updated all the reports, then you can remove from the OCV the older version of Smart Filter Pro (v2.0.4 or previous releases).

Upgrade Smart Filter Pro in Power BI

In every report where you have a preview version of Smart Filter Pro (v2.0.4 or previous releases) you should import the new release of Smart Filter Pro (v2.0.5) and update the existing visuals following these steps for each report:

  1. Open the report in Power BI Desktop.
  2. Import Smart Filter Pro v2.0.5 from the My Organization Marketplace if you use OCV, or from the folder where you saved the version downloaded after you activated your subscription.

  3. You should see two icons of Smart Filter Pro in your list of Visualizations. The first one is the old version, the second one is the new version.
  4. For each Smart Filter Pro visual in your report, click the visual and then select the new version of Smart Filter Pro from the list of Visualizations. For example, this first bitmap shows that the Smart Filter Pro selected has the version 2.0.4 and it is in Preview.

    By clicking the icon of the new version, the selected visual is upgraded to the licensed version 2.0.5.
  5. Once you updated all the Smart Filter Pro instances, try to delete the old custom visual.
    If you forgot to upgrade some visual, you will see an error message notifying that one or more tiles in the report are using the version of the custom visual that you want to remove. Check all the visuals in your report and make sure that you are able to delete the old version of the custom visual, and confirm the Delete operation only when the warning reports only 0 associated tiles from the report.
  6. Save the Power BI file, then repeat the process for all the Power BI files where you have use the preview of Smart Filter Pro.

If you have any questions, write at support@okviz.com and we will assist you.