Qlik Community

Qlik Design Blog

All about product and Qlik solutions: scripting, data modeling, visual design, extensions, best practices, etc.

Announcements
Support Case Portal has moved to Qlik Community! Read the FAQs to start exploring Support resources.
Yianni_Ververis
Employee
Employee

banner-4.jpg

qdt-components (Qlik Demo Team Components) is a library of components that we have developed in the demo team and that have been used in most of our mashups found in webapps.qlik.com and demos.qlik.com. It's a collection of filters, tables, barcharts, selection toolbars, or even simple getting/creating object methods from the Visualization Api. You do not have to worry about connection strings, loading Requirejs, jQuery etc. Everything is taken care for you! The library can be used in a simple html page by loading the qdt-components.js or in React and Angular2+ via npm.

Today, I will show you how to load a simple object and create a session barchart, in simple html and Angular 5

Simple HTML

  • In your HTML, add the following:

 

 

 

<head>
  <script type="text/javascript" src="qdt-components.js"></script>
</head>
<body>
  <div id="qdt1"></div>
</body>

 

 

 

  • In your Javascript code, add:

 

 

 

var qConfig = {
   "config": {
      "host": "your-sense-server.com",
      "secure": true,
      "port": 443,
      "prefix": "/",
      "appId": "133dab5d-8f56-4d40-b3e0-a6b401391bde"
   },
   "connections": {
      "vizApi": true,
      "engineApi": false
   }
}

var QdtComponent = new window.qdtComponents.default(qConfig.config, qConfig.connections);

var element = document.getElementById('qdt1');

QdtComponent.render('QdtViz', {id: 'a5e0f12c-38f5-4da9-8f3f-0e4566b28398', height:'300px'}, element);

 

 

 

And you are done.

Simple HTML template: GitHub - qlik-demo-team/qdt-html-template: A simple html template that uses qdt-components

Live Demo: Simple html with qdt-components

 

Angular 5

npm install --save qdt-components
  • Create new component by typing in the command line
ng generate component components/qdt-components --style=less
  • In your qdt-component.component.ts import the library and import or set the qConfig with the connection details

 

 

import { Component, OnInit, ElementRef, Input } from '@angular/core';
// import * as qConfig from '../../../qConfig.json';

import QdtComponents from 'qdt-components';

let qConfig = {
   "config": {
      "host": "sense-demo.qlik.com",
      "secure": true,
      "port": 443,
      "prefix": "/",
      "appId": "133dab5d-8f56-4d40-b3e0-a6b401391bde"
   },
   "connections": {
      "vizApi": true,
      "engineApi": false
   }
}

 

 

  • Replace the class with:

 

 

export class QdtComponentComponent implements OnInit {
   @Input() Component: Function;
   @Input() props: object;

   static QdtComponent = new QdtComponents(qConfig.config, qConfig.connections);

   constructor(private elementRef: ElementRef) { }

   ngOnInit() {
      QdtComponentComponent.QdtComponent.render(this.Component, this.props, this.elementRef.nativeElement);
   }
}

 

 

  • After this, you can start using it in any other component. In the HTML, add:

 

 

<qdt-component [Component]="'QdtViz'" [props]="{id: 'a5e0f12c-38f5-4da9-8f3f-0e4566b28398', height:'300px'}"></qdt-component>

 

 

Angular Template: GitHub - qlik-demo-team/qdt-angular-template: An Angular 5 template that is using qdt-components for...

Live Demo Angular 5: https://webapps.qlik.com/qdt-components/angular5/index.html

Live Demo Angular 6: https://webapps.qlik.com/qdt-components/angular/index.html

 

React 16.3

Live Demo: https://webapps.qlik.com/qdt-components/react/index.html

Git Repo: https://github.com/qlik-demo-team/qdt-react-template

 

Vue 2.5

Live Demo: https://webapps.qlik.com/qdt-components/vue/index.html

Git Repo: https://github.com/qlik-demo-team/qdt-vue-template

 

qdt-components

Branch: Qlik Branch

Github: GitHub - qlik-demo-team/qdt-components: React Components to be used with Angular2+ and React. Connec...

Npm: qdt-components

 

Yianni

37 Comments
mlehtola
Partner
Partner

Looks great! Can't wait to test out React components.

0 Likes
6,122 Views
thpessato
Contributor III
Contributor III

Hello Yianni! This looks great!

I just imported this JavaScript file and noted that it puts bootstrap's CSS with a <style> tag, overriding almost all my CSS classes and styles.

Is Bootstrap a requirement to use the qdt-components? Or do I have an option to not load it?


Thanks!

0 Likes
6,122 Views
Yianni_Ververis
Employee
Employee

Hello Thomas,

I am really glad you tried it out. We are in the process of removing bootstrap.

1. Try to load your css after initializing the component

2. Bootstrap is used only in the objects that are using hte Engine API and not the Visualization API. So, if you only wand to display Qli kSense objects with their id, set the engineApi to false in your config

Let me know how any of these work out for you

Yianni

6,122 Views
thpessato
Contributor III
Contributor III

Hey Yianni, thanks for the tip!

I think that loading my CSS after the component's initialization isn't really an option, since this JS file has 1.5mb... It would be painful for the user experience, if on slow connections...

I tried with engineApi set to false but it still applies all CSS styles in my page, since I'm using default class names (e.g navbar).

As you suggested in 2., if I set to engineApi to false, it should not load Bootstrap CSS, or did I misunderstood?

Thanks for your attention

0 Likes
6,122 Views
Yianni_Ververis
Employee
Employee

Hmmm maybe its not the bootstrap, maybe its /resources/autogenerated/qlik-styles.css?

We will definitely work on removing bootstrap

Yianni

6,122 Views
thpessato
Contributor III
Contributor III

Well, I have this line on my HTML:

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

But this never gave me any issues, actually

I will keep waiting for that!

Keep up the good work!

0 Likes
6,122 Views
bela2_szalontai
Contributor II
Contributor II

Hello Yianni!

Thnx for the initiation.

My question is that how the Authentication will work in an Angular2+ environment to access Qlik sense apps and sheets protected by e.g. SAML or JWT authentication method behind a Virtual Proxy?

Br: Béla Szalontai

0 Likes
4,958 Views
Yianni_Ververis
Employee
Employee

Hello Bella,

This is over the anon proxy. We will have an auth component later on

0 Likes
4,958 Views
Yianni_Ververis
Employee
Employee

We've just added a template if you want to use the qdt-components from dev-hub

https://github.com/qlik-demo-team/qdt-devhub-template

4,958 Views
ChristofSchwarz
Partner
Partner

Hey QDT authors! Great work, very useful and it speeds up mashup creation. However, how could I achieve that a anguar-app with QDT parses selection parameters from URL? (like the /single integration)? Usually I would grap the app object and use app.field(...).selectMatch(...) or so.

0 Likes
4,958 Views