> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/documentation/de/weitere-funktionen/custom-analytics.md).

# Benutzerdefinierte Analysen

<figure><img src="/files/2e59d08aeb115959ab17368cb600fa512ce54df3" alt=""><figcaption></figcaption></figure>

***

## Wichtige Highlights

* Stellen Sie Fragen in einfacher Sprache und der **KI-Assistent** schreibt das SQL für Sie.
* Verwenden Sie SQL, um Ihre BoxHero-Daten abzufragen.
* Kombinieren Sie Bedingungen (z. B. Artikel, Attribut, Preis, Datumsbereich, Partner), um die Daten zu definieren, die Sie als benutzerdefinierten Bericht zurückgeben möchten.
* Speichern Sie Abfragen, die Sie häufig verwenden, und öffnen Sie sie jederzeit erneut.
* Exportieren Sie Ergebnisse zur weiteren Analyse oder Berichterstattung nach Excel.

## Anwendungsfälle

Die Standard- <mark style="color:$primary;">`Bestandsberichten`</mark> Funktion bietet Ihnen einen schnellen Überblick über wichtige Kennzahlen wie den durchschnittlichen Lagerbestand und den Lagerumschlag für einen ausgewählten Zeitraum. Da diese Berichte vordefinierte Formeln und Felder verwenden, decken sie möglicherweise nicht jede Art von Analyse ab, die Ihr Team benötigt.

<mark style="color:$primary;">`Benutzerdefinierten Analysen`</mark> gibt Ihnen mehr Kontrolle darüber, wie Sie Ihre Daten untersuchen. Sie ist besonders nützlich, wenn:

* Sie die benötigten Daten in der Standard- [Bestandsberichten](/docs/documentation/de/weitere-funktionen/analytics.md)
* Sie Daten nach Artikel, Lieferant, Kunde, Teammitglied oder anderen detaillierten Bedingungen filtern oder gruppieren möchten
* Sie zeitbasierte Analysen wie monatliche, vierteljährliche oder im Jahresvergleich benötigen
* Sie Berichte speichern möchten, auf die Sie sich verlassen, und sie erneut verwenden
* Sie flexible Daten benötigen, um Berichte oder Entscheidungen zu unterstützen

***

## So verwenden Sie benutzerdefinierte Analysen

### 1. Erste Schritte

Gehen Sie zu <mark style="color:$primary;">`Berichte`</mark> > <mark style="color:$primary;">`Benutzerdefinierten Analysen`</mark>. Dadurch wird ein neuer Arbeitsbereich geöffnet, in dem Sie Ihre SQL-Abfragen erstellen und verwalten können. Wählen Sie dann <mark style="color:$primary;">`+ Neu`</mark> um eine neue Abfrage zu erstellen.

<figure><img src="/files/7d97ea4b7777758d0d17c688ab53baf76caf867d" alt=""><figcaption></figcaption></figure>

### 2. Eine Abfrage schreiben

Es gibt zwei Möglichkeiten, Abfragen zu schreiben:

1. **Verwenden Sie den KI-Assistenten** um SQL aus einer Frage in einfacher Sprache zu generieren (für die meisten Benutzer empfohlen).
2. **SQL direkt schreiben** mit [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

<figure><img src="/files/889ad43f94b5dc60a3b87b5c3528e30ad503cda8" alt=""><figcaption></figcaption></figure>

#### Die Verwendung des KI-Assistenten

Die <mark style="color:$primary;">`KI-Assistent`</mark> verwandelt Fragen in einfacher Sprache in funktionierende SQL-Abfragen. Sie müssen SQL nicht kennen, um ihn zu verwenden.&#x20;

Geben Sie Ihre Frage im Assistentenfenster ein und drücken Sie die Eingabetaste. Der Assistent generiert das SQL, übernimmt es in den Editor und führt es aus. Die Ergebnisse erscheinen unter der Abfrage.

Sie können das generierte SQL vor dem Speichern bearbeiten, wenn Sie etwas anpassen möchten.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

**Beispielfragen**

* Artikel unterhalb des Mindestbestands
* Was wurde in den letzten 90 Tagen nicht verkauft?
* Top 10 SKUs nach verkauften Einheiten in diesem Monat
* Offene Bestellungen nach ihrem erwarteten Ankunftsdatum
* Lagerbestände nach Standort&#x20;

#### Wiederverwendbare Abfragen erstellen

Sie können den Assistenten bitten, anpassbare Filter in eine Abfrage aufzunehmen, z. B. Datumsbereiche oder Partnernamen. Der Assistent verwendet Abfragevariablen, sodass Sie die Eingaben später ändern können, ohne das SQL neu zu schreiben.

Zum Beispiel führt die Anfrage *"Verkäufe nach Artikel für einen Datumsbereich, den ich ändern kann"* zu einer Abfrage mit einer Datumsvariable, die bei jedem Ausführen der Abfrage zur Eingabe auffordert.

<figure><img src="/files/a4aaa2496cf190924ee77a15ef425776eefd8259" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Der KI-Assistent funktioniert am besten mit **konkreten** **Fragen**. \
Statt *"Zeig mir Verkäufe,"* versuchen Sie *"die 10 umsatzstärksten Artikel dieses Monats."*
{% endhint %}

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

{% hint style="success" %}
Klicken Sie auf die <mark style="color:$primary;">`Diagramm`</mark> Schaltfläche, um die Daten zu visualisieren — Balken-, Linien-, Kreis-, gestapeltes Balken- und gestapeltes Flächendiagramm werden unterstützt.
{% endhint %}

### 3. Eine Abfrage speichern

Wählen Sie <mark style="color:$primary;">`Ausführen`</mark> um Ihre Abfrage zu testen. Da die Ergebnisse von den von Ihnen geschriebenen Bedingungen abhängen, überprüfen Sie die Ausgabe, um sicherzustellen, dass sie Ihren Erwartungen entspricht.

Wenn Sie eine Abfrage wiederverwenden möchten, wählen Sie <mark style="color:$primary;">`Speichern`</mark> in der oberen rechten Ecke. Gespeicherte Abfragen erscheinen in der linken Seitenleiste, wo Sie sie jederzeit öffnen und ausführen können.

Nachdem Ihre Abfrage erfolgreich ausgeführt wurde, können Sie die Ergebnisse mit <mark style="color:$primary;">`Nach Excel exportieren`</mark>.

<figure><img src="/files/ef328d1919f712a07b2ef9ce0086f094e68bf7b5" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Ihre Daten synchronisieren sich automatisch **einmal täglich**.\
Um sofort zu synchronisieren, klicken Sie auf das Synchronisierungssymbol (🔄) unten in der Seitenleiste.
{% endhint %}

***

## Abfragevariablen

Wenn Sie `{{variable_name}}` in Ihre Abfrage einfügen, wird automatisch ein Eingabefeld generiert, wenn die Abfrage ausgeführt wird. Der in dieses Feld eingegebene Wert wird auf die Variable in Ihrer SQL-Abfrage angewendet.

Wenn Sie eine Abfrage speichern, können Ihre Teammitglieder ihre eigenen Werte in das Variablenfeld eingeben und den Bericht jederzeit ausführen, wenn sie ihn benötigen.

#### Beispiel

1. Um nach Artikeln zu suchen, die ein bestimmtes Schlüsselwort enthalten, geben Sie die folgende Abfrage ein:

```sql
select sku, name 
from items 
where name ilike '%' || {{item_name}} || '%';
```

2. Wenn Sie die Abfrage ausführen, wird ein Eingabefeld mit dem Namen **item\_name** angezeigt.

<figure><img src="/files/f1535b6adcecbdcd3328cdd83f782fc8505fc9af" alt=""><figcaption></figcaption></figure>

3. Geben Sie ein Schlüsselwort wie *`Pullover`* ein und die Ergebnisse zeigen alle Artikel mit *„Pullover“* in ihrem Namen.

<figure><img src="/files/420d9840ce87c556d1c94efd1d9de845a4a435c4" alt=""><figcaption></figcaption></figure>

4. Speichern Sie die Abfrage, wenn Sie sie erneut verwenden möchten. Sie können gespeicherte Abfragen jederzeit über das linke Menü auswählen und laden.

<figure><img src="/files/d37b5d047b5388effe4ed6844fa2b27f7064661b" alt=""><figcaption></figcaption></figure>

***

## Beispiele

Custom Analytics enthält integrierte Vorlagen, die Sie sofort ausführen können. Sehen Sie sich eine Vorlage an, um zu verstehen, wie sie funktioniert, und passen Sie sie dann an oder erstellen Sie eine neue Abfrage auf Grundlage Ihrer Anforderungen.

#### Vorlagen

* Wöchentlicher Lager Ein-/Ausgangsbericht
* Monatlicher Kauf- und Verkaufstrend
* Letztes Ausgangsdatum nach Artikel

<figure><img src="/files/cdbdb643fc67541c5a04099af2cdaac49bc8a286" alt=""><figcaption></figcaption></figure>

***

## Häufig gestellte Fragen

**Haben Sie noch Fragen?** Sehen Sie sich unsere FAQ zu Custom Analytics an:

{% content-ref url="/spaces/XheEaMYiuftIgYOteBBt/pages/f575652148c7550c212180edef939f90d4e72989" %}
[Benutzerdefinierte Analysen](/docs/faq/de/berichte/benutzerdefinierte-analysen.md)
{% endcontent-ref %}


---

# 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, and the optional `goal` query parameter:

```
GET https://www.boxhero.io/docs/documentation/de/weitere-funktionen/custom-analytics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.