# Auswertungsvorlagen

{% hint style="info" %}
Auswertungsvorlagen sind eine kostenpflichtige Zusatzfunktion. Wenn Sie Interesse haben, kontaktieren Sie uns unter **<support@polyteia.de>**.
{% endhint %}

Stellen Sie sich vor, Sie haben eine Auswertung erstellt, die genau zeigt, was Sie brauchen. Jetzt möchten Sie, dass andere Teams oder Organisationen dieselbe Auswertung mit ihren eigenen Daten nutzen können. Genau dafür gibt es Auswertungsvorlagen.

### Was ist eine Auswertungsvorlage?

Eine Vorlage ist wie ein Rezept. Sie enthält die Anleitung (die Abfrage und die Visualisierung), aber nicht die Zutaten (Ihre Daten). Andere Nutzer können das Rezept nehmen und mit ihren eigenen Zutaten nachkochen.

### Was wird in der Vorlage gespeichert?

Eine Vorlage enthält:

* **SQL- oder Baukasten-Abfrage**
* **Datensatz-Systemnamen und Spaltennamen** der verwendeten Datensätze
* **Visualisierungseinstellungen** (Diagrammtyp, Farben usw.)

{% hint style="info" %}
Es werden **keine Daten** geteilt. Datensätze und deren Inhalte bleiben privat – nur Referenzen zu Datensätzen und die Konfiguration der Auswertung kommen in die Vorlage.
{% endhint %}

### Wann ist das nützlich?

* Mehrere Organisationen sollen dieselbe Auswertung nutzen, aber mit eigenen Daten
* Sie möchten eine bewährte Auswertung als Vorlage für andere bereitstellen
* Teams sollen eine einheitliche Auswertungsstruktur verwenden

***

## Vorlage erstellen

{% stepper %}
{% step %}
**Auswertung öffnen**

Öffnen Sie die Auswertung, aus der Sie eine Vorlage erstellen möchten. Die Auswertung muss eine gespeicherte Abfrage haben.
{% endstep %}

{% step %}
**Vorlage erstellen wählen**

Klicken Sie auf das Drei-Punkte-Menü **...** in der oberen rechten Ecke. Wählen Sie **Vorlage erstellen**.

{% hint style="info" %}
Diese Option erscheint nur, wenn Sie die Auswertung bearbeiten dürfen und Zugriff auf alle darin verwendeten Datensätze haben.
{% endhint %}
{% endstep %}

{% step %}
**Sicherheitshinweis bestätigen**

Sie sehen einen Hinweis, welche Informationen in der Vorlage enthalten sind. Lesen Sie diesen durch und klicken Sie auf **Speichern & Vorlage erstellen**.

{% hint style="info" %}
Mögliche ungespeicherte Änderungen werden vor dem Erstellen der Vorlage automatisch gespeichert. Während dieses Vorgangs lässt sich der Dialog nicht abbrechen.
{% endhint %}

{% hint style="warning" %}
Falls in der Auswertung mehrere Datensätze denselben **Systemnamen** haben, erhalten Sie die Meldung **Doppelter Systemname**. Benennen Sie den betroffenen Datensatz um, sodass jeder Systemname eindeutig ist, und versuchen Sie es erneut.
{% endhint %}
{% endstep %}

{% step %}
**Link kopieren und speichern**

Nach der Erstellung erscheint ein Link zur Auswertungsvorlage. Kopieren Sie diesen Link und geben Sie ihn an andere Nutzer weiter.

Hinweise zum Link:

* Notieren Sie den Link jetzt – er wird nur hier angezeigt.
* Jeder Polyteia-Nutzer mit dem Link kann die Vorlage anwenden.
* Erstellen Sie jederzeit eine weitere Vorlage, um einen neuen Link zu erzeugen.
  {% endstep %}
  {% endstepper %}

***

## Vorlage anwenden

Wenn Sie einen Vorlagen-Link erhalten haben, können Sie daraus eine neue Auswertung mit Ihren eigenen Daten erstellen.

{% stepper %}
{% step %}
**Link öffnen**

Öffnen Sie den Vorlagen-Link in Ihrem Browser. Sie werden automatisch zur Vorlagen-Anwendung weitergeleitet.
{% endstep %}

{% step %}
**Lösung auswählen**

Wählen Sie, wo die neue Auswertung erstellt werden soll:

1. **Organisation** wählen (wenn Sie Zugang zu mehreren haben)
2. **Arbeitsbereich** auswählen
3. **Lösung** auswählen
4. Klicken Sie auf **Weiter**

{% hint style="info" %}
Sie können auch nach Lösungen suchen, um schneller die richtige zu finden.
{% endhint %}
{% endstep %}

{% step %}
**Name und Beschreibung anpassen**

Passen Sie den Namen und die Beschreibung der neuen Auswertung an. Die Vorschau auf der rechten Seite zeigt Ihnen, wie die Auswertung mit Ihren Daten aussehen wird.
{% endstep %}

{% step %}
**Datensätze zuordnen (optional)**

Das System versucht automatisch, passende Datensätze in Ihrer Lösung zu finden. In den meisten Fällen müssen Sie hier nichts ändern.

Wenn die automatische Zuordnung nicht klappt oder Sie sie überschreiben möchten, klicken Sie auf **Erweiterte Einstellungen**:

* In der linken Spalte sehen Sie den **Datensatz aus der Vorlage**
* In der rechten Spalte wählen Sie Ihren **eigenen Datensatz** aus der Ziellösung

{% hint style="info" %}
Der Bereich **Erweiterte Einstellungen** öffnet sich automatisch, wenn das System einem Datensatz aus der Vorlage keinen passenden Datensatz in Ihrer Lösung zuordnen konnte.
{% endhint %}

{% hint style="warning" %}
Wenn ein Warnsymbol erscheint, stimmen die Spalten oder Datentypen Ihres Datensatzes nicht mit der Vorlage überein. Die Auswertung funktioniert dann möglicherweise nicht wie erwartet.
{% endhint %}
{% endstep %}

{% step %}
**Anwenden**

Klicken Sie auf **Anwenden**. Die neue Auswertung wird in Ihrer gewählten Lösung erstellt. Sie werden automatisch zur neuen Auswertung weitergeleitet.
{% endstep %}
{% endstepper %}

***

## Systemname (Slug) für Datensätze

Damit die Vorlage Datensätze automatisch zuordnen kann, hat jeder Datensatz einen **Systemnamen**. Das ist eine kurze Kennung aus Kleinbuchstaben, Zahlen und Unterstrichen.

Der Systemname muss innerhalb einer Lösung eindeutig sein. Wenn die Ziellösung einen Datensatz mit dem gleichen Systemnamen hat, wird er automatisch vorgeschlagen.

{% hint style="info" %}
Sie können den Systemnamen eines Datensatzes in den **Datensatzdetails bearbeiten** ändern.
{% endhint %}

***

## Tipps

* **Gleiche Systemnamen verwenden**: Wenn Sie Vorlagen zwischen Organisationen teilen, verwenden Sie in allen Lösungen die gleichen Systemnamen für ähnliche Datensätze. So werden die Datensätze automatisch zugeordnet.
* **Spaltennamen beibehalten**: Damit die Vorlage korrekt funktioniert, sollten die Spaltennamen in Ihren Datensätzen mit denen aus der Vorlage übereinstimmen.
* **Vorschau prüfen**: Prüfen Sie vor dem Anwenden die Vorschau auf der rechten Seite. So sehen Sie sofort, ob die Daten richtig zugeordnet sind.
* **Erst testen, dann teilen**: Wenn Sie die Vorlage an viele Personen weitergeben möchten, testen Sie sie zuerst mit einer Person. So können Sie prüfen, ob alles wie erwartet funktioniert, bevor Sie den Link breit verteilen.


---

# 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://docs.polyteia.com/auswertungen/auswertungsvorlagen.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.
