Nebula sense

Generate a nebula visualization to be used as an extension in Qlik Sense

Usage

nebula sense

Example

Generate a visualization with an extension definition

nebula sense --ext def.js

Generate a visualization with a meta info

nebula sense --meta meta.json

Generate a visualization no need of minifying and uglifying code

nebula sense --minify false

Generate a visualization setting destination directory as sn-table-ext

nebula sense --output sn-table-ext

Generate a visualization with generating source maps - .js.map files

nebula sense --sourcemap

Generate a legacy extension to run in Qlik Sense before 2020

nebula sense --legacy

Options

ParameterDescriptionDefault
--versionShow version number
--ext stringSet extension definition
--meta stringSet extension meta information
--output stringSet Destination directory"<name>-ext"
--minifyMinify and uglify codetrue
--sourcemapGenerate sourcemapsfalse
--legacyGenerate legacy extensionfalse
-h, --helpShow help for command

Details

EXT

You can set property panel definition and feature supprts by creating a separate file for the extension info and providing its filename as an argument to --ext.

Create a file called def.js and add the following code demonstrating an example to set the extension definition:

export default {
  definition: {
    // Property panel definition
  },
  support: {
    export: true,
    exportData: true,
    snapshot: true,
    viewData: true,
  },
  importProperties: null,
  exportProperties: null,
};

Run the command:

nebula sense --ext def.js

Note: Using the --ext option overwrites any ext definition already presented on the chart, its main purpose is to support legacy option below.

Meta

You can improve meta info about the extension, such as extension name, extension icon, and description by providing a .json formatted file and supply that filename as an argument to the nebula sense command with --meta option.

Create a file called meta.json and add the following code demonstrating an example to set the extension meta information:

{
  "name": "My tasty banana extension",
  "icon": "barchart",
  "description": "Nebula test table wrapped in a Qlik Sense extension"
}

Run the command:

nebula sense --meta meta.json

The meta data is ended up in the .qext file used by the Qlik Sense.

Copy the updated your-chart-ext directory to your Extension directory, overwriting the old version. Then the meta data of the extension has been changed.

The rest of the required information is populated automatically based on the content in package.json.

Output

Generate all required files into the specified --output folder called sn-table-ext:

nebula sense --output sn-table-ext

You can upload that folder as an extension on Qlik Sense Enterprise for Windows or SaaS editions of Qlik Sense

QEXT

Running nebula sense generates a QEXT file for you, which is required for loading the visualization into sense.

The QEXT file can also be manually created by yourself. Create a file called your-extension-name.qext and add the following code as an example:

{
  "name": "your-extension-name",
  "version": "0.1.0",
  "description": "",
  "author": {
    "name": "",
    "email": ""
  },
  "icon": "extension",
  "type": "visualization",
  "supernova": true
}

The "supernova": true attribute should not be added when building with the --legacy option below.

Legacy

Qlik Sense before 2020 does not support nebula supernova natively, so a special build path is needed for visualizations to load properly in the client. For this purpose, use the --legacy option.

nebula sense --legacy

You can find that the generated QEXT file does not include supernova: true.

Note: For old Qlik Sense, not all features of extension are presented.

Was this page helpful?