# Benutzerdefinierte Analysen

<figure><img src="https://3195545272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-d61c3469b2516c1c74f1c382fa03a7c10db659b6%2FCustom%20Analytics.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:blau;">**`Benutzerdefinierte Analysen`**</mark> befindet sich derzeit in **Beta**.\
Es wird nach der offiziellen Veröffentlichung eine kostenpflichtige Funktion.
{% endhint %}

***

## Wichtige Highlights

* Verwende SQL, um deine BoxHero-Daten abzufragen.
* Kombiniere Bedingungen (z. B. Artikel, Attribut, Preis, Datumsbereich, Partner), um die Daten zu definieren, die du als benutzerdefinierten Bericht zurückgeben möchtest.
* Speichere Abfragen, die du häufig verwendest, und öffne sie jederzeit erneut.
* Exportiere Ergebnisse für zusätzliche Analysen oder Berichte nach Excel.

## Wann benutzerdefinierte Analysen verwendet werden sollten

Der Standard <mark style="color:blau;">**`Inventarberichte`**</mark> -Funktion bietet dir 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 dein Team benötigt.

<mark style="color:blau;">**`Benutzerdefinierte Analysen`**</mark> gibt dir mehr Kontrolle darüber, wie du deine Daten untersuchst. Es ist besonders nützlich, wenn:

* Du die benötigten Daten in den standardmäßigen [Inventarberichte](https://www.boxhero.io/docs/documentation/de/weitere-funktionen/analytics)
* Du Daten nach Artikel, Lieferant, Kunde, Teammitglied oder anderen detaillierten Bedingungen filtern oder gruppieren möchtest
* Du zeitbasierte Analysen wie monatlich, vierteljährlich oder im Jahresvergleich benötigst
* Du Berichte speichern möchtest, auf die du angewiesen bist, und sie erneut verwenden willst
* Du flexible Daten benötigst, um Berichte oder Entscheidungen zu unterstützen

***

## So verwendest du benutzerdefinierte Analysen

### 1. Erste Schritte

Gehe zu <mark style="color:blau;">**`Berichte`**</mark> > <mark style="color:blau;">**`Benutzerdefinierte Analysen`**</mark>. Dadurch wird ein neuer Arbeitsbereich geöffnet, in dem du deine SQL-Abfragen erstellen und verwalten kannst. Wähle dann <mark style="color:blau;">**`+ Neu`**</mark> aus, um eine neue Abfrage zu erstellen.

<figure><img src="https://3195545272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-6960754566997f8dfd56a04778905774d0b8c7d2%2Fcustom-analytics-welcome.png?alt=media" alt=""><figcaption></figcaption></figure>

### 2. Eine Abfrage schreiben

Abfragen verwenden [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction). Du kannst die <mark style="color:blau;">**`AI Prompt`**</mark> -Datei herunterladen, um alle verfügbaren Tabellen und Spalten zu sehen.

<figure><img src="https://3195545272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-565c3ed88b69c6de48e7fade26e3212a3f034b19%2Fcustom-analytics-new-query.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Wenn du **KI-Tools** wie ChatGPT oder Gemini verwendest, hilft das Anhängen der "*AI Prompt"* -Datei dabei, präzises SQL zu erzeugen.
{% endhint %}

Wähle <mark style="color:blau;">**`Ausführen`**</mark> aus, um deine Abfrage zu testen. Da die Ergebnisse von den Bedingungen abhängen, die du schreibst, überprüfe die Ausgabe, um zu bestätigen, dass sie deinen Erwartungen entspricht.

Nachdem deine Abfrage erfolgreich ausgeführt wurde, kannst du die Ergebnisse mit <mark style="color:blau;">**`Nach Excel exportieren`**</mark>.

<figure><img src="https://3195545272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-cfc1d5c123f1352a5b6093f60ecedf6bc75136ae%2Fcustom-analytics-execute-sql-query.png?alt=media" alt=""><figcaption></figcaption></figure>

### 3. Eine Abfrage speichern

Wenn du eine Abfrage wiederverwenden möchtest, wähle <mark style="color:blau;">**`Speichern`**</mark> in der oberen rechten Ecke.

Gespeicherte Abfragen erscheinen in der linken Seitenleiste, wo du sie jederzeit öffnen und ausführen kannst.

<figure><img src="https://3195545272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-fbbe3777b87c3433ebdf88f73707514a4661997c%2Fcustom-analytics-monthly-revenue-spend.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Deine Daten werden automatisch synchronisiert **einmal pro Tag**.\
Um sofort zu synchronisieren, klicke unten in der Seitenleiste auf das Synchronisierungssymbol (🔄).
{% endhint %}

***

## Abfragevariablen

Wenn du `{{variable_name}}` in deine Abfrage einfügst, wird beim Ausführen der Abfrage automatisch ein Eingabefeld erstellt. Der in dieses Feld eingegebene Wert wird auf die Variable in deiner SQL-Abfrage angewendet.

Wenn du eine Abfrage speicherst, können deine 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, gib die folgende Abfrage ein:

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

2. Wenn du die Abfrage ausführst, erscheint ein Eingabefeld mit dem Namen **item\_name** .

<figure><img src="https://3195545272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-0e37f6dcdc52cfcb1415c0e175422f65a0f0f922%2Fcustom-analytics-query-variables.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3195545272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-6b0e5a3a5d226e5f678354e11ede42ce36f514eb%2Fcustom-analytics-query-variables-keyword.png?alt=media" alt=""><figcaption></figcaption></figure>

4. Speichere die Abfrage, wenn du sie erneut verwenden möchtest. Du kannst gespeicherte Abfragen jederzeit über das linke Menü auswählen und laden.

<figure><img src="https://3195545272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-b428ef1d1d046a131901affe11e06926f0910343%2Fcustom-analytics-saved-query-variables.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## Anwendungsfälle

Benutzerdefinierte Analysen enthalten integrierte Vorlagen, die du sofort ausführen kannst. Sieh dir eine Vorlage an, um zu verstehen, wie sie funktioniert, und passe sie dann an oder erstelle eine neue Abfrage nach deinen Bedürfnissen.

#### Vorlagen

* Wöchentlicher Ein-/Ausgangsbericht für Lagerbestände
* Monatlicher Einkaufs- und Verkaufstrend
* Letztes Ausgangsdatum nach Artikel

<figure><img src="https://3195545272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-5bfafcad6d5c7a69353ac530532be7fd32f542b5%2Fcustom-analytics-saved-template-example.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## Häufig gestellte Fragen (FAQ)

### Kann ich Daten aus mehreren Teams kombinieren?

Nein. Die Daten sind nach Team getrennt, und du kannst nur Daten aus dem Team analysieren, in das du derzeit eingeloggt bist.

### Kann ich Mitglieder daran hindern, benutzerdefinierte Analysen zu verwenden?

Admins und Mitglieder können Abfragen erstellen und ansehen. Mitglieder mit benutzerdefinierten Berechtigungen *haben* keinen

Zugriff auf diese Funktion. Wenn du den Zugriff für ein Mitglied einschränken musst, weise ihm eine [benutzerdefinierte Berechtigung](https://www.boxhero.io/docs/documentation/de/einstellungen/members#custom-roles-and-permissions) mit **allen ausgewählten Berechtigungen**zu. Benutzerdefinierte Analysen sind *nicht* in den Optionen für benutzerdefinierte Berechtigungen enthalten, daher hat das Mitglied selbst bei allen ausgewählten Berechtigungen keinen Zugriff.

<figure><img src="https://3195545272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-ed545f8a01d471bb0d774157ef6209e756574a4c%2Fcustom-analytics-member-permissions.png?alt=media" alt=""><figcaption></figcaption></figure>