> 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.5/webanwendung/sichten/webreport/grundlagen/datenzugriff/werteabfrage.md).

# Werteabfrage

Im Bereich Wertabfrage können mehrere Tabellen mit unterschiedlichen zeitlichen Abfragen und Messgrößen angelegt werden. Das Einfügen einer weiteren (neuen) Tabelle geschieht über die Taste *+Neue*.

## Abfragetyp

Für jede Tabelle der Wertabfrage kann der Abfragetyp eingestellt werden. Folgende Abfragetypen sind möglich:

* Keine
* Tagesabfrage
* Wochenabfrage
* Monatsabfrage
* Jahresabfrage

Der Abfragetyp legt das zeitliche Raster der Abfrage fest. Der Abfragetyp *Keine* ist ein Typ wo der Abfragezeitraum nicht vom Wisch-Zeitraster beeinflusst wird.

Um z.B. für einen Jahresbericht Daten von Messgrößen abzufragen, wird typischerweise der Abfragetyp auf Jahresabfrage gestellt.

## Startzeit

Die Startzeit ergibt in Kombination mit dem Abfragetyp der Abfragezeitraum. Folgende Startzeit Einträge sind verfügbar:

* Automatisch
* Relativ
* Absolut

### Automatisch

Im Modus Automatisch ergibt sich die Startzeit aus dem Wisch-Zeitraster die bei den Eigenschaften eingestellt wurden.

Bei einem Wisch-Zeitraster von 1 Jahr und einem Abfragetyp von Jahresabfrage ergibt sich ein Abfragezeitraum von genau einem Jahr beginnend am 1 Januar.

#### Beispiel

01.01.2022 00:00:00 – 01.01.2023 00:00:00

### Relativ

Im Modus Relativ ergibt sich der Abfragezeitraum aus den folgenden Parametern:

* Versatz (Zeiteinheit)
* Dauer (Zeiteinheit)
* Bezug (Keine oder Zeiteinheit)
* Der **Versatz** kann den Zeitraum verschieben. Der Versatz kann auch negativ sein.
* Die **Dauer** ist die Dauer des Abfragezeitraumes.
* Der **Bezug** beeinflusst die Startzeit. Damit kann der Zeitpunkt z.B. am aktuellen Tag oder am aktuellen Monat beginnen.
* Die **Zeiteinheit** kann zwischen Millisekunden und Jahre eingestellt werden.

#### Beispiel

In diesem Beispiel werden Daten für 2 Jahre abgefragt. Durch den Bezug wird der Abfragezeitraum beim aktuellen Tag begonnen und noch um 1 Jahr verschoben:

<table><thead><tr><th width="218"></th><th></th></tr></thead><tbody><tr><td>Aktuelles Jahr:</td><td>2022</td></tr><tr><td>Abfragetyp:</td><td>Jahresabfrage</td></tr><tr><td>Startzeit:</td><td>Relativ</td></tr><tr><td>Versatz:</td><td>-1 Jahr</td></tr><tr><td>Dauer:</td><td>2 Jahre</td></tr><tr><td>Bezug:</td><td>Tage</td></tr><tr><td>Abfragezeitraum (Vorschau):</td><td>12.02.2019 00:00:00 - 12.02.2021 00:00:00</td></tr></tbody></table>

### Absolut

Im Modus Absolut wird der Abfragezeitraum fest vorgegeben.

#### Beispiel

<table><thead><tr><th width="218"></th><th></th></tr></thead><tbody><tr><td>Abfragetyp:</td><td>Jahresabfrage</td></tr><tr><td>Startzeit:</td><td>Absolut</td></tr><tr><td>Von:</td><td>2022</td></tr><tr><td>Bis:</td><td>2023</td></tr><tr><td>Abfragezeitraum (Vorschau):</td><td>01.01.2022 00:00:00 - 01.01.2023 00:00:00</td></tr></tbody></table>

## Messgrößen der Tabelle zuweisen

Bei einem neuen Bericht oder einer neuen Tabelle ist der Eintrag *Timestamp* schon vorhanden. Dabei handelt es sich um den Zeitstempel der Messgrößen. Die gewünschten Messgrößen werden per Drag\&Drop aus der Objektliste in die Liste der Messgrößen eingetragen. Durch das Betätigen der Lösch-Schaltfläche, erkennbar durch das Papierkorb-Symbol, kann eine Messgröße wieder aus der Liste der Messgrößen entfernt werden.

Beim Einfügen der Messgrößen in die Liste, wird die Verdichtungsstufe der Messgröße, abhängig der Abfragetyp, automatisch gesetzt. Zum Beispiel bei einer *Jahresabfrage* bekommen die Messgrößen automatisch die Verdichtungsstufe *Monate* gesetzt. Bei Abfragetyp *Monate* wiederum wird die Verdichtungsstufe *Tage* als Standard gesetzt. Eine gewünschte Änderung der Verdichtungsstufe kann nachdem Einfügen einer Messgröße vorgenommen werden.

Eine Messgröße kann mehrfach in die Liste der Messgrößen eingefügt werden. Mit der Voraussetzung, dass immer unterschiedliche Verdichtungsstufen eingestellt sind.

{% hint style="info" %}
Es können auch Jahreswerte in einer Jahresabfrage sinnvoll sein. Die Jahreswerte können in der Fußzeile vom Jahresbericht verwendet oder als Textobjekt angezeigt werde. Dazu würde man eine zweite Tabelle als Wertabfrage anlegen.
{% endhint %}


---

# 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.5/webanwendung/sichten/webreport/grundlagen/datenzugriff/werteabfrage.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.
