Installation Instructions - GeoAnalytics for Qlik Sense Server

Installation Instructions - GeoAnalytics for Qlik Sense Server

Version: February 2021 (5.28.1), Date: 2021-01-21

Contents

Introduction

Welcome to this quick guide to installing Qlik GeoAnalytics on Qlik Sense Server.

Note that you will need a Qlik LEF license to install version 5.8 or later.

Requirements

This version of GeoAnalytics works with Qlik Sense 3.2 or later and QlikView 11.2 or later. Note that Qlik Sense February 2018 requires GeoAnalytics February 2018 or later.

This version of GeoAnalytics requires .NET Framework v4.5.2 or later.

Installation

That is it, you should now be ready to use GeoAnalytics for Qlik Sense Server

Configuration

You can configure a few global extension settings by editing the file IdevioMap\settings.js in the Qlik Sense extensions folder by adding or changing the values of the following properties.

Note that the settings file is overwritten when upgrading, so any settings will need to be applied again.

SettingTypeDescription
serverstringDefault GeoAnalytics server URL
allowCustomServerbooleanIf false maps will ignore the map server URL setting in their properties and instead use the default URL
safeHtmlbooleanIf true info bubbles will be limited to only allow a small safer subset of HTML tags (a, b, br, em, i, img, small, span, strong, sup, sub) and attributes (class, style, href, target, rel, alt, src, height, width)

Custom Installation/Shared persistence

If you have installed your Server to use different paths to resources than the standard paths. Please use the "Custom Installation" option when applying license in the GeoAnalyticsSetup.

Updating

To update your existing GeoAnalytics for Qlik Sense Server the process is very similar to how you initially installed it.

Simply select all the GeoAnalytics extensions.

Press 'Delete' in the lower left corner.

Follow the instructions in the Installation section.

After Installing/Updating

If you install the GeoAnalytics extensions as instructed but get the error "Invalid Visualization", it most likely is because Qlik Sense occasionally has problems with its cache. To resolve this issue you need to clear the browser cache, but how you do that depends on how you run Qlik Sense.

Below you will find a short step by step guide on how to clear the cache depending on how you run Qlik Sense. Terminology may differ between languages but the functionality should be the same.

  • Google Chrome
  • 1) Navigate to the app you are having problems with.
  • 2) Press F12 or Ctrl+Shift+j to open the developer tools.
  • 3) Once the developer tools page is open you will find a tab called "Network". It will be between "Elements" and "Sources". Click it.
  • 4) On the very top of the "Network" tab you will find the check box "Disable Cache". Check it if not already checked.
  • 5) Hit F5 to refresh.
  • 6) You can now close the developer tools by pressing F12 again.
  • If you have the same problem with other apps, just repeat the process with that app.
  • Firefox
  • 1) Navigate to the app you are having problems with.
  • 2) Press F12 to open the developer tools.
  • 3) Once the developer tools page is open you will find an icon that looks like a small cogwheel. It is located in the top-right corner of the developer tools. Click it.
  • 4) Look for a check box labeled "Disable Cache". Check it if not already checked.
  • 5) Hit F5 to refresh.
  • 6) You can now close the developer tools by pressing F12 again.
  • If you have the same problem with other apps, just repeat the process with that app.
  • Internet Explorer
  • This is for Internet Explorer 9, but the steps for Internet Explorer 10 and 11 is most likely very similar.
  • 1) Navigate to the Menu Button (the one looking like a small cogwheel) and click it.
  • 2) Navigate to the "Safety" option and click the "Delete Browsing History" button.
  • 3) Uncheck everything except "Preserve Favorites website data" and "Temporary Internet files".
  • 4) Press Delete.
  • 5) Hit F5 to refresh.
  • 6) If you have the same problem with other apps, just repeat the process with that app.
  • Once an app is working the cache should not be a problem again.