# 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 festzulegen, 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 die Ergebnisse nach Excel für zusätzliche Analysen oder Berichte.

## Anwendungsfälle

Der Standard <mark style="color:$primary;">`Bestandsberichte`</mark> Funktion bietet Ihnen einen schnellen Überblick über wichtige Kennzahlen wie die durchschnittliche Lagerbestandsmenge 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;">`Benutzerdefinierte Analysen`</mark> gibt Ihnen mehr Kontrolle darüber, wie Sie Ihre Daten erkunden. Besonders nützlich ist es, wenn:

* Sie die benötigten Daten in den Standard [Bestandsberichte](/docs/documentation/de/weitere-funktionen/analytics.md)
* nicht finden können
* Sie Daten nach Artikel, Lieferant, Kunde, Teammitglied oder anderen detaillierten Bedingungen filtern oder gruppieren möchten
* Sie Berichte speichern möchten, auf die Sie sich verlassen, und sie erneut verwenden möchten
* 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;">`Benutzerdefinierte 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> aus, um eine neue Abfrage zu erstellen.

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

### 2. Eine Abfrage schreiben

Sie haben 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>

#### Mit dem KI-Assistenten

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

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

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 Sicherheitsbestands
* Was wurde in den letzten 90 Tagen nicht verkauft?
* Top 10 SKUs nach in diesem Monat verkauften Einheiten
* Offene Bestellungen, deren erwartetes Ankunftsdatum überschritten ist
* Bestandsmengen 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 erzeugt die Anfrage *„Umsätze nach Artikel für einen Datumsbereich, den ich ändern kann“* eine 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 **spezifischen** **Fragen**. \
Statt *„Zeig mir Verkäufe,“* versuchen Sie *„Top 10 Artikel nach Umsatz in diesem Monat.“*
{% 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, prüfen Sie die Ausgabe, um sicherzustellen, dass sie Ihren Erwartungen entspricht.

Wenn Sie planen, eine Abfrage wiederzuverwenden, 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;">`In Excel exportieren`</mark>.

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

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

***

## Abfragevariablen

Wenn Sie `{{variable_name}}` in Ihre Abfrage einfügen, wird beim Ausführen der Abfrage automatisch ein Eingabefeld generiert. 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 im 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, erscheint ein Eingabefeld mit dem Namen **item\_name** .

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

3. Geben Sie ein Schlüsselwort ein, z. B. *`Pullover`* 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

Benutzerdefinierte Analysen 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 entsprechend Ihren Anforderungen.

#### Vorlagen

* Wöchentlicher Bericht über Zu- und Abgänge im Bestand
* Monatlicher Trend bei Käufen und Verkäufen
* Letztes Ausgangsdatum nach Artikel

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

***

**Sie haben weitere Fragen?** Schauen Sie sich unsere FAQ zu benutzerdefinierten Analysen an:

{% content-ref url="/spaces/XheEaMYiuftIgYOteBBt/pages/f575652148c7550c212180edef939f90d4e72989" %}
[Broken mention](broken://spaces/XheEaMYiuftIgYOteBBt/pages/f575652148c7550c212180edef939f90d4e72989)
{% endcontent-ref %}


---

# Agent Instructions: 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://www.boxhero.io/docs/documentation/de/weitere-funktionen/custom-analytics.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.