Egyedi feed formátum (Custom Format) útmutató#

1. Bevezetés#

Mi az egyedi formátum#

Az egyedi formátum egy olyan funkció, amellyel megtaníthatod a Mergadót szinte bármilyen XML vagy CSV fájl felismerésére és feldolgozására. Lehetővé teszi tetszőleges feed betöltését a Mergadóba, struktúrájának definiálását, majd az adatokkal való munkát ugyanúgy, mint a beépített integrált formátumoknál. Ezenkívül lehetővé teszi olyan formátumú feed létrehozását a Mergadóban, amely nincs a hivatalos integrációk között.

Az egyedi formátumot te határozod meg – leírod a Mergadónak, milyen Elemeket importáljon vagy exportáljon, és hogyan kezelje őket. Ez a funkció elsősorban a kevésbé szokásos, módosított vagy géppel felismerhetetlen formátumokhoz készült, amelyeket a Mergado a te definíciód nélkül nem tudna betölteni.

Mire szolgál#

Az egyedi formátumnak több kulcsfontosságú felhasználása van:

1. Bemenet és kimenet testreszabása#

Lehetővé teszi az adatstruktúra igényeidhez igazítását – a Projekt bemenetén és kimenetén egyaránt.

2. Nagyobb kontroll az adatok felett#

Segít pontosan meghatározni, hogyan dolgozza fel, jelenítse meg és exportálja a Mergado a termékadatokat.

3. Ismeretlen feedek importja#

Hasznos a Mergado által nem felismert formátumokkal való munkánál: beszállítói feedek, elavult vagy jelentősen módosított struktúrák, egyedi feedek vagy kiegészítő feedek (pl. készlet, utazási ajánlatok, értékelések).

4. A feed eredeti struktúrájának megőrzése#

Ha a bemeneti XML a gyökérelem után közvetlenül tartalmazza az egyes termékeket, az egyedi formátummal megőrizheted az eredeti struktúrát módosítás nélkül – hasznos instabil beszállítói forrásoknál.

5. Export egyedi formátumba#

Olyan kimeneti feed létrehozására is szolgál, amelynek formátumát a Mergado hivatalosan még nem támogatja. Ez jellemző új piacokra való terjeszkedésnél vagy kisebb összehasonlítóknál. Elég egy minta feedet használni, amely legalább egy mintaelemet tartalmaz.

Hogyan dolgozik a Mergado az adatokkal (Mergado XML és konverter)#

Mergado XML#

A Mergadóban minden adatkonverzió az egységes Mergado XML köztes formátumon keresztül történik. Ez „univerzális nyelvként" szolgál, amelyre a bemeneti adatok konvertálódnak, és amelyből a kimeneti formátumok generálódnak.

Konverter#

A konverter az a mechanizmus, amely a formátumok közötti adatkonverziót végzi. Mindig aktiválódik, ha a bemeneti és kimeneti formátum eltér.

• Újdonság: a konverter mostantól akkor is aktiválódik, ha a bemeneten és a kimeneten is Google Merchants formátum van.

Az egyedi formátum szerepe#

Az egyedi formátummal saját konvertert hozhatsz létre. A CF definiálásakor elmagyarázod a Mergadónak, hogy a feed melyik része mit jelent, és melyik Mergado XML ekvivalenshez kell hozzárendelni.

A legfontosabb lépés (csak XML feed esetén érvényes) az Elemek helyes kiválasztása:

• CHANNEL (Elem neve a Mergado XML-ben)
  • Ún. Root, azaz a gyökérelem, amely az XML feedben az összes terméket foglalja magába
  • az XML feedben ilyen Elem csak egy van,
  • általában a nyitó tagje a feed legelején, a záró tagje a feed legvégén található
  • a gyökérelem neve feedenként más lehet, példák formátum szerint:
    • Google:
    • Heureka
    • Mergado XML
• ITEM (Elem neve a Mergado XML-ben)
  • az egyes termékek/tételek obaló Eleme,
  • az XML feedben annyiszor fordul elő, ahány tételed/terméked van,
  • minden termék/tétel pontosan egy obaló Elemmel rendelkezik
  • a termék obaló Elemének neve feedenként más lehet, példák formátum szerint:
    • Google:
    • Heureka
    • Mergado XML

Ez a két Elem határozza meg a struktúrát, amelyben a Mergado az adatokat feldolgozza.

Mikor érdemes egyedi formátumot használni#

Bemeneten#

• A Mergado nem ismeri fel a feed formátumát.
• Ismeretlen, módosított vagy egyedi formátummal dolgozol.
• Meg kell őrizned a feed eredeti struktúráját.
• Kiegészítő adatokat csatlakoztatol, amelyek nincsenek integrálva (készlet, szolgáltatások, értékelések).

Kimeneten#

• Nem támogatott formátumú feedre van szükséged.
• Kontrollt szeretnél a gyökérelemek és a kimeneti XML struktúrája felett.
• Rendelkezésedre áll egy minta feed, amelyből sablon készíthető.

Korlátozások és mire figyelj#

1. Az ITEM-en kívüli Elemek figyelmen kívül hagyása#

Az egyedi formátum nem tudja feldolgozni a tétel obaló Elemén kívül elhelyezkedő Elemeket. Ami nincs az ITEM alatt, azt az Editor az egyedi formátumon keresztül feldolgozott feednél nem látja. Ez azt jelenti, hogy a CHANNEL és az ITEM között elhelyezkedő információk elveszhetnek.

Megoldás összetett struktúrákhoz: a feed szétbontása két Projektre és azok újbóli összekapcsolása a Blending Bull Bővítménnyel.

2. A konverzió adatvesztést okozhat#

A konverter akkor is érvényesül, ha ugyanabból az egyedi formátumból ugyanabba konvertálsz. Ha a leképezés nem teljes, az új feedben információvesztés következhet be – az adatok az eredeti feedben megmaradnak, a Mergado csak nem dolgozik velük.

3. Gyökérelemek a kimeneten#

A kimeneti feed gyökérelemei a választott kimeneti formátum szerint jönnek létre, és nem szerkeszthetők közvetlenül. Ha más struktúrára van szükséged, minta feed alapján létrehozott egyedi formátumot kell használnod, vagy a Blending Bull-lal módosítanod.

4. Frissítés szükségessége változásokkor#

Ha a bemeneti fájlban új Elem jelenik meg, az egyedi formátumnak nincs hozzá beállított viselkedése. A Mergado az ilyen Elemet automatikusan importálja és NEM rejti el, így módosítás nélkül bekerül a kimeneti feedbe. Ilyenkor frissíteni kell az egyedi formátum struktúráját és kiegészíteni az új Elem leképezését. Mentés és a Projekt újragenerálása után a változások automatikusan érvényre jutnak.

Ha az új Elemek érvénytelen kimeneti feedet okoznának, a leggyorsabb megoldás az új Elemek manuális elrejtése az Elemek oldalon, majd a Projekt exportjának futtatása (Szabályok alkalmazása nélkül).

GYIK#

1. Mi az egyedi formátum a Mergadóban?

Az egyedi formátum egy funkció, amellyel megtaníthatod a Mergadót szinte bármilyen XML vagy CSV fájl feldolgozására, függetlenül attól, hogy a Mergado szokásosan támogatja-e. Lehetővé teszi annak definiálását, milyen Elemeket tartalmaz a feed, és hogyan kezelje a rendszer importkor és exportkor. Saját formátumú kimeneti feed létrehozására is szolgál.

2. Mire szolgál az egyedi formátum?

Lehetővé teszi a Projekt adatstruktúrájának igényeidhez igazítását. Segít pontosan szabályozni, hogyan töltse be, jelenítse meg és exportálja a Mergado a termékadatokat. Különösen hasznos nem szabványos vagy módosított feedek importjánál és olyan formátumokba való exportnál, amelyek nem részei az integrált csatornáknak.

3. Mikor érdemes egyedi formátumot használni a bemeneten?

Akkor, ha a Mergado nem ismeri fel a feedet, vagy ha egyedi, módosított vagy kiegészítő feedekkel dolgozol. Segít ott is, ahol meg kell őrizni az eredeti feed struktúrát. Használhatod bemeneti kiegészítő adatokhoz is, mint készlet, szolgáltatások vagy értékelések.

4. Mikor érdemes egyedi formátumot használni a kimeneten?

Ha nem támogatott formátumú feedre van szükséged. Gyakran új platformokra való terjeszkedéskor vagy saját XML struktúrájú belső rendszerekhez való csatlakozáskor. Elég egy minta feed, amely alapján a Mergado létrehozza a kimeneti sablont.

5. Mi az a Mergado XML és miért fontos?

A Mergado XML egy belső köztes formátum, amelyen keresztül minden adatkonverzió történik. „Univerzális nyelvként" működik, amelyre a bemeneti adatok fordítódnak, és amelyből a kimeneti formátumok generálódnak. Ennek köszönhetően nem kell minden formátumpár számára külön konverter.

6. Mit csinál a konverter?

A konverter az értékeket konvertálja a formátumok között – tetszőleges bemenetből Mergado XML-be és onnan a kimeneti formátumba. Egyes formátumoknál (pl. Google Merchants) akkor is aktiválódik, ha a bemeneten és kimeneten ugyanaz a formátum van. Ha a leképezés nem teljes, a konverter egyes értékeket kihagyhat.

7. Milyen szerepe van az egyedi formátumnak az adatkonverzióban?

Az egyedi formátum lehetővé teszi saját, a feedre szabott konverter létrehozását. Pontosan megadod, mit jelentenek az egyes Elemek, és hogyan konvertálandók Mergado XML-be. Ezzel kontrollt kapsz az adatok strukturálása felett, még a Mergado által nem ismert platformoknál is.

8. Mit jelent a CHANNEL és ITEM helyes kiválasztása?

A CHANNEL a Mergado XML feed gyökéreleme, és meghatározza, hol kezdődik és végződik az egész dokumentum. Az ITEM egy tétel obaló Eleme, és a Mergado XML-ben annyiszor fordul elő, ahány terméked van. E két Elem helyes leképezése alapvető előfeltétele annak, hogy a Mergado a feededet feldolgozza. A CSV feednek nincsenek ilyen Elemei, így ott a leképezés elmarad.

9. Milyen korlátozásai vannak az egyedi formátumnak?

Nem tudja feldolgozni az ITEM-en kívül elhelyezkedő Elemeket, pl. a CHANNEL és ITEM közötti információkat. Konverziónál adatvesztés lehetséges, ha a leképezés nem teljes. Új bemeneti Elemek automatikusan importálódnak, de a rendszer nem tudja, mit kezdjen velük – manuálisan kell frissíteni a leképezést.

10. Miért következhet be adatvesztés konverziónál?

Az egyedi formátum figyelmen kívül hagyja az ITEM-en kívüli Elemeket az XML feedekben. Ha ilyen Elemek fontos információkat tartalmaznak, más megoldást kell alkalmaznod, pl. kétprojektes modellt és Blending Bull-lal történő összevonást.

11. Hogyan kezeli a Mergado a gyökérelemeket a kimeneten?

A gyökérelemek a választott kimeneti formátum szerint jönnek létre, és nem szerkeszthetők közvetlenül. Ha más struktúrára van szükséged, minta feed alapján készített egyedi formátumot kell használnod, vagy a Blending Bull-lal módosítanod.

12. Mi a teendő, ha a bemeneti feedben új Elem jelenik meg?

Az új Elem automatikusan importálódik a Projektbe, de a Mergado nem tudja, mit kezdjen vele, mert nem része az eredeti leképezésnek. Frissíteni kell az egyedi formátum struktúráját és kiegészíteni a leképezést. Ezután a Projektet újra kell generálnod.

13. Hogyan tudom megállapítani, mikor jobb nem használni egyedi formátumot?

Ahol létezik hivatalos integráció, ott nincs szükség egyedi formátumra. Kétség esetén írj nekünk a mergado@mergado.hu címre.

14. Mire szolgál a minta feed?

A minta feed sablonként szolgál a kimeneti egyedi formátum létrehozásakor. A Mergado ebből határozza meg a gyökérelemek struktúráját, az obaló tageket és a megőrzendő elemeket. Elég egy minimális példa – akár egyetlen termék is. A minta feednek URL címen kell elérhetőnek lennie.

15. Honnan tudom, hogy az egyedi formátum helyesen van konfigurálva?

A formátum helyes definiálását onnan ismered fel, hogy a Projekt betölti az összes szükséges Elemet, és a kimeneti feed az elvárt struktúrával rendelkezik. Kritikus pont a CHANNEL és ITEM helyes leképezése, valamint a Projektben a párosító Elem. Ha a kimeneti adatok megfelelnek a kívánt sablonnak és nincs információvesztés, a konfiguráció rendben van.

16. Mi a teendő, ha az egyedi formátummal történő Projekt-létrehozás hibával végződik?

Ellenőrizd az egyedi formátum leképezését. XML feedeknél gyakori hiba a rosszul leképezett gyökérelem vagy a tételt obaló Elem. Mindkét Elem csak egyszer, egy-egy feedbeli Elemre képezhető le. További gyakori hiba a rosszul választott párosító Elem. A legbiztosabb a termék-azonosítót tartalmazó Elemet választani, kombinálva pl. EAN-okat vagy termék-URL-eket/kép-URL-eket tartalmazó Elemmel. Kétség esetén írj nekünk a mergado@mergado.hu címre.

2. Hol hozható létre és kezelhető az egyedi formátum#

Az egyedi formátumot a Mergadóban kétféleképpen hozhatod létre: közvetlenül a Projekt létrehozásakor, vagy az egyedi formátumok kezelésére szolgáló önálló szekcióban. A két módszer kiegészíti egymást, és bármilyen formátumdefiníció elkészítésére és újrafelhasználására alkalmas.

Definíció a Projekt létrehozásakor#

A Projekt létrehozásakor megadhatod az egyedi formátumot mind a bemeneti, mind a kimeneti feedhez. Ez a lehetőség mindig megjelenik, ha a Mergado nem tud a bemeneti fájlhoz integrált formátumot rendelni, vagy ha egyedi kimenetre van szükséged.

Egyedi formátum a bemeneten#

A bemeneti feed egyedi formátumát a Projekt-létrehozó varázsló 3. lépésében állíthatod be. Ha a rendszer felismeri a csatlakoztatott feed struktúráját, felajánlja a Másik formátum választása gombot – így vagy másik hivatalos formátumot választhatsz, vagy a Saját formátum definiálása gombbal egyedi formátumot hozhatsz létre.

Ha a rendszer nem ismeri fel a struktúrát, közvetlenül felajánlja az egyedi formátum létrehozását, vagy egy hivatalos formátum manuális kiválasztását.

A bemeneti feed egyedi formátumának létrehozásakor két megközelítés áll rendelkezésre:

• Egyszerűsített varázsló – gyors alapstruktúra-beállításhoz.
• Részletes beállítás – az összes talált Elem részletes leképezéséhez.

Mindkét módszer ugyanazt a célt szolgálja: meghatározni, hol kezdődik a feed, mely Elemek képviselik az egyes termékeket, és melyik Elem tartalmaz egyedi értéket minden terméknél.

A bemeneti feed helyes feldolgozásához legalább ezeket kell leképezni:

• gyökérelem (CHANNEL),
• termékek obaló Eleme (ITEM),
• termékazonosító (ITEM_ID) – egyedi értékű Elem minden tételnél.

Természetesen a bemeneti feed összes Elemét is leképezheted, ami megkönnyítheti a későbbi munkát (pl. csökkenti a szükséges Szabályok számát). Magához az adatimporthoz ez azonban nem szükséges.

Egyedi formátum a kimeneten#

A kimeneti feed egyedi formátumát a Projekt-létrehozó varázsló 4. lépésében állíthatod be – kattints a Saját formátum definiálása gombra. Ezután meg kell adnod a minta feed URL-jét, amelynek alapján a Mergado összeállítja a kimeneti formátum struktúráját.

Figyelem: A minta feed nem tölthető fel feltöltéssel (Upload), az URL kötelező. Ha a sablonod fájlként van, hozz létre URL-t felhőszolgáltatással (pl. Dropbox), vagy használd a Mergado Files Bővítményt.

Ha már van kész egyedi formátumod, kimeneti formátumként választhatod a Projekthez. Ezzel meghatározod a végleges XML vagy CSV kinézetét, függetlenül attól, hogy a Mergado szokásosan támogatja-e az adott formátumot. Ha a formátum minta feedből készült, a Mergado megőrzi a gyökérelemeket és elrendezésüket.

A kimeneti feed egyedi formátumának létrehozásakor csak egy megközelítés áll rendelkezésre:

• Részletes beállítás – az összes talált Elem részletes leképezéséhez.
• Egyszerűsített varázsló itt nem elérhető.

A kimeneti feed helyes létrehozásához legalább ezeket kell leképezni:

• gyökérelem (CHANNEL),
• termékek obaló Eleme (ITEM).

Ebben az esetben a Mergado elkészíti a kimeneti feedet, létrehozza a sablon összes Elemét a Projektben, de mivel nem tudja, mit jelentenek az egyes Elemek, az Elemeket nem tölti ki értékekkel – Szabályokkal kell beállítani.

Természetesen a minta feed összes többi Elemét is leképezheted, ami megkönnyíti a további munkát (pl. csökkenti a szükséges Szabályok számát).

„Egyedi formátumok" szekció a főmenüben#

Az egyedi formátumok önálló kezelőfelületét a Mergado Editor bal oldali menüjében találod, felhasználói szinten. (A bal menü aszerint változik, hogy felhasználót, webáruházat vagy Projektet kezelsz.) Ez a szekció a fiókban létrehozott összes formátum központi kezelőhelye.

Itt lehetőséged van:

• új formátumot létrehozni konkrét Projekthez való kötés nélkül,
• minta fájl URL-jét megadni,
• Elemek leképezését elvégezni,
• meglévő formátumot szerkeszteni vagy újra elemezni.

Ez a szekció központi helyként szolgál, ahol az egyedi formátumokat karbantarthatod, tesztelheted és előkészítheted további Projektekhez.

Egyedi formátumok újrafelhasználása#

Miután létrehozol egy egyedi formátumot – akár a varázslóban, akár az önálló szekcióban – a Mergadóban eltárolódik, és tetszőlegesen hosszú ideig használhatod:

• a bemeneten, ha ugyanolyan struktúrájú újabb feedet szeretnél feldolgozni,
• a kimeneten, ha ugyanolyan formátumú feedet kell generálnod.

Ha már van legalább egy mentett egyedi formátumod, egy újabb létrehozásakor elérhető az Előtöltés alapján funkció, amellyel átveheted egy meglévő formátum struktúráját és leképezését. Ez sokat gyorsít, ha hasonló sémájú feedekkel dolgozol.

GYIK#

1. Hol hozhatok létre egyedi formátumot a Mergadóban? Kétféleképpen – közvetlenül a Projekt létrehozásakor vagy az Egyedi formátumok szekcióban a bal menüben. Mindkét mód kiegészíti egymást, és lehetővé teszi gyors vagy előzetes formátum-előkészítést. A mentett formátum az összes Projektben újra felhasználható.

2. Hogyan hozok létre egyedi formátumot a bemeneten Projekt létrehozásakor? A varázsló 3. lépésében a Mergado felajánlja az egyedi formátum létrehozását, ha nem ismeri fel a feed struktúráját, vagy ha manuálisan választod a „Másik formátum" lehetőséget. Használhatod az egyszerűsített varázslót vagy a részletes beállítást. Legalább a CHANNEL-t, ITEM-et (XML feedeknél) és lehetőleg a termékazonosítót kell leképezned.

3. Mit kell minimálisan leképezni, hogy a Mergado be tudja tölteni a feedet? A minimális működéshez le kell képezni a CHANNEL-t, ITEM-et (XML feedeknél) és egy egyedi értékű Elemet (leggyakrabban ITEM_ID). Ez elég ahhoz, hogy a Mergado azonosítsa a dokumentum elejét, az egyes termékeket és azok egyértelmű kulcsát. A többi Elem később is kiegészíthető.

4. Hogyan hozok létre egyedi formátumot a kimeneten? A Projekt létrehozásának 4. lépésében a Saját formátum definiálása lehetőséggel. Be kell illeszteni a minta XML fájl URL-jét, amely alapján a Mergado összeállítja a kimenet struktúráját. Ezután leképezed legalább az alap Elemeket és elmented.

5. Miért kell a minta feednek URL-en elérhetőnek lennie? A Mergado a kimeneti formátumot kizárólag URL-en elérhető fájlból hozza létre, mert elemzéskor importálnia kell a struktúrát. Feltöltés nem támogatott. Ha nincs saját hostingod, használhatsz felhőszolgáltatást (Dropbox, OneDrive) vagy a Mergado Files Bővítményt.

6. Miért nincs egyszerűsített varázsló a kimeneti formátumhoz? A kimeneti formátumnál mindig csak a részletes beállítás áll rendelkezésre. Ez szándékos, mert a célstruktúra a minta feedből származik, és teljes kontrollra van szükség a sablonba való konverzióhoz.

7. Mi történik, ha a kimeneti formátumnál csak a minimumot képezem le? A Mergado ugyan létrehozza a kimeneti feedet a sablon gyökérelemeivel, és a Projektben létrehozza az üres Elemeket, de a le nem képezett Elemek nem lesznek kitöltve értékekkel. Ezeket Szabályokkal kell kiegészíteni. Ezért érdemes minél több Elemet leképezni a minta feedből.

8. Mire szolgál az „Egyedi formátumok" szekció a bal menüben? A fiókban lévő összes egyedi formátum központi kezelésére. Új formátumokat hozhatsz létre, meglévőket szerkeszthetsz, struktúrájukat frissítheted. Ideális hely a jövőben ismételten használandó formátumok előkészítéséhez.

9. Használhatom ugyanazt az egyedi formátumot különböző Projektekben? Igen, minden mentett egyedi formátum újra felhasználható. Bemeneten és kimeneten is használhatod tetszőleges számú Projektben.

10. Mire szolgál az „Előtöltés alapján" lehetőség új formátum létrehozásakor? Lehetővé teszi egy korábban létrehozott egyedi formátum struktúrájának (leképezésének) átvételét. Ideális, ha több hasonló sémájú formátummal dolgozol, így nem kell mindent az elejéről kezdened.

3. Egyszerűsített varázsló vs. Részletes beállítás#

A bemeneti egyedi formátum létrehozásakor a Projekt-létrehozó varázslón belül kétféle módszer áll rendelkezésedre: egyszerűsített varázsló vagy részletes beállítás. Mindkét megközelítés ugyanazt a célt szolgálja – elmagyarázni a Mergadónak a feed struktúráját – de különböznek abban, milyen mértékű kontrollt és mennyi lehetőséget kínálnak.

Az egyszerűsített varázsló a feedek gyors feldolgozásához alkalmas. A részletes beállítás teljes kontrollt ad az Elemek leképezése és a formátum konfigurálása felett.

Egyszerűsített varázsló#

Az egyszerűsített varázsló csak a bemeneti egyedi formátum létrehozásakor jelenik meg, a Projekt-létrehozó varázslón belül. Gyors utat kínál az alapstruktúra definiálásához – csak a legfontosabb Elemeket mutatja, a haladó beállításokat elrejti.

Mikor használatos#

• A Projekt létrehozási varázslóján belül a bemeneti feed formátumának beállításakor.
• Ha a lehető leggyorsabban szeretnél működő leképezést létrehozni.

Mit kínál#

• Alapvető Elemek áttekinthető megjelenítése,
• hirdetési csatornák által használt kulcsfontosságú elemek kiemelése,
• érthetőbb Elem-nevek, mint a technikai nézetben,
• intelligens leképezés, amely a nevek és jelentés alapján automatikusan próbálja hozzárendelni az Elemeket.

Hogyan működik az intelligens leképezés#

A rendszer párosítást javasol – pl. description -> DESCRIPTION, EAN -> EAN, ID -> ITEM_ID. Neked csak ellenőrizned kell a javaslatok helyességét, és szükség esetén módosítani.

Mikor ideális az egyszerűsített varázsló#

• Ha gyorsan el kell kezdened az adatokkal dolgozni,
• ha a feed struktúrája nagyrészt szokásos konvenciókat követ,
• ha egyszeri vagy kevésbé összetett leképezésről van szó.

Részletes beállítás (teljes egyedi formátum definíció)#

A részletes beállítás az egyedi formátum definiálásának teljes felülete. Az Elemek leképezésénél felhasználható összes lehetőséget tartalmazza.

Mikor használatos#

• A feed összetett vagy szokatlan struktúrájú,
• minden Elem feldolgozását pontosan kontrollálni kell,
• formátumot készítesz ismételt használatra vagy kimeneti feedhez,
• al-Elemek, variánsok vagy paraméterek jelentését kell definiálni.

Mit tartalmaz#

1. Az egyedi formátum paraméterei#

Általános konfiguráció, amely meghatározza a formátum viselkedését:

• megfelelő formátumnév,
• ország beállítása (hatással a pénznemekre),
• meglévő formátumból való átvétel lehetősége,
• variánsok önálló termékekre bontásának opciója,
• saját kategóriafa definiálása.

2. Adatfeldolgozás beállítása (Elemek leképezése)#

A kulcsrész, amely meghatározza, hogyan értelmezi a Mergado a feed egyes részeit.

Alapvető Elemek:

• gyökérelem (pl. CHANNEL),
• termékek obaló Eleme (pl. ITEM),
• termékazonosító (pl. ITEM_ID) – egyedi értékű Elem minden tételnél.

További lehetőségek:

• közvetlen Mergado XML leképezés,
• műveletek al-Elemek nélküli Elemeknél (Változatlanul hagyás, Elrejtés, Elem jelentése),
• speciális műveletek obaló Elemeknél (pl. DELIVERY, PARAM, VARIANT),
• tetszőleges mennyiségű Elem leképezése a Projektben végzett munka megkönnyítéséhez.

Összehasonlítás: Egyszerűsített varázsló vs. Részletes beállítás#

Melyik módszert válaszd#

• Használd az egyszerűsített varázslót, ha gyorsan kell Projektet létrehoznod és a feed viszonylag áttekinthető struktúrájú.
• Válaszd a részletes beállítást, ha összetett feedekkel dolgozol, kimeneti sablont készítesz, vagy pontosan kell definiálnod az egyes Elemek jelentését.

GYIK#

1. Mi az egyszerűsített varázsló az egyedi formátum létrehozásakor? A varázsló 3. lépésében elérhető felület, amely csak a legfontosabb Elemeket mutatja és gyorsan átvezet a működő leképezésig. Nem terhel haladó beállításokkal, és intelligens leképezést kínál – a nevek és jelentés alapján automatikusan javasolja az Elemek hozzárendelését.

2. Mikor jelenik meg az egyszerűsített varázsló? Kizárólag bemeneti egyedi formátum létrehozásakor, ha a Mergado nem ismeri fel a feed struktúráját, vagy ha manuálisan választod az egyedi formátum definiálását.

3. Hogyan működik az intelligens leképezés? Automatikusan megpróbálja hozzárendelni az Elemeket a nevük és tipikus jelentésük alapján. Csak ellenőrizd a javasolt értékeket, és szükség esetén módosíts.

4. Mikor érdemes egyszerűsített varázslót használni? Ha gyorsan el kell kezdened az adatokkal dolgozni, és a feed viszonylag szabványos struktúrájú. Egyszeri feldolgozásnál is alkalmas, vagy ha nem szeretnél rögtön az elején részletes beállításokkal foglalkozni.

5. Mi a részletes beállítás? Az egyedi formátum teljes definiálási felülete, amelyen minden Elem és al-Elem maximális pontossággal leképezhető. Tartalmazza a formátum összes paraméterét is, mint az ország, név vagy variánsok bontása, és lehetővé teszi összetettebb struktúrák viselkedésének definiálását.

6. Mikor érdemes részletes beállítást használni? Ha a feed összetett, nem szabványos vagy többszintű struktúrájú. Ha pontosan kontrollálnod kell az adatok feldolgozását és exportálását. Ismételten használandó vagy kimeneti formátumoknál is szükséges.

7. Mely Elemeket kell mindkét esetben leképezni? Akár egyszerűsített varázslót, akár részletes beállítást használsz, mindig meg kell adnod a gyökérelemet (CHANNEL) (XML feedeknél), a termék obaló Elemét (ITEM) (XML feedeknél) és legalább egy termékazonosítót (leggyakrabban ITEM_ID).

8. Mit kínál a részletes beállítás az egyszerűsítetten felül? Lehetővé teszi minden Elem jelentésének definiálását és speciális műveletek beállítását az al-Elemekkel rendelkező Elemeknél, pl. paramétereknél, szállításnál vagy variánsoknál. Tartalmazza a formátum összes paraméterét és lehetőséget ad meglévő CF struktúrájának átvételére.

9. Melyik módszert válasszam? Az egyszerűsített varázslót gyors Projekt-létrehozáshoz és egyszerű feed struktúrához. A részletes beállítást, ha hosszú távon tervezel az adatokkal dolgozni, vagy ha a feed összetett és pontos leképezést igényel.

10. Kiválthatja az egyszerűsített varázsló a részletes beállítást? Igen, sok egyszerűbb esetben elegendő. Ha azonban a feed variánsokat, paramétereket, többszintű struktúrát tartalmaz, vagy további exportokat tervezel, a részletes beállítás pontosabb és stabilabb eredményt ad.

4. Egyedi formátum létrehozása – Részletes beállítás#

A részletes beállítás az a lépés, amelyben pontosan megadod a Mergadónak, hogyan értelmezze a feed struktúráját. Ezek alapján jön létre a konverter a te adatformátumod és a Mergado XML között. Ez a fázis a forrásfájl struktúraelemzése után következik.

A feed struktúrájának elemzése#

Az egyedi formátum létrehozásakor a Mergado először betölti és elemzi a csatlakoztatott fájlt. A struktúrából meghatározza, mely Elemek képezhetők le, és összeállítja a leképezési listát.

Mit csinál az elemzés#

• betölti az XML vagy CSV struktúráját a megadott URL-ről,
• azonosítja az elérhető Elemeket és struktúrájukat,
• előkészíti a leképezhető Elemek listáját a Mergado XML-hez.

Struktúra frissítése#

Ha később a bemeneti fájlban új Elem jelenik meg, azt be kell pótolni az egyedi formátum beállításába. Erre szolgál a Struktúra frissítése fájlból lehetőség, amely betölti az új elemeket és lehetővé teszi a feldolgozási mód meghatározását.

Alapvető paraméterek beállítása#

Ebben a részben a formátum általános paramétereit határozod meg. Ezek a beállítások nem az egyes Elemekre, hanem a formátum egészének viselkedésére vonatkoznak.

Elérhető paraméterek#

Elemek leképezése (Adatfeldolgozás beállítása)#

Ez a rész határozza meg, hogyan értelmezi a Mergado a feed Elemeit. A leképezés definiálja az egyes Elemek és Mergado XML ekvivalensük közötti kapcsolatot.

Kötelező Elemek (csak XML-nél)#

A feed működő feldolgozásához legalább ezt a két elemet le kell képezni:

• CHANNEL – az egész feed gyökéreleme,
• ITEM – egy tétel obaló Eleme.

E két Elem nélkül az XML feed nem importálható.

Ajánlott Elemek#

A Mergado tetszőleges mennyiségű további Elem leképezését teszi lehetővé. Minél több Elemet képezel le, annál kevesebb munka vár rád később a Szabályokkal, és annál jobban konvertálható a feed más kimeneti formátumokba.

Műveletek egyszerű Elemeknél#

Az al-Elemek nélküli Elemeknél háromféle művelet használható:

Műveletek obaló Elemeknél#

Az al-struktúrával rendelkező Elemeknél speciális műveletek választhatók, amelyek hozzáférhetővé teszik az al-Elemek beállítását.

Példák:

• DELIVERY – szállítási költség, szállító neve vagy kódja,
• PARAM – termékparaméterek definiálása,
• VARIANT – egyes tételvariánsokkal való munka.

A leképezés hatásai#

• Bővebb leképezés megkönnyíti a más formátumokba való exportot.
• Minimális leképezés több munkát igényel a Szabályokban (értékek másolása és kiegészítése).
• Az ITEM-en kívüli Elemek nem feldolgozhatók – a Mergado figyelmen kívül hagyja őket.

GYIK#

1. Mit jelent a feed struktúra elemzése? Az első lépés, amelyben a Mergado betölti a fájlt az URL-ről és azonosítja az összes elérhető Elemet. Hierarchiájukból összeállítja a struktúrát, amelyet leképezésre kínál.

2. Mi a teendő, ha a bemeneti feedben új Elem jelenik meg? Nyisd meg az egyedi formátum definícióját és használd a Struktúra frissítése fájlból lehetőséget. Az új Elem megjelenik a listában, és meghatározhatod a feldolgozási módját. Mentés és újragenerálás után az új Elem a Projekt részévé válik.

3. Mire szolgálnak az alapbeállítások? Ezek a formátum egészének viselkedését határozzák meg. Ide tartozik a formátumnév, az ország beállítása, a variánsokkal való munka, vagy a saját kategóriafa aktiválása. Helyes beállításuk egyszerűsíti a jövőbeli használatot.

4. Miért fontos jól elnevezni az egyedi formátumot? A formátum neve a formátumlistában jelenik meg, és megkönnyíti a tájékozódást, különösen ha több formátumod van. Jól megválasztott névvel gyorsan azonosíthatod, milyen típusú feedhez készült.

5. Hogyan működik az „Előtöltés alapján" lehetőség? Hozzáférést ad a meglévő egyedi formátumokhoz és lehetővé teszi struktúrájuk átvételét. Hasznos, ha hasonló formátumot kell létrehoznod, vagy azonos sémájú feedekkel dolgozol.

6. Mit jelentenek a „Változatlanul hagyás", „Elrejtés" és „Elem jelentése" műveletek?

• „Változatlanul hagyás" – Az Elem változás nélkül importálódik és exportálódik, hacsak el nem rejtik.
• „Elrejtés" – Az Elem importálódik, de elrejtettként. Szabályokban, Lekérdezésekben használható, vagy manuálisan felfedhető.
• „Elem jelentése" – Az Elem leképezése a Mergado XML ekvivalenséhez.

7. Mikor éri meg a kötelezőkön kívül további Elemeket is leképezni? Ha más formátumokba tervezel exportálni vagy Szabályokban dolgozol az adatokkal, a részletes leképezés jelentős előnyt jelent. Kevesebb leképezett Elem több munkát jelent az értékek kiegészítésénél.

8. Hogyan működnek a speciális műveletek az obaló Elemeknél? Akkor használatosak, ha az Elemnek saját beágyazott struktúrája van, pl. paraméterek, szállítás vagy variánsok. A speciális művelet kiválasztásával hozzáférsz az al-Elemek beállításához.

9. Miért hagyja figyelmen kívül a Mergado az ITEM-en kívüli Elemeket? Az egyedi formátum csak az XML azon részével tud dolgozni, amelyet az egyes termékek alkotnak. Az ITEM feletti Elemek nem részei a termékadatok modelljének, ezért importkor figyelmen kívül maradnak.

10. Honnan tudom, hogy a leképezés elegendő? Ha a feedet be tudod tölteni, az adatokkal kiterjedt Szabályok nélkül tudsz dolgozni, és az export információvesztés nélkül történik, a leképezés jól van beállítva. Ha gyakran kell Szabályokkal kiegészítened értékeket, a leképezés valószínűleg túl szűkös.

11. Mi a kapcsolat a leképezés és a konverter között? A leképezést te határozod meg, és annak alapján konvertálja a konverter az adatokat Mergado XML-be. Ha egy Elemet nem képezel le, a konverter „nem tud róla" és nem dolgozik vele.

5. Egyedi formátum a bemeneten#

A bemeneti egyedi formátummal a Mergado által nem felismert feedeket is be tudod tölteni és a belső Mergado XML struktúrába konvertálni. Ezzel szinte tetszőleges XML vagy CSV fájl feldolgozható a Mergadóban.

Mikor használatos#

Egyedi formátumra akkor van szükséged, ha a rendszer nem ismeri fel a bemeneti feed struktúráját, és jelzi, hogy a formátum ismeretlen. Ilyenkor felajánlja az egyedi formátum létrehozását.

Tipikus helyzetek#

• Beszállítói feedek vagy máshogy strukturált XML/CSV,
• egyedileg készített feedek, jellemzően nagyobb webáruházaknál,
• ismert formátumok elavult vagy jelentősen módosított változatai,
• kiegészítő feedek, pl. készlet vagy szerviz feedek,
• más típusú szolgáltatásokat nyújtó feedek (értékelések, utazási ajánlatok).

Egyedi formátum létrehozásának menete feed importnál#

Az egyedi formátum definiálása a Projekt-létrehozó varázsló 3. lépésében történik.

Lépések#

1. Hozz létre új Projektet és add meg a bemeneti feed URL-jét.
2. Ha a Mergado nem ismeri fel a struktúrát, válaszd a Saját formátum definiálása lehetőséget.
3. Képezd le a kötelező Elemeket:

• CHANNEL,
• ITEM.

4. Képezd le a további Elemeket, amelyekkel a Projektben dolgozni fogsz (URL, NAME, ITEM_ID, …).
5. Nevezd el és mentsd el a formátumot.
6. A 4. lépésben:

• meghagyhatod ugyanazt az egyedi formátumot a kimeneten is, így a feed struktúrája nem változik
• választhatsz más hivatalos formátumot, pl. Google, Meta stb.
• vagy létrehozhatsz új egyedi formátumot a kimenetre

7. Az utolsó lépésben ellenőrizd a párosító Elemek kiválasztását. Ha nincsenek beállítva, be kell állítanod.

A párosító Elem beállítása#

A párosító Elem kulcsfontosságú adat, amelyet a Mergado az egyes tételek egyértelmű azonosítására használ a Projektben.

Ami fontos#

• minden terméknél egyedi értékkel kell rendelkeznie,
• leggyakrabban a termék-azonosítót vagy más egyértelmű azonosítót tartalmazó Elemet használjuk (URL, EAN, …),
• az összefoglaló lépésben ellenőrizni kell, hogy a párosító Elem helyesen van kiválasztva.

A párosító Elem úgy működik, mint minden tétel „személyi száma" – ennek segítségével követi és dolgozza fel a Mergado az egyes termékeket, függetlenül attól, hogyan változnak az értékeik.

Hány Elemet érdemes leképezni#

Minimum – a működéshez#

Az importhoz elegendő csak a kötelező Elemeket leképezni (CHANNEL, ITEM és esetleg ITEM_ID).

Maximum – a hatékonysághoz#

Több Elem leképezése egyszerűbb munkát jelent a Projekt további lépéseiben.

A részletes leképezés előnyei:

• kevesebb szükséges Szabály az értékek másolásához,
• gyorsabb konverzió más kimeneti formátumokba,
• jobb olvashatóság és a Projekt stabilitása.

Példa: Ha nem képezed le a terméknevet tartalmazó Elemet, később Szabállyal kell kiegészítened. Ha már a CF definiálásakor leképezed, a Mergado automatikusan helyesen konvertálja a kimeneti feedbe.

Struktúra frissítése feed változásokkor#

Ha a bemeneti feedben új Elemek jelennek meg, a mentett egyedi formátum automatikusan nem veszi át őket. Ilyenkor tedd a következőt:

1. Nyisd meg az adott egyedi formátumot.
2. Kattints a Struktúra frissítése fájlból lehetőségre.
3. Rendeld hozzá a feldolgozási módot az újonnan talált Elemekhez.
4. Mentsd el, és generáld újra az ezzel a formátummal rendelkező Projekteket.

Ezzel biztosítod, hogy a feed a változások után is konzisztensen dolgozódjon fel.

GYIK#

1. Mikor szükséges bemeneti egyedi formátumot használni? Akkor, ha a Mergado nem ismeri fel a bemeneti feed struktúráját, és jelzi, hogy a formátum ismeretlen. Jellemzően beszállítói, egyedi, elavult vagy jelentősen módosított feedekről van szó.

2. Milyen típusú feedek igénylik leggyakrabban a bemeneti egyedi formátumot? Leggyakrabban beszállítói és egyedi feedek, amelyeknek nincs nyilvános specifikációja, vagy eltérnek a szabványoktól. Ide tartoznak a kiegészítő feedek, pl. készlet, szerviz vagy értékeléseket és utazási ajánlatokat tartalmazó feedek.

3. Hogyan történik az egyedi formátum létrehozása importnál? A Projekt-létrehozó varázsló 3. lépésében, ahol a „Saját formátum definiálása" lehetőséget választod. Ezután leképezed a kötelező CHANNEL és ITEM Elemeket (XML feedeknél) és további tételeket, amelyekkel a Projektben dolgozni fogsz. Végül elmented a formátumot.

4. Mi az a párosító Elem és miért olyan fontos? A párosító Elem az az adat, amely lehetővé teszi a Mergado számára, hogy egyértelműen azonosítsa az egyes tételeket. Minden terméknél egyedi értékkel kell rendelkeznie – leggyakrabban ITEM_ID, URL vagy EAN. Helyes párosító Elem nélkül a feed importja és a változások párosítása nem működik megfelelően.

5. Hány Elemet érdemes leképezni? Az alapműködéshez elég a CHANNEL, ITEM (XML feedeknél) és egy egyedi azonosító. Ha azonban minimalizálni szeretnéd a későbbi munkát, érdemes további Elemeket is leképezni, mert ez egyszerűsíti a Szabályokkal való munkát és megkönnyíti a konverziót más formátumokba.

6. Mi történik, ha nem képezek le fontos Elemeket? A le nem képezett Elemek ugyan megjelennek a Projektben, de a Mergado nem tudja helyesen használni őket, és Szabályokkal kell manuálisan kiegészíteni. Ez nagyobb munkaterhet jelent és exportnál hibákat okozhat.

7. Hogyan járjak el, ha a bemeneti feedben új adatmezők jelennek meg? Nyisd meg az egyedi formátum definícióját és használd a Struktúra frissítése fájlból lehetőséget. A Mergado betölti az új Elemeket és te hozzárendeled a feldolgozási módot. Ezután a Projektet újragenerálod.

8. Használható az egyedi formátum akkor is, ha a Mergado felismeri a formátumot? Igen, bizonyos esetekben előnyös lehet egyedi formátumot létrehozni felismert feednél is, pl. ha meg akarod őrizni az eredeti struktúrát. Ilyenkor egyszerűen válaszd a „Másik formátum" lehetőséget.

9. Mi a teendő, ha nem vagyok biztos, hogy az egyedi formátum helyesen van beállítva? Ellenőrizd a betöltött Elemeket, a párosító Elemet és a Projekt kimeneti feedjének struktúráját. Ha látod az összes szükséges értéket és az adatok helyesen párosulnak, a formátum rendben van. Probléma esetén térj vissza a leképezéshez, vagy írj nekünk a mergado@mergado.hu címre.

6. Egyedi formátum használata a kimeneten#

A kimeneti egyedi formátum arra szolgál, hogy a Mergado olyan struktúrájú termékfeedet generáljon, amelyet alapból nem támogat. Akkor jön jól, ha a kimeneti fájlnak pontosan meg kell felelnie egy platform, rendszer vagy belső folyamat egyedi követelményeinek.

Mikor használatos#

A kimeneti egyedi formátum elsősorban akkor jön jól, ha:

• a Mergadóban nem integrált platformhoz kell feed,
• új e-commerce csatornához készítesz csatlakozást,
• kisebb összehasonlítókkal vagy saját adatstruktúrájú belső rendszerekkel dolgozol,
• a gyökérelemek specifikus struktúrájára van szükség (pl. …).

Mi az a minta feed és miért szükséges#

A kimeneti egyedi formátum minta feed alapján készül – ez egy minta XML vagy CSV fájl, amely legalább egy tételt tartalmaz.

Miért fontos#

• Sablonként szolgál, amely alapján a Mergado megtanulja, hogyan nézzen ki a végleges feed.
• Meghatározza a gyökérelemeket a célstruktúrában.
• Lehet teljesen fiktív – elég egyetlen fiktív tétel, az értékek nem számítanak.

Követelmények#

• URL-en kell elérhetőnek lennie (feltöltés nem támogatott),
• tartalmaznia kell a kívánt kimeneti gyökérstruktúrát,
• minimális tartalom is elegendő.

Hogyan hozz létre minta feedet#

Két módszer létezik:

1. Manuális fájl létrehozása#

• XML-t szövegszerkesztőben vagy CSV-t táblázatszerkesztőben készítesz,
• szerverre mented,
• URL-en elérhetővé teszed.

2. A Mergado Files Bővítménnyel#

• aktiválod a Mergado Files Bővítményt,
• létrehozol egy új fájlt,
• beilleszted a mintatételt,
• XML vagy CSV formátumban mented,
• megkapod az URL-t a formátumdefinícióhoz.

A kimeneti egyedi formátum létrehozásának menete#

A kimeneti egyedi formátum az Egyedi formátumok szekcióban a felhasználói szintű bal menüben, vagy közvetlenül a Projekt-létrehozó varázsló 4. lépésében hozható létre.

Lépések#

1. Nyisd meg az Egyedi formátumokat és kattints az Új egyedi formátum lehetőségre.
2. A „Forrásfájl" mezőbe illeszd be a minta feed URL-jét.
3. Nevezd el a formátumot.
4. Képezd le az Elemeket:

• minimum a gyökér obaló Elemek (CHANNEL, ITEM),
• ajánlott az összes kimeneten generálandó Elem leképezése.

5. Mentsd el a formátumot.

Mentés után az egyedi formátum újra felhasználhatóvá válik. Bármely Projektben kimeneti (és bemeneti) formátumként választható.

Hogyan generálja a Mergado a kimeneti feedet egyéni sablon alapján#

A kimeneti egyedi formátum határozza meg a feed végleges struktúráját. A Mergado a kimenet generálásakor:

• a gyökérelemeket pontosan a minta feedből veszi,
• az értékek konvertálásához a definiált leképezést használja,
• megőrzi az Elemek sorrendjét és struktúráját a sablon szerint.

Ezzel gyorsan elkészíthető tetszőleges XML vagy CSV feed anélkül, hogy a Mergadónak új integrációt kellene fejlesztenie.

GYIK#

1. Mikor érdemes kimeneti egyedi formátumot használni? Ha olyan struktúrájú feedre van szükséged, amelyet a Mergado alapból nem kínál. Jellemzően új platformhoz, kisebb összehasonlítóhoz vagy saját struktúrájú belső rendszerhez.

2. Mi az a minta (example) feed? Minta XML vagy CSV fájl, amely legalább egy tételt tartalmaz és megfelel a generálni kívánt célstruktúrának. A Mergado ebből olvassa ki a gyökérelemeket, a belső struktúrát és az Elemek sorrendjét.

3. Kell-e a minta feednek valósnak lennie? Nem, teljesen fiktív is lehet – elég egyetlen tétel minimális értékekkel. A lényeg a helyes Elem-struktúra, nem a konkrét adatok.

4. Miért kell a minta feednek URL-en elérhetőnek lennie? A Mergado a struktúrát közvetlenül az URL-ről tölti be elemzéskor. URL nélküli feltöltés nem lehetséges. Ha nincs saját hostingod, használhatsz felhőszolgáltatást vagy a Mergado Files Bővítményt.

5. Hogyan történik a kimeneti egyedi formátum létrehozása? Az Egyedi formátumok szekcióban az „Új egyedi formátum" lehetőséget választod, forrásfájlként megadod a minta feed URL-jét. Elemzés után elnevezed és leképezed a szükséges Elemeket. Alternatívaként a Projekt-létrehozó varázsló 4. lépésében is létrehozhatod.

6. Hogyan használja a Mergado az egyedi formátumot a kimenet generálásakor? A minta feedből betöltött sablonból indul ki, megőrzi a gyökérelemeket és struktúrát. A leképezés segítségével konvertálja az értékeket a Mergado XML-ből a kimeneti Elemekbe.

7. Mi történik, ha csak a minimumot képezem le a kimeneten? A Mergado létrehozza a helyes struktúrájú kimeneti feedet, de az Elemek nem lesznek adatokkal töltve. A le nem képezett Elemek értékeit Szabályokkal kell kiegészíteni.

8. Miért érdemes a kimeneten is minél több Elemet leképezni? Jobb kontrollt kapsz a kimenet felett, kevesebb Szabályra van szükséged, és egyszerűbb az újrafelhasználás más Projektekben.

9. Használható a kimeneti egyedi formátum bemenetként is? Igen, létrehozása után a formátumok listájában bemenetre és kimenetre is elérhető.

7. Munka összetett XML struktúrákkal#

Ez a rész azokat az eseteket írja le, amikor a feed az ITEM-en kívüli elemeket is tartalmaz. Ilyen feedeknél az egyedi formátum korlátokba ütközik, és alternatív megoldásra van szükség.

Az egyedi formátum korlátai importnál#

Az egyedi formátum csak az ITEM obaló Elemén belüli Elemekkel tud dolgozni. Az ITEM felett vagy azon kívül lévő elemeket a Mergado Editor figyelmen kívül hagyja.

A CHANNEL és ITEM közötti információk#

• Egyes XML feedek a CHANNEL és ITEM között további adatszinteket tartalmaznak (pl. kategóriák, szállítás, metaadatok).
• Ezek az Elemek nem részei a tételnek, ezért importkor nem töltődnek be.

Tipikus problémás feedek példái#

• XML feedek globális kategória-információkkal a termékeken kívül,
• adatforrások CHANNEL szinten definiált szállítási információkkal,
• összetett, többszintű feedek a gyökérelem és az egyes tételek között.

Megoldás: kétprojektes modell + Blending Bull#

Ha az XML feed teljes struktúráját meg kell őrizni, beleértve az ITEM-en kívüli elemeket, kétlépcsős megoldás alkalmazható:

1. Első Projekt – termékeket tartalmaz.
2. Második Projekt – a kiegészítő információkat tartalmazza, amelyek nem részei az ITEM-nek.
3. Összevonás – mindkét Projekt kimeneti adatai a Blending Bull Bővítménnyel egyesülnek.

Hogyan működik#

Összevonás Blending Bull-lal#

1. Aktiváld a Blending Bull Bővítményt.
2. Az Adatforrások részben válaszd ki mindkét Projekt kimenetét.
3. A Fájlok szekcióban hozz létre új kimeneti fájlt és válaszd ki az előző lépésben létrehozott adatforrásokat.
4. Szükség szerint egészítsd ki Szabályokkal.

Miért működik#

Minden Projekt csak azt a részt tölti be, amellyel a Mergado dolgozni tud. A Blending Bull ezután összevonja mindkét kimenetet, és előállítja a teljes adatkimenetet.

Gyökérelemek szerkesztése a kimeneten#

A kimeneti feed gyökérelemei nem szerkeszthetők közvetlenül a Mergadóban. Ha más obaló Elem-struktúrára van szükséged, két alternatíva létezik: módosítás Blending Bull-lal vagy saját sablon létrehozása.

Módosítás Blending Bull-lal#

A Blending Bull lehetővé teszi, hogy a kimeneti feedet szöveges fájlként kezeld. Ezzel módosíthatók:

• gyökérelemek,
• fejléc,
• lábléc,
• Elem-nevek.

„Keresés és csere" típusú Szabályok#

A Blending Bull Szabályaival tömeges Elem-névváltoztatások végezhetők. Például:

• SHOP -> PRODUCTS,
• SHOPITEM -> PRODUCT.

Ezzel a kimeneti struktúra könnyen módosítható magába a Projektbe való beavatkozás nélkül.

Alternatívák a Blending Bull-hoz (a kimeneti struktúra kontrollálására)#

1. Sablon létrehozása egyedi formátummal#

• A kívánt gyökérelemeket tartalmazó fiktív vagy meglévő feedet használsz.
• Ezt a feedet kimeneti egyedi formátum létrehozásakor használod.
• A Mergado pontosan a minta feedben szereplő gyökérelemeket őrzi meg.

2. Új integrált formátum hozzáadásának kérése#

• Ha rendelkezel a célformátum specifikációjával, írj nekünk a mergado@mergado.hu címre.
• A formátum bekerülhet a hivatalosan támogatott integrációk közé.
• Ezután szokásos kimeneti formátumként választható.
• A hozzáadás prioritizálási folyamaton megy keresztül, és tovább tarthat.

GYIK#

1. Miért hagyja figyelmen kívül a Mergado a bemeneti XML feed egyes Elemeit? Az egyedi formátum csak az ITEM obaló Elemén belüli Elemekkel tud dolgozni. Ami azon kívül van, importkor nem kerül feldolgozásra.

2. Hogyan ismerem fel, hogy a feed problémás és speciális megoldást igényel? A legegyszerűbb a kimeneti feedet összehasonlítani a bemeneti feeddel. Ha import után fontos adatok hiányoznak, az annak a jele, hogy az ITEM-en kívüli struktúrában vannak.

3. Mi az a kétprojektes modell? Az egyik Projekt a termékeket tölti be, a másik a kiegészítő információkat. Ezután mindkét kimenet a Blending Bull Bővítménnyel egyesül.

4. Lehet a Mergadóban közvetlenül szerkeszteni a kimeneti feed gyökérelemeit? Nem. Minta feed alapján készített egyedi formátummal vagy a Blending Bull-lal módosíthatók.

5. Mikor érdemes kimeneti egyedi formátummal sablont készíteni? Ha pontosan meghatározott kimeneti XML struktúrád van, pl. partner vagy saját rendszer specifikációja. Ez a legstabilabb megoldás hosszú távú használatra.

6. Kérhető új hivatalos formátum hozzáadása a Mergadóhoz? Igen, dokumentáció és specifikáció birtokában. A folyamat prioritizálás alá esik, és tovább tarthat. Ha gyors eredményre van szükséged, az egyedi formátum vagy a Blending Bull gyorsabb megoldás.

8. Fogalmak magyarázata#

Mergado XML mint univerzális nyelv#

• A Mergado XML univerzális köztes formátumként működik, amelyen keresztül a Mergado minden termékadatot konvertál. Nem kell minden bemeneti-kimeneti formátumpárhoz külön konverter – elég egyetlen közös struktúra, amelyre az adatok konvertálódnak.

Egyedi formátum mint szótár és nyelvtani szabályok#

• Az egyedi formátum határozza meg, hogyan „fordíthatók le" a feed egyes Elemei Mergado XML-re. Ez egy szabálykészlet, amely lehetővé teszi a Mergado számára szinte bármilyen feed struktúrájának felismerését.

Minta feed mint célnyelv#

• A kimeneti formátum létrehozásakor a minta feed definiálja, hogyan nézzen ki a végső struktúra. A Mergado ebből olvassa ki:
  • a gyökérstruktúrát,
  • az Elem-neveket,
  • a tételek szervezését.

Ezzel a saját specifikációdnak pontosan megfelelő kimeneti feedet kapsz.

Konverziós példák#

• Import (beszállítói feed -> webáruház formátuma)
  • A Mergado úgy készíti elő a struktúrát, hogy kompatibilis legyen a webáruház formátumával, beleértve az árakat, elérhetőségeket és paramétereket.