Troubleshooting: mashups

This section describes problems that can occur when creating mashups for Qlik Sense, as well as suggestion for resolving them.

Mashup is empty in Qlik Sense environment

Your mashup is empty when you try to access it in a server environment.

Scenario 1

Possible cause  

The Qlik Sense app does not exist or the app ID is incorrectly referenced in the mashup.

Proposed action  

Add the app to the repository or update the mashup's reference to the app ID.

Scenario 2

Possible cause  

Your environment is set up with a virtual proxy and the prefix has not been added to your mashup files.

Proposed action  

Make sure the host, including the prefix, is included in the three link references in the HTML file. Also, make sure you adjust the HTML configuration in the JavaScript file.

Mashup is empty after copying to Extensions folder

After having copied a mashup to the Extensions folder it do not render, the mashup is empty.

Note: This problem can only occur on Qlik Sense Desktop.

Possible cause  

The Qlik Associative Engine has not been refreshed since copying the mashup to the Extensions folder and therefore, the mashup is not yet available.

Proposed action  

  1. Re-start the Qlik Associative Engine.
  2. Close Qlik Sense Desktop.
  3. Launch Qlik Sense Desktop again.

Create new button is unavailable

The Create new button in Dev Hub is unavailable and therefore, no new extensions or mashups can be created from Dev Hub.

Possible cause  

You may not have sufficient privileges to create extensions and mashups.

Proposed action  

Add the correct privileges by creating a security rule in Qlik Management Console.

  1. Open Qlik Management Console.
  2. Select Security rules on the QMC start page or from the StartS drop-down menu to display the overview.

  3. Click PCreate new in the action bar.

    This opens the Security rule edit page.

  4. In the Identification view, select Extension access rule from the Create from template drop-down list.

  5. In the Basic section, select the Create, Read, Update, and Delete check-boxes as applicable.

    Then, select a user condition that specifies which users the rule will apply to.

  6. In the Identification view, give the security rule a name in the Name text box.
  7. Click Apply in the action bar to create and save the rule, or click Cancel to discard changes.

    Successfully added is displayed at the bottom of the page.

WebSocket limit reached

Mashups containing more than six iframes generate several error messages on the page when using Microsoft Internet Explorer.

Possible cause  

Microsoft Internet Explorer supports a maximum of six WebSocket connections. Because each iframe is considered as a new WebSocket connection, even when it is calling objects from the same Qlik Sense app, this limitation will apply for mashups containing more than six iframes.

Proposed action  

  • Use div integration (using Capability APIs) instead of iframe integration (using Single integration) and make sure not to call objects from more than six different Qlik Sense apps.
  • Modify the number of server connections allowed, see http://msdn.microsoft.com.

    Note: This proposed action is only applicable if you are working in a controlled environment, for example an Intranet.

Extension does not work in a mashup on an external web server

An extension used in a mashup hosted on a web server that is different from the one on which Qlik Sense is running.

Possible cause

The extension is trying to avoid cross-scripting issues by using JSONP.

Example:  

The file in the extension is "styles.css", which will work in a non-cross-site scenario. In a cross-site scenario, RequireJS will look for a "style.css.js" file instead, which typically is not available.

Possible action

If you have access to the QMC and can update the extension, wrap the file inside a corresponding js-file. The format required by RequireJS is:

define([], function () { return "the text from the original file";});

Note: You must re-install the extension, just putting the file in the folder will not work.

Did this information help you?

Thanks for letting us know. Is there anything you'd like to tell us about this topic?

Can you tell us why it did not help you and how we can improve it?