Skip to content

Hello Visualization

Build a data visualization from data loaded into a Qlik Associative Engine running inside a Docker container.

Prerequisites

Clone the Get Started Git repository to your local machine. The Hello tutorials are located here, and all commands should be executed from this Git repository.

You must have Node.js and npm installed on your local machine.

Note

Make sure the Qlik Associative Engine is running and that you have loaded data into the Qlik Associative Engine. If you are unfamiliar with starting the Qlik Associative Engine in a Docker container and loading data, we recommend that you begin with the Hello Engine tutorial followed by the Hello Data tutorial.

Building a visualization

This example contains a small Node.js application that creates two visualizations from the data loaded into your dockerized Qlik Associative Engine.

  1. Install dependencies.

    Note

    If you already installed the dependencies in the previous tutorial, go to step 2.

    Run the following command from a command shell:

    npm install
    

    This command installs all of the dependent packages in the package.json file.

  2. Run the application.

    Run the following command from a command shell:

    npm run hello-visualization
    

    This command runs the application, which contains information on where to fetch the data and which data to load. This information is then used to create and populate a session app.

  3. Open the visualization in a browser.

    Open a browse and navigate to http://localhost:8080 to view the data in a visualization.

    If the application runs successfully, you will see that the visualization is deployed to localhost:8080 and you will receive a message that the webpack has compiled successfully.

What is happening

When you run a visualization, app.js creates and populates a session app from the data that is available to the Qlik Associative Engine using enigma.js to communicate with the engine and halyard.js to manage the data. A session app only lives while the session is alive.

Tip

We recommend that you take a look at picasso.js, a charting library that is streamlined for building visualizations with Qlik Core. You can also open the app.js file to see how enigma.js and halyard.js are used to load and retrieve the movies data from the engine.

Next steps

Now that you have seen how to start the Qlik Associative Engine in a Docker container, load data, and build a visualization from that data, we recommend that you explore the Orchestration tutorial, which shows how to run all core services of Qlik Core together. This will cover important topics such as how to run several Qlik Associative Engine instances using different container orchestration platforms.