create method

Note: STABLE.
This API is reliable and breaking changes are unlikely.

qlik.app.visualization.create(type, cols, options)

Create a new visualization on the fly based on a session object and will not be persisted in the app.

Version history

Introduced 2.2

Parameters

type

Type: String

Visualization type. Can be:

  • barchart
  • boxplot
  • combochart
  • distributionplot
  • gauge
  • histogram
  • kpi
  • linechart
  • piechart
  • pivot-table
  • scatterplot
  • table
  • treemap
  • extension

cols

Type: Array

Optional.

Column definitions, dimensions and measures. Each entry can be of the following structures:

  • String
  • NxDimension
  • NxMeasure

If the NxDimension or the NxMeasure refer to a library dimension or a library measure, you also need to add qType : "measure" or "dimension".

Columns for details and examples.

options

Type: Object

Optional.

Options to set.

Options for all the properties that can be set for each visualization type.

Returns

A promise of a QVisualization.

Example

Example: Creating a barchart on the fly

var app = qlik.openApp('c31e2aba-3b46-4b13-8b87-c5c2514dea1d');
app.visualization.create('barchart',["Case Owner Group","=Avg([Case Duration Time])"],{title:"Great on-the-fly barchart"}).then(function(bar){
	bar.show('QV04');
});

Example: Creating a toolbar using an extension.

app.visualization.create('com-qliktech-toolbar',null,
	{"buttons":{"clear":true,"back":true,"forward":true}}).then(function(vis){
		vis.show("QV05");
});

See also: