Elemek a Mergadóban#

1. Mik azok az elemek#

Definíció#

Az elem a feed alapvető építőköve, amely adatot hordoz. Minden elem konkrét információt jelöl – például terméknevet, árat, kódot vagy képet. Az XML és CSV formátumban egyaránt az elem annak a helynek a jelölése, ahol az adott érték található.

Leegyszerűsítve:

• elem = „az információ neve",
• érték = „az információ tartalma".

Példa:

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

Ebben a példában:

• a <g:title> az elem,
• a „Bid long and prosper – bögre" az értéke.

Elemek különböző formátumokban#

Elem XML feedben#

XML fájlokban az elem mindaz, ami a nyitó és záró tag között található. Az elem tartalmazhat szöveget, attribútumokat vagy további elemeket (ún. beágyazás). Az XML hierarchikus formátum – ezáltal bonyolultabb adatkapcsolatokat is képes leírni.

Példa:

<PRICE_VAT>1499</PRICE_VAT>

A PRICE_VAT elem egyetlen értéket tartalmaz – az ÁFÁ-s árat.

Elem CSV feedben#

CSV fájlokban az elem egy oszlopnak felel meg a táblázatban. Az oszlop neve az elem, az oszlop cellái az értékei.

Példa:

A CSV nem tud beágyazással dolgozni (szülő-gyerek), ezért a Mergado ezt a struktúrát a szülő | gyerek írásmóddal szimulálja.

Elem a Mergado Editorban#

A Mergado Editorban minden elem egy sornak felel meg az Elemek oldalon. Az Editor a feed struktúráját faként jeleníti meg – hierarchikusan, ahol a beágyazott elemek behúzással láthatók.

Minden elem a Mergadóban lehet:

• egyszerű, ha egyetlen értéke van,
• többszörös, ha többször ismétlődik (pl. több kép, több paraméter),
• beágyazott, ha egy másik elem része,
• vagy attribútumos, ha kiegészítő információt ad az értékhez (pl. @id vagy @description).

Mire szolgálnak az elemek#

Az elemek képezik az adatok átvitelének, feldolgozásának és módosításának alapját a Mergadóban. Segítenek az adatok szervezésében, hogy lehetőség legyen:

• olvasásra, módosításra és exportálásra,
• formátumok közötti átalakításra (pl. Heureka → Google Merchant),
• rendezésre, szűrésre és kiértékelésre.

A gyakorlatban a következőknél használod:

• terméklekérdezések létrehozása,
• szabályok beállítása,
• változókkal és automatizálással való munka,
• adatok rendezése és ellenőrzése a Termékek és Elemek oldalakon.

Összefoglaló#

Az elem a feed alapvető adategysége. A Mergado egységesen kezeli, függetlenül a formátumtól – akár XML-ből, CSV-ből vagy más forrásból származik. Az elemek működésének megértése kulcsfontosságú a hatékony munkához a szabályokkal, lekérdezésekkel és exportokkal.

GYIK#

1. Mi az az elem? Az elem a feed alapvető építőköve, amely konkrét információt hordoz – például nevet, árat vagy termékkódot. Az XML és CSV formátumban egyaránt annak a helynek a jelölése, ahol az adott érték található.

2. Mi a különbség az elem és az érték között? Az elem az információ neve (pl. PRICE_VAT), míg az érték a tartalma (pl. 1499). Együtt egy párt alkotnak – név és adattartalom.

3. Hogyan néz ki egy elem XML feedben? Az XML-ben az elemet nyitó és záró tag határozza meg. Példa:

• <PRICE_VAT>1499</PRICE_VAT>

Itt a PRICE_VAT az elem, az 1499 az értéke.

4. Hogyan működik az elem CSV feedben? A CSV fájlban az elem az oszlop nevének felel meg. Az oszlop minden cellája az elem egy-egy értékét jelöli. Példa:

• PRICE_VAT → oszlop 1499, 1599, 1799 stb. értékekkel.

5. Hogyan jelöli a CSV a beágyazást, ha nem támogatja a hierarchiát? A Mergado a CSV-ben a szülő | gyerek írásmóddal szimulálja a beágyazást. Például a PARAM | VAL útvonal a PARAM elem alá beágyazott VAL elemet jelöli.

6. Hogyan jeleníti meg a Mergado Editor az elemeket? A Mergado Editorban minden elem külön sorként jelenik meg az Elemek oldalon. A beágyazott elemek vizuálisan behúzva láthatók, fastruktúrát alkotva, amely megfelel az XML feed struktúrájának. Ez vonatkozik a Termékek oldalra is az Elemek nézetben.

7. Milyen elemtípusokat különböztet meg a Mergado? A Mergado négy alaptípussal dolgozik:

• Egyszerű elemek – egyetlen értékük van.
• Többszörös elemek – több értékük lehet.
• Beágyazott elemek – egy másik elem részei.
• Attribútumos elemek – kiegészítő információt adnak az elemhez (pl. @id).

8. Mire szolgálnak az elemek a Mergadóban? Az elemek az adatokkal való munka alapjai – adatok olvasására, módosítására, szűrésére, exportálására és átalakítására használjuk őket. Kulcsfontosságúak a szabályoknál, lekérdezéseknél, változóknál és automatizálásnál.

9. Azonosak az elemek minden formátumban? Igen. A Mergado egységesen kezeli őket – függetlenül attól, hogy XML-ből, CSV-ből vagy más formátumból származnak.

10. Miért fontos megérteni az elemeket? Mert a Mergadóban szinte minden munka (lekérdezések, szabályok, számítások, exportok) elemeken alapul. Az elemek megértése a kulcs az adatok módosításának és feldolgozásának pontos irányításához.

2. Az elemek alapjai#

Elemtípusok#

A Mergado négy alapvető elemtípust különböztet meg. Mindegyiknek sajátos viselkedése és felhasználási lehetőségei vannak.

1. Egyszerű elemek#

• Egyetlen értékük van.
• Pozíciójuk (@@POSITION) mindig 1-gyel egyenlő.
• Használatukkor nem szükséges pozíciót megadni.

Példa:

<ITEM_ID>47</ITEM_ID>

Az ITEM_ID útvonal ugyanarra az értékre mutat, mint az ITEM_ID { @@POSITION = 1 }.

2. Többszörös elemek#

• Több azonos típusú értéket tartalmaznak.
• Minden értéknek saját pozíciója van (1, 2, 3 …).
• Konkrét érték célzásához feltételeket vagy a @@POSITION és @@VALUE attribútumokat használjuk.

Példa:

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

Az IMAGE elem két értékkel rendelkezik – az 1. és 2. pozíción.

A többszörösség leggyakrabban képeknél, szállítási módoknál, paramétereknél vagy kategóriáknál fordul elő.

3. Beágyazott elemek#

• Egy másik elem (ún. szülő) belsejében találhatók.
• Hierarchikus adatstruktúrát alkotnak.
• A Mergadóban a beágyazás behúzással jelenik meg, az elem útvonalában pedig függőleges vonallal |.

Példa:

<PARAM> <PARAM_NAME>Szín</PARAM_NAME> <VAL>Fekete</VAL> </PARAM>

Az értékhez vezető útvonal:

• PARAM | VAL

Ez az írásmód jelzi, hogy a VAL érték a PARAM elemen belül található.

4. Attribútumos elemek#

• Az attribútum kiegészítő információ, amely az elem jelentését bővíti.
• Az XML-ben a nyitó tagben szerepel, és a @ jellel jelöljük.
• A Mergadóban az attribútumok szokásos módon használhatók, a @ jelű útvonallal.

Példa:

<IMAGE description=“Téli dzseki”>kep.jpg</IMAGE>

Az attribútumhoz vezető útvonal:

• IMAGE | @description

Az elemek megjelenítése a Mergado Editorban#

Az Elemek oldal#

Az Elemek oldalon megtalálod a projekt összes elemének teljes áttekintését. Itt az elemeket:

• megjelenítheted és elrejtheted (a kimeneti feed számára),
• hozzáadhatod, törölheted vagy átnevezheted (felhasználói elemeknél),
• rendezheted név vagy struktúra szerint,
• megtekintheted a bemeneti és kimeneti értékeiket.

Az elem nevére kattintva megnyílik az összes értékének részletes áttekintése.

A Termékek oldal#

A Termékek oldalon az elemek két módon jeleníthetők meg:

• „Elemek" nézet – egy adott termék összes elemét és értékeit jeleníti meg.
• „Táblázat" nézet – lehetővé teszi konkrét elemek kiválasztását és áttekinthető táblázatban való megjelenítését.

Az Elem útvonal (Element-Path) eszköz#

Az Elemek oldalon és a szabályokban elérhető az Elem útvonal eszköz, amely segít a helyes útvonal megírásában és érvényességének ellenőrzésében. Megmutatja, hova vezet pontosan az útvonal, és megkönnyíti a munkát a szabályokkal és lekérdezésekkel.

Összefoglaló#

Az elemek az alapvető egységek, amelyekkel a Mergado dolgozik. Funkciójuk szerint különböztetjük meg őket (egyszerű, többszörös, beágyazott, attribútumos), és megértésük a kulcs a hatékony munkához a szabályokkal, lekérdezésekkel és a feed struktúrájával.

GYIK#

1. Milyen elemtípusok léteznek a Mergadóban? Négy alaptípus létezik:

• Egyszerű – egyetlen értékük van.
• Többszörös – több értéket tartalmaznak.
• Beágyazott – egy másik elemen belül találhatók.
• Attribútumos – kiegészítő információt adnak az értékhez.

2. Mit jelent az elem pozíciója? Minden elemérték rendelkezik pozícióval (pl. első, második, harmadik érték). Egyszerű elemeknél a pozíció mindig 1, többszörös elemeknél magasabb is lehet.

3. Hogyan dolgozzunk a többszörös elemekkel? A többszörös elemek (pl. IMAGE) több értékkel rendelkezhetnek. Velük feltételek vagy speciális attribútumok segítségével dolgozunk: @@POSITION (pozíció szerinti célzás) és @@VALUE (tartalom szerinti célzás).

4. Hogyan ismerjük fel a beágyazott elemet? A beágyazott elem egy másik elem (ún. szülő) belsejében található. Az elem útvonalában függőleges vonallal jelöljük, pl. PARAM | VAL.

5. Hogyan írjuk le az elemek attribútumait? Az attribútumokat a @ jellel jelöljük. Példa:

• <IMAGE description=“Téli dzseki”>kep.jpg</IMAGE>

A Mergadóban ennek az attribútumnak az útvonala IMAGE | @description.

Egyes feedformátumoknál (pl. ceneo) az attribútumok a burkoló elemnél is megtalálhatók.

• <o id=“123” price=“100” avail=“1”> <name>Terméknév</name> … </o>

Ebben az esetben a Mergadóban az attribútum útvonala @id, @price, @avail. Ha új attribútumot akarsz létrehozni a burkoló elemhez, azt az Elemek oldalon új sorban add hozzá – ne a meglévő elem + ikonjával.

6. Hol találom meg az elemeket a Mergadóban? Az Elemek oldalon, a projekt bal oldali menüjében. Itt az elemeket megjelenítheted, elrejtheted, hozzáadhatod vagy rendezheted struktúra szerint.

7. Hogyan jelenítsem meg egy elem értékeit? Az elem nevére kattintva az Elemek oldalon megnyílik az összes értékének áttekintése – bemeneti és kimeneti egyaránt.

8. Hogyan jelennek meg az elemek a Termékek oldalon? A Termékek oldalon választhatsz:

• Elemek nézet – egy adott termék összes eleme és értéke,
• Táblázat nézet – áttekinthető kilistázás a kiválasztott elemekről táblázatban.

9. Mi az Elem útvonal (Element-Path) eszköz?

Az Element-Path, azaz az Elem útvonal a Mergado által fejlesztett nyelv, amely az elemekhez és értékeikhez vezető útvonalak leírására szolgál. Az Element-Path segítségével meghatározod, a feed mely értékeit akarod célozni – olvasni vagy írni.

A Mergado Editor az elemekkel ugyanúgy dolgozik, mint az XML feed – fastruktúrában. Ahhoz, hogy ebben a struktúrában pontosan meghatározhasd, milyen adatokkal akarsz dolgozni, ismerned kell az útvonalat. Éppen ezt teszi lehetővé az Element-Path.

10. Mi a különbség az egyszerű és a többszörös elem között? Az egyszerű elem minden terméknél egyetlen értékkel rendelkezik (pl. ITEM_ID). A többszörös elemnek egy terméknél több értéke is lehet (pl. több IMAGE tag) – ezekkel az Element-Path segítségével egyenként is dolgozhatsz.

3. Elemek beágyazása#

Mi az a beágyazás#

A beágyazás (vagy befészkelés) az elem olyan tulajdonsága, amely meghatározza az XML feed hierarchiájában elfoglalt helyét. Egy elem beágyazottnak minősül, ha az XML-ben egy másik elem nyitó és záró tagja között található. A beágyazás struktúrát teremt, amely segíti az áttekinthetőséget és az adatok logikai kapcsolatait.

Ennek az elvnek gyakorlati jelentősége van – az egymásba ágyazott elemek általában összefüggenek és egy egészet alkotnak. Ilyen struktúrával találkozol például a termékparamétereknél, kategóriáknál vagy szállítási opcióknál.

Példa:

<PARAM> <PARAM_NAME>Szín</PARAM_NAME> <VAL>Fekete</VAL> </PARAM>

Ebben az esetben:

• a PARAM_NAME a paraméter neve,
• a VAL az értéke,
• a PARAM a fölérendelt elem, amely mindkettőt összefogja.

Ennek a struktúrának köszönhetően a Mergado felismeri, hogy a „Fekete" érték a „Szín" paraméterhez tartozik.

Szülők, gyerekek és testvérek#

A beágyazott elemek között az XML fastruktúrájának megfelelő kapcsolatok jönnek létre:

Példa a kapcsolatokra:

PARAM | PARAM_NAME PARAM | VAL

• A PARAM a szülő.
• A PARAM_NAME és VAL a gyerekei.
• A PARAM_NAME és VAL egymás testvérei.

A Mergado Editorban ez a kapcsolat vizuálisan behúzásként jelenik meg – a gyerekek az Elemek és Termékek oldalakon mindig jobbra tolva láthatók a szülőhöz képest.

A Mergado és a beágyazott struktúra#

A Mergado Editor átveszi és megjeleníti az XML feed struktúráját a természetes fastruktúrában. Minden elem megőrzi a szülőjéről és gyerekeiről szóló információt, ami lehetővé teszi:

• pontos megkülönböztetést, mely értékek tartoznak össze,
• konkrét érték pontos célzását (pl. PARAM | VAL),
• új beágyazott elemek létrehozását és kezelését közvetlenül az Editor felületén.

Az Elemek oldalon új beágyazott elemet a szülő elem + ikonjára kattintva adhatsz hozzá. Az így létrehozott elem üres, és szabállyal (pl. Átírás) töltheted fel értékkel.

A jobb orientáció érdekében a struktúrát mappákhoz és fájlokhoz hasonlíthatod:

• a szülő elem a mappa,
• a gyerek a fájl vagy almappa benne.

Például a PARAM | VAL útvonal azt jelenti, hogy a VAL érték a PARAM elemen belül található.

CSV és beágyazás#

A beágyazás az XML és JSON formátumok természetes tulajdonsága, de a CSV formátum nem tudja natívan kifejezni. Ezért a Mergado a CSV-ben a beágyazást a szülő | gyerek írásmóddal szimulálja, hogy az adatokkal ugyanúgy lehessen dolgozni, mint XML-ben.

A gyakorlatban ez azt jelenti, hogy a CSV fájlban minden oszlop egy elem útvonalat jelöl. Például:

PARAM | PARAM_NAME PARAM | VAL

Ez az írásmód kifejezi, hogy a VAL elem a PARAM elem alá van beágyazva. Így a Mergado képes fenntartani az adatok logikai kapcsolatait még olyan formátumoknál is, amelyek önmagukban nem támogatják a beágyazást.

Munka a beágyazással a Mergado Editorban#

1. Beágyazott elem útvonalának leírása#

Amikor egy szabályban vagy lekérdezésben beágyazott elemmel akarsz dolgozni, az útvonalat a függőleges vonal | segítségével írod le.

Példa:

• PARAM | VAL

Ez az írásmód azt jelenti: „Keresd meg a PARAM elemet, és benne a VAL gyereket." A szóközöket a függőleges vonal előtt és után be kell tartani.

• Helyes: PARAM | VAL
• Helytelen: PARAM|VAL

2. Pontos célzás feltétellel#

Ha a PARAM elemnek több értéke van (pl. több paraméter), érdemes feltételt megadni a pontosabb célzáshoz. A feltételeket kapcsos zárójelekben { } írjuk, és az adott kritérium szerint szűrik az értékeket.

Példa:

• PARAM { PARAM_NAME = “Kijelzőtípus” } | VAL

Ez az írásmód azt jelenti: „Keresd meg a PARAM elemet, amelynek PARAM_NAME gyerekének értéke Kijelzőtípus, és módosítsd a VAL értékét." Így pontosan a kívánt paramétert célzod, függetlenül a feedbeli pozíciójától.

Különbség az XML és CSV beágyazás-kezelése között#

Míg az XML a beágyazást jelölőkkel és egymásba ágyazott tagekkel fejezi ki, a CSV az elválasztójeles | útvonal-írásmódot használja. A Mergado mindkét struktúrát egységesíti, és lehetővé teszi az azonos módon történő munkát.

Összefoglaló#

A beágyazás a Mergado Editorban való adatfeldolgozás alapelve. Lehetővé teszi annak felismerését, hogyan függenek össze az egyes elemek értékei, és ezáltal pontosan célozhatók a szabályok és lekérdezések.

A beágyazás helyes megértése a kulcs a hatékony munkához a paraméterekkel, szállítási opciókkal, variánsokkal és más többszörös struktúrákkal. Akár XML, akár CSV feedel dolgozol, a Mergado képes megjeleníteni, fenntartani és felhasználni a beágyazást minden típusú módosításnál.

GYIK#

1. Mi az elem beágyazása? A beágyazás az elem olyan tulajdonsága, amely meghatározza, hogy egy másik elemen belül található. Ez a kapcsolat adathierarchiát hoz létre – például a PARAM elem (szülő) tartalmazhatja a paraméterek neveit és értékeit (PARAM_NAME és VAL), amelyek a gyerekei. A beágyazott és befészkelődött kifejezések ugyanazt jelentik.

2. Mire szolgál a beágyazás? A beágyazás segít fenntartani az adatok logikus és áttekinthető struktúráját. Lehetővé teszi az értékek egyértelmű hozzárendelését a kontextusukhoz – például hogy a „Szín" paraméternek a „Fekete" az értéke. Így az összefüggő információk egyetlen struktúrába szervezhetők.

3. Milyen kapcsolatok léteznek a beágyazott struktúrában? A beágyazott elemek háromféle kapcsolatot alkotnak:

• Szülő (Parent) – az elem, amely más elemeket tartalmaz.
• Gyerek (Child) – az elem, amely egy másik elemen belül van.
• Testvérek (Siblings) – azonos szülővel rendelkező elemek.

Példa: a PARAM | VAL útvonalban a PARAM a szülő, a VAL a gyereke.

4. Hogyan néz ki egy beágyazott elem XML-ben? Az XML-ben a beágyazást egymásba ágyazott tagek fejezik ki. Példa:

<PARAM> <PARAM_NAME>Szín</PARAM_NAME> <VAL>Fekete</VAL> </PARAM>

A PARAM elem a szülő, a PARAM_NAME és VAL a gyerekei.

5. Hogyan jeleníti meg a Mergado a beágyazott elemeket? A Mergado Editor az elemeket fastruktúrában jeleníti meg, amely megfelel az XML feed struktúrájának. A beágyazott elemek balról behúzva láthatók a szülőjükhöz képest. A beágyazás a Termékek és Elemek oldalakon egyaránt látható. Új beágyazott elem a szülő elem + ikonjára kattintva hozható létre.

6. Hogyan írjuk le a beágyazást az Element-Path-ban? A beágyazást függőleges vonallal | jelöljük az elemnevek között. Példa:

PARAM | VAL

Ez az írásmód azt jelenti, hogy a VAL a PARAM elem gyereke. A szóközöket a függőleges vonal előtt és után be kell tartani.

• Helyes: PARAM | VAL
• Helytelen: PARAM|VAL

7. Hogyan fejezi ki a CSV formátum a beágyazást? A CSV formátum nem tudja natívan kifejezni a hierarchiát, ezért a Mergado a beágyazást a szülő | gyerek írásmóddal szimulálja. Például a PARAM | PARAM_NAME és PARAM | VAL ugyanazt a kapcsolatot fejezi ki, mint az XML struktúrában.

8. Mely fájltípusok tudnak beágyazással dolgozni? A beágyazással természetesen az XML és JSON formátumok dolgoznak. A CSV formátum natívan nem támogatja, de a Mergado Editor éppen a szülő | gyerek írásmóddal segíti ebben.

9. Mi a beágyazási szintek maximális száma? Nincs elméleti korlátja a beágyazás mélységének. A gyakorlatban a Mergado akár kilenc beágyazási szinttel is találkozott, például Upgates formátumú feedeknél.

10. Hogyan célozzunk pontosan egy beágyazott elem értékére? A pontos célzáshoz feltételt használunk az útvonalban. Példa:

PARAM { PARAM_NAME = "Kijelzőtípus" } | VAL

Ez az írásmód azt jelenti: „Keresd meg a PARAM elemet, amelynek PARAM_NAME gyerekének értéke Kijelzőtípus, és dolgozz a VAL elemével." Ez a legmegbízhatóbb módszer, mert a feed struktúrájában elfoglalt pozíciótól független.

11. Hogyan célozzunk, ha az elem egyszerre többszörös és beágyazott? Ha az elem többszörös (pl. a PARAM többször ismétlődik), feltételt kell használni. A PARAM | VAL útvonal feltétel nélkül minden értéket céloz, de a pontos célzást a következő írásmód biztosítja: PARAM { PARAM_NAME = "Szín" } | VAL

12. Miért biztonságosabb a gyerek szerinti célzás, mint a @@POSITION? A gyerek szerinti célzás (pl. PARAM_NAME = "Szín") biztonságosabb, mert a helyes értéket választja ki, függetlenül a listabeli pozíciójától. A @@POSITION attribútum csak a sorrendre hivatkozik, így ha a paraméterek sorrendje termékenként eltér, hibás eredményre vezethet.

13. Miért fontos a beágyazással való munka? Az összetett adatok többsége – mint a paraméterek, szállítás vagy variánsok – beágyazott. A beágyazás helyes megértése lehetővé teszi a pontos adatkezelést, megbízható szabályok létrehozását és a feed logikus struktúrájának fenntartását.

4. Elemek többszörössége#

Mit jelent a többszörös elem#

A többszörös elem olyan elem, amelynek több azonos nevű értéke létezik. A feed struktúrájának szempontjából ez azt jelenti, hogy egy terméken belül az adott elem ismétlődik – például képeknél, paramétereknél vagy variánsoknál.

A többszörösség lehetővé teszi, hogy több rokon értéket egyetlen elemnév alá vonjunk össze, és ne kelljen minden értékhez új elemet létrehozni.

A többszörös elemekkel leggyakrabban a következőknél találkozol:

• kép URL-ek (pl. IMGURL_ALTERNATIVE),
• termékparaméterek (PARAM),
• szállítás (DELIVERY),
• kategóriák,
• termékvariánsok.

Példa XML struktúrában:

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

Ebben az esetben az IMGURL_ALTERNATIVE elem többszörös, mert több értéke van.

Különbség az egyszerű és a többszörös elem között#

Beágyazott struktúráknál (pl. PARAM) a többszörösség a szülő elemre vonatkozik. A gyerekek (tipikusan PARAM_NAME és VAL) egyszerűek maradnak, mert egy szülőn belül mindig csak egyetlen értékük van.

Pozíciók a Mergadóban#

Minden elemérték rendelkezik sorszámmal, azaz pozícióval (1, 2, 3 …). A pozíció felhasználható egy konkrét érték pontos célzásához az elemen belül.

A pozíciókkal való munkához a Mergadóban a @@POSITION speciális attribútumot használjuk. Ez az Element-Path nyelv része, és meghatározza, melyik pozíciót akarod célozni.

Példa:

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

Ha a harmadik képpel akarsz dolgozni, a következő útvonalat használd:

• IMAGES | IMAGE { @@POSITION = 3 }

Ez az írásmód azt jelenti: „A 3. pozíción lévő IMAGE elemmel dolgozom."

A @@POSITION attribútum korlátai#

A @@POSITION attribútum csak a sorrendre hivatkozik, nem a tartalomra. Ha az értékek sorrendje termékenként eltér, ugyanaz a pozíció különböző információkra mutathat.

Példa:

• Az első terméknél a paraméterek: 1. Anyag, 2. Térfogat.
• A második terméknél: 1. Anyag, 2. Dekor.

A PARAM { @@POSITION = 2 } | VAL útvonal a második terméknél a Dekor-ra mutat, nem a Térfogat-ra.

Biztonságosabb ezért név szerint célozni:

• PARAM { PARAM_NAME = “Térfogat” } | VAL

Munka a többszörösséggel a Mergado Editorban#

Pozíció felderítése és használata#

1. Az Elemek oldalon nyisd meg az adott elemet, és megjelenik az összes értéke a pozíciókkal együtt.
2. A szabályokban és lekérdezésekben célozhatsz:
   • pozíció szerint, pl. IMGURL_ALTERNATIVE { @@POSITION > 1 },
   • vagy pozíciótartomány szerint, pl. IMGURL_ALTERNATIVE { @@POSITION >= 3 AND @@POSITION <= 8 }.
3. Ha inkább érték szerint akarsz dolgozni, használd a @@VALUE attribútumot, például:
   • CATEGORY { @@VALUE != "Játékok" }
4. Ez az írásmód a CATEGORY elem minden értékét kiválasztja, kivéve a „Játékok"-at.

Mikor nem szükséges pozíciót megadni#

Az útvonalban a pozíció megadása nem szükséges a következő esetekben:

1. Egyszerű elemek
   1. Mindig egyetlen értékük van, tehát pozíció = 1. Az ITEM_ID útvonal ekvivalens az ITEM_ID { @@POSITION = 1 } írásmóddal.
2. Olvasás többszörös elemből feltétel nélkül
   1. Ha szabályban olvasol egy többszörös elemből feltétel nélkül, a Mergado automatikusan az első értéket használja.
   2. Például: a %PARAM | VAL% használatakor a Mergado az első értéket veszi.
3. Minden érték célzása
   1. Ha az elem összes előfordulását fel akarod dolgozni, használd az elem nevét feltétel nélkül.
   2. Pl. az IMAGES | IMAGE útvonal minden képpel dolgozik.
   3. Íráskor tartsd szem előtt, hogy a változás az adott útvonalnak megfelelő összes értéknél végrehajtódik.

Összefoglaló#

A többszörösség lehetővé teszi több azonos típusú érték tárolását és feldolgozását egyetlen elemen belül. A pontos munkához feltételekkel vagy speciális attribútumokkal célozd a konkrét értékeket. Így biztosítod, hogy a módosítások helyesen történjenek, és ne érintsék a többi adatot.

GYIK#

1. Mi az a többszörös elem? A többszörös elem olyan elem, amelynek több azonos nevű értéke van. A gyakorlatban ez azt jelenti, hogy egy terméken belül ismétlődik – például képeknél, paramétereknél, szállításnál vagy kategóriáknál. Tipikus többszörös elemek: IMAGE, PARAM, DELIVERY vagy CATEGORY.

2. Mi a különbség az egyszerű és a többszörös elem között?

• Az egyszerű elem egyetlen értéket tartalmaz, pozíciója mindig 1.
• A többszörös elem több értékkel rendelkezhet, amelyek mindegyikének saját pozíciója van (2, 3, 4 …).

Példa: <IMAGE>url1.jpg</IMAGE> <IMAGE>url2.jpg</IMAGE>

Az IMAGE elem többszörös, mert többször fordul elő és több értéket tartalmaz.

3. Mire szolgál a többszörösség? A többszörösség lehetővé teszi, hogy több rokon értéket egyetlen elemnév alá vonjunk össze. Nem szükséges tehát minden értékhez új elemet létrehozni. Például egy termék összes alternatív képe IMGURL_ALTERNATIVE ismétlődő elemekként írható le.

4. Mely elemek tipikusan többszörösek? A többszörösség leggyakrabban a termékek ismétlődő tulajdonságait leíró elemeknél fordul elő, például:

• kép URL-ek (IMGURL_ALTERNATIVE),
• termékparaméterek (PARAM),
• szállítás (DELIVERY),
• kategóriák,
• termékvariánsok.

5. Hogyan dolgozik a Mergado az értékek pozíciójával? Minden elemértéknek van pozíciója, azaz sorszáma (1, 2, 3 …). A pozíció felhasználható egy konkrét érték pontos célzásához az elemen belül. Ehhez a @@POSITION speciális attribútumot használjuk. Példa: IMAGES | IMAGE { @@POSITION = 3 }

Ez az írásmód azt jelenti: „A 3. pozíción lévő IMAGE elemmel dolgozom."

6. Mit jelent a @@POSITION attribútum és hogyan használjuk? A @@POSITION meghatározza az érték sorrendjét a többszörös elemen belül. Feltételekben használható konkrét pozíció vagy pozíciótartomány célzásához. Példa: IMGURL_ALTERNATIVE { @@POSITION > 1 }

Ez az írásmód az első kivételével minden alternatív képet céloz. Fontos azonban tudni, hogy a @@POSITION csak a sorrenddel dolgozik, nem a tartalommal. Ha a sorrend termékenként eltér, hibás értéket célozhat.

7. Mi az a @@VALUE attribútum és mikor használjuk? A @@VALUE az elem értékének tartalmát jelöli, és lehetővé teszi az érték szerinti célzást a pozíció helyett. Elsősorban gyerek nélküli elemeknél használjuk, például CATEGORY vagy IMGURL_ALTERNATIVE. Példa: CATEGORY { @@VALUE != "Játékok" }

Ez az írásmód a „Játékok" kivételével minden kategóriát kiválaszt.

8. Hogyan célozzunk többszörös elemek értékeire az Element-Path-ban? A célzás kapcsos zárójelbe { } írt feltételekkel történik. Bennük a @@POSITION, @@VALUE attribútumokat vagy MQL nyelvi kifejezéseket használhatunk. Minden érték célzása: IMAGES | IMAGE

• Az összes értéket feldolgozza (url1, url2, url3 …).

Konkrét értékek vagy pozíciótartomány célzása: IMAGES | IMAGE { @@POSITION IN (3;4) }

• A harmadik és negyedik képet célozza.

9. Hogyan derítem ki az értékek pozícióit a Mergado Editorban? Az Elemek oldalon minden elemnél megjelenítheted az összes értéket a pozíciójukkal együtt. Ez az áttekintés segít jobban megérteni a többszörös adatok struktúráját, és megkönnyíti a szabályokban való célzást.

10. Mikor nem szükséges pozíciót megadni az útvonalban? A pozíció megadása nem szükséges a következő esetekben:

• Egyszerű elemek – mindig egyetlen értékük van (pozíció = 1). Az ITEM_ID ekvivalens az ITEM_ID { @@POSITION = 1 } írásmóddal.
• Olvasás többszörös elemből feltétel nélkül – a Mergado automatikusan az első értéket használja. Pl. a %PARAM | VAL% az első értéket veszi.
• Minden érték célzása – elég az elem nevét feltétel nélkül megadni, pl. IMAGES | IMAGE.

11. Mi a különbség a pozíció és az érték szerinti célzás között?

• A @@POSITION az érték sorrendjével dolgozik.
• A @@VALUE az érték tartalmával dolgozik.

Ha az értékek sorrendje termékenként eltér, biztonságosabb a @@VALUE használata, mert közvetlenül a tartalmat célozza.

12. Mi a @@POSITION szerinti célzás problémája? A @@POSITION csak a sorrendre hivatkozik. Ha a termékek paraméterei eltérő sorrendben vannak, az útvonal hibás értéket célozhat. Biztonságosabb a gyerek neve szerinti célzás, például: PARAM { PARAM_NAME = "Térfogat" } | VAL

13. Hogyan dolgozzunk többszörös elemekkel szabályokban és lekérdezésekben? A többszörös elemekkel való munka attól függ, hogy a szabály az elemből olvas vagy belé ír. Olvasás:

• Ha az útvonal több értékhez vezet, a Mergado az elsőt használja.
• Ha más értéket akarsz olvasni, az útvonalat feltétellel kell pontosítani.

Írás:

• Ha a szabály többszörös elembe ír, a változás az adott útvonalnak megfelelő összes értéknél végrehajtódik.
• Ha csak egy konkrét értékbe akarsz írni, az útvonalat feltétellel kell szűkíteni.
• Ha a feltétel = operátort vagy AND kötőszót tartalmaz, a Mergado automatikusan létrehozza a hiányzó struktúrát.

14. Miért fontos megkülönböztetni a többszörösséget? A többszörösség meghatározza, hogy az elem több azonos típusú értéket tartalmazhat. Ennek megértése alapvető a szabályok, lekérdezések helyes beállításához és a feedbeli adatok pontos célzásához.

5. Munka többszörös elemekkel a Mergado szabályokban#

A többszörös elemek a Mergado Editorban eltérően viselkednek, mint az egyszerű elemek. Minden termék több azonos elemértéket tartalmazhat, ezért tudni kell, hogyan dolgoznak velük a szabályok – hogyan olvassák, írják és hogyan célozzuk pontosan az értékeket.

Olvasás és írás a szabályokban#

A többszörös elem olyan, amelynek egy terméknél több mint egy értéke van. A Mergado szabályai (például Átírás, Tömeges értékmásolás, Számítás) ilyen esetben meghatározott alapértelmezett viselkedéssel rendelkeznek.

Olvasás elemekből és változókból#

Ha a szabály egy többszörös elem értékét olvassa, amelynek útvonala több értékhez vezet, a Mergado automatikusan csak az első értéket használja.

Ez a viselkedés a százalékjeles % írásmóddal történő olvasásnál érvényes (pl. %PARAM | VAL%).

Példa:

<VAL>Fekete</VAL> <VAL>XL</VAL>

Ha a szabály a PARAM | VAL útvonalról olvas, a Mergado csak az első, „Fekete" értéket veszi. Egyszerű elemeknél (pl. ITEM_ID) ez a logika nem érvényesül, mert mindig csak egyetlen érték létezik.

Írás elemekbe#

Ha a szabály további pontosítás nélkül többszörös elembe ír, a Mergado az adott elem minden előfordulásába beírja az értéket.

Példa:

• Ha az Átírás szabályban az IMGURL_ALTERNATIVE útvonalat használod és új értékként uj_kep.jpg-t adsz meg,

a Mergado az elem összes meglévő értékét átírja.

Ha csak egy konkrét értékbe akarsz írni, az útvonalat feltételekkel kell pontosítani. Például a

• PARAM { PARAM_NAME = “Szín” } | VAL

útvonal csak a „Szín" paraméterekbe ír. Ha egy terméken belül a „Szín" paraméter többször fordul elő, a módosítás ezek mindegyikénél végrehajtódik.

Feltételek és speciális attribútumok használata#

Egy többszörös elem konkrét értékének pontos célzásához feltételt kell megadni. A feltételek szűrőként működnek – meghatározzák, mely értékekre vagy pozíciókra vonatkozik a szabály. Kapcsos zárójelekbe { } írjuk őket, és tartalmazhatnak beágyazott elemet vagy speciális attribútumot.

1. Beágyazott elem használata feltételben#

Ez a módszer a legmegbízhatóbb, mert az érték tartalma alapján céloz, nem a sorrend alapján.

Példa: A VAL elem értékét akarjuk átírni, amely a „Szín" paraméterhez tartozik:

• PARAM { PARAM_NAME = “Szín” } | VAL

Ez az írásmód azt jelenti: „Keresd meg az összes PARAM elemet, amelynek PARAM_NAME gyerekének értéke Szín, és módosítsd a VAL elem értékét."

Ez a módszer független az elemek feedbeli sorrendjétől, ezért a legtöbb esetben ezt érdemes használni.

2. A @@POSITION speciális attribútum használata#

A @@POSITION attribútum az érték sorrendje szerinti célzásra szolgál. Minden elemérték rendelkezik pozícióval – első = 1, második = 2 stb.

Példa:

IMGURL_ALTERNATIVE { @@POSITION > 1 }

Ez az írásmód az első kivételével minden képet céloz.

Mikor érdemes használni: Olyan elemeknél, ahol az értékek sorrendje megfelel a jelentésüknek (pl. alternatív képek).

Gyengesége: A @@POSITION célzás csak a pozícióra hivatkozik, nem a tartalomra. Ha az értékek sorrendje termékenként eltér, az eredmény nem biztos, hogy konzisztens.

3. A @@VALUE speciális attribútum használata#

A @@VALUE attribútum az elem tényleges értékére hivatkozik, nem a sorrendjére. Ott érdemes használni, ahol a sorrend változik vagy nem lényeges.

Példa:

• CATEGORY { @@VALUE != “Játékok” }

Ez az írásmód a CATEGORY elem „Játékok" kivételével minden értékét célozza.

A @@VALUE-t elsősorban gyerek nélküli elemeknél használjuk (pl. CATEGORY, IMGURL_ALTERNATIVE). Szülő elemeknél, amelyek maguk nem hordoznak értéket (pl. PARAM), nincs értelme a használata.

Gyakorlati útvonalpéldák#

A Mergado szabályai az elemekkel való munka során (olvasás/írás) az Element-Path nyelvet használják, amely lehetővé teszi az olvasni vagy írni kívánt értékek pontos célzását.

Konkrét paraméter értékének célzása#

• PARAM { PARAM_NAME = “Szín” } | VAL

Ez az írásmód a Szín nevű paraméter VAL értékét olvassa vagy írja.

A Mergado a következőképpen értelmezi: „Keresd meg a PARAM elemet, amelynek PARAM_NAME gyerekének értéke Szín, és módosítsd a VAL gyerek értékét."

Variánsok értékének célzása#

Az útvonal több beágyazási szintet és többszörösséget is kombinálhat. Példa a második variánssal való munkára, amely „Méret" paramétert tartalmaz:

• VARIANTS | VARIANT { @@POSITION = 2 } | PARAMETERS | PARAMETER { NAME = “Méret” } | VALUE

Ez az írásmód azt jelenti: „Keresd meg a termék második variánsát, amelyben a Méret paraméter egy adott értéket hordoz, és dolgozz ezzel az értékkel."

Új értékek hozzáadása szabályokkal#

Többszörös vagy beágyazott elemekbe való írásnál egy fontos szabály érvényes: Ha a célzott elem még nem létezik, a Mergado automatikusan létrehozza.

Ez azt jelenti, hogy minden, ami a feltételben szerepel (pl. PARAM_NAME = "Szín") és az = operátorral vagy AND kötőszóval írt útvonalban, automatikusan létrejön.

Példa új strukturált érték – ún. „flag" – hozzáadására:

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

Új érték: 0

Ha a „action" kódú flag nem létezik, a Mergado létrehoz egy új FLAG-et (új pozíciót) a CODE = "action" elemmel, és hozzáadja az ACTIVE elemet 0 értékkel.

Ez a mechanizmus új variánsok, szállítási opciók, paraméterek és egyéb strukturált adatok hozzáadásakor használatos.

A többszörösséggel érintett szabályok áttekintése#

A többszörös értékek olvasási és írási viselkedése a következő szabályokra vonatkozik:

Összefoglaló#

A többszörös elemekkel való munkánál a Mergado Editor szabályaiban a legfontosabb tudni, melyik értékkel dolgozol. Pontosítás nélkül a szabály mindig az első értéket olvassa, és az összes megfelelő értékbe ír. Feltételekkel, a @@POSITION és @@VALUE speciális attribútumokkal vagy több beágyazási szint kombinálásával pontosan meghatározhatod, mit módosít a szabály.

A helyesen megírt elem útvonal biztosítja, hogy a módosítások pontosan ott történjenek, ahol kell – és biztonságosak maradjanak akkor is, ha a feed struktúrája idővel változik.

GYIK#

1. Mi a szabályok alapelve a többszörös elemek kezelésénél? A Mergado Editor szabályai a többszörös elemeket két elv alapján kezelik – értékek olvasása és értékek írása. Az egyszerű elemeknek mindig egyetlen értékük van, így a szabály közvetlenül dolgozik velük. A többszörös elemeknek azonban egy terméknél több értékük is lehet, ezért meg kell határozni, melyikkel dolgozzon a szabály. Pontosítás nélkül a szabályok az első értéket olvassák és az összes értékbe írnak.

2. Hogyan olvassa a Mergado a többszörös elemek értékeit? Ha az útvonal több értékhez vezet, a Mergado automatikusan csak az első értéket használja. Ez a viselkedés minden szabálynál érvényes, amely a % jelöléssel olvassa az elem értékét – pl. %PARAM | VAL%.

3. Hogyan ír a Mergado a többszörös elemekbe? Ha a szabály további pontosítás nélkül többszörös elembe ír, a Mergado az új értéket az összes előfordulásba (pozícióba) beírja. Ha csak egy konkrét értéket akarsz célozni, az útvonalat feltétellel kell pontosítani.

4. Miért szükséges feltételeket használni a többszörös elemeknél? A feltételek szűrőként működnek, meghatározzák, mely értékekre vonatkozik a szabály. Feltétel nélkül a szabály az elem összes értékét érintené.

5. Hogyan használjunk beágyazott elemet feltételben? A beágyazott elem szerinti célzás a legmegbízhatóbb, mert a tartalomra támaszkodik, nem a sorrendre. Példa: PARAM { PARAM_NAME = "Szín" } | VAL

6. Mikor használjuk a @@POSITION attribútumot? A @@POSITION az érték sorrendje szerinti célzásra szolgál. Példa: IMGURL_ALTERNATIVE { @@POSITION > 1 } Ott használd, ahol az értékek sorrendje megfelel a jelentésüknek. Gyengesége: csak a sorrendre hivatkozik, nem a tartalomra.

7. Mikor használjuk a @@VALUE attribútumot? A @@VALUE az elem tényleges értékére hivatkozik. Elsősorban gyerek nélküli elemeknél használjuk (pl. CATEGORY, IMGURL_ALTERNATIVE). Példa: CATEGORY { @@VALUE != "Játékok" }

8. Hogyan kombináljuk a feltételeket és speciális attribútumokat? Egyetlen útvonalban több feltétel és attribútum is kombinálható. A feltételek tartalmazhatnak logikai operátorokat (AND, OR) vagy MQL nyelvi lekérdezéseket.

9. Hogyan hoz létre a Mergado új értékeket írásnál? Ha a célzott elem nem létezik, a Mergado írásnál automatikusan létrehozza. Ez minden = operátort vagy AND kötőszót tartalmazó feltételnél érvényes.

10. Hogyan előzzük meg a hibákat a többszörös értékekkel való munkánál?

• Ellenőrizd, hogy az elem, amellyel dolgozol, valóban több értéket tartalmaz-e.
• Használj { } feltételeket a pontos célzáshoz.
• Kerüld a @@POSITION-ra való támaszkodást, ha az értékek sorrendje termékenként eltér.
• Írás előtt ellenőrizd, hogy az útvonal nem érint-e több értéket a kívántnál.
• Használd az Elem útvonal eszközt annak ellenőrzésére, hova céloz a szabály.

6. Attribútumok az elemekben#

Mik azok az attribútumok#

Az attribútum az elem része, amely pontosítja annak jelentését vagy tulajdonságát. Míg az elem hordozza az adatokat, az attribútum kiegészítő információt nyújt ezekről az adatokról. Az attribútumok tehát az elemértékek bővítményeiként működnek, és gyakran segítenek olyan részleteket leírni, amelyek egyébként nem férnének bele a struktúrába.

Attribútumok XML-ben#

Az XML-ben az attribútum mindig az elem nyitó tagjében szerepel, és saját neve és értéke van. Az attribútum értékét idézőjelbe vagy aposztrófba kell zárni.

XML írásmód példa:

<person gender=“female”> <firstname>Katalin</firstname> <lastname>Nagy</lastname> </person>

Ebben a példában

• a person az elem,
• a gender az attribútum,
• a female az attribútum értéke.

A gender attribútum tehát pontosítja a személyről szóló információt – hogy nőről van szó.

Mire szolgálnak az attribútumok#

A termékfeedekben az attribútumoknak gyakorlati jelentőségük van – lehetővé teszik a termék vagy tulajdonságai pontosabb leírását. Egyes hirdetési portálok vagy webáruház-platformok kifejezetten megkövetelik, hogy bizonyos adatok attribútumként legyenek megadva.

Attribútumok kezelése a Mergado Editorban#

A Mergado Editor teljes értékűen tud dolgozni az attribútumokkal. Az attribútumok az elemek egyik alaptípusai, és az Editor teljes környezetében használhatók – szabályokban, lekérdezésekben, változókban és MQL lekérdezésekben.

Attribútumok azonosítása#

A Mergadóban az attribútumokat a név elején álló @ jelről ismered fel.

• @id – azonosító attribútum,
• @description – a képet leíró attribútum,
• @availability – állapotot vagy elérhetőséget leíró attribútum.

A szokásos attribútumokon kívül léteznek speciális attribútumok is, amelyek két @-tel @@ kezdődnek. Ezek az Element-Path nyelvben használatosak, és pontos célzásra szolgálnak – tipikusan @@POSITION (érték pozíciója) és @@VALUE (elem értéke).

Attribútumok célzása Element-Path-szal#

Az attribútumokkal való munkához az Element-Path nyelvet használjuk. Az attribútumhoz vezető útvonalat a @ jellel írjuk az attribútum neve elé.

Attribútum létrehozása#

Az attribútumot közvetlenül az Elemek oldalon hozhatod létre.

1. Nyisd meg az Elemek oldalt, és válaszd az Új elem lehetőséget.
2. Add meg a nevet, és válaszd az attribútum típust.
3. Ha a névbe @ jelet írsz, az Editor automatikusan felismeri, hogy attribútumot akarsz létrehozni.
4. Ha beágyazott attribútumot akarsz létrehozni, használd a szülő elem + ikonját, és válaszd az attribútum típust.

Létrehozás után az attribútum üres (nincsenek értékei). Az Átírás szabállyal töltheted fel értékkel.

Attribútum értékének átírása#

Az attribútumokat ugyanúgy módosíthatod, mint a szokásos elemeket – pl. az Átírás szabállyal.

Attribútum törlése#

Az attribútumokat kétféleképpen törölheted:

1. Manuálisan – az Elemek oldalon a kézzel létrehozott attribútumok a kuka ikonnal törölhetők.
2. Szabályokkal – a bemeneti vagy kimeneti formátumból származó attribútumoknál csak az értékek törölhetők, szabállyal (pl. Átírás üres értékkel).

A célformátum által definiált (ún. rendszer-) attribútumokat nem lehet átnevezni vagy törölni, mert a kimeneti feed specifikációjának részei.

Összefoglaló#

Az attribútumok kiegészítik az elemek jelentését, és lehetővé teszik a feed adatainak részletesebb leírását. A Mergado Editorban ugyanúgy dolgozhatsz velük, mint a szokásos elemekkel – létrehozhatod, módosíthatod és célozhatod őket szabályokban.

Az attribútumokkal való helyes munka különösen fontos a pontos adatstruktúrát megkövetelő portálokra irányuló feedeknél, mint a Google, Heureka, Ceneo vagy Shoptet.

7. Az Element-Path nyelv#

Mi az Element-Path#

Az Element-Path a Mergado által fejlesztett nyelv, amely az elemekhez és értékeikhez vezető útvonalak leírására szolgál. Az Element-Path segítségével meghatározod, a feed mely értékeit akarod célozni – olvasni vagy írni.

A Mergado Editor az elemekkel ugyanúgy dolgozik, mint az XML feed – fastruktúrában. Ahhoz, hogy ebben a struktúrában pontosan meghatározhasd, milyen adatokkal akarsz dolgozni, ismerned kell az útvonalat. Éppen ezt teszi lehetővé az Element-Path.

Mit jelent az „elem útvonal"#

Az elem útvonal olyan leírás, amely kifejezi, hol található az adatstruktúrában az az érték (vagy értékek), amellyel dolgozni akarsz. Ezzel az útvonallal közlöd a Mergadóval, hogy:

1. az értéket olvasni akarod – tehát bemenetként használni (pl. szabályban vagy lekérdezésben), vagy
2. az értéket módosítani akarod – tehát új adatokat írni belé.

Az Element-Path szintaxisa tartalmazza az elemneveket, a függőleges vonalat | a beágyazás jelölésére, a { } feltételeket, a @@ speciális attribútumokat és az MQL nyelv lehetőségeit.

Segítség az útvonalak írásakor#

A Mergado Editorban az Element-Path-szal való munka több funkcióval is megkönnyített:

• Automatikus kiegészítés: az Editor felajánlja az elérhető elemeket, operátorokat és értékeket.
• Validáció: Ha a beírt elem nem létezik a projektben, pirosra színeződik; érvényes útvonal zölddel jelenik meg.
• Szállítók és paraméterek kiegészítése: Bizonyos feedtípusoknál az Editor konkrét neveket ajánl (pl. szállítók, paraméterek), és automatikusan kiegészíti a teljes útvonalat.

Hol használjuk az Element-Path-ot#

Az elem útvonalakat a Mergado Editor szinte minden részében használjuk – mindenhol, ahol meg kell határozni, milyen adatokkal dolgozunk.

• Szabályokban – pl. Átírás, Keresés és csere, Tömeges értékmásolás, Számítás.
• Lekérdezésekben – terméklekérdezések létrehozásakor vagy saját MQL lekérdezés írásakor.
• Változókban – konkrét elemek értékeinek olvasásához és beírásához.
• Importoknál – az importfájlok elemeiben, amelyeket az Adatfájl importálása szabály dolgoz fel.
• A Termékek oldalon – rendezéshez, szűréshez és az elemértékek áttekintéséhez.
• Automatizálásban – szabályok és feltételek beállításánál automatikus akciókhoz.

Összefoglaló#

Az Element-Path az alapvető nyelv a Mergado Editorban való adatkezeléshez. Segítségével pontosan meghatározhatod, honnan származnak az értékek, hova kell beírni őket, és milyen kontextusban találhatók.

Az Element-Path struktúrájának és szintaxisának helyes megértése lehetővé teszi, hogy biztonságos szabályokat, hatékony lekérdezéseket és automatizálásokat hozz létre, amelyek megbízhatóan működnek összetett XML és CSV feedekkel is.

8. Feltételek az elem útvonalában#

Mik azok a feltételek#

Az elem útvonalban a feltételek szűrőként működnek, amelyek lehetővé teszik, hogy csak a kiválasztott értékeket célozd, és ezáltal pontosítsd az adatokkal való munkát. Az Element-Path nyelv szerves részei, és elsősorban többszörös és beágyazott elemeknél használatosak.

A feltételek mindig a tőlük balra álló elemhez kötődnek, és csak annak beágyazott gyerekeit szűrhetik.

Feltételek szintaxisa#

A feltételeket kapcsos zárójelekbe { } írjuk, amelyek a megfelelő elemhez kötődnek.

Alap írásmód sablon:

Elem { Gyerek Operátor Érték } | Következő_gyerek

Példa:

• PARAM { PARAM_NAME = “Szín” } | VAL

Ez az útvonal azt jelenti: „Keresd meg a PARAM elemet, amelynek PARAM_NAME gyerekének értéke Szín, és benne célozd a beágyazott VAL elemet."

Írási szabályok#

• A szóközök fontosak – nem hagyhatók el. Ez érvényes a feltételen belül és a feltétel előtt és után is.
• A feltételek tartalmazhatnak tetszőlegesen összetett kifejezéseket, beleértve az AND, OR, NOT operátorokat vagy több beágyazási szintet.

MQL használata feltételekben#

Az Element-Path feltételei támogatják a Mergado Query Language (MQL) teljes szintaxisát. Ez azt jelenti, hogy ugyanazokat a kifejezéseket írhatod beléjük, mint az egyéni lekérdezések űrlapjába.

Mire szolgálnak a feltételek#

A feltételek pontosítják az elem útvonalát, és lehetővé teszik az értékek konkrét alcsoportjainak célzását. Elsősorban a következőkre használjuk:

1. Többszörös elemek konkrét értékeinek célzása. Például paramétereknél, szállítási opcióknál vagy képeknél, ahol a feltétel nélküli útvonal több értékhez vezetne.
2. Strukturális értékek hozzáadása – írásnál érvényes, hogy minden, ami a feltételben = operátorral vagy AND kötőszóval szerepel, a Mergado automatikusan létrehozza, ha még nem létezik.
3. Speciális attribútumok használata – a feltételek a @@POSITION és @@VALUE speciális attribútumokkal való munkára is szolgálnak.

Összefoglaló#

Az Element-Path nyelv feltételei kulcsfontosságú eszközök a konkrét értékek pontos és biztonságos célzásához. Lehetővé teszik az adatok szűrését, új struktúrák létrehozását és a többszörös és beágyazott elemekkel való munkát a hibás átírás kockázata nélkül. A feltételek helyes használata segít megelőzni a hibákat, rendet tartani a szabályokban, és biztosítani, hogy a Mergado mindig csak azokat az adatokat módosítsa, amelyeket valóban módosítani akarsz.