> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/feed-template-editor.md).

# Datenfelder bearbeiten

Mit dem Editor „Datenfelder bearbeiten“ legen Sie ohne Programmierkenntnisse fest, welche Produktdaten an die Suche gehen.

Mit dem Editor „Datenfelder bearbeiten“ legen Sie fest, welche Produktdaten InsightSearch für die Suche bekommt. Sie brauchen dafür keine Programmierkenntnisse. Alle verfügbaren Felder stehen als Liste da. Sie schalten Felder ein oder aus und wählen, woher der Wert kommt. Sie brauchen den Editor, wenn ein Feld in der Suche fehlt, zum Beispiel eine Eigenschaft wie „Farbe“ oder ein Zusatzfeld Ihres Shops.

## So öffnen Sie den Editor

Klicken Sie in **Quellen** oder in **Datenattribute** auf „Datenfelder bearbeiten“. Bei Push-Quellen heißt die Seite „Datenfelder bearbeiten (Push-Index)“. Den Knopf gibt es nicht, wenn die Quelle ein externer Feed ist, denn dessen Felder lassen sich hier nicht ändern.

Oben rechts stehen:

* **Speichern** (bei Push „Feldeinstellungen speichern“)
* **Export testen** (nur bei Pull): Prüft, ob der Produkt-Export von Shopware mit den Einstellungen fehlerfrei erzeugt werden kann.

Eine blaue Info-Karte fasst die wichtigsten Punkte zusammen:

* „Aktiv“ heißt: Das Feld wird übertragen und steht danach in Suche, Filtern und Suchgewichtung zur Verfügung.
* Änderungen wirken nach dem nächsten „Produktdaten neu einlesen“. Nach dem Speichern geht das direkt im Editor.
* Felder mit Schloss gibt InsightSearch fest vor. Bei eigenen Zuordnungen sollten Sie prüfen, ob Quelle und Wert passen, sonst fehlen Daten in der Suche.
* Bei Pull zeigt die Karte, ob eine dynamische Produktgruppe bestimmt, welche Produkte übertragen werden. „Dynamische Produktgruppe öffnen“ führt dorthin. Ohne Gruppe werden alle Produkte des Verkaufskanals übertragen.

## Suchen und filtern

Über der Liste finden Sie ein Suchfeld („Feldname, Eigenschaft oder Quelle …“) und einen Zähler wie „12 von 30 Feldern aktiv“. Die Auswahl-Knöpfe „Alle“, „Aktiv“, „Inaktiv“, „Pflichtfelder“ und „Empfohlen“ zeigen jeweils die Anzahl. Während Sie suchen oder filtern, sind alle Gruppen aufgeklappt. Passt nichts, steht dort „Keine Felder passen zu Suche und Filter.“

## Die Gruppen

Die Felder stehen in aufklappbaren Gruppen. Jede zeigt, wie viele ihrer Felder aktiv sind.

| Gruppe                 | Inhalt                                                                                                             |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Pflichtfelder          | Ohne diese Felder kann InsightSearch Produkte nicht in der Suche anzeigen: id, price, title, link und image\_link. |
| Produktdaten           | Standardfelder aus Shopware wie Name, Beschreibung, Marke oder Maße.                                               |
| Eigenschaften          | Eigenschaftsgruppen wie Farbe oder Größe, gut für Filter und Regeln.                                               |
| Zusatzfelder           | Die eigenen Zusatzfelder Ihres Shops.                                                                              |
| Felder anderer Plugins | Von anderen Plugins angelegte Zusatzfelder. Für die Suche meist ohne Nutzen. Die Gruppe ist zugeklappt.            |

Pflichtfelder tragen das rote Label „Pflichtfeld“. Empfohlene Felder tragen das blaue Label „Empfohlen“: availability, brand, keywords und search\_keywords. Bitte nutzen Sie nach Möglichkeit alle Pflicht- und empfohlenen Felder, das verbessert die Suche und die Produktempfehlungen.

## Die Spalten einer Zeile

| Spalte | Bedeutung                                                                                                    |
| ------ | ------------------------------------------------------------------------------------------------------------ |
| Feld   | Der lesbare Name, darunter der technische Name, unter dem das Feld in Filtern und Datenattributen erscheint. |
| Aktiv  | Ob das Feld übertragen wird. Neu übermittelte Felder sind nach dem nächsten Neu-Einlesen automatisch aktiv.  |
| Quelle | Woher der Wert kommt: „Produkt“, „Eigenschaft“, „Zusatzfeld“ oder „Fester Wert“.                             |
| Wert   | Das konkrete Feld der gewählten Quelle, zum Beispiel die Eigenschaftsgruppe „Farbe“.                         |

Bei der Quelle „Produkt“ stehen lesbare Werte zur Auswahl, etwa Produktnummer, EAN/GTIN, Name, Beschreibung, Schlüsselwörter, Suchbegriffe, Hersteller, Breite, Höhe, Länge, Gewicht, Verkaufseinheit oder Grundeinheit. „Automatisch (vom System bestimmt)“ steht bei Feldern, die InsightSearch selbst füllt. Eigenschaftsgruppen und Zusatzfelder lädt der Editor aus Ihrem Shop. Dabei erscheint „Geladen: {n} Eigenschaften, {m} Zusatzfelder für Produkte“.

### Feste Felder mit Schloss

Bei Pull gibt InsightSearch einige Felder fest vor. Sie tragen ein Schloss, der Schalter lässt sich nicht ändern, und die Herkunft steht als Text, etwa „Produkt → Name“. Bei Push gibt es keine Schlösser, dort sind alle Felder bearbeitbar.

### Eigene Felder

Den Namen eines Feldes können Sie nur ändern, wenn Sie es selbst angelegt haben. Bei Push legen Sie mit „Benutzerdefiniertes Feld hinzufügen“ ein neues Feld an. Es erscheint als neue Zeile mit der Quelle „Zusatzfeld“ und ist aktiv.

### Das Feld „Badge“

Ein Badge ist das kleine Etikett auf der Produktkarte, zum Beispiel „Sale“ in Rot. Für das Feld gibt es einen eigenen Regel-Editor. Je Regel legen Sie fest, woher der Text kommt („Text aus“, „Textfeld“) und woher die Farbe („Farbe aus“, „Farbe / Farbfeld“ oder bei „Feste Farbe“ ein Farbwähler). „Badge-Regel hinzufügen“ legt eine weitere Regel an, „Entfernen“ löscht eine. Mindestens eine Regel bleibt bestehen.

## Speichern und neu einlesen

1. Nehmen Sie Ihre Änderungen vor.
2. Klicken Sie auf **Speichern**. Es erscheint „Datenfelder gespeichert.“
3. Ein blauer Kasten sagt: „Gespeichert. Damit die Suche die neuen Felder kennt, die Produktdaten einmal neu einlesen.“ Klicken Sie auf **Jetzt neu einlesen**.

Haben Sie den Editor nicht aus Quellen oder Datenattribute geöffnet, steht stattdessen der Hinweis, im Plugin-Dashboard unter „Quellen“ auf „Produktdaten neu einlesen“ zu klicken.

{% hint style="warning" %}
Wird der Export Ihres Shops von einer geplanten Aufgabe erzeugt, wie es das Plugin einrichtet, greifen Änderungen erst mit dem nächsten Lauf dieser Aufgabe. Warten Sie ihn ab und lesen Sie die Produktdaten danach neu ein. Der Editor weist mit einem eigenen Hinweis darauf hin.
{% endhint %}

## Ungespeicherte Änderungen

Verlassen Sie den Editor mit ungespeicherten Änderungen, fragt der Dialog „Ungespeicherte Änderungen“: „Du hast Felder geändert, aber nicht gespeichert. Seite trotzdem verlassen?“ Mit „Weiter bearbeiten“ bleiben Sie, mit „Verwerfen und verlassen“ gehen Sie ohne Speichern. Auch beim Schließen oder Neuladen des Browser-Tabs warnt Ihr Browser. Haben Sie eine Änderung wieder zurückgesetzt, gilt sie nicht als ungespeichert.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-c9723ca0d8455d92ec258fa85bdac782571ef1b1%2Fimage.png?alt=media" alt="Feld-Editor des Produkt-Feeds, Ansicht 1"><figcaption></figcaption></figure>

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-7501a6d6a7a9743b3d560eb1e9b671b17d2a78a9%2Fimage.png?alt=media" alt="Feld-Editor des Produkt-Feeds, Ansicht 2"><figcaption></figcaption></figure>

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-6a0a7f25250f41ca7558e182b1c97a5b9c54128c%2Fimage.png?alt=media" alt="Feld-Editor des Produkt-Feeds, Ansicht 3"><figcaption></figcaption></figure>

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-70f452feefcbd5353df6ae272f2f9c498388cd12%2Fimage.png?alt=media" alt="Feld-Editor des Produkt-Feeds, Ansicht 4"><figcaption></figcaption></figure>

## Weiterlesen

{% content-ref url="/pages/dJoO5DWs6VHjJlMD4xiD" %}
[Quellen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/indizes.md)
{% endcontent-ref %}

{% content-ref url="/pages/zsJr3fdaXeR7dV1yGTh9" %}
[Datenattribute](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/datenattribute.md)
{% endcontent-ref %}

{% content-ref url="/pages/vHbSYnjIL0wgwKxanyHw" %}
[Filter](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/filter.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/feed-template-editor.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
