Skip to content

Nebula Line chart

v1.30.8

Line chart generic object definition

properties

namespace

Properties

color

Color settings. Most color options for visualizations are set in the color object in the options. You activate custom coloring by setting "auto": false which turns off auto-coloring. If "auto": true, no other properties need to be defined in the color object. Note: Some of the color properties are depending on which theme is currently being used.

components
Array<Component>

Styling of chart components.

dataPoint

Data point settings.

dimensionAxis

Dimension axis settings.

footnote
string | StringExpression

Visualization footnote.

gridLine

Grid lines settings.

legend

Legend settings.

lineType
default=line
'line' | 'area'

Type of line chart.

measureAxis

Measure axis settings.

nullMode
default=gap
'gap' | 'connect' | 'zero'

Null value presentation

orientation
default=horizontal
'vertical' | 'horizontal'

Orientation setting. If horizontal, the dimension axis can only be docked on bottom or top and measure axis on left or right.

preferContinuousAxis
default=true
boolean

Chart axis setting to control preference of scale on a dimensional axis. If true, the scale along the dimensional axis will be continuous if the data supports it, discrete otherwise.

qHyperCubeDef

Extends HyperCubeDef, see Engine API: HyperCubeDef.

refLine

Reference lines settings

scrollbar
default=miniChart
'bar' | 'miniChart' | 'none'

Sets the style of the scroll bar

scrollStartPos
default=0
number

Scroll Alignment. If 0, then the scrollbar will start at the left/top of the chart, if 1 it starts at the right/bottom of the chart. Generally decides if the scroll starts at the beginning or end of the data

separateStacking
default=true
boolean

Stack positive and negative values separately. Dependent of lineType property.

showDetails
default=true
boolean

Show visualization details toggle

showDisclaimer
default=true
boolean

Show visualization disclaimer toggle

showMiniChartForContinuousAxis
default=true
boolean

Chart axis setting to turn on/off the mini chart for continuous axis.

showTitles
default=true
boolean

Show title for the visualization.

stackedArea
default=false
boolean

Stack areas. Dependent of lineType property.

subtitle
string | StringExpression

Visualization subtitle.

title
string | StringExpression

Visualization title.

tooltip

Custom tooltip properties

version
string

Current version of this generic object definition

Accumulation

object

It allows you to accumulate values of your measure over one or two dimensions.

Properties

fullAccumulation
boolean

Select whether the accumulation will happen on the Full range or Custom range.

showExcludedValues
boolean

Shows the excluded values (values not in the current selection) in the accumulation.

type
string

This should be set to "accumulation".

accumulationDimension:
number

Only applicable when there are two dimensions. Selects the dimension on which the accumulation will take place. If the accumulation is made across multiple dimensions, this will be the first dimension.

crossAllDimensions
boolean

Only applicable when there are two dimensions. Continues accumulation across both dimensions.

disabled
boolean

No description

steps
number

Only applicable when fullAccumulation is set to false. The number of steps in the dimensions which form an accumulation range. Only zero and positive integers are accepted. Note: Sorting order of dimension values (or step order) is important and affects results.

AttributeDimensionProperties

object
extendsNxAttrDimDef

Extends NxAttrDimDef, see Engine API: NxAttrDimDef.

Properties

id
string

One of: colorByAlternative: colors the chart using different dimensions (can be used together with color.mode="byDimension") or colorByExpression together with color.mode="byExpression".

type AttributeExpressionProperties

ColorAttributes | CustomTooltipAttributes | ForecastAttributes

Axis

object

Properties

axis

No description

key
string

This should be set to "axis" (Determines which component the settings apply to).

AxisStyling

object

Properties

label

No description

title

No description

byDimDef

object

Settings when coloring by dimension ("mode": "byDimension")

Properties

key
string

libraryId if "type": "libraryItem", dimension expression if "type": "expression"

label
string

Label displayed for coloring (in legend and tooltip for instance). String or expression. Not used when coloring by library items.

type
'expression' | 'libraryItem'

No description

byMeasureDef

object

Settings when coloring by measure ("mode": "byMeasure")

Properties

key
string

libraryId if "type": "libraryItem", measure expression if "type": "expression"

label
string

Label displayed for coloring (in legend and tooltip for instance). String or expression. Not used when coloring by library items.

type
'expression' | 'libraryItem'

No description

ColorAttributes

object
extendsNxAttrExprDef

Extends NxAttrExprDef, see Engine API: NxAttrExprDef.

Properties

id
string

One of: colorByAlternative: colors the chart using different dimensions (can be used together with color.mode="byDimension") or colorByExpression together with color.mode="byExpression".

type Component

Line | Label | Axis | Legend

CustomTooltipAttributes

object
extendsNxAttrExprDef

Extends NxAttrExprDef, see Engine API: NxAttrExprDef.

Properties

id
'customTooltipTitle' | 'customTooltipDescription' | 'customTooltipExpression'

Indicates how the attribute expression will be interpreted by the chart. customTooltipTitle: additional title displayed on the custom tooltip customTooltipDescription: description displayed on the custom tooltip customTooltipExpression: measures displayed on the custom tooltip

```json
"qAttributeExpressions": [{
  "qExpression": "",
  "qLibraryId": "",
  "qAttribute": true,
  "qNumFormat": {
     "qType": "U",
     "qnDec": 10,
     "qUseThou": 0,
     "qFmt": "",
     "qDec": "",
     "qThou": "",
   }
  "qLabel": "custom title",
  "qLabelExpression": "",
  "id": "customTooltipTitle"
},
{
  "qExpression": "avg(population)",
  "qLibraryId": "",
  "qAttribute": true,
  "qNumFormat": {
     "qType": "U",
     "qnDec": 10,
     "qUseThou": 0,
     "qFmt": "",
     "qDec": "",
     "qThou": "",
   }
  "qLabel": "",
  "qLabelExpression": "",
  "id": "customTooltipDescription"
},
{
  "qExpression": "",
  "qLibraryId": "zpDNMcg",
  "qAttribute": true,
  "qNumFormat": {
     "qType": "U",
     "qnDec": 10,
     "qUseThou": 0,
     "qFmt": "",
     "qDec": "",
     "qThou": "",
   }
  "qLabel": "",
  "qLabelExpression": "",
  "id": "customTooltipExpression"
},
{
  "qExpression": "sum(population)",
  "qLibraryId": "",
  "qAttribute": true,
  "qNumFormat": {
     "qType": "M",
     "qnDec": 2,
     "qUseThou": 0,
     "qFmt": "$#,##0.00;-$#,##0.00",
     "qDec": ".",
     "qThou": ",",
   }
  "qLabel": "",
  "qLabelExpression": "=avg(population)",
  "id": "customTooltipExpression"
},
{
  "qExpression": "'https://my_url/'+sum(population)",
  "qLibraryId": "",
  "qAttribute": true,
  "qNumFormat": null,
  "qLabel": "",
  "qLabelExpression": "",
  "cId": "generatedUniqueId",
  "id": "customTooltipImages"
}]
```

Difference

object

Properties

showExcludedValues
boolean

Shows the excluded values (values not in the current selection) in the difference.

type
string

This should be set to "difference".

accumulationDimension:
number

Only applicable when there are two dimensions. Selects the dimension on which the difference will take place. If the difference is made across multiple dimensions, this will be the first dimension.

crossAllDimensions
boolean

Only applicable when there are two dimensions. Continues the difference across both dimensions.

disabled
boolean

No description

DimensionForecast

object

Properties

steps
default=3
number

Number of forecast steps

stepSize
default='days'
number

No description

stepSizeMultiplier
default=1
number

No description

DimensionProperties

object
extendsNxDimension

Extends NxDimension, see Engine API: NxDimension.

Properties

qAttributeDimensions

No description

qDef

Extends NxInlineDimensionDef, see Engine API: NxInlineDimensionDef.

dimRefLine

object

Properties

label
string

Reference line label.

paletteColor

Color information structure. Holds the actual color and index in palette.

refLineExpr

No description

show
default=true
boolean | ValueExpression

Set to true to display this reference line.

align
default='center'
'start' | 'center' | 'end'

Set alignment for this reference line

coloredBackground
default=false
boolean

Set to true to fill the label and/or value of this reference line with this color

showLabel
default=true
boolean

Set to true to show the label of this reference line.

showValue
default=true
boolean

Set to true to show the value of this reference line.

style

Styling settings for reference line

FontStyling

object

Properties

color

Color information structure. Holds the actual color and index in palette.

fontFamily
string

No description

fontSize
string

No description

ForecastAttributes

object
extendsNxAttrExprDef

Extends NxAttrExprDef, see Engine API: NxAttrExprDef.

Properties

id
'forecast' | 'forecast_lower' | 'forecast_lower'

Indicates how the attribute expression will be interpreted by the chart. forecast: forecast line forecast_lower: lower edge of forecast confidence interval forecast_upper: upper edge of forecast confidence interval

ImageComponent

object

Image component information structure.

Properties

cId
string

Identifier of the image component - used as a link with an attribute expression

ref
string | StringExpression | MediaLibraryRef

The reference value of the image

size
string

Size as 'small','medium','large' or 'original'

type
string

Input type as 'url' or 'media library'

InlineDimensionDef

object
extendsNxInlineDimensionDef

Extends NxInlineDimensionDef, see Engine API: NxInlineDimensionDef.

Properties

forecast

No description

othersLabel
string | StringExpression

No description

autoSort
boolean

Set to automatically sort the dimension.

cId
string

ID used by the Qlik Sense. Must be unique within the current chart.

InlineMeasureDef

object
extendsNxInlineMeasureDef

Extends NxInlineMeasureDef, see Engine API: NxInlineMeasureDef.

Properties

forecast

No description

isCustomFormatted
boolean

Set to true to toggle off the default client formatting.

numFormatFromTemplate
default=true
boolean

When enabled, the number format to use can be selected from multiple predefined formats based on the desired type (number, date).

othersLabel
string | StringExpression

No description

autoSort
boolean

Set to automatically sort the measure.

cId
string

ID used by the Qlik Sense. Must be unique within the current chart.

modifiers
Array<Modifier>

Set to apply a modifier to a measure.

style

Can be used to change the line thickness, line type, and line curve for one of the lines. These style settings will override the components styling settings.

Label

object

Properties

key
string

This should be set to "label" (Determines which component the settings apply to).

label

No description

LabelNameStyling

object

Properties

name

No description

LabelValueStyling

object

Properties

value

Data points labels

Legend

object

Properties

key
string

This should be set to "legend" (Determines which component the settings apply to).

legend

No description

LegendStyling

object

Properties

label

No description

title

No description

Line

object

Properties

key
string

This should be set to "line" (Determines which component the settings apply to).

style

No description

LineStyling

object

Properties

dataPointSize
default=6
number

Set to specify the size of the data point.

lineCurve
default="linear"
'linear' | 'monotone'

No description

lineThickness
default=1
number

Set to specify line thickness. Can be set from 1 to 5.

lineType
default="solid"
'solid' | 'dashed'

No description

MasterVisualizationChart

object

Chart component information structure.

Properties

object

Chart component information structure.

style

Chart component information structure.

MasterVisualizationChartObject

object

Chart component information structure.

Properties

refId
string

Input field containing the qExtendsId of the visualization, where qExtendsId is the unique id of the master visualization

MasterVisualizationChartStyle

object

Chart component information structure.

Properties

size
string

Input type as 'small' or 'medium' or 'large'

MeasureForecast

object

Properties

confidence
default=0.95
number

Only relevant when method is 'SSA' and showConfidence is true. should be between 0 and 1 (exclusive)

enabled
default=false
boolean

No description

lineCurve
default="linear"
'linear' | 'monotone'

No description

lineThickness
default=1
number

Set to specify line thickness. Can be set from 1 to 5.

lineType
default="dashed"
'solid' | 'dashed'

No description

method
default='ssa_forecast'
'ssa_forecast' | 'ols_forecast'

Forecast method

paletteColor

Color information structure. Holds the actual color and index in palette.

showConfidence
default=true
boolean

Only used when method is 'SSA'

MeasureProperties

object
extendsNxMeasure

Extends NxMeasure, see Engine API: NxMeasure.

Properties

qAttributeExpressions

No description

qDef

Extends NxInlineMeasureDef, see Engine API: NxInlineMeasureDef.

MediaLibraryRef

object

Media Library Reference structure.

Properties

qStaticContentUrlDef
object

Media library structure

type Modifier

Accumulation | Difference | MovingAverage

MovingAverage

object

Properties

fullRange
boolean

Select whether the moving average will happen on the Full range or Custom range.

nullSuppression
boolean

Choose to have null values calculated by the moving average modifier.

showExcludedValues
boolean

Shows the excluded values (values not in the current selection) in the moving average.

type
string

This should be set to "movingAverage".

accumulationDimension:
number

Only applicable when there are two dimensions. Selects the dimension on which the moving average will take place. If the moving average is made across multiple dimensions, this will be the first dimension.

crossAllDimensions
boolean

Only applicable when there are two dimensions. Continues the moving average across both dimensions.

disabled
boolean

No description

steps
number

Only applicable when fullRange is set to false. The number of steps in the dimension which form a moving average. Only zero and positive integers are accepted. Note: Sorting order of dimension values (or step order) is important and affects results.

paletteColor

object

Color information structure. Holds the actual color and index in palette.

Properties

color
string

Color as hex string (mandatory if index: -1)

index
number

Index in palette

qStaticContentUrlDef

object

Media Library structure that will be evaluated by the engine.

Properties

qUrl
string

Value of media library image

refLine

object

Properties

label
string

Reference line label.

paletteColor

Color information structure. Holds the actual color and index in palette.

refLineExpr

No description

show
default=true
boolean | ValueExpression

Set to true to display this reference line.

coloredBackground
default=false
boolean

Set to true to fill the label and/or value of this reference line with this color

showLabel
default=true
boolean

Set to true to show the label of this reference line.

showValue
default=true
boolean

Set to true to show the value of this reference line.

style

Styling settings for reference line

refLineStyle

object

Styling settings for reference line

Properties

lineThickness
default=2
number

Set the thickness for this reference line.

lineType
default=''
string

Set the dash type for this reference line.

Was this page helpful?