# Line graph

**Category:** Control

**Version:** 1.0

**Last Updated:** November 27, 2025

**Author:** Any2Info

***

### 1. Description

The line graph allows visualization of a datatable (by using a dataclip) on a dashboard. The control allows basic graph related features like legends, data zooming and time based axis.

***

### 2. Mappings

This control supports the following data related properties.

| **Property** | **Note**                                                           |
| ------------ | ------------------------------------------------------------------ |
| **XItems**   | Effectively sets the content displayed on the X axis of the graph. |

Usability of this mapping depends heavily on the linked fields | | **YItems** | Effectively sets the content displayed on the Y axis of the graph, or more precisely the displayed lines.   Usability of this mapping depends heavily on the linked fields | | **YMin/YMax** | Sets the upper and lower bound of the displayed data. These mappings can be used to create a dynamic display of ranged data |

***

### 3. **Default chart**

By default a chart will show table header values on the y axis as lines, and the unique values (rows) on the X axis. The showed labels on the X axis by default will show the unique values (occurrence) for each row, in most cases this value is not display friendly, to solve this an extended mapping can be made.

### 4. **Time charts**

Whenever a graph is linked using a start and end date range it will automatically change to time chart functionality. This means the X Axis will start showing time based values.

When a true time axis, meaning time gaps should be displayed as such, you need to enable use of time axis (Properties > Axes > Use time axis). Als when enabled the displayed time labels can be formatted if needed

***

### 5. **Swapped charts**

By default a chart will show table header values on the y axis as lines, and the unique values (rows) on the X axis. In some cases the reverse is needed, meaning the dataset rows determine the lines on the y axis and the individual datapoints are based on the table headers

### 6. Events

| **Property**  | **Note**                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------------ |
| **On update** | Triggers when the graph updates its data as a result of an initial load or changed linked value. |

***

### 7. Changelog

| Version | Date              | Change                               |
| ------- | ----------------- | ------------------------------------ |
| **1.0** | November 27, 2025 | Initial documentation version added. |
