# Datenzuordnung

Mit der **Datenzuordnung** kannst du Felder eines CMS-Elements dynamisch mit Daten der aktuellen Seiten-Entität (z.B. Kategorie) befüllen. So zeigt z.B. ein Teaser auf einer Kategorieseite automatisch das Kategoriebild und den Kategorienamen an - ohne manuelle Eingabe.

{% hint style="warning" %}
**Wichtig**: Diese Funktion ist nur in der ThemeWare® Pro Edition verfügbar.
{% endhint %}

***

## Anleitung

#### Datenzuordnung zuweisen

1. Öffne die Erlebniswelt einer **Kategorieseite** im CMS-Editor
2. Füge ein unterstütztes CMS-Element ein (z.B. einen Teaser)
3. Klicke in der Element-Konfiguration beim gewünschten Feld auf den Button **"Datenzuordnung"** (1)
4. Wähle die gewünschte Entitäts-Eigenschaft aus (2 – z.B. `category.name` für den Kategorienamen)
5. Speichere die Erlebniswelt

Das Feld wird nun auf jeder Kategorieseite automatisch mit den Daten der jeweiligen Kategorie befüllt.

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

{% hint style="success" %}
**Tipp**: Du kannst in dem Dropdown auch Zusatzfelder (abhängig vom CMS-Layout-Typ) auswählen.
{% endhint %}

#### Datenzuordnung entfernen

Wurden Daten zugewiesen, wird anstelle der Konfiguration ein entsprechender Hinweis (3) in der Element-Konfiguration angezeigt.

Über den Button "Datenzuordnung entfernen" (4) kannst du die Zuweisung jederzeit wieder aufheben.

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

***

## Unterstützte Elemente und Felder

Die Datenzuordnung haben wir in möglichst vielen CMS-Elementen verfügbar gemacht. Ausgenommen sind nur die Elemente, die ohnehin eindeutig verlinkt werden müssen und bei denen eine dynamische Datenzuordnung deshalb keinen echten Mehrwert bringt.

> Dazu kommen noch ein paar Grenzfälle – zum Beispiel Teaser mit Buttons oder Banner, die grundsätzlich verlinkt sein sollten. Hier möchten wir euch bewusst etwas Spielraum lassen: Nicht jedes Element muss die Datenzuordnung nutzen, wenn sie im jeweiligen Fall einfach keinen Sinn ergibt.

### Teaser

| CMS-Element            | Bild | Überschrift/Titel | Text |
| ---------------------- | ---- | ----------------- | ---- |
| Advanced-Teaser        | x    | x                 | x    |
| Classic-Teaser         | x    | x                 |      |
| Hero-Teaser            | x    | x                 | x    |
| Hover-Box              | x    | x                 | x    |
| Image-Teaser           | x    |                   |      |
| Modern-Teaser          | x    | x                 |      |
| Runder Teaser          | x    | x                 |      |
| Teaser                 | x    | x                 |      |
| Text-Teaser            | x    | x                 |      |
| Text-Teaser (verziert) | x    | x                 |      |

### Banner

| CMS-Element     | Bild | Überschrift/Titel | Text |
| --------------- | ---- | ----------------- | ---- |
| Advanced-Banner | x    | x                 | x    |
| Hero-Banner     | x    | x                 | x    |
| Image-Banner    | x    |                   |      |
| Parallax-Banner | x    | x                 |      |

### Sonstiges

| CMS-Element             | Bild | Überschrift/Titel | Text |
| ----------------------- | ---- | ----------------- | ---- |
| Bild & Text überlagernd | x    | x                 | x    |

{% hint style="info" %}

#### Tipp: Zusatzfelder nutzen

Neben den Standard-Eigenschaften (z.B. `product.name` oder `category.media`) kannst du auch **ThemeWare® Zusatzfelder** per Datenzuordnung mappen. So lässt sich z.B. die Kurzbeschreibung statt der Standard-Produktbeschreibung verwenden.
{% endhint %}

***

## Einschränkungen

* Die Datenzuordnung funktioniert nur auf Seiten mit einer zugewiesenen Entität (z.B. Kategorie- oder Produktseiten)
* Auf statischen Erlebniswelten (z.B. Landingpages) steht keine Entität zur Verfügung - die Felder bleiben leer
* Felder mit aktiver Datenzuordnung können nicht gleichzeitig manuell befüllt werden
* Der "Datenzuordnung"-Button ist nur sichtbar, wenn die Erlebniswelt einem Seitentyp mit Entität zugewiesen ist (z.B. Kategorie- oder Produktseiten)


---

# 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://doku.themeware.design/zusatzfunktionen/cms-erweiterungen/cms-elemente/datenzuordnung.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.