> For the complete documentation index, see [llms.txt](https://docs.videc.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.videc.de/june5-3.7/en/webanwendung/sichten/dashboard.md).

# Dashboard

Dashboards are very advantageous when it comes to presenting multiple different types of data from a single access point, including reports, analyses, and other content. The information contained in these dashboards is packaged in so-called widgets. Widgets are graphical and tabular components for functions that are positioned and configured on the dashboard.

## Properties

The following properties can be configured in the *Properties window*:

* Name
* Identification
* Minimum Grid Columns
* Minimum Grid Rows
* Grid Type (Fit to View, Fixed, Scrollbar)
* Automatic Refresh
* [Print](/june5-3.7/en/webanwendung/sichten/drucken.md)

## Toolbar

The toolbar provides buttons for the following settings.

* Refresh *(loads newly occurred values from the data source).*
* Edit *(switches the edit mode for widgets on and off).*
* Add Widget *(Opens the selection of possible widgets and object types)*
* Automatic Refresh *(Opens the configuration for automatic dashboard refresh)*
* Arrange Widgets (Depending on the option, the widgets are rearranged so that there are no free spaces on the left and top.)

o Compact upward (All widgets are moved upward so that any gaps above or below the widgets are closed).

o Compact left (All widgets are moved to the left so that any gaps in the left area of the widgets are closed).

o Compact left & top (All widgets are first moved to the left and then upward so that any gaps below, above, and in the left area of the widgets are closed).

o Compact top & left (All widgets are first moved upward and then to the left so that any gaps below, above, and in the left area of the widgets are closed).

## Edit Mode (Widgets)

Only after activating edit mode are the following actions enabled for widgets:

* Change position of widgets
* Resize widgets
* Edit widgets
* Delete widgets

In the deactivated state, only the actions Full Screen Mode and, if applicable, the Online Mode action can be used.

## Inserting Objects (Widgets) into the Dashboard

After clicking on the button with the *plus symbol* in the toolbar, a window appears in which the entry *Dashboard* is selected. Subsequently, in the object list on the left, the desired objects can be added to the dashboard. This is done by clicking on the auxiliary button with three dots to the right of the objects. Furthermore, there is the option to insert widgets into the dashboard. There are two ways to do this.

### Option 1

In the toolbar, first click on the *plus button* (+). In the following modal window, two options are available: *New* and *Template*.

Under the entry *New*, a new widget can be inserted, which can be configured immediately afterwards.

Under the entry *Template Objects*, all previously existing, pre-configured custom objects can be added as widgets.

### Option 2

This option follows via gesture control. First, the area for the widget is marked on the grid via drag and drop. Here, the mouse pointer is dragged over the cells with the left mouse button held down, and only released when the desired area is reached. After releasing, the same modal window opens as in option 1. All further steps follow the same way as in option 1.

## Change Position of a Widget

After dashboard editing is activated, there is the option to move existing widgets to a different position within the dashboard. To do this, move the mouse pointer over the widget. With the left mouse button held down, the widget can now be moved to the desired position. Once the position is reached, the mouse button is released.

## Resize a Widget

After dashboard editing is activated, there is the option to resize existing widgets. To do this, move the mouse pointer to the bottom right corner of a widget. With the left mouse button held down, the size of the widget can now be changed.

## Edit Widgets

A widget present in the dashboard can be edited afterwards. This is done via the Edit button, recognizable by the *pencil icon*. Subsequently, the window for editing opens.

{% hint style="info" %}
All changes to widgets or dashboards must be saved using the Save button in the toolbar.
{% endhint %}

## Delete Widgets

Deletion is done via the Delete button, recognizable by the *trash icon*. When this is pressed, the widget is subsequently irrevocably deleted.

## Widget - Full Screen Display

The full screen display of widgets is done via the Fullscreen button, recognizable by the *rectangle icon*.

## Delete Dashboards

To delete a dashboard, the auxiliary button with three dots can be pressed in the object list to the right of the dashboard. In the following dropdown menu, the delete button appears, recognizable by the *trash icon*. When this is pressed, the dashboard is subsequently irrevocably deleted.

## Automatic Refresh of Dashboard

A dashboard can be automatically refreshed at regular intervals. Activation is done in the toolbar via the button with the *clock* symbol and the label *auto. Refresh*.

During automatic refresh, all *widget buttons*, except the *play button (Online Mode*), are disabled!

Please note that for widgets where online mode is already running, automatic refresh is ignored.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.videc.de/june5-3.7/en/webanwendung/sichten/dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
