Elemente in Mergado#

1. Was sind Elemente#

Definition#

Ein Element ist der grundlegende Baustein eines Feeds, der Daten trägt. Jedes Element stellt eine konkrete Information dar – zum Beispiel den Produktnamen, den Preis, einen Code oder ein Bild. In XML wie auch in CSV funktioniert ein Element als Bezeichnung der Stelle, an der sich der jeweilige Wert befindet.

Vereinfacht gesagt:

• Element = „Name der Information",
• Wert = „Inhalt dieser Information".

Beispiel:

<g:title>Bid long and prosper – Tasse</g:title> <g:price>364.21 CZK</g:price> <g:id>47</g:id>

In diesem Beispiel ist:

• <g:title> ein Element,
• „Bid long and prosper – Tasse" sein Wert.

Elemente in verschiedenen Formaten#

Element in einem XML-Feed#

In XML-Dateien ist ein Element alles, was sich zwischen öffnendem und schließendem Tag befindet. Ein Element kann Text, Attribute oder weitere Elemente enthalten (sogenannte Verschachtelung). XML ist ein hierarchisches Format – dadurch kann es auch komplexere Beziehungen zwischen Daten abbilden.

Beispiel:

<PRICE_VAT>1499</PRICE_VAT>

Das Element PRICE_VAT enthält einen Wert – den Preis inkl. MwSt.

Element in einem CSV-Feed#

In CSV-Dateien entspricht ein Element einer Spalte in der Tabelle. Der Spaltenname stellt das Element dar, die Zellen in der Spalte seine Werte.

Beispiel:

CSV kann keine Verschachtelung (Eltern-Kind) abbilden, weshalb Mergado diese Struktur mit der Schreibweise Eltern | Kind simuliert.

Element im Mergado Editor#

Im Mergado Editor entspricht jedes Element einer Zeile auf der Seite Elements (Elemente). Der Editor zeigt die Struktur des Feeds als Baum – also in einer Hierarchie, bei der verschachtelte Elemente eingerückt dargestellt werden.

Jedes Element in Mergado kann sein:

• einfach, wenn es nur einen Wert hat,
• mehrfach, wenn es sich mehrmals wiederholt (z. B. mehrere Bilder, mehrere Parameter),
• verschachtelt, wenn es Bestandteil eines anderen Elements ist,
• oder ein Attribut, wenn es den Hauptwert um eine weitere Information ergänzt (z. B. @id oder @description).

Wozu Elemente dienen#

Elemente sind die Grundlage für die Übertragung, Verarbeitung und Anpassung von Daten in Mergado. Sie helfen, Daten so zu organisieren, dass Sie sie können:

• lesen, ändern und exportieren,
• zwischen Formaten konvertieren (z. B. Heureka → Google Merchant),
• sortieren, filtern und auswerten.

In der Praxis arbeiten Sie mit ihnen bei:

• der Erstellung von Produktauswahlen,
• der Einrichtung von Regeln,
• der Arbeit mit Variablen und Automatisierung,
• der Sortierung und Kontrolle von Daten auf den Seiten Products und Elements.

Zusammenfassung#

Ein Element ist die grundlegende Dateneinheit im Feed. Mergado behandelt es einheitlich, unabhängig vom Format – ob es aus XML, CSV oder einer anderen Quelle stammt. Das Verständnis dafür, wie Elemente funktionieren und zusammenhängen, ist entscheidend für die effiziente Arbeit mit Regeln, Auswahlen und Exporten.

FAQ#

Was ist ein Element?#

Ein Element ist der grundlegende Baustein eines Feeds, der eine konkrete Information trägt – zum Beispiel den Namen, den Preis oder den Code eines Produkts. In XML wie auch in CSV stellt es die Bezeichnung der Stelle dar, an der sich der jeweilige Wert befindet.

Was ist der Unterschied zwischen einem Element und einem Wert?#

Ein Element ist der Name der Information (z. B. PRICE_VAT), während der Wert dessen Inhalt ist (z. B. 1499). Zusammen bilden sie ein Paar – Name und dessen Dateninhalt.

Wie sieht ein Element in einem XML-Feed aus?#

In XML wird ein Element durch ein öffnendes und ein schließendes Tag definiert. Beispiel:

• <PRICE_VAT>1499</PRICE_VAT>

Hier ist PRICE_VAT das Element und 1499 sein Wert.

Wie funktioniert ein Element in einem CSV-Feed?#

In einer CSV-Datei entspricht ein Element dem Spaltennamen. Jede Zelle in dieser Spalte stellt einen Wert des Elements dar. Beispiel:

• PRICE_VAT → Spalte mit den Werten 1499, 1599, 1799 usw.

Wie wird die Verschachtelung in CSV geschrieben, wenn CSV keine Hierarchie kann?#

Mergado simuliert die Verschachtelung in CSV mit der Schreibweise Eltern | Kind. Zum Beispiel stellt der Pfad PARAM | VAL den Wert des Elements VAL dar, das unter dem Element PARAM verschachtelt ist.

Wie zeigt der Mergado Editor Elemente an?#

Im Mergado Editor wird jedes Element als eigene Zeile auf der Seite Elements angezeigt. Verschachtelte Elemente werden visuell eingerückt und bilden eine Baumstruktur, die der Struktur des XML-Feeds entspricht. Das gilt auch für die Seite Products in der Ansicht Elements.

Welche Arten von Elementen unterscheidet Mergado?#

Mergado arbeitet mit vier Grundtypen:

• Einfache Elemente – haben einen Wert.
• Mehrfache Elemente – können mehrere Werte haben.
• Verschachtelte Elemente – sind Bestandteil eines anderen Elements.
• Attribut-Elemente – ergänzen ein Element um eine weitere Information (z. B. @id).

Wozu dienen Elemente in Mergado?#

Elemente sind die Grundlage der Arbeit mit Daten – sie werden zum Lesen, Anpassen, Filtern, Exportieren und für Konvertierungen von Daten verwendet. Sie sind entscheidend bei der Arbeit mit Regeln, Auswahlen, Variablen und Automatisierung.

Sind Elemente in allen Formaten gleich?#

Ja. Mergado behandelt sie einheitlich – unabhängig davon, ob sie aus XML, CSV oder einem anderen Format stammen.

Warum ist es wichtig, Elemente zu verstehen?#

Weil fast die gesamte Arbeit in Mergado (Auswahlen, Regeln, Berechnungen, Exporte) auf Elementen basiert. Das Verständnis von Elementen bedeutet die Fähigkeit, Anpassungen und Datenverarbeitung präzise zu steuern.

2. Grundlagen der Elemente#

Arten von Elementen#

Mergado unterscheidet vier Grundtypen von Elementen. Jeder von ihnen hat ein spezifisches Verhalten und Einsatzmöglichkeiten.

1. Einfache Elemente#

• Haben einen Wert.
• Ihre Position (@@POSITION) ist immer gleich 1.
• Bei der Arbeit mit ihnen muss die Position nicht angegeben werden.

Beispiel:

<ITEM_ID>47</ITEM_ID>

Der Pfad ITEM_ID zielt auf denselben Wert wie ITEM_ID { @@POSITION = 1 }.

2. Mehrfache Elemente#

• Enthalten mehrere Werte desselben Typs.
• Jeder Wert hat eine eigene Position (1, 2, 3 …).
• Zum Zielen auf einen konkreten Wert dienen Bedingungen oder die Attribute @@POSITION und @@VALUE.

Beispiel:

<IMAGE>url1.jpg</IMAGE> <IMAGE>url2.jpg</IMAGE>

Das Element IMAGE hat zwei Werte – auf Position 1 und 2.

Mehrfachheit tritt häufig zum Beispiel bei Bildern, Versandarten, Parametern oder Kategorien auf.

3. Verschachtelte Elemente#

• Befinden sich innerhalb eines anderen Elements (des sogenannten Elternelements).
• Bilden eine hierarchische Datenstruktur.
• In Mergado wird die Verschachtelung durch Einrückung dargestellt, im Elementpfad mit der senkrechten Linie |.

Beispiel:

<PARAM> <PARAM_NAME>Farbe</PARAM_NAME> <VAL>Schwarz</VAL> </PARAM>

Der Pfad zum Wert lautet:

• PARAM | VAL

Diese Schreibweise legt fest, dass sich der Wert VAL innerhalb des Elements PARAM befindet.

4. Attribut-Elemente#

• Ein Attribut ist eine ergänzende Information, die die Bedeutung eines Elements erweitert.
• In XML steht es im öffnenden Tag und wird mit dem Symbol @ gekennzeichnet.
• In Mergado werden Attribute üblich verwendet und mit einem Pfad mit @ geschrieben.

Beispiel:

<IMAGE description="Winterjacke">bild.jpg</IMAGE>

Pfad zum Attribut:

• IMAGE | @description

Wie Sie Elemente im Mergado Editor anzeigen#

Seite Elements#

Auf der Seite Elements finden Sie eine vollständige Übersicht aller Elemente im Projekt. Hier können Sie Elemente:

• anzeigen und ausblenden (für den Ausgabefeed),
• hinzufügen, löschen oder umbenennen (bei benutzerdefinierten Elementen),
• nach Name oder nach Struktur sortieren,
• ihre Eingabe- und Ausgabewerte ansehen.

Durch Klick auf den Elementnamen öffnen Sie eine detaillierte Übersicht aller seiner Werte.

Seite Products#

Auf der Seite Products lassen sich Elemente auf zwei Arten anzeigen:

• Ansicht „Elements" – zeigt alle Elemente und ihre Werte bei einem konkreten Produkt.
• Ansicht „Table" – ermöglicht die Auswahl konkreter Elemente und deren Anzeige in einer übersichtlichen Tabelle.

Werkzeug „Element-Path" (Elementpfad)#

Auf der Seite Elements und in Regeln können Sie das Werkzeug Element-Path nutzen, das bei der Erstellung eines korrekten Pfads und der Kontrolle seiner Gültigkeit hilft. Es zeigt Ihnen, wohin der Pfad genau führt, und erleichtert die Arbeit mit Regeln oder Auswahlen.

Zusammenfassung#

Elemente sind die grundlegende Einheit, mit der Mergado arbeitet. Sie werden nach ihrer Funktion unterschieden (einfach, mehrfach, verschachtelt, Attribut), und ihr Verständnis ist der Schlüssel zur effizienten Arbeit mit Regeln, Auswahlen und der Struktur des Feeds.

FAQ#

Welche Elementtypen gibt es in Mergado?#

Es gibt vier Grundtypen:

• Einfach – haben einen Wert.
• Mehrfach – enthalten mehrere Werte.
• Verschachtelt – befinden sich innerhalb eines anderen Elements.
• Attribut – ergänzen den Wert um eine weitere Information.

Was bedeutet die Position eines Elements?#

Jeder Wert eines Elements hat seine Position (z. B. erster, zweiter, dritter Wert). Bei einfachen Elementen ist die Position immer 1, bei mehrfachen Elementen kann sie höher sein.

Wie arbeitet man mit mehrfachen Elementen?#

Mehrfache Elemente (z. B. IMAGE) können mehrere Werte haben. Für die Arbeit mit ihnen dienen Bedingungen oder die speziellen Attribute @@POSITION (Zielen nach Reihenfolge) und @@VALUE (Zielen nach Inhalt).

Wie erkenne ich ein verschachteltes Element?#

Ein verschachteltes Element befindet sich innerhalb eines anderen Elements (des sogenannten Elternelements). Im Elementpfad wird es mit einer senkrechten Linie | gekennzeichnet, zum Beispiel PARAM | VAL.

Wie werden Attribute von Elementen geschrieben?#

Attribute werden mit einem Klammeraffen @ geschrieben. Beispiel:

• <IMAGE description="Winterjacke">bild.jpg</IMAGE>

In Mergado lautet der Pfad zu diesem Attribut IMAGE | @description.

Bei manchen Feed-Formaten (z. B. Ceneo) stehen Attribute auch beim umhüllenden Element.

• <o id="123" price="100" avail="1"> <name>Produktname</name> … </o>

In diesem Fall lautet der Pfad zu diesem Attribut in Mergado @id, @price, @avail. Und möchten Sie in Mergado ein neues Attribut im umhüllenden Element erstellen, fügen Sie es auf der Seite Elements als neue Zeile hinzu, nicht über das Plus-Symbol bei einem bestehenden Element.

Wo finde ich Elemente in Mergado?#

Auf der Seite Elements im linken Projektmenü. Hier können Sie Elemente anzeigen, ausblenden, hinzufügen oder nach Struktur sortieren.

Wie zeige ich mir die Werte eines konkreten Elements an?#

Durch Klick auf seinen Namen auf der Seite Elements öffnen Sie eine Übersicht aller seiner Werte – der Eingabe- und der Ausgabewerte.

Wie werden Elemente auf der Seite Products angezeigt?#

Auf der Seite Products können Sie wählen:

• Ansicht Elements – alle Elemente und ihre Werte bei einem konkreten Produkt,
• Ansicht Table – übersichtliche Auflistung ausgewählter Elemente in einer Tabelle.

Was ist das Werkzeug Element-Path?#

Element-Path ist eine von Mergado entwickelte Sprache, die dem Schreiben von Pfaden zu Elementen und ihren Werten dient. Mithilfe von Element-Path bestimmen Sie, auf welche Werte im Feed Sie zielen möchten – ob Sie sie lesen oder in sie schreiben möchten.

Der Mergado Editor arbeitet mit Elementen genauso wie der XML-Feed – in einer Baumstruktur. Damit sich in dieser Struktur genau bestimmen lässt, mit welchen Daten Sie arbeiten möchten, müssen Sie deren Pfad kennen. Genau das ermöglicht die Sprache Element-Path.

Was ist der Unterschied zwischen einem einfachen und einem mehrfachen Element?#

Ein einfaches Element hat bei allen Produkten einen Wert (z. B. ITEM_ID). Ein mehrfaches Element hat mehrere Werte (z. B. mehrere IMAGE-Tags) bei einem Produkt – und mit diesen Werten lässt sich dank Element-Path einzeln arbeiten.

3. Verschachtelung von Elementen#

Was ist Verschachtelung#

Verschachtelung ist eine Eigenschaft eines Elements, die seine Position in der Hierarchie des XML-Feeds bestimmt. Ein Element gilt als verschachtelt, wenn es sich in XML zwischen dem öffnenden und schließenden Tag eines anderen Elements befindet. Verschachtelung erzeugt eine Struktur, die hilft, die Übersichtlichkeit und logische Verbindungen zwischen Daten zu bewahren.

Dieses Prinzip hat praktische Bedeutung – Elemente, die ineinander verschachtelt sind, hängen üblicherweise zusammen und bilden eine Einheit. Eine solche Struktur begegnet Ihnen zum Beispiel bei Produktparametern, Kategorien oder Versandarten.

Beispiel:

<PARAM> <PARAM_NAME>Farbe</PARAM_NAME> <VAL>Schwarz</VAL> </PARAM>

In diesem Fall:

• ist PARAM_NAME der Name des Parameters,
• ist VAL sein Wert,
• ist PARAM das übergeordnete Element, das beide verbindet.

Dank dieser Struktur erkennt Mergado, dass der Wert „Schwarz" gerade zum Parameter „Farbe" gehört.

Eltern, Kinder und Geschwister#

Verschachtelte Elemente bilden untereinander Beziehungen, die der Baumstruktur von XML entsprechen:

Beispiel für Beziehungen:

PARAM | PARAM_NAME PARAM | VAL

• PARAM ist das Elternelement.
• PARAM_NAME und VAL sind seine Kinder.
• PARAM_NAME und VAL sind untereinander Geschwister.

Im Mergado Editor zeigt sich diese Beziehung visuell durch Einrückung – Kinder werden auf den Seiten Elements und Products immer nach rechts versetzt zum Elternelement dargestellt.

Wie Mergado mit verschachtelter Struktur arbeitet#

Der Mergado Editor arbeitet mit Elementen so, dass er die Struktur des XML-Feeds in ihrer natürlichen Baumform übernimmt und anzeigt. Jedes Element behält die Information über sein Elternelement und seine Kinder, was ermöglicht:

• genau zu unterscheiden, welche Werte zusammengehören,
• korrekt auf einen konkreten Wert zu zielen (z. B. PARAM | VAL),
• neue verschachtelte Elemente direkt in der Oberfläche des Editors zu erstellen und zu verwalten.

Auf der Seite Elements können Sie neue verschachtelte Elemente durch Klick auf das „+"-Icon beim Elternelement hinzufügen. Ein so erstelltes Element ist leer und wird erst mit einer Regel befüllt (z. B. Rewrite).

Zur besseren Orientierung können Sie sich die Struktur wie Ordner und Dateien vorstellen:

• das Elternelement ist ein Ordner,
• das Kind ist eine Datei oder ein Unterordner darin.

Zum Beispiel bedeutet der Pfad PARAM | VAL, dass sich der Wert VAL innerhalb des Elements PARAM befindet.

CSV und Verschachtelung#

Verschachtelung ist eine natürliche Eigenschaft von Formaten wie XML oder JSON, aber das Format CSV kann sie nicht nativ ausdrücken. Deshalb simuliert Mergado die Verschachtelung in CSV mit der Schreibweise Eltern | Kind, damit sich mit den Daten genauso arbeiten lässt wie in XML.

In der Praxis bedeutet das, dass in einer CSV-Datei jede Spalte einen Elementpfad darstellt. Zum Beispiel:

PARAM | PARAM_NAME PARAM | VAL

Diese Schreibweise drückt aus, dass das Element VAL unter dem Element PARAM verschachtelt ist. Auf diese Weise kann Mergado logische Beziehungen zwischen Daten auch bei Formaten bewahren, die Verschachtelung selbst nicht unterstützen.

Praktisch: Arbeit mit Verschachtelung im Mergado Editor#

1. Schreiben eines Pfads zu einem verschachtelten Element#

Möchten Sie in einer Regel oder Auswahl mit einem verschachtelten Element arbeiten, schreiben Sie seinen Pfad mit der senkrechten Linie |.

Beispiel:

• PARAM | VAL

Diese Schreibweise bedeutet: „Finde das Element PARAM und darin das Kind VAL." Es ist notwendig, die Leerzeichen vor und nach der senkrechten Linie einzuhalten.

• Richtig: PARAM | VAL
• Falsch: PARAM|VAL

2. Präzises Zielen mithilfe einer Bedingung#

Hat das Element PARAM mehrere Werte (z. B. mehrere Parameter), ist es sinnvoll, eine Bedingung für präziseres Zielen hinzuzufügen. Bedingungen werden in geschweifte Klammern { } geschrieben und filtern Werte nach einem angegebenen Kriterium.

Beispiel:

• PARAM { PARAM_NAME = “Displaytyp” } | VAL

Diese Schreibweise sagt: „Finde das Element PARAM, das ein Kind PARAM_NAME mit dem Wert Displaytyp hat, und passe dessen Wert VAL an." Auf diese Weise zielen Sie genau auf den gewünschten Parameter, unabhängig von seiner Position im Feed.

Unterschied zwischen XML und CSV bei der Verarbeitung von Verschachtelung#

Während XML Verschachtelung mit Tags und verschachtelten Tags ausdrückt, verwendet CSV eine Pfadschreibweise mit dem Trennzeichen |. Mergado vereinheitlicht beide Strukturen und ermöglicht die Arbeit mit ihnen auf dieselbe Weise.

Zusammenfassung#

Verschachtelung ist ein grundlegendes Prinzip der Arbeit mit Daten im Mergado Editor. Sie ermöglicht es zu erkennen, wie Werte einzelner Elemente zusammenhängen, und dadurch Regeln und Auswahlen präzise zu zielen.

Das richtige Verständnis der Verschachtelung ist der Schlüssel zur effizienten Arbeit mit Parametern, Versanddienstleistern, Varianten und weiteren mehrfachen Strukturen. Ob Sie mit einem XML- oder CSV-Feed arbeiten, Mergado kann die Verschachtelung anzeigen, bewahren und bei allen Arten von Anpassungen nutzen.

FAQ#

Was ist die Verschachtelung eines Elements?#

Verschachtelung ist eine Eigenschaft eines Elements, die bestimmt, dass es sich innerhalb eines anderen Elements befindet. Diese Beziehung erzeugt eine Datenhierarchie – zum Beispiel kann das Element PARAM (Eltern) Namen und Werte von Parametern enthalten (PARAM_NAME und VAL), die seine Kinder sind. Die Begriffe verschachtelt und eingebettet bedeuten dasselbe.

Wozu dient Verschachtelung?#

Verschachtelung hilft, eine logische und verständliche Datenstruktur zu bewahren. Dank ihr lassen sich Werte eindeutig ihrem Kontext zuordnen – zum Beispiel, dass der Parameter „Farbe" den Wert „Schwarz" hat. Sie ermöglicht es so, zusammengehörige Informationen in einer Struktur zu vereinen.

Welche Beziehungen kommen in einer verschachtelten Struktur vor?#

Verschachtelte Elemente bilden untereinander drei Arten von Beziehungen:

• Eltern (Parent) – Element, das andere Elemente enthält.
• Kind (Child) – Element, das sich innerhalb eines anderen Elements befindet.
• Geschwister (Siblings) – Elemente, die dasselbe Elternelement haben.

Beispiel: im Pfad PARAM | VAL ist PARAM das Elternelement und VAL sein Kind.

Wie sieht ein verschachteltes Element in XML aus?#

In XML wird Verschachtelung durch verschachtelte Tags ausgedrückt. Beispiel:

<PARAM> <PARAM_NAME>Farbe</PARAM_NAME> <VAL>Schwarz</VAL> </PARAM>

Das Element PARAM ist das Elternelement, PARAM_NAME und VAL sind seine Kinder.

Wie zeigt Mergado verschachtelte Elemente an?#

Der Mergado Editor zeigt Elemente in einer Baumhierarchie an, die der Struktur des XML-Feeds entspricht. Verschachtelte Elemente sind links gegenüber ihrem Elternelement eingerückt. Die Verschachtelung sehen Sie zum Beispiel auf den Seiten Products und Elements. Ein neues verschachteltes Element lässt sich durch Klick auf das „+"-Icon beim Elternelement erstellen.

Wie wird Verschachtelung in Element-Path geschrieben?#

Verschachtelung wird mit der senkrechten Linie | zwischen den Elementnamen geschrieben. Beispiel:

PARAM | VAL

Diese Schreibweise bedeutet, dass VAL ein Kind des Elements PARAM ist. Es müssen die Leerzeichen vor und nach der senkrechten Linie eingehalten werden.

• Richtig: PARAM | VAL
• Falsch: PARAM|VAL.

Wie wird Verschachtelung im CSV-Format ausgedrückt?#

Das Format CSV kann Hierarchie nicht nativ ausdrücken, deshalb simuliert Mergado die Verschachtelung mit der Schreibweise Eltern | Kind. Zum Beispiel drücken PARAM | PARAM_NAME und PARAM | VAL dieselbe Beziehung aus wie in der XML-Struktur.

Welche Dateitypen können mit Verschachtelung arbeiten?#

Mit Verschachtelung arbeiten natürlicherweise die Formate XML und JSON. Das Format CSV kann Verschachtelung nicht nativ, aber der Mergado Editor hilft dabei genau mit der Schreibweise Eltern | Kind.

Wie hoch ist die maximale Anzahl von Verschachtelungsebenen?#

Für die Tiefe der Verschachtelung gibt es keine theoretische Begrenzung. In der Praxis ist Mergado bereits auf bis zu neun Verschachtelungsebenen gestoßen, zum Beispiel bei Feeds im Format Upgates.

Wie ziele ich präzise auf den Wert eines verschachtelten Elements?#

Für präzises Zielen dient eine Bedingung im Pfad. Beispiel:

PARAM { PARAM_NAME = "Displaytyp" } | VAL

Diese Schreibweise sagt: „Finde das Element PARAM, das ein Kind PARAM_NAME mit dem Wert Displaytyp hat, und arbeite mit dessen Element VAL." Diese Methode ist am zuverlässigsten, weil sie unabhängig von der Reihenfolge der Elemente im Feed funktioniert.

Wie ziele ich, wenn ein Element sowohl mehrfach als auch verschachtelt ist?#

Ist ein Element mehrfach (z. B. wiederholt sich PARAM mehrmals), ist eine Bedingung notwendig. Der Pfad PARAM | VAL ohne Bedingung zielt auf alle Werte, aber präzises Zielen stellt die Schreibweise sicher: PARAM { PARAM_NAME = "Farbe" } | VAL

Warum ist das Zielen über ein Kind sicherer als über @@POSITION?#

Das Zielen über ein Kind (z. B. PARAM_NAME = "Farbe") ist sicherer, weil es unabhängig von seiner Position in der Liste den richtigen Wert auswählt. Das Attribut @@POSITION bezieht sich nur auf die Reihenfolge, sodass es bei unterschiedlicher Parameterreihenfolge zwischen Produkten zu einem falschen Ergebnis führen kann.

Warum ist die Arbeit mit Verschachtelung wichtig?#

Die meisten komplexen Daten wie Parameter, Versand oder Varianten sind verschachtelt. Das richtige Verständnis der Verschachtelung ermöglicht es, präzise mit Daten zu arbeiten, zuverlässige Regeln zu erstellen und den Feed logisch strukturiert und übersichtlich zu halten.

4. Mehrfachheit von Elementen#

Was bedeutet ein mehrfaches Element#

Ein mehrfaches Element ist ein Element, bei dem mehrere Werte mit demselben Namen existieren. Aus Sicht der Feed-Struktur bedeutet das, dass das jeweilige Element innerhalb eines Produkts wiederholt vorkommt – zum Beispiel bei Bildern, Parametern oder Varianten.

Mehrfachheit ermöglicht es, mehrere zusammengehörige Werte unter einem Elementnamen zu vereinen, sodass nicht für jeden Wert ein neues Element erstellt werden muss.

Mehrfachen Elementen begegnen Sie am häufigsten bei:

• Bild-URLs (z. B. IMGURL_ALTERNATIVE),
• Produktparametern (PARAM),
• Versand (DELIVERY),
• Kategorien,
• Produktvarianten.

Beispiel in XML-Struktur:

<IMGURL_ALTERNATIVE>url1.jpg</IMGURL_ALTERNATIVE> <IMGURL_ALTERNATIVE>url2.jpg</IMGURL_ALTERNATIVE>

In diesem Fall ist das Element IMGURL_ALTERNATIVE mehrfach, weil es mehrere Werte hat.

Unterschied zwischen einfachem und mehrfachem Element#

Bei verschachtelten Strukturen (z. B. PARAM) bezieht sich die Mehrfachheit auf das Elternelement. Die Kinder (typischerweise PARAM_NAME und VAL) bleiben einfach, weil sie innerhalb eines Elternelements immer nur einen Wert haben.

Wie Mergado mit Positionen arbeitet#

Jeder Wert eines Elements hat seine Ordnungszahl bzw. Position (1, 2, 3 …). Die Position lässt sich zum präzisen Zielen auf einen konkreten Wert innerhalb eines Elements nutzen. Dafür dient das spezielle Attribut @@POSITION. Es ist Bestandteil der Sprache Element-Path und ermöglicht es, festzulegen, auf welche Position innerhalb des Elements Sie zielen möchten.

Beispiel:

<IMAGE>url1.jpg</IMAGE> @@POSITION = 1 <IMAGE>url2.jpg</IMAGE> @@POSITION = 2 <IMAGE>url3.jpg</IMAGE> @@POSITION = 3

Möchten Sie mit dem dritten Bild arbeiten, verwenden Sie den Pfad:

• IMAGES | IMAGE { @@POSITION = 3 }

Diese Schreibweise sagt: „Ich arbeite mit dem Element IMAGE auf der dritten Position."

Einschränkung des Attributs @@POSITION#

Das Attribut @@POSITION bezieht sich nur auf die Reihenfolge, nicht auf den Inhalt. Unterscheidet sich die Reihenfolge der Werte zwischen Produkten, entsprechen gleiche Positionen möglicherweise nicht denselben Informationen.

Beispiel:

• Das erste Produkt hat die Parameter 1. Material, 2. Volumen.
• Das zweite Produkt hat 1. Material, 2. Dekor.

Der Pfad PARAM { @@POSITION = 2 } | VAL verweist beim zweiten Produkt dann auf Dekor, nicht auf Volumen.

Sicherer ist es deshalb, nach dem Namen zu zielen:

• PARAM { PARAM_NAME = “Volumen” } | VAL

Wie Sie mit Mehrfachheit im Mergado Editor arbeiten#

Ermittlung und Verwendung der Position#

1. Öffnen Sie auf der Seite Elements das jeweilige Element, und Sie sehen alle seine Werte mit ihren Positionen.
2. In Regeln oder Auswahlen können Sie zielen:
   • nach Position, z. B. IMGURL_ALTERNATIVE { @@POSITION > 1 },
   • oder nach einem Positionsbereich, z. B. IMGURL_ALTERNATIVE { @@POSITION >= 3 AND @@POSITION <= 8 }.
3. Möchten Sie statt der Position mit dem Wert arbeiten, verwenden Sie das Attribut @@VALUE, zum Beispiel:
   • CATEGORY { @@VALUE != "Spielzeug" }
4. Diese Schreibweise wählt alle Werte des Elements CATEGORY aus, die nicht „Spielzeug" entsprechen.

Wann Sie die Position nicht angeben müssen#

Die Position muss im Pfad in folgenden Fällen nicht angegeben werden:

1. Einfache Elemente
   1. Haben immer nur einen Wert, also Position = 1. Der Pfad ITEM_ID ist gleichbedeutend mit ITEM_ID { @@POSITION = 1 }.
2. Lesen aus einem mehrfachen Element ohne Präzisierung
   1. Lesen Sie in einer Regel ohne Bedingung aus einem mehrfachen Element, verwendet Mergado automatisch den ersten Wert.
   2. Zum Beispiel: bei der Verwendung von %PARAM | VAL% nimmt Mergado den ersten Wert.
3. Zielen auf alle Werte
   1. Möchten Sie alle Vorkommen eines Elements verarbeiten, verwenden Sie nur den Elementnamen ohne Bedingung.
   2. Z. B. arbeitet IMAGES | IMAGE mit allen Bildern.
   3. Beachten Sie beim Schreiben, dass sich die Änderung bei allen Werten auswirkt, die dem jeweiligen Pfad entsprechen.

Zusammenfassung#

Mehrfachheit ermöglicht es, mehrere Werte desselben Typs innerhalb eines Elements zu speichern und zu verarbeiten. Für präzise Arbeit ist es sinnvoll, mit Bedingungen oder speziellen Attributen auf konkrete Werte zu zielen. Damit stellen Sie sicher, dass Anpassungen korrekt ablaufen und andere Daten nicht berühren.

FAQ#

Was ist ein mehrfaches Element?#

Ein mehrfaches Element ist ein Element, das mehrere Werte mit demselben Namen hat. In der Praxis bedeutet das, dass es innerhalb eines Produkts wiederholt vorkommt – zum Beispiel bei Bildern, Parametern, Versand oder Kategorien. Typische mehrfache Elemente sind IMAGE, PARAM, DELIVERY oder CATEGORY.

Was ist der Unterschied zwischen einem einfachen und einem mehrfachen Element?#

• Ein einfaches Element enthält einen Wert und hat immer die Position 1.
• Ein mehrfaches Element kann mehrere Werte haben, von denen jeder seine eigene Position hat (2, 3, 4 …).

Beispiel: <IMAGE>url1.jpg</IMAGE> <IMAGE>url2.jpg</IMAGE>

Das Element IMAGE ist mehrfach, weil es mehrmals vorkommt und mehrere Werte enthält.

Wozu dient Mehrfachheit?#

Mehrfachheit ermöglicht es, mehrere zusammengehörige Werte unter einem Elementnamen zu vereinen. Es müssen also nicht für jeden Wert eigene Elemente erstellt werden. Zum Beispiel lassen sich alle alternativen Produktbilder als sich wiederholende Elemente IMGURL_ALTERNATIVE schreiben.

Welche Elemente sind typischerweise mehrfach?#

Mehrfachheit kommt am häufigsten bei Elementen vor, die sich wiederholende Produkteigenschaften beschreiben, zum Beispiel:

• Bild-URLs (IMGURL_ALTERNATIVE),
• Produktparameter (PARAM),
• Versand (DELIVERY),
• Kategorien,
• Produktvarianten.

Wie arbeitet Mergado mit Positionen von Werten?#

Jeder Wert eines Elements hat seine Position, also eine Ordnungszahl (1, 2, 3 …). Die Position lässt sich zum präzisen Zielen auf einen konkreten Wert innerhalb eines Elements nutzen. Dafür dient das spezielle Attribut @@POSITION. Beispiel: IMAGES | IMAGE { @@POSITION = 3 }

Diese Schreibweise bedeutet: „Ich arbeite mit dem Element IMAGE auf der dritten Position."

Was bedeutet das Attribut @@POSITION und wie wird es verwendet?#

@@POSITION bestimmt die Reihenfolge eines Werts innerhalb eines mehrfachen Elements. Es wird in Bedingungen zum Zielen auf eine konkrete Position oder einen Positionsbereich verwendet. Beispiel: IMGURL_ALTERNATIVE { @@POSITION > 1 }

Diese Schreibweise zielt auf alle alternativen Bilder außer dem ersten. Beachten Sie jedoch, dass @@POSITION nur mit der Reihenfolge arbeitet, nicht mit dem Inhalt. Unterscheidet sich die Reihenfolge zwischen Produkten, kann es auf den falschen Wert zielen.

Was ist das Attribut @@VALUE und wann verwende ich es?#

@@VALUE stellt den Inhalt des Werts eines Elements dar und ermöglicht das Zielen nach Wert statt nach Position. Es wird vor allem bei Elementen ohne Kinder verwendet, zum Beispiel CATEGORY oder IMGURL_ALTERNATIVE. Beispiel: CATEGORY { @@VALUE != "Spielzeug" }

Diese Schreibweise wählt alle Kategorien außer „Spielzeug" aus.

Wie ziele ich in Element-Path auf Werte mehrfacher Elemente?#

Das Zielen erfolgt mithilfe von Bedingungen in geschweiften Klammern { }. Darin lassen sich die Attribute @@POSITION, @@VALUE oder Ausdrücke aus der Sprache MQL verwenden. Zielen auf alle Werte: IMAGES | IMAGE

• Verarbeitet alle Werte (url1, url2, url3 …).

Zielen auf konkrete Werte oder einen Positionsbereich: IMAGES | IMAGE { @@POSITION IN (3;4) }

• Zielt auf das dritte und vierte Bild.

Wie ermittle ich Positionen von Werten im Mergado Editor?#

Auf der Seite Elements lassen sich bei jedem Element alle seine Werte einschließlich ihrer Positionen anzeigen. Diese Übersicht hilft, die Struktur mehrfacher Daten besser zu verstehen, und erleichtert das Zielen in Regeln.

Wann muss die Position im Pfad nicht angegeben werden?#

Die Position muss in folgenden Fällen nicht angegeben werden:

• Einfache Elemente – haben immer einen Wert (Position = 1). ITEM_ID ist gleichbedeutend mit ITEM_ID { @@POSITION = 1 }.
• Lesen aus einem mehrfachen Element ohne Bedingung – Mergado verwendet automatisch den ersten Wert. Z. B. nimmt %PARAM | VAL% den ersten Wert.
• Zielen auf alle Werte – es genügt der Elementname ohne Bedingung, z. B. IMAGES | IMAGE.

Was ist der Unterschied zwischen Zielen nach Position und nach Wert?#

• @@POSITION arbeitet mit der Reihenfolge des Werts.
• @@VALUE arbeitet mit dem Inhalt des Werts.

Unterscheidet sich die Reihenfolge der Werte innerhalb der Produkte, ist es sicherer, @@VALUE zu verwenden, weil es direkt auf den Inhalt zielt.

Was ist das Problem beim Zielen mit @@POSITION?#

@@POSITION bezieht sich nur auf die Reihenfolge. Haben Produkte Parameter in unterschiedlicher Reihenfolge, kann der Pfad auf den falschen Wert zielen. Sicherer ist das Zielen nach dem Namen des Kinds, zum Beispiel: PARAM { PARAM_NAME = "Volumen" } | VAL

Wie arbeite ich mit mehrfachen Elementen in Regeln und Auswahlen?#

Die Arbeit mit mehrfachen Elementen hängt davon ab, ob eine Regel aus dem Element liest oder in es schreibt. Lesen:

• Führt der Pfad zu mehreren Werten, verwendet Mergado den ersten davon.
• Möchten Sie einen anderen Wert lesen, müssen Sie den Pfad mit einer Bedingung präzisieren.

Schreiben:

• Schreibt eine Regel in ein mehrfaches Element, erfolgt die Änderung bei allen Werten, die dem angegebenen Pfad entsprechen.
• Möchten Sie nur in einen konkreten Wert schreiben, müssen Sie den Pfad mit einer Bedingung eingrenzen.
• Enthält die Bedingung den Operator = oder die Verknüpfung AND, erstellt Mergado die fehlende Struktur automatisch.

Warum ist es wichtig, Mehrfachheit zu unterscheiden?#

Mehrfachheit bestimmt, dass ein Element mehrere Werte desselben Typs enthalten kann. Das Verständnis dieses Prinzips ist entscheidend für die korrekte Einrichtung von Regeln, Auswahlen und das präzise Zielen auf konkrete Daten innerhalb des Feeds.

5. Arbeit mit mehrfachen Elementen in Mergado-Regeln#

Mehrfache Elemente verhalten sich im Mergado Editor anders als einfache Elemente. Jedes Produkt kann mehrere Werte desselben Elements enthalten, deshalb ist es wichtig zu wissen, wie Regeln mit ihnen arbeiten – wie sie Werte lesen, schreiben und wie man sie richtig zielt.

Wie Regeln mehrfache Werte lesen und schreiben#

Ein mehrfaches Element ist ein Element mit mehr als einem Wert bei einem Produkt. Regeln in Mergado (zum Beispiel Rewrite, Bulk Copy Values, Calculation) haben dafür ein bestimmtes Standardverhalten.

Lesen aus Elementen und Variablen#

Liest eine Regel einen Wert aus einem mehrfachen Element, dessen Pfad zu mehreren Werten führt, verwendet Mergado automatisch nur den ersten Wert.

Dieses Verhalten gilt beim Lesen mit der Prozentzeichen-Schreibweise % (zum Beispiel %PARAM | VAL%).

Beispiel:

<VAL>Schwarz</VAL> <VAL>XL</VAL>

Liest eine Regel aus dem Pfad PARAM | VAL, nimmt Mergado nur den ersten Wert „Schwarz". Bei einfachen Elementen (z. B. ITEM_ID) zeigt sich diese Logik nicht, da es dort immer nur einen Wert gibt.

Schreiben in Elemente#

Schreibt eine Regel ohne weitere Präzisierung in ein mehrfaches Element, schreibt Mergado den Wert in alle Vorkommen dieses Elements.

Beispiel:

• Verwenden Sie in der Regel Rewrite den Pfad IMGURL_ALTERNATIVE und geben Sie einen neuen Wert neues_bild.jpg ein,

überschreibt Mergado alle bestehenden Werte dieses Elements.

Möchten Sie nur in einen konkreten Wert schreiben, müssen Sie den Pfad mit Bedingungen präzisieren. Zum Beispiel schreibt der Pfad

• PARAM { PARAM_NAME = “Farbe” } | VAL

den Wert nur in Parameter „Farbe". Kommt der Parameter „Farbe" bei einem Produkt mehrmals vor, erfolgt die Änderung bei allen diesen Vorkommen.

Wann eine Bedingung und wann ein spezielles Attribut verwenden#

Für präzises Zielen auf einen konkreten Wert eines mehrfachen Elements ist eine Bedingung nötig. Bedingungen funktionieren als Filter – sie bestimmen, auf welche Werte oder Positionen sich die Regel bezieht. Sie werden in geschweifte Klammern { } geschrieben und können entweder ein verschachteltes Element oder ein spezielles Attribut enthalten.

1. Verwendung eines verschachtelten Elements in der Bedingung#

Diese Methode ist am zuverlässigsten, weil sie nach dem Inhalt des Werts zielt, nicht nach der Reihenfolge.

Beispiel: Wir möchten den Wert des Elements VAL überschreiben, der zum Parameter „Farbe" gehört:

• PARAM { PARAM_NAME = “Farbe” } | VAL

Diese Schreibweise sagt: „Finde alle Elemente PARAM, die ein Kind PARAM_NAME mit dem Wert Farbe haben, und passe bei ihnen den Wert des Elements VAL an."

Diese Methode funktioniert unabhängig von der Reihenfolge der Elemente im Feed und wird deshalb in den meisten Fällen empfohlen.

2. Verwendung des speziellen Attributs @@POSITION#

Das Attribut @@POSITION dient dem Zielen auf einen Wert nach seiner Reihenfolge. Jeder Wert eines Elements hat seine Position – der erste = 1, der zweite = 2 usw.

Beispiel:

IMGURL_ALTERNATIVE { @@POSITION > 1 }

Diese Schreibweise zielt auf alle Bilder außer dem ersten.

Geeignete Verwendung: Bei Elementen, bei denen die Reihenfolge der Werte der Bedeutung entspricht (z. B. alternative Bilder).

Schwäche: Das Zielen mit @@POSITION bezieht sich nur auf die Position, nicht auf den Inhalt. Ändert sich die Reihenfolge der Werte zwischen Produkten, ist das Ergebnis möglicherweise nicht konsistent.

3. Verwendung des speziellen Attributs @@VALUE#

Das Attribut @@VALUE bezieht sich auf den tatsächlichen Wert des Elements, nicht auf seine Reihenfolge. Es eignet sich dort, wo sich die Reihenfolge ändert oder nicht wichtig ist.

Beispiel:

• CATEGORY { @@VALUE != “Spielzeug” }

Diese Schreibweise zielt auf alle Werte des Elements CATEGORY außer „Spielzeug".

@@VALUE wird vor allem bei Elementen ohne Kinder verwendet (z. B. CATEGORY, IMGURL_ALTERNATIVE). Bei Elternelementen, die selbst keinen Wert tragen (z. B. PARAM), ergibt seine Verwendung keinen Sinn.

Praktische Beispiele für Pfade#

Regeln in Mergado verwenden bei der Arbeit mit Elementen (Lesen/Schreiben) die Sprache Element-Path, die es ermöglicht, präzise auf Werte zu zielen, aus denen Sie lesen oder in die Sie schreiben möchten.

Zielen auf den Wert eines konkreten Parameters#

• PARAM { PARAM_NAME = “Farbe” } | VAL

Diese Schreibweise liest oder schreibt den Wert VAL beim Parameter, dessen Name Farbe ist.

Mergado interpretiert das wie folgt: „Finde das Element PARAM, das ein Kind PARAM_NAME mit dem Wert Farbe hat, und passe den Wert seines Kinds VAL an."

Zielen auf den Wert in Varianten#

Der Pfad kann mehrere Ebenen von Verschachtelung und Mehrfachheit kombinieren. Beispiel für die Arbeit mit der zweiten Variante, die den Parameter „Größe" enthält:

• VARIANTS | VARIANT { @@POSITION = 2 } | PARAMETERS | PARAMETER { NAME = “Größe” } | VALUE

Diese Schreibweise sagt: „Finde die zweite Variante des Produkts, in der der Parameter Größe einen bestimmten Wert trägt, und arbeite mit diesem Wert."

Hinzufügen neuer Werte mithilfe von Regeln#

Beim Schreiben in mehrfache oder verschachtelte Elemente gilt eine wichtige Regel: Existiert das Element, auf das Sie zielen, noch nicht, erstellt Mergado es.

Das bedeutet, alles, was in der Bedingung (z. B. PARAM_NAME = "Farbe") und im Pfad mit dem Operator = steht, wird automatisch erstellt.

Beispiel für das Hinzufügen eines neuen strukturierten Werts – eines sogenannten „Flags":

Element: FLAGS | FLAG { CODE = “action” } | ACTIVE

Neuer Wert: 0

Existiert das Flag mit dem Code action noch nicht, erstellt Mergado ein neues FLAG (eine neue Position) mit dem Element CODE = "action" und fügt ihm das Element ACTIVE mit dem Wert 0 hinzu.

Dieser Mechanismus wird beim Hinzufügen neuer Varianten, Versanddienstleister, Parameter oder anderer strukturierter Daten verwendet.

Übersicht der Regeln, die Mehrfachheit betrifft#

Das beschriebene Verhalten beim Lesen und Schreiben mehrfacher Werte betrifft diese Regeln:

Zusammenfassung#

Bei der Arbeit mit mehrfachen Elementen in Regeln des Mergado Editor ist es am wichtigsten, zu wissen, mit welchem Wert Sie arbeiten. Ohne Präzisierung liest eine Regel immer den ersten Wert und schreibt in alle entsprechenden Werte. Mithilfe von Bedingungen, den speziellen Attributen @@POSITION und @@VALUE oder einer Kombination mehrerer verschachtelter Ebenen können Sie genau festlegen, was die Regel anpasst.

Ein korrekt geschriebener Elementpfad stellt sicher, dass Anpassungen genau dort erfolgen, wo sie sollen – und sicher bleiben, auch wenn sich die Struktur des Feeds im Laufe der Zeit ändert.

FAQ#

Was ist das Grundprinzip der Arbeit von Regeln mit mehrfachen Elementen?#

Regeln im Mergado Editor arbeiten mit mehrfachen Elementen nach zwei Prinzipien – dem Lesen von Werten und dem Schreiben von Werten. Einfache Elemente haben immer nur einen Wert, sodass eine Regel direkt mit ihnen arbeitet. Mehrfache Elemente können jedoch bei einem Produkt mehrere Werte haben, deshalb muss festgelegt werden, mit welchem davon die Regel arbeiten soll. Ohne Präzisierung lesen Regeln den ersten Wert und schreiben in alle Werte.

Wie liest Mergado Werte aus mehrfachen Elementen?#

Führt der Pfad zu mehreren Werten, verwendet Mergado automatisch nur den ersten Wert. Dieses Verhalten gilt bei allen Regeln, die den Wert eines Elements mit der %-Schreibweise lesen – zum Beispiel %PARAM | VAL%. Beispiel: <VAL>Schwarz</VAL> <VAL>XL</VAL>

Der Pfad PARAM | VAL gibt den Wert „Schwarz" zurück, weil es das erste Vorkommen ist.

Wie schreibt Mergado in mehrfache Elemente?#

Schreibt eine Regel ohne weitere Präzisierung in ein mehrfaches Element, schreibt Mergado den neuen Wert in alle seine Vorkommen (Positionen). Möchten Sie nur auf einen konkreten Wert zielen, müssen Sie den Pfad mit einer Bedingung präzisieren. Beispiel: PARAM { PARAM_NAME = "Farbe" } | VAL

Diese Schreibweise passt den Wert des Elements VAL nur bei Parametern „Farbe" an. Hat ein Produkt mehrere Parameter „Farbe", erfolgt die Änderung bei allen diesen Vorkommen.

Warum sind Bedingungen bei mehrfachen Elementen nötig?#

Bedingungen funktionieren als Filter, der bestimmt, auf welche Werte sich die Regel bezieht. Ohne Bedingung würde die Regel alle Werte des Elements erfassen. Bedingungen werden in geschweifte Klammern { } geschrieben und können entweder ein verschachteltes Element oder ein spezielles Attribut enthalten.

Wie verwende ich ein verschachteltes Element in einer Bedingung?#

Das Zielen mit einem verschachtelten Element ist am zuverlässigsten, weil es sich auf den Inhalt stützt, nicht auf die Reihenfolge. Beispiel: PARAM { PARAM_NAME = "Farbe" } | VAL

Diese Schreibweise bedeutet: „Finde das Element PARAM, das ein Kind PARAM_NAME mit dem Wert Farbe hat, und passe den Wert seines Kinds VAL an." Diese Methode funktioniert unabhängig von der Reihenfolge der Elemente und wird in der Praxis empfohlen.

Wann verwende ich das Attribut @@POSITION?#

Das Attribut @@POSITION dient dem Zielen nach Reihenfolge des Werts innerhalb eines Elements. Jeder Wert hat seine Position – der erste = 1, der zweite = 2 usw. Beispiel: IMGURL_ALTERNATIVE { @@POSITION > 1 }

Zielt auf alle Bilder außer dem ersten. Verwenden Sie es dort, wo die Reihenfolge der Werte der Bedeutung entspricht (z. B. alternative Bilder). Schwäche: @@POSITION bezieht sich nur auf die Reihenfolge, nicht auf den Inhalt. Unterscheidet sich die Reihenfolge der Werte zwischen Produkten, sind die Ergebnisse möglicherweise nicht konsistent.

Wann verwende ich das Attribut @@VALUE?#

Das Attribut @@VALUE bezieht sich auf den tatsächlichen Wert des Elements und ermöglicht das Zielen nach Inhalt statt nach Reihenfolge. Es wird vor allem bei Elementen ohne Kinder verwendet (z. B. CATEGORY, IMGURL_ALTERNATIVE). Beispiel: CATEGORY { @@VALUE != "Spielzeug" }

Diese Schreibweise wählt alle Werte des Elements CATEGORY außer „Spielzeug" aus. @@VALUE eignet sich dort, wo sich die Reihenfolge der Werte ändern kann oder nicht wichtig ist.

Wie kombiniere ich Bedingungen und spezielle Attribute?#

In einem Pfad lassen sich mehrere Bedingungen und Attribute kombinieren. Bedingungen können logische Operatoren (AND, OR) oder Abfragen in der Sprache MQL enthalten. Beispiel: VARIANTS | VARIANT { @@POSITION = 2 } | PARAMETERS | PARAMETER { NAME = "Größe" } | VALUE

Bedeutet: „Finde die zweite Variante des Produkts, die den Parameter Größe enthält, und arbeite mit dessen Wert VALUE."

Wie erstellt Mergado neue Werte beim Schreiben?#

Existiert das Element, auf das Sie zielen, nicht, erstellt Mergado es beim Schreiben automatisch. Das gilt für alle Bedingungen mit dem Operator = oder der Verknüpfung AND. Beispiel: FLAGS | FLAG { CODE = "action" } | ACTIVE

Existiert das Flag „action" nicht, erstellt Mergado ein neues Element FLAG mit dem Kind CODE = "action" und fügt ihm ACTIVE mit dem Wert 0 hinzu. Dieser Mechanismus ermöglicht das automatische Hinzufügen neuer Parameter, Varianten oder strukturierter Daten.

Wie vermeide ich Fehler bei der Arbeit mit mehrfachen Werten?#

• Überprüfen Sie, ob das Element, mit dem Sie arbeiten, tatsächlich mehrere Werte enthält.
• Verwenden Sie Bedingungen { } für präzises Zielen.
• Verlassen Sie sich nicht auf @@POSITION, wenn sich die Reihenfolge der Werte zwischen Produkten unterscheidet.
• Überprüfen Sie vor dem Schreiben, ob der Pfad nicht mehr Werte beeinflusst, als gewünscht.
• Nutzen Sie das Werkzeug Element-Path, um zu überprüfen, wohin die Regel zielt.

6. Attribute in Elementen#

Was sind Attribute#

Ein Attribut ist ein Bestandteil eines Elements, der dessen Bedeutung oder Eigenschaft präzisiert. Während das Element die eigentlichen Daten trägt, liefert das Attribut eine ergänzende Information zu diesen Daten. Attribute funktionieren so als Erweiterung der Werte eines Elements und helfen oft, Details zu beschreiben, die sonst nicht in die Struktur passen würden.

Wie Attribute in XML geschrieben werden#

In XML wird ein Attribut immer im öffnenden Tag des Elements angegeben und hat seinen Namen und Wert. Der Attributwert muss in Anführungszeichen oder Apostrophen stehen.

Beispiel für die XML-Schreibweise:

<person gender="female"> <firstname>Petra</firstname> <lastname>Novak</lastname> </person>

In diesem Beispiel ist

• person das Element,
• gender das Attribut,
• female der Wert des Attributs.

Das Attribut gender präzisiert also die Information über die Person – dass es sich um eine Frau handelt.

Dieselbe Information ließe sich theoretisch auch anders ausdrücken, mit einem eigenen verschachtelten Element:

<person> <gender>female</gender> <firstname>Petra</firstname> <lastname>Novak</lastname> </person>

Beide Schreibweisen sind korrekt – sie unterscheiden sich nur in der Datenstruktur. Die Verwendung von Attributen wird üblicherweise dort gewählt, wo sie die Bedeutung des Hauptelements ergänzen oder präzisieren.

Wozu Attribute dienen#

In Produktfeeds haben Attribute praktische Bedeutung – sie ermöglichen es, ein Produkt oder seine Eigenschaften genauer zu beschreiben. Manche Werbeportale oder Onlineshop-Plattformen verlangen direkt, dass bestimmte Daten in Form von Attributen angegeben werden.

Beispiele für die Verwendung von Attributen in verschiedenen Systemen#

• Ceneo
  • Verwendet Attribute zur Beschreibung des Herstellers oder anderer Eigenschaften, zum Beispiel:
    • <attrs> <a name="Producent">Nike</a> </attrs>
• Heureka (Verfügbarkeitsfeed)
  • Verlangt Attribute zur Ergänzung von Zeitangaben:
    • <delivery_time orderDeadline="2023-04-17 12:00">2023-04-26 12:00</delivery_time>
• Shoptet
  • Verwendet Attribute zum Beispiel bei Bildern:
    • <IMAGE description="Columbia Squish N' Stuff (Farbe Grün, Größe L)">https://cdn.myshoptet.com/bild.jpg``
• Google Shopping
  • Unterscheidet nicht zwischen Elementen und Attributen, sondern bezeichnet innerhalb seines Systems alle als Attribute.

Die richtige Verwendung von Attributen in Mergado ermöglicht es Ihnen, die Anforderungen dieser Portale zu erfüllen und sicherzustellen, dass Ihr Feed fehlerfrei akzeptiert wird.

Wie Sie mit Attributen im Mergado Editor arbeiten#

Der Mergado Editor ist so konzipiert, dass er mit Attributen vollwertig arbeiten kann. Attribute sind einer der grundlegenden Elementtypen und lassen sich im gesamten Editor verwenden – in Regeln, Auswahlen, Variablen und MQL-Abfragen.

Identifizierung von Attributen#

Attribute erkennen Sie in Mergado am Klammeraffen @ am Anfang des Namens.

• @id – Attribut mit dem Bezeichner des Produkts,
• @description – Attribut, das ein Bild beschreibt,
• @availability – Attribut, das den Zustand oder die Verfügbarkeit beschreibt.

Neben normalen Attributen gibt es auch spezielle Attribute, die mit zwei Klammeraffen @@ beginnen. Diese werden in der Sprache Element-Path verwendet und dienen dem präzisen Zielen – typischerweise @@POSITION (Position des Werts) und @@VALUE (Wert des Elements).

Tipp! Spezielle Attribute dienen nur dem Zielen auf Werte von Elementen und normalen Attributen innerhalb von Element-Path und werden nie in den eigentlichen Feed exportiert, im Unterschied zu normalen Attributen, die Sie im Feed vorfinden.

Zielen auf Attribute mit Element-Path#

Für die Arbeit mit Attributen dient die Sprache Element-Path. Der Pfad zu einem Attribut wird mit einem Klammeraffen @ vor dem Attributnamen geschrieben.

Beispiel für Zielen nach Attribut:

1. In einer Regel zielen wir auf das Element CODE einer konkreten Variante, die im Attribut id des Elements VARIANT den Wert idvariant3 enthält:

<VARIANTS> <VARIANT id="idvariant3"> <CODE>EEQ21</CODE> <UNIT>unit</UNIT> <FREE_SHIPPING>1</FREE_SHIPPING> <FREE_BILLING>1</FREE_BILLING> </VARIANT> <VARIANT id="idvariant4"> <CODE>EEQ22</CODE> <UNIT>unit2</UNIT> <FREE_SHIPPING>0</FREE_SHIPPING> <FREE_BILLING>0</FREE_BILLING> </VARIANT> </VARIANTS>

Der Pfad zum jeweiligen Element CODE sieht dann so aus: VARIANTS | VARIANT { @id ~ “idvariant3” } | CODE.

2. Auf der Seite Products suchen wir ein Produkt mit der Standardkategorie mit dem Attribut @id = 123:

<CATEGORIES> <DEFAULT_CATEGORY id="123">Haushaltsgeräte</DEFAULT_CATEGORY> <CATEGORY id="456">Elektronik</CATEGORY> </CATEGORIES>

Die Bedingung für die Auswahl sieht dann so aus: CATEGORIES | DEFAULT_CATEGORY | @id = “123”.

Praktisch: Erstellen, Überschreiben und Entfernen eines Attributs#

Erstellen eines Attributs#

Ein Attribut lässt sich direkt auf der Seite Elements erstellen.

1. Öffnen Sie die Seite Elements und wählen Sie die Option Neues Element.
2. Geben Sie den Namen ein und wählen Sie den Typ Attribut.
3. Fügen Sie dem Namen einen Klammeraffen @ hinzu, erkennt der Editor automatisch, dass Sie ein Attribut erstellen möchten.
4. Möchten Sie ein verschachteltes Attribut erstellen, verwenden Sie das „+"-Icon beim Elternelement und wählen Sie den Typ Attribut.

Nach der Erstellung ist das Attribut leer (hat keine Werte). Befüllen Sie es zum Beispiel mit der Regel Rewrite.

Überschreiben des Attributwerts#

Attribute lassen sich genauso anpassen wie normale Elemente – zum Beispiel mit der Regel Rewrite.

Zielen: Geben Sie im Feld Element den Pfad zum Attribut an, z. B.:

IMAGE | @description SHOPITEM | @id PARAM { @@VALUE = “Farbe” } | @lang

Vorgehen: Erstellen Sie auf der Seite Rules eine neue Regel vom Typ Rewrite, wählen Sie die Produktauswahl, geben Sie den Pfad zum Attribut ein und geben Sie im Feld New Value (Neuer Wert) den neuen Wert ein.

Entfernen eines Attributs#

Attribute lassen sich auf zwei Arten entfernen:

1. Manuell – auf der Seite Elements lassen sich manuell erstellte Attribute mit dem Papierkorb-Icon löschen. Damit werden sowohl die Werte als auch das Attribut selbst gelöscht.
2. Mithilfe von Regeln – bei Attributen, die aus dem Eingabe- oder Ausgabeformat stammen, lassen sich nur die Werte entfernen, und zwar mit einer Regel (z. B. Rewrite mit leerem Wert).

Attribute, die vom Zielformat definiert sind (sogenannte Systemattribute), lassen sich nicht umbenennen oder entfernen, weil sie Bestandteil der Spezifikation des Ausgabefeeds sind.

Zusammenfassung#

Attribute ergänzen die Bedeutung von Elementen und ermöglichen es, Daten im Feed detaillierter zu beschreiben. Im Mergado Editor können Sie mit ihnen genauso arbeiten wie mit normalen Elementen – sie erstellen, ihre Werte ändern und in Regeln auf sie zielen.

Die richtige Arbeit mit Attributen ist besonders für Feeds wichtig, die an Portale gehen, die eine genau definierte Struktur verlangen, wie Google, Heureka, Ceneo oder Shoptet.

FAQ#

Was ist ein Attribut im Kontext von XML und Produktfeeds?#

Ein Attribut ist ein Bestandteil eines Elements, der dessen Bedeutung oder Eigenschaft präzisiert. Während das Element die eigentlichen Daten trägt, liefert das Attribut eine ergänzende Information zu diesen Daten – zum Beispiel eine Einheit, einen Zustand oder eine Art des Werts. In XML steht ein Attribut immer im öffnenden Tag des Elements und hat seinen Namen und Wert, der in Anführungszeichen oder Apostrophen stehen muss. Beispiel: <person gender="female"> <firstname>Petra</firstname> <lastname>Novak</lastname> </person>

Hier ist person das Element, gender das Attribut, und sein Wert ist "female".

Wozu dienen Attribute in Produktfeeds?#

Attribute haben praktische Bedeutung – sie ermöglichen es, ein Produkt oder seine Eigenschaften genauer zu beschreiben. Manche Werbeportale und Onlineshop-Plattformen verlangen, dass bestimmte Angaben gerade in Form von Attributen gemacht werden. Verwendungsbeispiele:

• Ceneo: verwendet Attribute zur Angabe des Herstellers (<a name="Producent">Nike</a>).
• Heureka (Verfügbarkeitsfeed): Attribute ergänzen Zeitangaben (<delivery_time orderDeadline="2023-04-17 12:00">…</delivery_time>).
• Shoptet: das Attribut description beschreibt Bilder (<IMAGE description="Columbia Squish N' Stuff…">…</IMAGE>).

Die Verwendung von Attributen in Mergado stellt sicher, dass der Feed die Anforderungen des Zielsystems erfüllt und fehlerfrei akzeptiert wird.

Wie werden Attribute in XML geschrieben?#

Ein Attribut ist Bestandteil des öffnenden Tags eines Elements: <element attribut="wert">Inhalt des Elements</element>

Der Attributwert muss in Anführungszeichen oder Apostrophen stehen. Beispiel: <product available="true">Winterjacke</product>

Hier ergänzt das Attribut available die Information über die Verfügbarkeit des Produkts.

Wie erkennt der Mergado Editor Attribute?#

Attribute erkennen Sie im Mergado Editor am Klammeraffen @ am Anfang des Namens.

• @id – Bezeichner des Elementwerts,
• @description – Beschreibung des Elementwerts,
• @lang – Sprache des Elementwerts.

Neben diesen normalen Attributen gibt es auch spezielle Attribute, die mit zwei Klammeraffen @@ beginnen (z. B. @@POSITION, @@VALUE). Diese werden ausschließlich in der Sprache Element-Path verwendet und nie in den Ausgabefeed exportiert.

Wie ziele ich mit der Sprache Element-Path auf Attribute?#

Für die Arbeit mit Attributen (Lesen, Anpassen, Filtern) dient die Sprache Element-Path. Der Pfad zu einem Attribut wird mit einem Klammeraffen @ vor seinem Namen geschrieben. Beispiele für das Zielen:

Beim Filtern von Produkten: Finden Sie Produkte, deren id der Hauptkategorie gleich 123 ist:

• CATEGORIES | DEFAULT_CATEGORY | @id = "123"

In einer Regel beim Zielen auf ein konkretes Element: Finden Sie CODE einer Variante, deren Attribut @id den Text idvariant3 enthält:

• VARIANTS | VARIANT { @id ~ "idvariant3" } | CODE

Attribute lassen sich auch in Bedingungen verwenden (in Klammern { }), wo sie konkrete Werte filtern.

Was ist der Unterschied zwischen normalen und speziellen Attributen?#

In Mergado unterscheiden wir zwei Arten von Attributen:

Wozu dienen die speziellen Attribute @@POSITION und @@VALUE?#

@@POSITION – entspricht der Reihenfolge des Werts des Elements, an das es gebunden ist. Wird vor allem bei mehrfachen Elementen verwendet (z. B. Bilder, Varianten). Beispiel:

IMGURL_ALTERNATIVE { @@POSITION > 1 }

• Diese Schreibweise zielt auf alle alternativen Bilder außer dem ersten.

@@VALUE – stellt den Inhalt des Werts des Elements dar. Wird bei Elementen verwendet, bei denen sich die Reihenfolge der Werte ändert oder nicht wichtig ist. Beispiel:

CATEGORY { @@VALUE != "Spielzeug" }

• Diese Schreibweise wählt alle Kategorien außer „Spielzeug" aus.

Wie erstelle ich ein neues Attribut in Mergado?#

Ein neues Attribut lässt sich auf der Seite Elements erstellen.

1. Klicken Sie auf Neues Element.
2. Geben Sie den Namen des Attributs beginnend mit dem Zeichen @ ein.
3. Mergado erkennt automatisch, dass Sie ein Attribut erstellen.
4. Möchten Sie ein verschachteltes Attribut erstellen, verwenden Sie das „+"-Icon beim Elternelement.

Das neu erstellte Attribut ist leer und lässt sich mit der Regel Rewrite befüllen.

Wie passe ich den Wert eines Attributs an oder überschreibe ihn?#

Attribute lassen sich genauso überschreiben wie normale Elemente. In der Regel Rewrite genügt es, im Feld Element den Pfad zum Attribut anzugeben. Beispiele:

• IMAGE | @description
• SHOPITEM | @id
• PARAM { @@VALUE = “Farbe” } | @value

Geben Sie im Feld New Value den gewünschten neuen Wert ein.

Wie entferne ich ein Attribut?#

Attribute lassen sich auf zwei Arten entfernen:

• Manuell: bei manuell erstellten Attributen auf der Seite Elements durch Klick auf das Papierkorb-Icon beim Attribut.
• Mithilfe einer Regel: z. B. mit der Regel Rewrite mit leerem Wert.

Attribute, die Bestandteil des Quell- oder Zielformats sind, lassen sich nicht entfernen, nur ihre Werte löschen.

Wie ist das Verhältnis zwischen Attributen und Elementen in Mergado?#

In Mergado gelten Attribute als spezieller Elementtyp. Sie lassen sich in Regeln, Auswahlen, Variablen und Automatisierungen genauso verwenden wie normale Elemente. Der Unterschied liegt nur in der Schreibweise (mit dem Zeichen @) und in ihrer Position innerhalb der Feed-Struktur.

Warum ist es wichtig, korrekt mit Attributen zu arbeiten?#

Die korrekte Arbeit mit Attributen ist entscheidend für Feeds, die an Portale gehen, die eine exakte Datenstruktur verlangen – wie Google, Heureka, Ceneo oder Shoptet. Fehlerhaft angegebene oder fehlende Attribute können zur Ablehnung des Feeds oder zur unvollständigen Anzeige von Produkten führen. Dank der Werkzeuge des Mergado Editor lassen sich Attribute mit hoher Präzision hinzufügen, ändern und kontrollieren.

7. Die Sprache Element-Path#

Was ist Element-Path#

Element-Path ist eine von Mergado entwickelte Sprache, die dem Schreiben von Pfaden zu Elementen und ihren Werten dient. Mithilfe von Element-Path bestimmen Sie, auf welche Werte im Feed Sie zielen möchten – ob Sie sie lesen oder in sie schreiben möchten.

Der Mergado Editor arbeitet mit Elementen genauso wie der XML-Feed – in einer Baumstruktur. Damit sich in dieser Struktur genau bestimmen lässt, mit welchen Daten Sie arbeiten möchten, müssen Sie deren Pfad kennen. Genau das ermöglicht die Sprache Element-Path.

Was bedeutet „Pfad zu einem Element"#

Der Pfad zu einem Element ist eine Schreibweise, die ausdrückt, wo sich in der Datenstruktur der Wert (die Werte) befindet, mit dem Sie arbeiten möchten. Mithilfe dieses Pfads teilen Sie Mergado mit, dass Sie entweder:

1. den Wert lesen möchten – also ihn als Eingang verwenden (z. B. in einer Regel oder Auswahl), oder
2. den Wert ändern möchten – also neue Daten hineinschreiben.

Beispiel:

• Möchten Sie auf den Wert des Elements NAME zielen, lautet der Pfad einfach: NAME

Der Mergado Editor liest diesen Pfad und verwendet den im Element NAME angegebenen Wert.

Hinweis: In der Praxis wird üblich der Begriff „Pfad zum Element" verwendet, obwohl es genauer gesagt immer um den „Pfad zum Wert des Elements" geht. Bei einfachen Elementen stimmen beide Begriffe jedoch inhaltlich überein.

Verschachtelte Pfade#

Verschachtelung wird in der Sprache Element-Path mit der senkrechten Linie | geschrieben, die die Beziehung zwischen Eltern und Kind ausdrückt.

• Syntax: Möchten Sie auf ein verschachteltes Element zielen, stellen Sie den Namen des Elternelements voran und trennen Sie beide mit einer senkrechten Linie.
• Lesen: Die senkrechte Linie lesen wir als „und darunter verschachtelt" oder „und dessen Kind".

Beispiel: Der Pfad

PARAM | VAL

• bedeutet: „Finde das Element PARAM und darunter das verschachtelte Element VAL."
• Wichtige Regel: Das Leerzeichen vor und nach der senkrechten Linie muss eingehalten werden – die Schreibweise PARAM | VAL ist richtig, PARAM|VAL nicht.

Vokabular und Syntax von Element-Path#

Element-Path hat sein eigenes „Vokabular" und Syntaxregeln. Die Grundelemente der Sprache sind:

1. Elementnamen – alle Namen, die im Projekt vorkommen.
2. Senkrechte Linie (|) – kennzeichnet Verschachtelung (Eltern → Kind).
3. Bedingungen ({ }) – filtern Werte nach angegebenen Kriterien.
4. Spezielle Attribute (@@…) – ermöglichen das Zielen z. B. nach Position (@@POSITION), Wert (@@VALUE) oder nach dem letzten Wert (@@MAX_POSITION).
5. MQL (Mergado Query Language) – lässt sich in Bedingungen für erweiterte Filterung verwenden (z. B. mit Operatoren AND, OR usw.).

Hilfe beim Schreiben von Pfaden#

Im Mergado Editor wird die Arbeit mit Element-Path durch mehrere Funktionen erleichtert:

• Autovervollständigung: Der Editor bietet verfügbare Elemente, Operatoren und Werte an.
• Validierung: Befindet sich das geschriebene Element nicht im Projekt, wird es rot hervorgehoben; ein gültiger Pfad wird grün hervorgehoben.
• Autovervollständigung für Versanddienstleister und Parameter: Bei manchen Feed-Typen bietet der Editor konkrete Namen an (z. B. Versanddienstleister, Parameter) und ergänzt automatisch den gesamten Pfad.

Wo Element-Path verwendet wird#

Elementpfade werden fast überall im Mergado Editor verwendet – überall dort, wo festgelegt werden muss, mit welchen Daten Sie arbeiten.

• In Regeln – z. B. Rewrite, Find and Replace, Bulk Copy Values, Calculation. Der Elementpfad bestimmt, mit welchen Werten die Regel arbeiten soll.
• In Auswahlen – bei der Erstellung von Auswahlen auf der Seite Products oder beim Schreiben einer eigenen MQL-Abfrage.
• In Variablen – zum Lesen von Werten aus konkreten Elementen und zum Schreiben von Werten in Elemente.
• In Importen – in Elementen von Importdateien, die über die Regel Data File Import verarbeitet werden.
• Auf der Seite Products – zum Sortieren, Filtern und für die Übersicht von Elementwerten.
• In der Automatisierung – bei der Einrichtung von Regeln und Bedingungen für automatische Aktionen.

Praktisch: Arbeit mit Schreibweise und Bedingungen#

Element-Path ist vor allem bei verschachtelten und mehrfachen Elementen entscheidend. Die korrekte Schreibweise des Pfads bestimmt, welche Werte Mergado liest oder anpasst.

1. Grundlegender Pfad ohne Bedingung#

Verwenden Sie einen verschachtelten Pfad ohne Bedingung, zielt Mergado auf alle Werte in der jeweiligen Struktur.

Beispiel:

• PARAM | VAL

Dieser Pfad bezeichnet alle Werte VAL aller Vorkommen des Elements PARAM. Hat ein Produkt die Parameter Farbe, Größe und Material, führt der Pfad PARAM | PARAM_NAME zu drei Werten. Beim Lesen verwendet Mergado den ersten davon; beim Schreiben wirkt sich die Änderung auf alle entsprechenden Werte aus.

2. Präzises Zielen mithilfe von Bedingungen#

Bedingungen werden in geschweifte Klammern { } geschrieben und beziehen sich immer auf das Element, das links davon steht. Sie dienen der Eingrenzung des Zielens auf konkrete Werte.

Zielen auf einen konkreten Wert eines verschachtelten Elements

Möchten Sie nur mit dem Parameter „Farbe" arbeiten, verwenden Sie eine Bedingung, die über das verschachtelte Element PARAM_NAME filtert:

PARAM { PARAM_NAME = “Farbe” } | VAL

Diese Schreibweise bedeutet: „Finde das Element PARAM, das ein Kind PARAM_NAME mit dem Wert Farbe hat, und passe darin den Wert des Elements VAL an."

Diese Methode ist am sichersten, weil sie unabhängig von der Reihenfolge der Parameter im Feed funktioniert.

Zielen auf die Position eines mehrfachen Elements

Mithilfe des speziellen Attributs @@POSITION können Sie auf einen Wert nach seiner Position zielen. Jeder Wert hat seine Ordnungszahl (1, 2, 3 …).

Beispiel:

• IMAGES | IMAGE { @@POSITION = 3 }

Dieser Pfad zielt auf das dritte Bild. Er eignet sich dort, wo die Reihenfolge der Werte eine feste Bedeutung hat. Beachten Sie jedoch, dass @@POSITION den Inhalt nicht berücksichtigt – unterscheidet sich die Reihenfolge zwischen Produkten, kann es zu einer unerwünschten Auswahl eines anderen Werts kommen.

Zielen auf den Wert eines mehrfachen Elements

Das Attribut @@VALUE bezieht sich auf den Wert des Elements. Es wird bei Elementen ohne Kinder verwendet und ermöglicht das Zielen nach einem konkreten Wert unabhängig von seiner Position.

Beispiel:

CATEGORIES | CATEGORY { @@VALUE != “Spielzeug” }

Diese Schreibweise wählt alle CATEGORY aus, deren Wert nicht „Spielzeug" entspricht. Bedingungen lassen sich auch mit MQL-Operatoren kombinieren (AND, OR, NOT usw.), was eine sehr präzise Filterung ermöglicht.

Zusammenfassung#

Element-Path ist die grundlegende Sprache für die Arbeit mit Daten im Mergado Editor. Dank ihr lässt sich genau bestimmen, woher Werte stammen, wohin sie geschrieben werden sollen und in welchem Kontext sie sich befinden.

Das richtige Verständnis der Struktur und Syntax von Element-Path ermöglicht Ihnen die Erstellung sicherer Regeln, effizienter Auswahlen und Automatisierungen, die auch mit komplexen XML- und CSV-Feeds zuverlässig funktionieren.

FAQ#

Was ist die Sprache Element-Path und wozu dient sie?#

Element-Path ist eine von Mergado entwickelte Sprache. Sie dient dem Schreiben von Pfaden zu Elementen und ihren Werten – also der Festlegung, mit welchen Daten im Feed Sie arbeiten möchten. Mithilfe von Element-Path können Sie:

• Werte lesen aus dem Feed (z. B. für Auswahlen, Berechnungen oder Bedingungen),
• neue Werte schreiben (z. B. mit Regeln wie Rewrite oder Find and Replace).

Was bedeutet „Pfad zum Element"?#

Der Pfad zum Element bestimmt, wo sich ein konkreter Wert in der Datenstruktur des Feeds befindet. Mithilfe des Pfads teilen Sie Mergado mit, auf welches Element eine Regel oder Auswahl zielen soll. Beispiel: NAME

• Diese Schreibweise sagt, dass wir mit dem Wert des Elements NAME arbeiten möchten.

Hinweis: Technisch gesehen geht es um den „Pfad zum Wert des Elements", weil das Ziel immer ein konkreter Wert ist, nicht das Tag des Elements selbst.

Wie wird Verschachtelung in Element-Path geschrieben?#

Verschachtelung drückt die Beziehung zwischen Eltern und Kind aus und wird mit der senkrechten Linie | geschrieben. Syntax: ELTERN | KIND

• Lesen: „Finde das Element ELTERN und darunter das verschachtelte Element KIND."
• Wichtig: Das Leerzeichen vor und nach der senkrechten Linie ist verpflichtend.
  • Richtig: PARAM | VAL
  • Falsch: PARAM|VAL

Beispiel: <PARAM> <PARAM_NAME>Farbe</PARAM_NAME> <VAL>Schwarz</VAL> </PARAM>

Der Pfad zum Wert VAL lautet PARAM | VAL.

Was ist das Vokabular und die Syntax von Element-Path?#

Element-Path hat seine eigene „Grammatik". Sie umfasst folgende Grundelemente:

Welche Werkzeuge helfen beim Schreiben von Pfaden in Mergado?#

Der Mergado Editor bietet erweiterte Funktionen für die Arbeit mit Element-Path:

• Autovervollständigung: Der Editor bietet verfügbare Elemente, Attribute und Operatoren an.
• Validierung: Existiert ein Element nicht, wird es rot hervorgehoben; gültige Pfade werden grün hervorgehoben.
• Autovervollständigung für Parameter und Versanddienstleister: Der Editor ergänzt automatisch konkrete Namen und erstellt vollständige Pfade.

Wo überall wird Element-Path verwendet?#

Elementpfade werden im gesamten Mergado Editor verwendet – überall dort, wo genau festgelegt werden muss, mit welchen Daten Sie arbeiten.

• In Regeln: z. B. Rewrite, Find and Replace, Calculation, Bulk Copy Values.
• In Auswahlen: in der einfachen Ansicht ebenso wie in MQL-Abfragen.
• In Variablen: beim Lesen oder Schreiben von Werten.
• In Importen: in den Kopfzeilen von Importdateien.
• Auf der Seite Products: für Anzeige, Sortierung und Filterung von Werten.
• In der Automatisierung: bei der Einrichtung von Regeln und Bedingungen für automatische Aktionen.

Was sind Bedingungen und wie funktionieren sie?#

Bedingungen dienen als Filter, der eingrenzt, auf welche Werte ein Pfad zielen soll. Sie werden in geschweifte Klammern { } geschrieben und beziehen sich immer auf das Element links davon. Beispiel: PARAM { PARAM_NAME = "Farbe" } | VAL

Diese Schreibweise wählt nur die Werte VAL bei Parametern aus, bei denen PARAM_NAME gleich „Farbe" ist. Bedingungen sind bei mehrfachen Elementen notwendig, bei denen sich dieselben Namen wiederholen können (z. B. verschiedene Parameter bei einem Produkt).

Wie lassen sich in Bedingungen logische MQL-Operatoren verwenden?#

Element-Path unterstützt das gesamte Vokabular der Sprache MQL (Mergado Query Language). In Bedingungen lassen sich logische Operatoren wie AND, OR, NOT, IN, CONTAINS usw. verwenden. Beispiel einer komplexen Bedingung: VARIANTS | VARIANT { PARAMETERS | PARAMETER { NAME = "Größe" } | VALUE = "M" AND PARAMETERS | PARAMETER { NAME = "Material" } | VALUE = "Baumwolle" } | STOCK | WAREHOUSES | WAREHOUSE | NAME

Diese Schreibweise wählt den Namen des Lagers (NAME) bei Varianten aus, die Größe „M" und Material „Baumwolle" haben.

Welche speziellen Attribute verwendet Element-Path?#

Spezielle Attribute beginnen immer mit zwei Klammeraffen @@ und werden in Bedingungen verwendet. Sie erleichtern das Zielen bei mehrfachen Elementen.

@@POSITION wird dort verwendet, wo die Reihenfolge der Werte der Bedeutung entspricht (z. B. Bilder). @@VALUE ist sicherer dort, wo sich die Reihenfolge ändern kann.

Wie werden Bedingungen mit mehreren Verschachtelungsebenen verwendet?#

Bedingungen lassen sich auch zwischen verschiedenen Elementebenen kombinieren. Beispiel für mehrstufige Verschachtelung: VARIANTS | VARIANT { @@POSITION = 2 } | PARAMETERS | PARAMETER { NAME = "Größe" } | VALUE

Diese Schreibweise zielt auf den Wert des Parameters „Größe" bei der zweiten Variante des Produkts.

Was sind die häufigsten Fehler beim Schreiben von Pfaden?#

• Fehlende Leerzeichen um die senkrechte Linie (|).
• Falsche Platzierung der geschweiften Klammern { }.
• Fehlerhafte Elementnamen (nicht im Projekt vorhanden).
• Verwendung von @@POSITION bei Elementen, bei denen sich die Reihenfolge zwischen Produkten unterscheidet.
• Ein Pfad, der beim Elternelement statt beim Kind endet (z. B. PARAM statt PARAM | VAL).

Der Mergado Editor erkennt Fehler automatisch im Feld zur Pfadeingabe – ein ungültiger Pfad wird rot dargestellt.

Wie hilft Element-Path bei der Präzision und Sicherheit von Regeln?#

Die korrekte Verwendung von Element-Path stellt sicher, dass Regeln, Auswahlen und Automatisierungen nur mit relevanten Daten arbeiten. Dank eines präzise definierten Pfads lässt sich:

• sicher lesen und Werte anpassen,
• nur auf ausgewählte Bedingungen zielen,
• Fehlern durch Änderungen der Feed-Struktur vorbeugen.

8. Bedingungen im Elementpfad#

Was sind Bedingungen#

Bedingungen im Elementpfad funktionieren als Filter, der es ermöglicht, nur auf ausgewählte Werte zu zielen und dadurch die Arbeit mit Daten zu präzisieren. Sie sind fester Bestandteil der Sprache Element-Path und werden vor allem bei der Arbeit mit mehrfachen und verschachtelten Elementen verwendet.

Bedingungen beziehen sich immer auf das Element, das links von ihnen steht, und können nur Werte seiner verschachtelten Kinder filtern.

Wie Bedingungen geschrieben werden#

Bedingungen werden in geschweifte Klammern { } geschrieben, die sich auf das jeweilige Element beziehen.

Grundschablone der Schreibweise:

Element { Kind Operator Wert } | Weiteres_Kind

Beispiel:

• PARAM { PARAM_NAME = “Farbe” } | VAL

Dieser Pfad sagt: „Finde das Element PARAM, das ein Kind PARAM_NAME mit dem Wert Farbe hat, und ziele darin auf das verschachtelte Element VAL."

Schreibregeln#

• Leerzeichen sind wichtig – sie dürfen nicht weggelassen werden. Das gilt sowohl innerhalb der Bedingung als auch davor und danach (z. B. ist PARAM { PARAM_NAME = "Farbe" } | VAL richtig, PARAM{PARAM_NAME="Farbe"}|VAL falsch).
• Klammern { } werden auf der deutschen Tastatur mit der Tastenkombination Alt Gr + 7 (links) und Alt Gr + 0 (rechts) geschrieben.
• Bedingungen können beliebig komplexe Ausdrücke enthalten, einschließlich der Operatoren AND, OR, NOT, oder mehrerer Verschachtelungsebenen.

Verwendung von MQL in Bedingungen#

Bedingungen in Element-Path unterstützen die vollständige Syntax von Mergado Query Language (MQL). Das bedeutet, Sie können darin dieselben Ausdrücke schreiben wie im Formular für eigene Abfragen.

Zum Beispiel:

• PARAM { PARAM_NAME = “Größe” AND VAL = “M” }

oder eine komplexere Variante mit mehreren Ebenen:

• VARIANT { PARAMETERS | PARAM { PARAM_NAME = “Material” AND VAL = “Baumwolle” } }

Dieser Ansatz ermöglicht die Kombination von Bedingungen und das Zielen auf sehr präzise definierte Wertgruppen.

Wozu Bedingungen dienen#

Bedingungen präzisieren den Pfad zu einem Element und ermöglichen das Zielen auf konkrete Untergruppen von Werten. Sie werden vor allem verwendet für:

1. Zielen auf konkrete Werte mehrfacher Elemente.
   1. Zum Beispiel bei der Arbeit mit Parametern, Versanddienstleistern oder Bildern, wo ein Pfad ohne Bedingung zu mehreren Werten führen würde. Die Bedingung stellt sicher, dass die Regel nur auf den richtigen angewendet wird.
2. Strukturelles Hinzufügen von Werten
   1. Beim Schreiben in den Feed gilt: Alles, was in der Bedingung mit dem Operator = oder AND steht, erstellt Mergado, sofern es noch nicht existiert.
   2. Dadurch lassen sich mit Bedingungen auch neue verschachtelte Strukturen erstellen (z. B. ein neuer Parameter oder ein Flag).
3. Verwendung spezieller Attribute
   1. Bedingungen dienen auch der Arbeit mit speziellen Attributen wie @@POSITION (Reihenfolge des Werts) und @@VALUE (Wert des Elements).

Wann sie sinnvoll sind und wann nicht#

Wann sie sinnvoll sind#

Bedingungen sind bei mehrfachen Elementen sinnvoll, bei denen sich eine Art von Information mehrmals wiederholen kann.

Am häufigsten werden sie verwendet bei der Arbeit mit:

• Parametern (PARAM),
• Versand (DELIVERY),
• Varianten (VARIANT),
• Bildern (IMAGE),
• Kategorien (CATEGORY).

Beispiel:

• PARAM { PARAM_NAME = “Farbe” } | VAL

Diese Schreibweise stellt sicher, dass die Änderung nur beim Parameter „Farbe" erfolgt, unabhängig von seiner Position im Feed. In diesem Fall ist das sicherer als die Verwendung des Attributs @@POSITION, das sich zwischen Produkten unterscheiden kann.

Wann sie nicht sinnvoll sind#

1. Einfache Elemente
   1. Bei einfachen Elementen (z. B. ITEM_ID, PRICE_VAT) hat das Element immer nur einen Wert, sodass die Bedingung überflüssig ist.
2. Zielen auf alle Werte
   1. Möchten Sie mit allen Werten eines Elements arbeiten, verwenden Sie keine Bedingung. Zum Beispiel: IMAGES | IMAGE
   2. Dieser Pfad zielt auf alle Bilder des jeweiligen Produkts.

Praktisch: Filterung von Werten mithilfe einer Bedingung#

Beispielpfad#

• PARAM { PARAM_NAME = “Farbe” } | VAL

Wie Mergado diesen Pfad auswertet#

1. PARAM – bezeichnet das übergeordnete, mehrfache Element.
2. { PARAM_NAME = "Farbe" } – ist die Bedingung, die sagt: „Uns interessieren nur die Elemente PARAM, deren Kind PARAM_NAME den Wert Farbe hat."
3. | VAL – bestimmt, dass wir mit dem Kind VAL arbeiten, also mit dem konkreten Wert des Parameters.

Das Ergebnis ist, dass Mergado nur die Werte VAL auswählt, die zum Parameter mit dem Namen „Farbe" gehören.

Vergleich mit dem Zielen nach Position#

Die Bedingung

• PARAM { PARAM_NAME = “Farbe” } | VAL

ist zuverlässiger als die Schreibweise

• PARAM { @@POSITION = 2 } | VAL

Weil das Zielen nach dem Parameternamen unabhängig von seiner Reihenfolge innerhalb des Produkts funktioniert. Bei Parametern mit unterschiedlicher Reihenfolge lässt sich so eine falsche Zuordnung von Werten vermeiden.

Zusammenfassung#

Bedingungen in der Sprache Element-Path sind ein Schlüsselwerkzeug für präzises und sicheres Zielen auf konkrete Werte. Sie ermöglichen es, Daten zu filtern, neue Strukturen zu erstellen und mit mehrfachen und verschachtelten Elementen zu arbeiten, ohne das Risiko eines fehlerhaften Überschreibens. Die richtige Verwendung von Bedingungen hilft Ihnen, Fehler zu vermeiden, Ordnung in Ihren Regeln zu halten und sicherzustellen, dass Mergado immer nur die Daten anpasst, die Sie tatsächlich ändern möchten.

FAQ#

Was sind Bedingungen in der Sprache Element-Path und warum werden sie verwendet?#

Bedingungen sind ein Filter, der den Pfad zu einem Element präzisiert. Mithilfe von ihnen bestimmen Sie, auf welche konkreten Werte Mergado zielen soll – also welche gelesen, angepasst oder erstellt werden sollen. Sie werden vor allem bei mehrfachen und verschachtelten Elementen verwendet, bei denen sich Werte wiederholen oder denselben Namen teilen. Bedingungen helfen:

• präzise auf einen ausgewählten Wert zu zielen (z. B. einen konkreten Parameter),
• Fehler beim Überschreiben nicht zusammenhängender Daten zu vermeiden,
• neue Strukturen direkt in Regeln zu erstellen.

Wie werden Bedingungen geschrieben (Syntax)?#

Bedingungen werden in geschweifte Klammern { } geschrieben, die sich auf das Element links davon beziehen. Grundform der Schreibweise:

• ELEMENT { KIND = "Wert" } | WEITERES_KIND

Beispiel:

• PARAM { PARAM_NAME = "Farbe" } | VAL

Diese Schreibweise sagt: „Finde das Element PARAM, dessen verschachteltes Element PARAM_NAME den Wert Farbe hat, und ziele darin auf VAL."

Wichtige Schreibregeln:

• Leerzeichen sind verpflichtend – sie dürfen weder innerhalb der Bedingung noch davor und danach weggelassen werden.
• Klammern { } werden auf der deutschen Tastatur mit der Kombination Alt Gr + 7 (links) und Alt Gr + 0 (rechts) geschrieben.
• Bedingungen können mehrere über logische Operatoren AND, OR, NOT verknüpfte Kriterien enthalten.

Wie funktioniert die Bindung von Bedingungen im Pfad?#

Eine Bedingung bezieht sich immer auf das Element links von ihr. Filtern lässt sich nur über die Kinder (verschachtelten Elemente) dieses Elements. Beispiel: VARIANT { PARAMETERS | PARAMETER { NAME = "Größe" } | VALUE = "M" } | STOCK

Diese Schreibweise bedeutet: „Finde die Variante, die einen Parameter mit dem Namen Größe und dem Wert M hat, und arbeite darin mit dem Element STOCK."

Wie werden Bedingungen bei der Arbeit mit mehrfachen Elementen genutzt?#

Bedingungen sind entscheidend bei der Arbeit mit Elementen, die sich innerhalb eines Produkts wiederholen (z. B. PARAM, DELIVERY, CATEGORY, IMAGE, VARIANT). Ohne Bedingung:

• PARAM | VAL – zielt auf alle Werte VAL innerhalb aller Parameter. Beim Lesen verwendet Mergado den ersten Wert, beim Schreiben ändert es alle.

Mit Bedingung:

• PARAM { PARAM_NAME = "Farbe" } | VAL – zielt nur auf den Wert VAL, der zum Parameter „Farbe" gehört. Diese Schreibweise ist sicher und eindeutig – die Reihenfolge der Elemente spielt keine Rolle.

Welche Operatoren lassen sich in Bedingungen verwenden?#

Bedingungen unterstützen alle üblichen Operatoren aus der Sprache MQL (Mergado Query Language). Dadurch lassen sich auch sehr präzise und komplexe Filter erstellen.

Wie wird in Bedingungen die MQL-Syntax verwendet?#

In Bedingungen lassen sich ganze MQL-Abfragen schreiben – die Sprache Mergado Query Language ist vollständig in Element-Path integriert. Dadurch lassen sich mehrfache Filter, verschiedene Verschachtelungsebenen und komplexe Logik kombinieren. Beispiel für eine komplexe Bedingung: VARIANTS | VARIANT { PARAMETERS | PARAMETER { NAME = "Material" AND VAL = "Baumwolle" } AND PARAMETERS | PARAMETER { NAME = "Größe" AND VAL = "M" } } | PRICE

Diese Schreibweise wählt den Preis (PRICE) bei der Variante aus, die die Parameter Material = Baumwolle und Größe = M hat.

Was, wenn ein Element keine verschachtelten Kinder hat?#

Bei Elementen, die keine verschachtelten Elemente haben, werden in Bedingungen spezielle Attribute verwendet:

• @@POSITION – zielt nach der Reihenfolge des Werts,
• @@VALUE – zielt nach dem Inhalt des Werts.

Beispiele:

• IMAGES | IMAGE { @@POSITION = 3 } – drittes Bild,
• CATEGORY { @@VALUE != "Spielzeug" } – alle Kategorien außer „Spielzeug".

Was ist der Unterschied zwischen einer Bedingung und dem Zielen nach Position?#

Das Zielen nach Position (@@POSITION) bezieht sich nur auf die Reihenfolge des Werts. Das Zielen mit einer Bedingung berücksichtigt dagegen den Inhalt. Vergleich:

• PARAM { @@POSITION = 2 } | VAL – zielt auf den zweiten Parameter in der Reihenfolge.
• PARAM { PARAM_NAME = "Farbe" } | VAL – zielt auf den Parameter mit dem Namen „Farbe", unabhängig von seiner Position.

Das Zielen nach Inhalt ist zuverlässiger, weil es auch dann funktioniert, wenn sich die Reihenfolge der Werte zwischen Produkten unterscheidet.

Wie helfen Bedingungen beim Schreiben neuer Daten?#

Beim Schreiben von Daten in den Feed gilt: Enthält die Bedingung bei einem Element nur die Operatoren = und AND mit Unterelementen, deren Werte nicht existieren, erstellt Mergado diese Werte automatisch. Dieses Prinzip ermöglicht das sogenannte strukturelle Hinzufügen von Werten – zum Beispiel das Hinzufügen eines neuen Parameters, einer Variante oder eines Flags. Beispiel: FLAGS | FLAG { CODE = "action" } | ACTIVE

Existiert das Flag mit dem Code action nicht, erstellt Mergado es automatisch und setzt ACTIVE auf 0.

Wann ist es sinnvoll, Bedingungen zu verwenden?#

Bedingungen sind vor allem bei mehrfachen oder verschachtelten Elementen sinnvoll, wie zum Beispiel:

• PARAM oder g:attribute_detail (Produktparameter),
• DELIVERY (Versand),
• VARIANT (Varianten),
• IMAGE (Bilder),
• CATEGORY (Kategorien).

Zum Beispiel stellt der Pfad: PARAM { PARAM_NAME = "Farbe" } | VAL

sicher, dass sich die Anpassung nur auf den Wert des Parameters „Farbe" bezieht, nicht auf andere Parameter.

Wann sind Bedingungen nicht sinnvoll?#

Bedingungen sind in folgenden Fällen nicht sinnvoll:

• Einfache Elemente – haben nur einen Wert (ITEM_ID, PRICE_VAT).
• Zielen auf alle Werte – möchten Sie mit allen Vorkommen eines Elements arbeiten (z. B. IMAGES | IMAGE), muss keine Bedingung hinzugefügt werden.

Wie überprüfe ich die Korrektheit eines Pfads mit Bedingung?#

Im Mergado Editor steht das Werkzeug Element-Path zur Verfügung, das ermöglicht:

• die Schreibweise des Pfads (einschließlich Bedingungen) zu testen,
• anzuzeigen, wohin der Pfad tatsächlich führt,
• zu validieren, ob die Elemente im Pfad existieren.

Außerdem bietet das Feld zur Pfadeingabe:

• Autovervollständigung (von Elementen, Attributen, Operatoren, Werten),
• farbliche Syntaxhervorhebung,
• Warnungen bei ungültigem oder unvollständigem Pfad.

Was sind die häufigsten Fehler beim Schreiben von Bedingungen?#

• Fehlende Leerzeichen um die geschweiften Klammern { }.
• Verwendung einer Bedingung bei einem Element, das keine Kinder hat.
• Verwechslung des Elementnamens (z. B. PARAM_NAME vs. NAME).
• Ausgelassene geschweifte Klammern oder falsche Platzierung der Bedingung im Pfad.
• Verwendung von @@POSITION statt des Elementnamens dort, wo sich die Reihenfolge unterscheidet.

Mergado macht auf diese Fehler automatisch durch Hervorhebung der fehlerhaften Schreibweise aufmerksam.

9. Spezielle Attribute in Element-Path#

Was sind spezielle Attribute#

Spezielle Attribute stellen ein fortgeschrittenes Werkzeug im Mergado Editor und der Sprache Element-Path dar. Sie dienen dem präzisen Zielen bei mehrfachen Elementen und ermöglichen die Unterscheidung zwischen einzelnen Werten desselben Elements.

Jedes spezielle Attribut:

• beginnt mit zwei Klammeraffen (@@),
• bezieht sich auf ein konkretes Element,
• wird innerhalb von Bedingungen in Elementpfaden verwendet (in geschweiften Klammern { }),
• erweitert die Möglichkeiten des Zielens und Filterns in Element-Path.

In Mergado stehen aktuell diese speziellen Attribute zur Verfügung:

1. @@POSITION – Position des Werts,
2. @@VALUE – Inhalt des Werts.
3. @@MAX_POSITION – eine Zahl, die die höchste Position der Werte eines Elements bei einem konkreten Produkt angibt.

@@POSITION – Zielen nach Position#

Das Attribut @@POSITION entspricht der Reihenfolge des Werts des Elements, an das es gebunden ist. Es ermöglicht das Zielen auf eine konkrete Position oder einen Positionsbereich innerhalb eines mehrfachen Elements.

• Jeder Wert hat seine Position, ausgedrückt durch eine natürliche Zahl (1, 2, 3 …).
• Bei einfachen Elementen hat der Wert immer die Position 1.
• Nur bei mehrfachen Elementen (IMAGE, PARAM, DELIVERY usw.) kann die Position höher als 1 sein.

Beispiel:

• IMAGES | IMAGE { @@POSITION = 3 }

Lesen Sie das als: „Finde das Element IMAGES und ziele auf sein Kind IMAGE mit dem Wert an der dritten Position."

Schwäche: @@POSITION arbeitet nur mit der Reihenfolge und berücksichtigt nicht den Inhalt des Werts. Unterscheidet sich die Reihenfolge der Werte zwischen Produkten, kann das Zielen auf einen anderen Wert treffen, als Sie erwarten.

@@VALUE – Zielen nach Inhalt des Werts#

Das Attribut @@VALUE repräsentiert den Wert des Elements, an das es gebunden ist, und ermöglicht das Zielen nach seinem Inhalt. Es wird in Bedingungen bei Elementen verwendet, die keine Kinder haben (oder dort, wo Sie nicht auf eine verschachtelte Struktur zielen müssen).

Wann @@VALUE verwenden

1. Bei Elementen ohne Kinder – zum Beispiel IMGURL_ALTERNATIVE, CATEGORY.
2. Bei mehrfachen Elementen – ermöglicht das Zielen auf einen Wert unabhängig von seiner Position.
3. Bei sich ändernder Reihenfolge der Werte – ersetzt das weniger zuverlässige Zielen mit @@POSITION.

Beispiel:

• CATEGORIES | CATEGORY { @@VALUE != “Spielzeug” }

Diese Schreibweise wählt alle Kategorien außer „Spielzeug" aus. Das Zielen mit @@VALUE eignet sich dort, wo sich die Reihenfolge der Werte zwischen Produkten unterscheiden kann.

@@MAX_POSITION – hilfreiches spezielles Attribut#

Das hilfreiche spezielle Attribut @@MAX_POSITION stellt die Position des Werts mit der höchsten Reihenfolge eines Elements bei einem konkreten Produkt dar. Mit anderen Worten – es bezeichnet die letzte Position, auf der sich das jeweilige Element innerhalb des Produkts befindet.

Beispiel:

<IMAGE>www.image1.jpg</IMAGE> …@@POSITION = 1 <IMAGE>www.image2.jpg</IMAGE> …@@POSITION = 2 <IMAGE>www.image3.jpg</IMAGE> …@@POSITION = 3

In diesem Fall ist @@MAX_POSITION = 3, weil die höchste existierende Position des Elements IMAGE genau 3 ist. Bei verschiedenen Produkten kann dasselbe Element einen unterschiedlichen Wert von @@MAX_POSITION haben, weil sich die Anzahl der Werte unterscheiden kann.

Wann @@MAX_POSITION verwenden

1. Hinzufügen neuer mehrfacher Werte

Möchten Sie einen neuen Wert ans Ende der bestehenden Werte hinzufügen, ohne dass einer überschrieben wird, verwenden Sie die Konstruktion: ELEMENT {@@POSITION = @@MAX_POSITION + 1}

Beispiel:

Sie möchten die neue URL eines Bildes www.image4.jpg in das Element IMAGE an die nächste freie Position schreiben.

• Verwenden Sie die Regel Rewrite
• Fügen Sie im Feld Element ein: IMAGE {@@POSITION = @@MAX_POSITION + 1}
• Geben Sie im Feld Neuer Wert die neue URL ein: www.image4.jpg

Ergebnis:

<IMAGE>www.image1.jpg</IMAGE> <IMAGE>www.image2.jpg</IMAGE> <IMAGE>www.image3.jpg</IMAGE> <IMAGE>www.image4.jpg</IMAGE>

2. Kopieren von Werten ans Ende einer bestehenden Liste

Beim Kopieren von Werten zwischen mehrfachen Elementen können Sie @@MAX_POSITION nutzen, um „ans Ende" zu kopieren, ohne die ursprünglichen Werte zu überschreiben.

Beispiel:

Im Feed haben wir diese zwei mehrfachen Elemente:

<IMAGE>www.image1.jpg</IMAGE> …@@POSITION = 1 <IMAGE>www.image2.jpg</IMAGE> …@@POSITION = 2 <IMAGE>www.image3.jpg</IMAGE> …@@POSITION = 3

<CONTEXT_IMAGE>www.context_image1.jpg</CONTEXT_IMAGE> …@@POSITION = 1 <CONTEXT_IMAGE>www.context_image2.jpg</CONTEXT_IMAGE> …@@POSITION = 2

Sie möchten alle CONTEXT_IMAGE in IMAGE kopieren, ohne dass die ursprünglichen Bilder überschrieben werden.

• Verwenden Sie die Regel Bulk Copy Values
• Geben Sie im Feld Quellelement ein: CONTEXT_IMAGE
• Geben Sie im Feld Zielelement ein: IMAGE {@@POSITION = @@MAX_POSITION + 1}

Ergebnis:

<IMAGE>www.image1.jpg</IMAGE> <IMAGE>www.image2.jpg</IMAGE> <IMAGE>www.image3.jpg</IMAGE> <IMAGE>www.context_image1.jpg</IMAGE> <IMAGE>www.context_image2.jpg</IMAGE>

Welches Attribut wann verwenden#

Regeln für die Wahl:

1. Bei einfachen Elementen müssen Sie die Position nicht angeben – sie ist immer gleich 1.
2. Bei mehrfachen Elementen ohne Kinder können Sie @@POSITION oder @@VALUE verwenden.
3. Bei verschachtelten Strukturen (z. B. Parametern) ist es am sichersten, eine Bedingung mit dem Namen des verschachtelten Elements zu verwenden, z. B. PARAM_NAME = "Farbe".

Indexierung (#)#

Neben speziellen Attributen ermöglicht Element-Path auch die Indexierung, die mit dem Zeichen # geschrieben wird. Indexierung = Vorkommen eines Elements. Während @@POSITION mit der Reihenfolge der Werte innerhalb eines mehrfachen Elements arbeitet (z. B. 3. Bild in IMAGE), ermöglicht die Indexierung mit # die Auswahl eines konkreten wiederholten Vorkommens desselben Elements (z. B. des zweiten Parameters „Farbe"), auch wenn sich seine Reihenfolge zwischen Produkten unterscheidet. Die Indexierung erweitert die Möglichkeiten des Zielens dort, wo @@POSITION nicht ausreicht.

Die Indexierung sollten Sie nur in Fällen verwenden, in denen der Elementpfad mehr als einen Wert zurückgibt und das spezielle Attribut @@POSITION nicht nutzbar ist, weil sich die Werte bei den einzelnen Produkten auf unterschiedlichen Positionen befinden.

Die Verwendung der Indexierung als Ersatz für @@POSITION in Situationen, in denen das nicht nötig ist, ist ungeeignet und kann zu einer Leistungsminderung führen.

Wie Sie die Indexierung Schritt für Schritt verwenden#

1. Machen Sie sich klar, auf welches Vorkommen Sie zielen möchten (1., 2., 3., …) und woran Sie es erkennen (z. B. Parameter mit dem Namen „Farbe").
2. Öffnen Sie die Stelle, an der Sie mit Daten arbeiten – die Indexierung lässt sich in Auswahlen und Regeln, in Feldern für Element-Path sowie in MQL (Mergado Query Language) verwenden.
3. Ergänzen Sie die Indexierung im Pfad mit # in der Form: <element> #{ Reihenfolge }
4. Speichern und wenden Sie an – die Regel oder Auswahl. Mergado arbeitet dann nur mit dem festgelegten Vorkommen.

• Syntax: PARAM { NAME = "Farbe" } #{ 2 } | VALUE
• Bedeutung: Zielt auf das zweite Vorkommen des Elements PARAM | VALUE mit dem Parameternamen „Farbe".
• Verwendung: Die Indexierung eignet sich besonders bei bedingten Elementen, bei denen sich @@POSITION nicht verwenden lässt.
• Empfehlung: Funktioniert das gewöhnliche Zielen nach Position, ist @@POSITION schneller und übersichtlicher.

Beispiel:

Im Feed haben wir 2 Produkte mit dem Parameter Farbe. Beide Produkte haben den Parameter Farbe 2× mit unterschiedlichen Werten, auf unterschiedlichen Positionen.

Produkt A

`<g:product_detail>`
	`<g:attribute_name>`Farbe`</g:attribute_name>`
	`<g:attribute_value>`Weiß`</g:attribute_value>`
`</g:product_detail>`
`<g:product_detail>`
	`<g:attribute_name>`Farbe`</g:attribute_name>`
	`<g:attribute_value>`Schwarz`</g:attribute_value>`
`</g:product_detail>`
`<g:product_detail>`
	`<g:attribute_name>`Material`</g:attribute_name>`
	`<g:attribute_value>`Keramik`</g:attribute_value>`
`</g:product_detail>`

Produkt B

`<g:product_detail>`
	`<g:attribute_name>`Farbe`</g:attribute_name>`
	`<g:attribute_value>`Grün`</g:attribute_value>`
`</g:product_detail>`
`<g:product_detail>`
	`<g:attribute_name>`Material`</g:attribute_name>`
	`<g:attribute_value>`Keramik`</g:attribute_value>`
`</g:product_detail>`
`<g:product_detail>`
	`<g:attribute_name>`Farbe`</g:attribute_name>`
	`<g:attribute_value>`Rot`</g:attribute_value>`
`</g:product_detail>`

Möchten wir genau auf den zweiten Wert des Parameters Farbe bei jedem Produkt zielen, können wir das spezielle Attribut @@POSITION nicht verwenden, weil sich die Werte auf unterschiedlichen Positionen befinden. Hier hilft uns genau die Indexierung.

Korrekte Schreibweise des Pfads mit Indexierung:

• g:product_detail { g:attribute_name = "Farbe" } #{ 2 } | g:attribute_value

Tipps zur Indexierung#

• Wo verwenden: in Auswahlen und Regeln (Element-Path, gegebenenfalls auch MQL).
• Wann einsetzen: wenn Sie auf ein konkretes Vorkommen desselben Elements zielen müssen (z. B. „zweite Farbe") und @@POSITION nicht ausreicht.
• Beim Zusammenführen: die Indexierung gibt Ihnen die Kontrolle darüber, aus welchem Vorkommen Sie den resultierenden Wert zusammensetzen.
• Wenn es nicht nötig ist: genügt Ihnen eine feste Reihenfolge der Werte, ist es einfacher und schneller, @@POSITION zu verwenden.

Praktische Beispiele für die Verwendung spezieller Attribute#

1. Zielen auf einen Positionsbereich mit @@POSITION#

Pfad für alternative Bilder von Position 3 bis 8:

• IMGURL_ALTERNATIVE { @@POSITION >= 3 AND @@POSITION <= 8 }

2. Kombination von Position und Wert zum Zielen auf Varianten#

Pfad für den Parameter „Größe" bei der zweiten Variante:

• VARIANTS | VARIANT { @@POSITION = 2 } | PARAMETERS | PARAMETER { NAME = “Größe” } | VALUE

3. Zielen auf ein Attribut mithilfe des Elementwerts @@VALUE#

Pfad für das Attribut @value bei Parametern mit dem Wert „Farbe":

• PARAM { @@VALUE = “Farbe” } | @value

In diesem Fall ersetzt @@VALUE das Element PARAM_NAME zum Zielen auf den Wert „Farbe".

4. Zielen auf alle Werte außer einem#

Pfad für Kategorien außer „Kinderspielplätze":

• CATEGORIES | CATEGORY { @@VALUE NOT CONTAINS “Kinderspielplätze” }

5. Indexierung in Auswahlen – Bedingung auf ein konkretes Vorkommen#

Sie möchten Produkte auswählen, bei denen der Parameter „Größe" ein zweites Vorkommen hat und sein Wert „XL" ist.

Beispiel für eine Bedingung (Element-Path):

• PARAM { NAME = “Größe” } #{ 2 } | VAL = “XL”

Diese Schreibweise stellt sicher, dass Sie genau das zweite Vorkommen des Parameters „Größe" auswerten, nicht einen beliebigen Wert „XL" in den Parametern.

Zusammenfassung#

Spezielle Attribute erweitern die Möglichkeiten des Zielens in Element-Path und ermöglichen die Arbeit mit mehrfachen Elementen auf Ebene einzelner Werte. @@POSITION und @@MAX_POSITION zielen nach Reihenfolge, @@VALUE nach Inhalt, und die Indexierung # ermöglicht die Adressierung konkreter Vorkommen.

Ihre richtige Verwendung stellt sicher, dass Sie in Mergado auf exakte Daten zielen und Anpassungen sicher und kontrolliert vornehmen, auch bei komplexen Feeds.

FAQ#

Was sind spezielle Attribute und warum gibt es sie?#

Spezielle Attribute sind ein erweiterndes Werkzeug der Sprache Element-Path, das präzises Zielen bei mehrfachen Elementen ermöglicht. Sie helfen, einzelne Werte nach ihrer Reihenfolge oder ihrem Inhalt zu unterscheiden, und werden innerhalb von Bedingungen verwendet (in geschweiften Klammern { }). Jedes spezielle Attribut:

• beginnt mit zwei Klammeraffen @@,
• bezieht sich auf ein konkretes Element,
• erweitert die Möglichkeiten des Zielens und Filterns,
• wird nie in den Feed exportiert (im Unterschied zu normalen XML-Attributen).

Aktuell unterstützt Mergado diese wichtigsten speziellen Attribute:

• @@POSITION – Zielen nach Reihenfolge,
• @@MAX_POSITION – Zielen nach der höchsten existierenden Position,
• @@VALUE – Zielen nach dem Inhalt des Werts.

Was ist der Unterschied zwischen speziellen und normalen XML-Attributen?#

Normale XML-Attribute werden in den Ausgabefeed exportiert, während spezielle Attribute nur für die interne Logik von Mergado bei der Arbeit mit Regeln, Auswahlen oder Variablen existieren.

Was macht das Attribut @@POSITION und wann verwende ich es?#

@@POSITION zielt auf die Reihenfolge des Werts des Elements, auf das es sich bezieht. Jeder Wert im Feed hat seine Position (1, 2, 3 …), die bestimmt, in welcher Reihenfolge er sich innerhalb des mehrfachen Elements befindet. Verwendung:

• Geeignet bei mehrfachen Elementen mit fester Reihenfolge (z. B. Bilder, Varianten).
• Bei einfachen Elementen (mit nur einem Wert) nicht nötig – ihre Position ist immer 1.

Beispiel:

• IMGURL_ALTERNATIVE { @@POSITION = 3 }

Diese Schreibweise sagt: „Ich arbeite mit dem dritten Wert des Elements IMGURL_ALTERNATIVE."

Was ist die Schwäche von @@POSITION?#

@@POSITION arbeitet nicht mit dem Inhalt des Werts, nur mit seiner Reihenfolge. Unterscheidet sich die Reihenfolge der Werte zwischen Produkten, kann es zu einer falschen Zuordnung kommen. Beispiel für das Problem:

• Bei einem Produkt ist Position 2 = „Volumen",
• bei einem anderen Produkt ist Position 2 = „Dekor".

Der Pfad PARAM { @@POSITION = 2 } | VAL wählt beim zweiten Produkt dann den falschen Wert aus.

Lösung: Verwenden Sie stattdessen das Zielen nach dem Namen des Kinds, z. B.

• PARAM { PARAM_NAME = "Volumen" } | VAL

Was macht das Attribut @@VALUE und wann verwende ich es?#

@@VALUE stellt den Inhalt des Werts eines Elements dar. Es wird zum Filtern nach Wert statt nach Reihenfolge verwendet. Geeignete Verwendung:

• bei Elementen, die keine Kinder haben (z. B. CATEGORY, IMGURL_ALTERNATIVE),
• bei mehrfachen Elementen mit sich ändernder Reihenfolge der Werte,
• dort, wo Sie nach Inhalt zielen möchten, nicht nach Position.

Beispiel:

• CATEGORY { @@VALUE != "Spielzeug" }

Diese Schreibweise wählt alle Werte des Elements CATEGORY außer „Spielzeug" aus. Im Vergleich zu @@POSITION ist diese Methode zuverlässiger, weil sie unabhängig von einer Änderung der Reihenfolge funktioniert.

6. Wie wähle ich zwischen @@POSITION, @@VALUE und einer Bedingung mit Kind

Empfehlung:

• Bei einfachen Elementen geben Sie die Position nicht an.
• Bei mehrfachen Elementen ohne Kinder können Sie beide Ansätze verwenden (@@POSITION und @@VALUE).
• Bei verschachtelten Strukturen bevorzugen Sie immer das Zielen über den Namen des Kinds (z. B. PARAM_NAME).

Was ist die Indexierung # und wie unterscheidet sie sich von @@POSITION?#

Die Indexierung ist ein ergänzendes Werkzeug der Sprache Element-Path, das es ermöglicht, ein konkretes Vorkommen eines Elements unabhängig von seiner Reihenfolge genau festzulegen. Sie wird mit dem Zeichen # geschrieben.

Die Indexierung lässt sich nicht nur in Element-Path-Pfaden verwenden, sondern auch in Filtern und Bedingungen in Auswahlen mittels MQL (Mergado Query Language). Das Prinzip bleibt gleich – Sie wählen ein konkretes Vorkommen eines sich wiederholenden Elements aus.

Syntax: PARAM { NAME = "Farbe" } #{ 2 }

Diese Schreibweise zielt auf das zweite Vorkommen des Elements PARAM mit dem Namen „Farbe". Möglichkeiten:

• Sie können einen Positionsbereich angeben: { 1 – 4 },
• geeignet bei bedingten Elementen, bei denen sich @@POSITION nicht verwenden lässt.

Hinweis: Genügt das gewöhnliche Zielen nach Position, ist @@POSITION schneller und übersichtlicher.

Wie kombiniere ich @@POSITION und @@VALUE in einem Pfad?#

Spezielle Attribute lassen sich innerhalb einer Bedingung oder mit weiteren Filtern über logische Operatoren kombinieren. Beispiel 1 – Zielen auf einen Positionsbereich: IMGURL_ALTERNATIVE { @@POSITION >= 3 AND @@POSITION <= 8 }

• Zielt auf alternative Bilder von der 3. bis zur 8. Position.

Beispiel 2 – Kombination mit weiteren Elementen: VARIANTS | VARIANT { @@POSITION = 2 } | PARAMETERS | PARAMETER { NAME = "Größe" } | VALUE

• Wählt den Parameter „Größe" bei der zweiten Variante aus.

Beispiel 3 – Zielen nach Wert: CATEGORIES | CATEGORY { @@VALUE NOT CONTAINS "Kinderspielplätze" }

• Wählt alle Kategorien außer denen aus, die „Kinderspielplätze" enthalten.

Kann ich mit speziellen Attributen auch auf Attribute von Elementen zielen?#

Ja. Spezielle Attribute lassen sich auch in Kombination mit normalen XML-Attributen verwenden. Zum Beispiel: PARAM { @@VALUE = "Farbe" } | @value

Diese Schreibweise zielt auf das Attribut @value bei Parametern, deren Wert „Farbe" ist. Hier ersetzt @@VALUE die Notwendigkeit, das Element PARAM_NAME zu verwenden.

Was sind die häufigsten Fehler bei der Arbeit mit speziellen Attributen?#

• Verwendung von @@POSITION bei Elementen, bei denen sich die Reihenfolge zwischen Produkten unterscheidet.
• Der Versuch, @@VALUE bei Elementen zu verwenden, die selbst keinen Wert tragen (z. B. PARAM).
• Verwechslung eines einzelnen Klammeraffen @ (normales XML-Attribut) mit zwei @@ (spezielles Attribut).
• Fehlerhafte Platzierung eines speziellen Attributs außerhalb einer Bedingung.

Alle Fehler macht Mergado automatisch im Editor durch farbliche Hervorhebung oder Fehlermeldung bei der Validierung bemerkbar.

Was ist der Unterschied zwischen @@POSITION und @@MAX_POSITION?#

Wann ist es sinnvoll, @@MAX_POSITION zu verwenden?#

• Beim Hinzufügen eines neuen Werts zu einem mehrfachen Element, damit kein bestehender überschrieben wird.
• Beim Kopieren von Werten von einem mehrfachen Element in ein anderes (z. B. Bilder, alternative Bilder, Kontextbilder).

Wie tausche ich das erste und letzte Vorkommen eines mehrfachen Elements?#

@@MAX_POSITION lässt sich auch zum Tausch zweier konkreter Positionen verwenden — typischerweise des ersten und letzten Vorkommens eines mehrfachen Elements. Da @@MAX_POSITION für jedes Produkt separat die höchste existierende Position zurückgibt, passt sich das Vorgehen auch an Feeds an, bei denen ein Produkt 2 Vorkommen hat und ein anderes 5.

Hat ein mehrfaches Element eine verschachtelte Struktur (zum Beispiel RELATED_FILES | RELATED_FILE mit den Unterelementen TEXT und URL), müssen Sie jedes Unterelement separat tauschen — mithilfe temporärer Hilfselemente.

Vorgehen in der Regel Rewrite:

1. Erstellen Sie ein Hilfselement für jedes Unterelement, dessen Wert Sie tauschen möchten (z. B. HELPER_TEXT, HELPER_URL).
2. Fügen Sie in der Regel Rewrite die Zeilen in dieser Reihenfolge hinzu:
   • speichern Sie den Wert der ersten Position im Hilfselement,
   • überschreiben Sie die erste Position mit dem Wert der letzten ({ @@POSITION = @@MAX_POSITION }),
   • überschreiben Sie die letzte Position ({ @@POSITION = @@MAX_POSITION }) mit dem Wert aus dem Hilfselement.
3. Wiederholen Sie dies für jedes Unterelement (TEXT und URL) separat.