Skip to main content Skip to complementary content

Normal mashup scenario

In the normal mashup scenario, the mashup web page is running on a different server from your Qlik Sense server. Use this method if your situation matches either of these two scenarios:

  • You started building your mashup as a simple mashup (typically using the DevHub).
  • You started from an existing web solution and need to include Qlik Analytics in that.

Normal deployment scenario: The user connects to a web server, which links to the Qlik Sense server.

To deploy your mashup the normal way, you need to do one of the following:

  • Tell the Qlik Sense server to accept your website as a client. This is done in the QMC. Use a mashup built in Dev Hub. This is done by deploying to the repository.
  • Add Qlik Analytics to an existing web page/solution.
Information noteThis is called the normal mashup scenario because the Qlik Sense server is not a fully-fledged web server, nor is the Dev Hub intended to compete with a full-fledged IDE or content management system. See Simple mashup scenario for more details.

Preparing for deploying to the repository

If you have created your mashup in a Qlik Sense Desktop environment, or on a dedicated development node, and you now want to deploy it to Qlik Sense, there are some preparation tasks to perform.

Do the following:

  1. Make sure to upload the Qlik Sense app to the repository.

  2. Update the JavaScript file. In a Qlik Sense environment, the openApp function references an app ID instead of the app name. See examples below.

    Example: openApp in Qlik Sense Desktop environment

    		//open app and get objects
    		var app = qlik.openApp( "Tutorial.qvf", config );
    		$( ".qvobject" ).each( function () {
    			var qvid = $( this ).data( "qvid" );
    			app.getObject( this, qvid ).then( function ( object ) {
    				qvobjects[qvid] = object;
    			} );
    		} );

    Example: openApp in Qlik Sense environment

    		//open app and get objects
    		var app = qlik.openApp( "2c18060f-d3b3-46ed-b3d4-a24915e1b64f", config );
    		$( ".qvobject" ).each( function () {
    			var qvid = $( this ).data( "qvid" );
    			app.getObject( this, qvid ).then( function ( object ) {
    				qvobjects[qvid] = object;
    			} );
    		} );

    Obtaining app IDs and object IDs to find help on locating the app ID.

  3. You are now ready to upload the mashup files to the repository.

Adding Qlik Analytics to an existing webpage/solution

If you are adding Qlik Analytics to an existing web page/solution then you need to do the following:

  1. Include the following Qlik stylesheets and Qlik scripts from the Qlik Sense server or domain.

    • <link rel="stylesheet" href="https://QSE_domain/resources/autogenerated/qlik-styles.css">

    • <script src="https://QSE_domain/resources/assets/external/requirejs/require.js"></script>

  2. In the JavaScript file you also need to define the Qlik Sense server or domain to open an app.

    var config = {
        host: 'QSE_domain',
        prefix: "/",
        port: 443,
        isSecure: true
        //webIntegrationId: 'web-integration-id-here' // only needed in SaaS editions
    };
    const baseUrl = ( config.isSecure ? 'https://' : 'http://' ) + config.host + (config.port ? ':' + config.port : '') + config.prefix;					
    require.config( {
        baseUrl: '${baseUrl}resources'       
        
    } );
    
Information noteDo not use different versions of RequireJS on the same web page. You can find out which version of RequireJS is being used by typing require.version in the browser console while displaying the mashup in the browser.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!