Vše co potřebujete vědět o vlastním formátu feedu (Custom Format)#

1. Úvod do Vlastního formátu (Custom Format)#

Co je vlastní formát#

Vlastní formát je funkce, pomocí které naučíte Mergado rozpoznat a zpracovávat téměř jakýkoli XML nebo CSV soubor. Umožňuje nahrát do Mergada libovolný feed, definovat jeho strukturu a následně s daty pracovat stejně jako s běžnými integrovanými formáty. Dále umožňuje vytvořit v Mergadu feed ve formátu, který není mezi oficiálními integracemi.

Vlastní formát určujete vy – popisujete Mergadu, jaké elementy má importovat či exportovat a jak s nimi zacházet. Tato funkcionalita je určena zejména pro méně obvyklé, upravené nebo strojem nerozpoznatelné formáty, které by Mergado bez vaší definice nedokázalo načíst.

K čemu slouží?#

Vlastní formát má několik klíčových využití:

1. Přizpůsobení vstupu a výstupu#

Umožňuje přizpůsobit strukturu dat vašim potřebám – na vstupu i na výstupu projektu.

2. Větší kontrola nad daty#

Pomáhá přesně určit, jak mají být produktová data v Mergadu zpracována, zobrazena a exportována.

3. Import neznámých feedů#

Vhodný při práci s formáty, které Mergado nepozná: dodavatelské feedy, zastaralé či výrazně upravené struktury, custom feedy nebo doplňkové feedy (např. skladové, cestovní nabídky, recenze).

4. Zachování původní struktury feedu#

Pokud vstupní XML obsahuje po kořenovém elementu přímo jednotlivé produkty, lze pomocí vlastního formátu zachovat původní strukturu bez úprav – užitečné u nestabilních dodavatelských zdrojů.

5. Export do vlastního formátu#

Slouží také pro vytvoření výstupního feedu ve formátu, který Mergado zatím oficiálně nepodporuje. Typické je to při expanzi na nová tržiště nebo pro menší srovnávače. Stačí použít šablonu feedu obsahující alespoň jednu vzorovou položku.

Jak Mergado pracuje s daty (Mergado XML a převodník)?#

Mergado XML#

Všechny datové převody v Mergadu probíhají přes jednotný meziformát Mergado XML. Ten slouží jako „univerzální jazyk“, do kterého se převedou vstupní data a ze kterého se následně generují výstupní formáty.

Převodník#

Převodník je mechanismus, který převádí data mezi formáty. Použije se vždy, když se liší vstupní a výstupní formát. Převodník se aktivuje i v případech, kdy je na vstupu i na výstupu Google Merchants formát.

Role vlastního formátu#

Vlastní formát vám umožňuje vytvořit vlastní převodník. Při definici CF Mergadu vysvětlujete, co která část vašeho feedu znamená a na jaký ekvivalent v Mergado XML se má namapovat.

Nejdůležitější krokem (platí pouze při práci s XML feedem) je správný výběr elementů pro:

• CHANNEL (název elementu v Mergado XML)
  • tzv. Root, tedy kořenový element obalující všechny produkty v XML feedu
  • v XML feedu je takový element pouze jeden,
  • obvykle je jeho otevírací tag úplně na začátku feedu a jeho uzavírací tag úplně na konci feedu
  • název kořenového elementu může být v každém feedu jiný, příklady dle formátu:
    • Google:
    • Heureka
    • Mergado XML
• ITEM (název elementu v Mergado XML)
  • element obalující jednu položku (produkt)
  • v XML feedu je takový element uveden tolikrát, kolik máte položek/produktů.,
  • Každý produkt/položka feedu má právě jeden obalovací element
  • název obalovacího elementu produktu může být v každém feedu jiný, příklady dle formátu:
    • Google:
    • Heureka
    • Mergado XML

Tyto dva elementy určují strukturu, ve které Mergado data zpracovává.

Kdy má smysl vlastní formát použít?#

Na vstupu#

• Mergado nerozpozná formát feedu.
• Pracujete s neznámým, upraveným nebo custom formátem.
• Potřebujete zachovat původní strukturu feedu.
• Napojujete doplňková data, která nejsou integrována (sklad, služby, recenze).

Na výstupu#

• Potřebujete feed v nepodporovaném formátu.
• Chcete mít kontrolu nad kořenovými elementy a strukturou výstupního XML.
• Máte k dispozici vzorový feed, ze kterého lze vytvořit šablonu.

Omezení a na co si dát pozor#

1. Ignorování elementů mimo ITEM#

Vlastní formát nedokáže zpracovat elementy umístěné nad obalovacím elementem položky. Vše, co není pod ITEM, Editor u feedu zpracovaného přes vlastní formát nevidí. To znamená, že informace umístěné mezi CHANNEL a ITEM mohou být ztraceny.

Řešení pro složité struktury: Rozložení feedu na dva projekty a jejich opětovné spojení pomocí rozšíření Blending Bull.

2. Převod může způsobit ztrátu dat#

Převodník se uplatní i v případě, že převádíte ze stejného vlastního formátu na ten stejný. Pokud není mapování kompletní, může dojít ke ztrátě informací v novém feedu (v původním feedu zůstanou zachována, jen s nimi Mergado nepracuje).

3. Kořenové elementy na výstupu#

Kořenové elementy vytváří Mergado Editor automaticky podle zvoleného výstupního formátu. Nejde je tedy vytvořit ručně jako standardní elementy v editoru. Pokud tedy potřebuje nestandardní kořenové elementy ve výstupním feedu, jediný způsob jak ovlivnit kořenové elementy je zvolením správné šablony pro vlastní formát, který pak použijete na výstupu.

4. Nutnost aktualizace při změnách#

Pokud se ve vstupním souboru objeví nový element, vlastní formát pro něj nemá nastavené chování. Mergado takový element automaticky importuje a neskryje, dostane se tak automaticky do výstupního feedu beze změny. V takovém případě je nutné aktualizovat strukturu vlastního formátu a doplnit nastavení mapování nového elementu. Po uložení a přegenerování projektu se pak změny automaticky projeví.

Případně pokud by nové elementy způsobili nevalidnost výstupního feedu, jde to nejrychleji opravit skrytím nových elementů ručně na stránce Elementy a spustit Export projektu (bez aplikace pravidel).

FAQ#

Co je vlastní formát v Mergadu?#

Vlastní formát je funkce, díky které naučíte Mergado zpracovat téměř jakýkoli XML nebo CSV soubor, bez ohledu na to, zda jej Mergado běžně podporuje. Umožňuje definovat, jaké elementy feed obsahuje a jak s nimi má systém pracovat při importu i exportu. Slouží také k vytvoření výstupního feedu ve vlastním formátu, například pro platformy nebo kanály, které Mergado standardně nepodporuje.

K čemu vlastní formát slouží?#

Vlastní formát umožňuje přizpůsobit datovou strukturu projektu vašim potřebám. Pomáhá přesně řídit způsob, jakým Mergado načítá, zobrazuje a exportuje produktová data. Je užitečný zejména pro import nestandardních nebo upravených feedů a pro export do formátů, které nejsou součástí integrovaných kanálů.

Kdy má smysl vlastní formát použít na vstupu?#

Vlastní formát je vhodný, když Mergado nedokáže feed rozpoznat nebo pokud pracujete s custom, upraveným či doplňkovým feedem, který se nevejde do existujících integrací. Pomáhá také tam, kde potřebujete zachovat původní strukturu feedu, pokud XML obsahuje položky přímo pod kořenovým elementem. Můžete jej využít i pro vstupní doplňková data jako sklad, služby nebo recenze.

Kdy má smysl vlastní formát použít na výstupu?#

Vlastní formát na výstupu se hodí, když potřebujete vytvořit feed v podobě, kterou Mergado standardně negeneruje. Často jde o expanzi na nové platformy nebo napojení na interní systémy s vlastní strukturou XML. Stačí mít vzorový feed, podle kterého Mergado vytvoří výstupní šablonu.

Co je Mergado XML a proč je důležité?#

Mergado XML je interní meziformát, přes který probíhají všechny datové převody. Funguje jako „univerzální jazyk“, do něhož se přeloží vstupní data, a z něhož se dále generují výstupní formáty. Díky tomu nemusí existovat převodník pro každý pár formátů zvlášť.

Co dělá převodník?#

Převodník převádí hodnoty mezi datovými formáty – z libovolného vstupu do Mergado XML a z něj do výstupního formátu. U vybraných formátů (např. Google Merchants) se aktivuje i v případech, kdy je stejný formát na vstupu i na výstupu . Pokud není mapování kompletní, může převodník některé hodnoty vynechat, což je důvod, proč se doporučuje věnovat mapování pozornost.

Jakou roli má vlastní formát při převodu dat?#

Vlastní formát umožňuje vytvořit vlastní převodník na míru vašemu feedu. Přesně určujete, co jednotlivé elementy znamenají a jak se mají převést do Mergado XML. Díky tomu získáte kontrolu nad strukturováním dat i přes platformy, které Mergado standardně nezná.

Co znamená správně vybrat CHANNEL a ITEM?#

CHANNEL je kořenový element Mergado XML feedu a určuje, kde celý dokument začíná a končí. ITEM je obalovací element jedné položky a v Mergado XML se vyskytuje tolikrát, kolik máte produktů. Správné mapování těchto dvou elementů je základním předpokladem pro to, aby Mergado dokázalo váš feed zpracovat. CSV feed tyto elementy nemá a proto mapování těchto elementů odpadá.

Jaká omezení má vlastní formát?#

Vlastní formát neumí zpracovat elementy, které leží mimo ITEM, tedy například informace umístěné mezi CHANNEL a ITEM. Tyto prvky Mergado ignoruje a v projektu s nimi nelze přímo pracovat. Pokud je potřebujete zachovat, je nutné použít jiný postup, například dvouprojektový model a sloučení přes Blending Bull.

Proč může dojít ke ztrátě dat při převodu?#

Vlastní formát ignoruje elementy v XML feedech, které jsou umístěné mezi CHANNEL a ITEM. Pokud takové elementy obsahují informace, které potřebujete, je třeba použít jiný postup, například dvouprojektový model a sloučení přes Blending Bull.

Jak Mergado pracuje s kořenovými elementy na výstupu?#

Kořenové elementy vznikají podle zvoleného výstupního formátu a nelze je přímo editovat. Pokud potřebujete jinou strukturu, je nutné použít vlastní formát vytvořený podle vzorového feedu, případně úpravu přes Blending Bull. Tím zajistíte, že výstupní feed bude mít přesně takové záhlaví a obal, jaký požadujete.

Co dělat, když se ve vstupním feedu objeví nový element?#

Nový element se automaticky importuje do projektu, ale Mergado neví, co s ním, protože není součástí původního mapování. V takové situaci je třeba aktualizovat strukturu vlastního formátu a doplnit mapování nového elementu. Poté projekt přegenerujete a data se načtou a převedou správně.

Jak zjistím, kdy je lepší vlastní formát nepoužívat?#

Vlastní formát není potřeba tam, kde existuje oficiální integrace. Pokud máte pochybnosti, je vhodné situaci konzultovat se supportem.

K čemu slouží vzorový feed?#

Vzorový feed slouží jako šablona při tvorbě výstupního vlastního formátu. Mergado podle něj určí strukturu kořenových elementů, obalovacích tagů a dalších prvků, které se mají ve výstupu zachovat. Stačí minimální příklad – klidně jeden produkt. Vzorový feed musí být dostupný na URL adrese.

Jak poznám, že je vlastní formát správně nakonfigurován?#

Zda je formát definován správně poznáte podle toho, že projekt načte všechny potřebné elementy a výstupní feed má očekávanou strukturu. Kritickým místem je správné mapování CHANNEL a ITEM, případně párovacího elementu v projektu. Pokud výstupní data odpovídají požadované šabloně a nedochází ke ztrátě informací, je konfigurace v pořádku.

Co dělat, když tvorba projektu s vlastním formátem skončí chybou?#

Zkontrolujte mapování vlastního formátu. Častou chybou u XML feedů je špatně namapovaný kořenový element nebo element obalující položku. Oba elementy mohou být namapované pouze jednou, na jeden element ve vašem feedu. Další chybou bývá špatně zvolený párovací element. Nejjistější je zvolit element s id produktů, kombinovaný např. s elementem s EANy nebo s URL produktů/obrázků. Pokud máte pochybnosti jak správně vlastní formát nastavit, je vhodné nastavení konzultovat se supportem.

2. Kde lze vlastní formát vytvořit a spravovat#

Vlastní formát můžete v Mergadu definovat dvěma způsoby: přímo při zakládání projektu nebo v samostatné sekci určené pro práci s vlastními formáty. Oba přístupy se vzájemně doplňují a umožňují vytvořit i později znovu použít libovolnou definici formátu.

Definice při tvorbě projektu#

V rámci zakládání projektu lze určit vlastní formát jak pro vstupní feed, tak pro výstupní feed. Tato možnost se objeví vždy, když Mergado nedokáže přiřadit vstupnímu souboru žádný integrovaný formát, případně když potřebujete vytvořit specifický výstup.

Vlastní formát na vstupu#

K vytvoření vlastního formátu pro vstupní feed se dostanete ve 3. kroku průvodce založením projektu. Pokud systém pozná strukturu připojeného feedu, nabídne možnost detekovaný formát změnit tlačítkem Vybrat jiný formát, a následně máte možnost buď vybrat jiný oficiální formát ze selectboxu, nebo právě pro vstupní feed vytvořit vlastní formát pomocí tlačítka Definovat vlastní formát.

Pokud systém nepozná strukturu připojeného feedu, nabídne možnost buď vybrat oficiální formát ze selectboxu ručně, nebo pro vstupní feed vytvořit vlastní formát pomocí tlačítka Definovat vlastní formát.

Při vytváření vlastního formátu pro vstupní feed systém nabízí dva přístupy:

• Zjednodušený průchod – vhodný pro rychlé nastavení základní struktury.
• Podrobné nastavení – umožňuje detailní mapování všech nalezených elementů.

Oba způsoby vedou ke stejnému cíli: určit, kde začíná feed, které elementy představují jednotlivé produkty a který element obsahuje unikátní hodnotu u všech produktů.

Pro správné zpracování vstupního feedu je nutné namapovat alespoň:

• kořenový element (CHANNEL),
• obalovací element produktů (ITEM),
• identifikátor produktu (ITEM_ID) – element s unikátní hodnotou pro každou položku.

Samozřejmě můžete namapovat i všechny elementy ze vstupního feedu, což vám může ulehčit následnou práci (například snížit počet potřebných pravidel). Pro samotný import dat to však nutné není.

Vlastní formát na výstupu#

K vytvoření vlastního formátu pro výstupní feed se dostanete ve 4. kroku průvodce založením projektu. Použijte tlačítko Definovat vlastní formát. V dalším kroku je třeba vložit URL vzorového feedu, tedy šablony, podle které se vlastní formát nastaví a podle které bude výstupní feed vytvořen.

Pozor. Vzorový feed nejde nahrát Uploadem, URL adresa je povinná. Pokud tedy máte šablonu jako soubor, vytvořte URL adresu pomocí cloudového úložiště, např Dropbox, nebo můžete využít rozšíření Mergado Files.

Máte-li vlastní formát již připravený, můžete jej vybrat jako výstupní formát projektu. Tím určíte, jak bude vypadat finální XML nebo CSV, bez ohledu na to, zda Mergado daný formát běžně podporuje. Pokud byl formát vytvořen ze vzorového feedu, Mergado zachová kořenové elementy i jejich uspořádání.

Při vytváření vlastního formátu pro výstupní feed systém nabízí pouze jeden přístup:

• Podrobné nastavení – umožňuje detailní mapování všech nalezených elementů.
• Zjednodušený průchod zde není dostupný

Pro správné vytvoření výstupního feedu je nutné namapovat alespoň:

• kořenový element (CHANNEL),
• obalovací element produktů (ITEM).

V tomto případě Mergado výstupní feed připraví, vytvoří všechny elementy z šablony do projektu, ale protože neví co jednotlivé elementy znamenají, elementy nenaplní a je třeba to nastavit ručně pomocí pravidel.

Samozřejmě můžete namapovat i všechny ostatní elementy ze vzorového feedu, což vám může ulehčit následnou práci (například snížit počet potřebných pravidel).

Sekce „Vlastní formáty“ v hlavním menu#

Samostatnou správu vlastních formátů najdete v levém menu Mergado Editoru v záložce Vlastní formáty, pokud stojíte na úrovni uživatele (levé menu se mění podle toho, zda spravujete uživatele, eshop, nebo projekt). Tato sekce slouží jako centrální místo pro práci se všemi formáty vytvořenými v účtu.

Zde je možné:

• vytvořit nový formát bez návaznosti na konkrétní projekt,
• zadat URL vzorového souboru (example feed),
• provést mapování elementů,
• upravit nebo znovu analyzovat již existující formát.

Tato sekce slouží jako centrální místo, kde můžete vlastní formáty udržovat, testovat a připravovat pro použití v dalších projektech.

Opakované použití vlastních formátů#

Jakmile vlastní formát vytvoříte – ať už v průvodci, nebo v samostatné sekci – uloží se v Mergadu a můžete jej používat libovolně dlouho, a to:

• na vstupu, pokud chcete zpracovat další feed se stejnou strukturou,
• na výstupu, pokud potřebujete generovat nový feed ve stejné podobě.

Pokud už máte uložený alespoň jeden vlastní formát, je při vytváření dalšího nového vlastního formátu k dispozici také funkce Předvyplnit dle, která umožní převzít strukturu (nastavené mapování) již existujícího formátu. Tím se urychlí práce v případech, kdy pracujete s více formáty, které mají podobné schéma.

FAQ#

Kde mohu v Mergadu vytvořit vlastní formát?#

Vlastní formát můžete vytvořit dvěma způsoby – přímo při zakládání projektu nebo v samostatné sekci Vlastní formáty v levém menu. Oba způsoby se doplňují a umožňují připravit formát buď rychle během práce na projektu, nebo jej vytvořit dopředu. Formát je po uložení dostupný pro opakované použití ve všech projektech.

Jak vytvořím vlastní formát na vstupu při zakládání projektu?#

Ve 3. kroku průvodce založením projektu Mergado nabídne vytvoření vlastního formátu tehdy, pokud nepozná strukturu feedu nebo pokud ručně vyberete možnost “Vybrat jiný formát”. Následně můžete buď použít zjednodušený průchod, nebo podrobné nastavení. Stačí namapovat CHANNEL, ITEM (u XML feedů) a ideálně i identifikátor produktu, aby mohl projekt správně pracovat s položkami.

Co je nutné minimálně namapovat, aby mohl Mergado feed načíst?#

Pro minimální funkčnost je nutné namapovat CHANNEL, ITEM (u XML feedů) a jeden element s unikátní hodnotou (nejčastěji ITEM_ID). To stačí k tomu, aby Mergado dokázalo identifikovat začátek dokumentu, jednotlivé produkty a jejich jednoznačný klíč. Ostatní elementy je možné doplnit později.

Jak vytvořím vlastní formát na výstupu?#

Vytváří se ve 4. kroku založení projektu pomocí volby Definovat vlastní formát. Je nutné vložit URL vzorového XML souboru (example feedu), podle kterého Mergado sestaví strukturu výstupu. Poté mapujete alespoň základní elementy a formát uložíte pro použití v projektu.

Proč musím mít vzorový feed dostupný na URL adrese?#

Mergado výstupní formát vytváří výhradně ze souboru dostupného přes URL, protože potřebuje strukturu importovat při analýze. Nahrání souboru přes upload není podporováno. Pokud nemáte vlastní hosting, můžete použít cloudovou službu (Dropbox, One Drive) nebo vytvořit soubor pomocí Mergado Files.

Proč se u výstupního formátu nenabízí zjednodušený průchod?#

U výstupního formátu je vždy k dispozici pouze podrobné nastavení. Je to záměr, protože cílová struktura vychází ze vzorového feedu a je potřeba plně kontrolovat převod do šablony. Zjednodušené mapování by u výstupu nemuselo být dostatečně přesné.

Co se stane, když při tvorbě výstupního formátu namapuji jen minimum?#

Mergado vytvoří výstupní feed s kořenovými elementy ze šablony, v projektu vytvoří prázdné elementy podle šablony, ale elementy bez namapování nebudou vyplněny žádnými hodnotami. Tyto hodnoty je pak nutné doplnit ručně pravidly. Proto je vhodné doplnit mapování pro co nejvíce elementů ze vzorového feedu.

K čemu slouží sekce „Vlastní formáty“ v levém menu?#

Tato sekce slouží k centrální správě všech vlastních formátů v účtu. Můžete zde vytvářet nové formáty, upravovat existující, a aktualizovat jejich strukturu Je to nejvhodnější místo pro přípravu formátů, které budete v budoucnu opakovaně používat.

Je možné používat jeden vlastní formát v různých projektech?#

Ano, každý uložený vlastní formát je dostupný pro opakované použití. Můžete jej použít na vstupu i na výstupu v libovolném počtu projektů. To je užitečné zejména tehdy, když pracujete s více feedy, které sdílejí stejnou strukturu.

K čemu slouží možnost „Předvyplnit dle“ při tvorbě nového formátu?#

Umožňuje převzít strukturu (mapování elementů) z dříve vytvořeného vlastního formátu. Je ideální, pokud pracujete s více formáty se stejným nebo podobným schématem. Díky tomu nemusíte při každém novém formátu začínat od nuly.

3. Zjednodušený průchod vs. Podrobné nastavení při definici vlastního formátu#

Při vytváření vlastního formátu na vstupu v rámci průvodce vytvoření nového projektu můžete pracovat dvěma způsoby: buď použijete zjednodušený průchod, nebo přejdete do podrobného nastavení. Oba přístupy slouží ke stejnému cíli – vysvětlit Mergadu strukturu feedu – ale liší se tím, jakou míru kontroly a kolik možností uživateli nabízejí.

Zjednodušený průchod je vhodný pro rychlé zpracování feedů. Podrobné nastavení poskytuje úplnou kontrolu nad mapováním elementů i konfigurací formátu.

1. Zjednodušený průchod#

Zjednodušený průchod se zobrazí pouze při vytváření vlastního formátu na vstupu v rámci průvodce vytvoření nového projektu. Wizard uživateli nabídne rychlou cestu, jak základní strukturu definovat. Cílem je zjednodušit nastavení vlastního formátu pro nové uživatele nabídkou mapování jen těch nejdůležitějších elementů a skrytí pokročilého nastavení, které lze změnit později.

Kdy se používá#

• V rámci průvodce vytváření nového projektu při nastavení formátu vstupního feedu.
• Když chcete co nejrychleji vytvořit funkční mapování.

Co zjednodušený průchod nabízí#

• Zobrazení základních elementů v přehledné podobě.
• Zvýraznění klíčových prvků používaných reklamními kanály.
• Srozumitelnější názvy elementů než v technickém zobrazení.
• Chytré mapování, které se pokusí automaticky přiřadit elementy podle názvů a významu.

Jak funguje chytré mapování#

Systém navrhne párování — např. description → DESCRIPTION, EAN → EAN, ID → ITEM_ID. Uživatel poté pouze zkontroluje správnost návrhů a případně upraví jednotlivé volby.

Kdy je zjednodušený průchod ideální#

• Když potřebujete rychle začít pracovat s daty.
• Když se struktura feedu převážně drží běžných konvencí.
• Když jde o jednorázové nebo méně komplexní mapování.

2. Podrobné nastavení (kompletní definice vlastního formátu)#

Podrobné nastavení je plná verze rozhraní pro definici vlastního formátu. Obsahuje veškeré možnosti, které lze u mapování elementů využít.

Kdy se používá#

• Feed má složitou nebo netypickou strukturu.
• Je nutné přesně kontrolovat, jak se každý element zpracuje.
• Připravujete formát pro opakované použití nebo pro výstupní feed.
• Je potřeba definovat význam podelementů, variant nebo parametrů.

Co zahrnuje podrobné nastavení#

1. Parametry vlastního formátu

Obecná konfigurace, která určuje chování formátu:

• vhodný název formátu,
• nastavení státu (vliv na měny),
• možnost převzít nastavení z existujícího formátu,
• volba pro rozdělení variant na samostatné produkty,
• definice vlastního stromu kategorií.

2. Nastavení zpracování dat (mapování elementů)

Klíčová část, která určuje, jak Mergado interpretuje jednotlivé části feedu.

Zásadní elementy:

• kořenový element (např. CHANNEL)
• obalovací element produktů (např. ITEM)
• identifikátor produktu (např. ITEM_ID) – element s unikátní hodnotou pro každou položku

Další možnosti:

• přímé mapování na Mergado XML
• operace pro elementy bez podelementů (Propsat jak je, Skrýt, Význam elementu)
• speciální operace pro obalovací elementy (např. DELIVERY, PARAM, VARIANT)
• možnost namapovat libovolné množství elementů pro snadnější následnou práci v projektu

Porovnání zobrazení: Zjednodušený průchod vs. Podrobné nastavení#

Jaký postup zvolit#

• Použijte zjednodušený průchod, pokud potřebujete rychle založit projekt a feed má relativně přehlednou strukturu.
• Zvolte podrobné nastavení, pokud pracujete s komplexním feedem, připravujete šablonu pro výstup nebo potřebujete přesně definovat význam jednotlivých elementů.

FAQ#

Co je zjednodušený průchod při vytváření vlastního formátu?#

Zjednodušený průchod je variantou rozhraní ve 3. kroku průvodce, která nabízí pouze nejdůležitější elementy a rychlejší cestu k vytvoření funkčního mapování. Je navržen tak, aby uživatele nezahltil pokročilým nastavením a umožnil rychlý start i u neznámých feedů. Nabízí chytré mapování, které automaticky doporučí přiřazení elementů podle názvů a významu.

Kdy se zjednodušený průchod zobrazí?#

Zobrazí se výhradně při vytváření vlastního formátu na vstupu a jen tehdy, pokud Mergado nerozpozná strukturu feedu nebo uživatel zvolí definici vlastního formátu ručně. V těchto situacích je cílem urychlit základní nastavení tak, aby byl projekt co nejdříve připraven k práci. Podrobné nastavení lze vyvolat kdykoli.

Jak funguje chytré mapování v rámci zjednodušeného průchodu?#

Chytré mapování se pokusí automaticky přiřadit elementy podle jejich názvu a typického významu. Uživatel pouze zkontroluje navržené hodnoty a případně ručně upraví, jaký element má být spojen s ekvivalentem v Mergado XML. Tento krok výrazně urychluje práci zejména u běžných nebo jednodušších struktur feedů.

Kdy je vhodné použít zjednodušený průchod?#

Zjednodušený průchod je ideální, pokud potřebujete rychle začít pracovat s daty a feed má poměrně standardní strukturu. Vhodný je také tehdy, když jde o jednorázové zpracování nebo když nechcete hned na začátku řešit detailní nastavení. Pokud feed neobsahuje složitou hierarchii, často postačí právě tato varianta.

Co je podrobné nastavení vlastního formátu?#

Podrobné nastavení je plná varianta tvorby vlastního formátu, která umožňuje mapovat jednotlivé elementy i jejich podelementy s maximální přesností. Obsahuje také všechny parametry formátu, jako je stát, název nebo rozdělování variant, a umožňuje definovat chování složitějších struktur. Tento přístup je určen pro feedy s více úrovněmi nebo připravované výstupní formáty.

Kdy je vhodné použít podrobné nastavení?#

Podrobné nastavení je nejlepší volba tehdy, když feed obsahuje složitou, nestandardní nebo víceúrovňovou strukturu. Stejně tak je vhodné, pokud potřebujete úplně přesně kontrolovat, jak se budou data v projektu zpracovávat a exportovat. Je nezbytné také při přípravě formátu, který se bude používat opakovaně nebo na výstupu.

Jaké elementy je nutné namapovat v obou případech?#

Ať už použijete zjednodušený průchod, nebo podrobné nastavení, musíte vždy určit kořenový element (CHANNEL) (platí pro XML feedy), obalovací element produktu (ITEM) (platí pro XML feedy), a alespoň jeden identifikátor produktu (nejčastěji ITEM_ID). Tyto elementy jsou klíčem k tomu, aby Mergado dokázalo datový feed správně načíst a identifikovat jednotlivé položky. Mapa ostatních elementů závisí na tom, co budete v projektu potřebovat.

Co nabízí podrobné nastavení navíc oproti zjednodušenému?#

Podrobné nastavení umožňuje definovat význam každého elementu a nastavovat speciální operace u elementů s podelementy, například u parametrů, dopravy nebo variant. Navíc obsahuje všechny parametry formátu a nabízí možnost převzít strukturu z existujícího CF. Poskytuje tedy nejvyšší možnou přesnost převodu dat.

Jaký postup zvolit – zjednodušený nebo podrobný?#

Zjednodušený průchod zvolte tehdy, když jde o rychlé vytvoření projektu a feed má jednoduchou a čitelnou strukturu. Podrobné nastavení použijte v případě, že plánujete s daty pracovat dlouhodobě, nebo pokud je feed složitý a vyžaduje přesné mapování. Volba postupu závisí především na složitosti dat a na tom, zda je pro vás důležitější rychlost, nebo přesnost.

Může zjednodušený průchod nahradit podrobné nastavení?#

Ano, v mnoha jednodušších případech postačí. Pokud ale feed obsahuje varianty, parametry, vícestupňovou strukturu nebo plánujete další exporty, bude podrobné nastavení ve výsledku přesnější a stabilnější. Doporučuje se tedy začít zjednodušeným přístupem a přejít na detailní režim, pokud zjistíte, že je potřeba více kontroly.

4. Tvorba vlastního formátu – Detailní nastavení#

Detailní nastavení vlastního formátu je krok, ve kterém Mergadu přesně určíte, jak má interpretovat strukturu vašeho feedu. Na základě těchto informací vzniká převodník mezi vaším datovým formátem a Mergado XML. Tato fáze následuje po analýze struktury zdrojového souboru.

Analýza struktury feedu#

Při vytváření vlastního formátu Mergado nejprve načte a analyzuje připojený soubor. Z jeho struktury určí, které elementy je možné mapovat, a vytvoří jejich přehled.

Co analýza dělá#

• načte strukturu XML nebo CSV ze zadané URL
• identifikuje dostupné elementy i jejich strukturu
• připraví seznam elementů, které lze namapovat na Mergado XML

Aktualizace struktury#

Pokud se později ve vstupním souboru objeví nový element, je nutné jej do nastavení vlastního formátu doplnit. Slouží k tomu volba Aktualizovat strukturu ze souboru, která načte nové prvky a umožní u nich určit, jak se mají do Mergada propsat.

Nastavení základních parametrů vlastního formátu#

V této části určíte obecné parametry formátu. Tyto volby se netýkají jednotlivých elementů, ale chování formátu jako celku.

Dostupné parametry#

Mapování elementů (Nastavení zpracování dat)#

Tato část určuje, jak bude Mergado interpretovat elementy vašeho feedu. Mapování definuje vztah mezi konkrétním elementem a jeho ekvivalentem v Mergado XML.

Povinné elementy (platí pouze pro XML)#

Pro funkční zpracování feedu je nutné namapovat alespoň tyto dva prvky:

• CHANNEL – kořenový obal celého feedu,
• ITEM – obalovací element jedné položky.

Bez těchto dvou elementů nelze XML feed importovat.

Doporučené elementy#

Mergado umožňuje mapovat libovolné množství dalších elementů. Čím více prvků namapujete, tím méně práce budete mít později s pravidly a tím lépe lze feed převádět na jiné výstupní formáty.

Operace pro jednoduché elementy#

U elementů, které nemají podelementy, lze použít tři typy operací:

Operace pro obalovací elementy#

U elementů, které mají v sobě další strukturu, lze zvolit speciální operace, které zpřístupní nastavení pro jejich podelementy.

Příklady:

• DELIVERY – nastavíte cenu dopravy, název či kód dopravce,
• PARAM – definice parametrů produktu,
• VARIANT – práce s jednotlivými variantami položky.

Dopady mapování#

• Rozsáhlejší mapování usnadní následný export do jiných formátů.
• Minimální mapování vyžaduje více práce v pravidlech (kopírování a doplňování hodnot).
• Elementy umístěné mimo ITEM nelze zpracovat – Mergado je ignoruje.

FAQ#

Co znamená analýza struktury feedu při tvorbě vlastního formátu?#

Analýza je první krok, ve kterém Mergado načte soubor z URL a identifikuje všechny dostupné elementy. Z jejich hierarchie sestaví strukturu, kterou následně nabídne k mapování. Tento proces určuje, s čím lze ve vlastním formátu pracovat.

Co mám dělat, když se ve vstupním feedu objeví nový element?#

Je potřeba otevřít definici uloženého vlastního formátu a použít volbu „Aktualizovat strukturu ze souboru“. Tím se načte nový element do seznamu a vy můžete určit, jak se má v Mergadu zpracovat. Po uložení a přegenerování dat je nový element součástí projektu.

K čemu slouží základní nastavení vlastního formátu?#

Tyto parametry určují chování formátu jako celku a neřeší jednotlivé elementy. Patří sem název formátu, nastavení státu, volba pro práci s variantami nebo aktivace vlastního stromu kategorií. Správné nastavení parametrů zjednoduší jeho budoucí použití v dalších projektech.

Proč je důležité správně pojmenovat vlastní formát?#

Název formátu se zobrazuje v seznamu formátů a usnadňuje orientaci zejména v případě, že jich máte více. Dobře zvolený název umožní rychle identifikovat, pro jaký typ feedu byl formát vytvořen. Předejdete tím chybám při opakovaném použití.

Jak funguje volba „Předvyplnit dle“?#

Tato možnost zpřístupní existující vlastní formáty a umožní převzít jejich strukturu. Hodí se, pokud potřebujete vytvořit podobný formát nebo pracujete s feedy se stejným schématem. Díky tomu nemusíte vše mapovat od začátku.

Co znamenají operace „Propsat jak je“, „Skrýt“ a „Význam elementu“?#

• „Propsat jak je“ - Element se importuje a exportuje beze změn, pokud ho pravidlo Převodník nebo uživatel nenastaví jako skrytý.
• „Skrýt“ zajistí, že se Element importuje a nastaví se jako skrytý. Lze s ním pracovat v rámci pravidel, vytváření výběrů, nebo ho případně ručně odkrýt.
• „Význam elementu“ slouží k mapování elementu na ekvivalent v Mergado XML

Kdy se vyplatí mapovat i další elementy mimo povinných?#

Pokud plánujete export do jiných formátů nebo budete pracovat s daty v pravidlech, je detailní mapování výrazně přínosné. Méně namapovaných elementů znamená více práce při doplňování hodnot v projektu. Čím přesnější mapování, tím jednodušší další zpracování.

Jak fungují speciální operace pro obalovací elementy?#

Používají se tehdy, když má element vlastní vnořenou strukturu, například parametry, dopravu nebo varianty. Výběrem speciální operace zpřístupníte nastavení pro jejich podelementy. To umožňuje detailně definovat, jak mají být hodnoty těchto struktur zpracovány.

Proč Mergado ignoruje elementy mimo ITEM?#

Vlastní formát umí pracovat jen s částí XML, kterou tvoří jednotlivé položky produktu. Elementy nad ITEM, například informace mezi CHANNEL a ITEM, nejsou součástí modelu produktových dat. Proto se při importu ignorují a projekt nad nimi nemá kontrolu.

Jak poznám, že je mapování dostatečné?#

Pokud dokážete načíst feed, pracovat s daty bez nutnosti rozsáhlých pravidel a export je bez ztrát informací, je mapování nastaveno správně. Kritickým bodem je zachycení všech elementů, které budete později upravovat nebo exportovat. Pokud musíte často doplňovat hodnoty pravidly, mapování je pravděpodobně příliš stručné.

Jaký je vztah mezi mapováním a převodníkem?#

Mapování určujete vy a právě podle něj převodník převádí data do Mergado XML. Pokud nějaký element nenamapujete, převodník o něm „neví“ a nepracuje s ním. Dobré mapování tedy určuje kvalitu celého převedeného feedu.

5. Vlastní formát na vstupu#

Vlastní formát na vstupu slouží k načtení datových feedů, které Mergado nerozpozná, a k jejich převodu do interní struktury Mergado XML. Díky tomu lze v Mergadu zpracovat téměř libovolný XML nebo CSV soubor.

Kdy se používá vlastní formát na vstupu#

Potřeba definovat vlastní formát vzniká tehdy, když systém nedokáže určit strukturu vstupního feedu a zobrazí informaci, že formát není známý. V takové situaci nabídne vytvoření vlastního formátu.

Typické scénáře#

• Dodavatelské feedy nebo jinak strukturované XML/CSV,
• Custom feedy vytvořené na míru. Typicky u větších e-shopů.
• Zastaralé nebo výrazně upravené varianty známých formátů,
• Doplňkové feedy, například skladové nebo servisní,
• Feedy poskytující jiné typy služeb (recenze, cestovní nabídky).
• atd.

Postup vytvoření vlastního formátu při importu feedu#

Definice vlastního formátu probíhá ve 3. kroku průvodce zakládáním projektu.

1. Vytvořte nový projekt a vložte URL vstupního feedu.
2. Pokud Mergado strukturu nerozpozná, zvolte Definovat vlastní formát.
3. Namapujte povinné elementy:

• CHANNEL
• ITEM

4. Namapujte další elementy, se kterými budete v projektu pracovat (URL, NAME, ITEM_ID, …).
5. Formát pojmenujte a uložte.
6. Ve 4. kroku můžete

• Ponechat stejný vlastní formát i na výstup, struktura feedu se tak nebude měnit.
• Vybrat pomocí selectboxu jiný oficiální formát, např. Google, Meta aj.
• Vytvořit nový vlastní formát pro výstup.

7. V posledním kroku zkontrolujte, zda jsou vybrané párovací elementy. Pokud ne, je nutné je nastavit.

Nastavení párovacího elementu#

Párovací element je klíčovým údajem, který Mergado používá pro jednoznačnou identifikaci každé položky v projektu.

Co je důležité:

• Musí mít unikátní hodnotu pro každý produkt.
• Nejčastěji se používá element s ID produktů nebo jiný jednoznačný identifikátor (URL, EAN,..).
• V rekapitulaci kroků je nutné zkontrolovat, že je párovací element správně vybraný.

Párovací element funguje jako „rodné číslo“ pro každou položku. Umožňuje Mergadu bezpečně sledovat a zpracovávat jednotlivé produkty bez ohledu na to, jak se jejich hodnoty v průběhu práce mění.

Kolik elementů mapovat#

Minimum – pro funkcionalitu#

Pro import postačí namapovat pouze povinné elementy (CHANNEL, ITEM a případně ITEM_ID).

Maximum – pro efektivitu#

Namapovat více elementů znamená jednodušší práci v dalších krocích projektu.

Výhody detailního mapování:

• méně potřebných pravidel pro kopírování hodnot,
• rychlejší převod do jiných výstupních formátů,
• lepší čitelnost a stabilita projektu.

Příklad dopadu: Pokud nenamapujete element s názvem produktu, musíte ho později do formátu doplnit pravidlem. Pokud jej namapujete už při definici CF, Mergado ho pak správně automaticky převede do výstupního feedu.

Aktualizace struktury při změnách feedu#

Pokud se u vstupního feedu objeví nové elementy, uložený vlastní formát je automaticky nepřevezme. Je potřeba:

1. Otevřít daný vlastní formát.
2. Kliknout na Aktualizovat strukturu ze souboru.
3. Nově nalezeným elementům přiřadit způsob zpracování.
4. Uložit a projekty s tímto vlastním formátem přegenerovat.

Tím zaručíte konzistentní zpracování feedu i po jeho změnách.

FAQ#

Kdy je potřeba použít vlastní formát na vstupu?#

Vlastní formát použijete tehdy, když Mergado nedokáže rozpoznat strukturu vstupního feedu a zobrazí informaci, že formát není známý. Typicky jde o dodavatelské, custom, zastaralé nebo výrazně upravené feedy. V těchto situacích je nutné Mergadu vysvětlit strukturu dat, aby je dokázal zpracovat.

Jaké typy feedů nejčastěji vyžadují vlastní formát na vstupu?#

Nejčastěji jde o dodavatelské a custom feedy, které nemají veřejnou specifikaci nebo se liší od standardů. Patří sem také doplňkové feedy, například skladové, servisní nebo feedy obsahující služby jako recenze či cestovní nabídky. Vlastní formát se používá i u upravených či zastaralých verzí jinak známých formátů.

Jak probíhá vytvoření vlastního formátu při importu?#

Vytvoření probíhá ve 3. kroku průvodce založením projektu, kde zvolíte možnost „Definovat vlastní formát“. Následně namapujete povinné elementy CHANNEL a ITEM (u XML feedů) a další položky, se kterými budete v projektu pracovat. Na závěr formát uložíte.

Co je párovací element a proč je tak důležitý?#

Párovací element je údaj, který umožňuje Mergadu jednoznačně identifikovat každou položku. Musí mít unikátní hodnotu pro každý produkt – nejčastěji jde o ITEM_ID, URL nebo EAN. Bez správně nastaveného párovacího elementu nelze feed importovat správně ani správně párovat změny.

Kolik elementů je vhodné při definici vlastního formátu namapovat?#

Pro základní funkčnost stačí namapovat CHANNEL, ITEM (u XML feedů) a jeden unikátní identifikátor. Pokud ale chcete minimalizovat pozdější práci, je vhodné namapovat i další elementy, protože to zjednoduší práci s pravidly a usnadní převod na jiné výstupní formáty. Detailní mapování zvyšuje stabilitu a přehlednost projektu.

Co se stane, když nenamapujete některé důležité elementy?#

Nenamapované elementy se v projektu sice objeví, ale Mergado je nebude umět správně využít a bude je potřeba doplňovat ručně pomocí pravidel. To vede k vyšší pracnosti a může způsobit chyby při exportu. Přesné mapování proto výrazně usnadní pozdější práci.

Jak postupovat, když se ve vstupním feedu objeví nová datová pole?#

Je nutné otevřít definici vlastního formátu a použít volbu „Aktualizovat strukturu ze souboru“. Mergado načte nové elementy a vy jim přiřadíte způsob zpracování. Poté projekt přegenerujete, aby se změny projevily.

Může se vlastní formát použít i tehdy, když Mergado formát pozná?#

Ano, v některých případech může být výhodné vytvořit vlastní formát i u rozpoznaného feedu, například pokud chcete zachovat původní strukturu nebo potřebujete pracovat s prvky, které standardní převodník nebere v úvahu. V takovém případě jednoduše zvolíte možnost „Vybrat jiný formát“ a následně definujete vlastní.

Co dělat, pokud si nejsem jistý, zda je vlastní formát nastaven správně?#

Doporučuje se zkontrolovat načtené elementy, párovací element a strukturu výstupního feedu projektu. Pokud vidíte všechny hodnoty, se kterými potřebujete pracovat, a data se správně párují, je formát v pořádku. Pokud narazíte na potíže, je lepší se vrátit do mapování nebo kontaktovat podporu.

6. Použití vlastního formátu na výstupu#

Vlastní formát na výstupu slouží k tomu, aby Mergado dokázalo generovat produktový feed v takové struktuře, kterou standardně nepodporuje. Vhodný je všude tam, kde potřebujete mít výstupní soubor přesně podle specifických požadavků platformy, systému nebo interních procesů.

Kdy se výstupní vlastní formát používá#

Výstupní vlastní formát využijete především v situacích, kdy:

• potřebujete feed pro platformu, která není v Mergadu integrována,
• vytváříte napojení na nový e-commerce kanál,
• pracujete s menšími srovnávači nebo interními systémy s vlastní strukturou dat,
• je nutné docílit konkrétní struktury kořenových elementů (např. …).

Výstupní vlastní formát umožňuje definovat podobu výsledného feedu tak, aby přesně odpovídala požadovanému formátu.

Co je vzorový feed a proč je potřebný#

Výstupní vlastní formát se vytváří na základě vzorového feedu – což je vzorový XML nebo CSV soubor obsahující alespoň jednu položku.

Proč je vzorový feed důležitý#

• Slouží jako šablona, podle které se Mergado naučí, jak má finální feed vypadat.
• Definuje kořenové elementy, které chcete mít v cílové struktuře.
• Může být zcela fiktivní – postačí jediná fiktivní položka, na jejichž hodnotách nezáleží.

Požadavky na vzorový feed#

• Musí být dostupný pod URL adresou.
• Musí obsahovat kořenovou strukturu, kterou chcete na výstupu.
• Může mít minimální obsah, například:

<?xml version="1.0" encoding="UTF-8"?> <PRODUCTS> <PRODUCT> <ID>1</ID> </PRODUCT> </PRODUCTS>

Jak vytvořit vzorový feed#

Existují dva způsoby:

1. Ruční vytvoření souboru#

• připravíte XML v textovém editoru, nebo CSV v tabulkovém editoru
• uložíte jej na server
• zpřístupníte pod URL adresou

2. Pomocí doplňku Mergado Files#

• aktivujete rozšíření Mergado Files
• vytvoříte nový soubor
• vložíte ukázkovou položku, kterou získáte například od srovnávačů
• uložíte jej jako XML nebo CSV
• získáte URL, kterou použijete při definici formátu

Mergado Files je ideální, pokud potřebujete vzorový feed rychle upravovat nebo testovat.

Postup vytvoření vlastního formátu na výstupu#

Vlastní formát na výstup se vytváří buď dopředu v sekci Vlastní formáty v levém menu na úrovni uživatele, nebo přímo během vytváření nového projektu ve 4. kroku wizardu.

1. Otevřete Vlastní formáty a klikněte na Nový vlastní formát.
2. Do pole Zdrojový soubor vložte URL vzorového feedu.
3. Formát pojmenujte.
4. Namapujte elementy:

• minimem je nastavení kořenových obalovacích elementů (CHANNEL, ITEM),
• doporučuje se namapovat všechny elementy, které budete generovat ve výstupu.

5. Uložte formát.

Po uložení se vlastní formát stává opakovaně použitelným. V každém projektu jej lze vybrat jako výstupní (i jako vstupní) formát.

Jak Mergado generuje výstupní feed podle vlastní šablony#

Výstupní vlastní formát určuje finální strukturu feedu. Mergado při generování výstupu:

• použije kořenové elementy přesně tak, jak byly uvedeny ve vzorovém feedu,
• využije definované mapování pro převod hodnot z vašeho vstupního feedu do výsledného formátu,
• zachová pořadí a strukturu elementů podle šablony.

Díky tomu lze rychle vytvořit libovolný XML nebo CSV feed bez nutnosti vývoje nové integrace ze strany Mergada.

Efektivita mapování#

Ačkoliv pro výstupní feed stačí namapovat minimum, výhodnější je definovat mapování co nejpodrobněji:

• získáte lepší kontrolu nad výsledkem,
• snížíte potřebu pravidel pro doplňování hodnot,
• umožníte snazší opakované použití formátu v dalších projektech.

FAQ#

Kdy má smysl použít vlastní formát na výstupu?#

Vlastní formát na výstupu použijete vždy, když potřebujete feed ve struktuře, kterou Mergado standardně nenabízí. Typicky jde o napojení na novou platformu, menší srovnávač nebo interní systém s vlastní strukturou. Umožňuje vám přesně řídit podobu výstupního XML nebo CSV, včetně kořenových elementů.

Co je vzorový (example) feed a k čemu slouží?#

Vzorový feed je ukázkový XML nebo CSV soubor, který obsahuje alespoň jednu položku a odpovídá cílové struktuře, kterou chcete generovat. Mergado podle něj načte kořenové elementy, vnitřní strukturu a pořadí elementů. Slouží jako šablona, podle které se výstupní feed následně generuje.

Musí být vzorový feed reálný, nebo může být fiktivní?#

Vzorový feed může být zcela fiktivní – stačí jedna položka s minimem hodnot. Důležité je, aby měl správnou strukturu elementů, ne konkrétní data. Hodnoty jako ID, název nebo cena jsou v tomto kontextu pouze ukázkové.

Proč musí být vzorový feed dostupný na URL adrese?#

Mergado načítá strukturu přímo z URL, aby ji mohlo při analýze použít jako zdroj pro definici formátu. Nahrání souboru bez URL není možné. Pokud nemáte vlastní hosting, můžete použít cloudové služby nebo doplněk Mergado Files.

Jakým způsobem mohu vzorový feed vytvořit?#

Buď si připravíte XML nebo CSV v textovém/tabulkovém editoru a uložíte jej na server s veřejnou URL, nebo použijete rozšíření Mergado Files. V Mergado Files vytvoříte nový soubor, vložíte ukázkovou položku, uložíte jej ve správném formátu a získáte URL pro použití ve vlastním formátu. Druhá možnost je vhodná, pokud potřebujete vzorový feed průběžně upravovat.

Jak probíhá vytvoření vlastního formátu na výstupu?#

V sekci Vlastní formáty zvolíte „Nový vlastní formát“ a jako zdrojový soubor zadáte URL vzorového feedu. Po analýze souboru formát pojmenujete a namapujete potřebné elementy, minimálně CHANNEL a ITEM. Uložený formát pak můžete vybrat jako výstupní formát v libovolném projektu. Alternativně můžete vlastní formát vytvořit přímo během vytváření nového projektu ve 4. kroku wizardu kliknutím na Definovat vlastní formát a vložem URL vzorového feedu. Po uložení vlastního formátu se vrátíte zpět do wizardu kde bude vytvořený vlastní formát vyplněn jako výstupní formát.

Jak Mergado použije vlastní formát při generování výstupního feedu?#

Při exportu Mergado vychází ze šablony načtené ze vzorového feedu, zachová jeho kořenové elementy i strukturu. Pomocí mapování převede hodnoty z Mergado XML do správných elementů ve výstupu. Výsledkem je feed v podobě, která odpovídá vašim požadavkům bez nutnosti vlastního programování.

Co se stane, pokud ve výstupním formátu namapuji jen minimum elementů?#

Mergado sice vytvoří výstupní feed se správnou strukturou, ale elementy nebudou naplněny daty. Hodnoty nenamapovaných elementů bude nutné doplnit pravidly nebo dalším nastavením v projektu. Takový postup je funkční, ale méně efektivní při dlouhodobém používání.

Proč je vhodné mapovat co nejvíce elementů i na výstupu?#

Detailní mapování vám dává lepší kontrolu nad tím, jak se data do výstupu zapisují, a snižuje množství pravidel, která musíte v projektu vytvářet. Zároveň zjednodušuje opakované použití stejného formátu v dalších projektech. Vyplatí se zejména v situacích, kdy formát slouží více klientům nebo více e-shopům.

Lze výstupní vlastní formát použít i jako vstupní?#

Ano, jakmile je formát jednou vytvořen, je k dispozici v seznamu formátů pro vstup i výstup. To může být užitečné například při transformacích mezi různými interními systémy nebo při kontrole dat.

7. Práce se složitějšími XML strukturami#

Tato sekce popisuje situace, kdy datový feed obsahuje prvky umístěné mimo obvyklou strukturu produktů, tedy mimo element ITEM. U těchto feedů naráží vlastní formát na určitá omezení a je nutné použít alternativní postupy.

Omezení vlastního formátu při importu#

Vlastní formát dokáže pracovat pouze s elementy umístěnými uvnitř zvoleného obalovacího elementu položky (ITEM). Prvky, které se v hierarchii nacházejí nad ním nebo mimo něj, Mergado Editor ignoruje.

Informace mezi CHANNEL a ITEM#

• Některé XML feedy obsahují další úroveň dat mezi CHANNEL a ITEM (např. kategorie, doprava, metadata).
• Tyto elementy nejsou součástí samotné položky, a proto nejsou při importu načteny.

Typické příklady problémových feedů#

• XML feedy s globálními informacemi o kategoriích uloženými mimo produkty.
• Datové zdroje, kde jsou informace o dopravě definovány na úrovni CHANNEL.
• Komplexní feedy s vícestupňovou strukturou mezi kořenovým elementem a jednotlivými položkami.

Řešení: dvouprojektový model + Blending Bull#

Pokud je potřeba zachovat celou strukturu XML feedu, včetně prvků mimo ITEM, lze použít dvoustupňový postup:

1. První projekt – obsahuje produkty.
2. Druhý projekt – obsahuje doplňkové informace, které nejsou součástí ITEM.
3. Sloučení – výstupní data obou projektů se spojí pomocí rozšíření Blending Bull.

Jak dvouprojektový model funguje#

Sloučení pomocí Blending Bull#

1. Aktivujte rozšíření Blending Bull.
2. V části Datové zdroje vyberte výstupy obou projektů.
3. V sekci Soubory vytvořte nový výstupní soubor a následně vyberte vytvořené datové zdroje z předchozího kroku.
4. Dle potřeby doplňte úpravy pomocí pravidel.

Proč tento postup funguje#

Každý projekt načte pouze tu část struktury, se kterou Mergado umí pracovat. Blending Bull následně umožní obě části znovu spojit a získat kompletní datový výstup.

Editace kořenových elementů na výstupu#

Kořenové elementy výstupního feedu nelze v Mergadu přímo upravit. Pokud potřebujete jinou strukturu obalových elementů, existují dvě alternativy: úprava přes Blending Bull, nebo vytvoření vlastní šablony.

Úpravy přes Blending Bull#

Blending Bull umožňuje pracovat s výstupním feedem jako s textovým souborem. Díky tomu lze upravovat:

• kořenové elementy,
• záhlaví,
• patičku,
• názvy elementů.

Pravidla typu „Najít a nahradit“

Pomocí pravidel v Blending Bullu lze provést hromadné změny názvů elementů. Například:

• SHOP → PRODUCTS, SHOPITEM → PRODUCT.

Tím lze snadno upravit výstupní strukturu bez nutnosti zásahu do projektu samotného.

Alternativy k Blending Bullu (pro kontrolu výstupní struktury)#

Existují dva další způsoby, jak ovlivnit strukturu výstupu:

1. Vytvoření šablony pomocí vlastního formátu

• Použijete fiktivní nebo existující feed s požadovanými kořenovými elementy.
• Tento feed použijete při tvorbě vlastního formátu na výstup.
• Mergado poté zachová kořenové elementy přesně tak, jak byly v example feedu.

2. Požádání o přidání nového integrovaného formátu

• Pokud máte specifikaci cílového formátu, lze kontaktovat podporu Mergada.
• Formát může být přidán mezi oficiálně podporované integrace.
• Následně jej lze vybrat jako běžný výstupní formát.
• Přidání nového formátu ale musí projít prioritizačním procesem a může trvat déle.

FAQ#

Proč Mergado ignoruje některé elementy ve vstupním XML feedu?#

Vlastní formát dokáže pracovat pouze s elementy, které jsou umístěny uvnitř obalovacího elementu položky (ITEM). Vše, co je mimo něj – například elementy mezi CHANNEL a ITEM – se při importu nezpracuje. Tyto informace nejsou součástí produktových dat, a proto je Editor nevidí.

Jak poznám, že je feed problémový a vyžaduje speciální postup?#

Nejjednodušší postup je otevřit si výstupní feed a provnat to se vstupním feedem. Typické příklady jsou feedy, kde jsou kategorie, doprava nebo další metadata umístěny na úrovni CHANNEL nebo v několika vrstvách nad ITEM. Pokud po importu některé důležité údaje chybí, je to známka toho, že se nacházejí mimo strukturu, kterou Mergado umí načíst. V takových situacích je nutné použít alternativní postup.

Co je dvouprojektový model a kdy ho použít?#

Dvouprojektový model se používá, když potřebujete zachovat nebo zpracovat části XML feedu, které nepatří pod ITEM. Jeden projekt načte produkty a druhý načte doplňkové informace. Následně se oba výstupy spojí pomocí rozšíření Blending Bull.

Jak dvouprojektový model prakticky funguje?#

V projektu s produkty namapujete CHANNEL a ITEM představující jednotlivé položky. V projektu se specifikacemi ponecháte stejný CHANNEL, ale jako ITEM zvolíte obalový element doplňkových informací. Oba projekty načítají stejný vstupní feed a Blending Bull je následně spojí do jednoho výstupu.

Proč je Blending Bull nezbytný pro sloučení složitých struktur?#

Mergado samo o sobě nedokáže zkombinovat data ze dvou různých projektů s různými objekty (produkty). Blending Bull vytvoří výstupní soubor, do kterého můžete přidat oba výstupy a případně je ještě upravit pomocí pravidel. Díky tomu získáte kompletní datovou strukturu, která odpovídá původnímu feedu.

K čemu slouží pravidla typu „Najít a nahradit“ v Blending Bullu?#

Pomocí těchto pravidel lze hromadně měnit názvy elementů, kořenové tagy nebo části záhlaví a patičky. Je to řešení pro případy, kdy potřebujete upravit výstupní feed tak, aby odpovídal specifickému formátu. I tímto způsobem můžete například přejmenovat SHOP na PRODUCTS nebo jiné klíčové elementy.

Lze v Mergadu přímo upravit kořenové elementy výstupního feedu?#

Ne, kořenové elementy nelze ve standardním rozhraní přímo editovat. Lze je ovlivnit buď tak, že vytvoříte vlastní formát na základě vzorového feedu, nebo pomocí úprav v Blending Bullu. Oba postupy zajistí správnou podobu výstupní struktury.

Kdy má smysl vytvořit vlastní šablonu pomocí výstupního vlastního formátu?#

Pokud máte jasně danou strukturu výstupního XML, například specifikaci partnera nebo vlastního systému, je výstupní vlastní formát nejčistším řešením. Definicí formátu podle vzorového feedu zajistíte, že Mergado vždy vygeneruje data v požadovaném tvaru. Tento postup je nejstabilnější pro dlouhodobé použití.

Je možné požádat o přidání nového oficiálního formátu do Mergada?#

Ano, pokud máte dokumentaci a jasnou specifikaci cílového formátu, můžete požádat podporu o přidání mezi oficiální integrace. Tento proces ale podléhá prioritizaci a může trvat déle. Pokud potřebujete výsledek rychle, výstupní vlastní formát nebo Blending Bull je rychlejší cesta.

Jak poznám, že je nutné použít dvouprojektový model?#

Pokud po importu chybí informace, které se nacházejí mimo ITEM, nebo pokud feed obsahuje více úrovní nad produkty, je dvouprojektový model obvykle jediným způsobem, jak zachovat kompletní strukturu. Stejně tak je nutný tehdy, pokud potřebujete kombinovat produktová data s globálními informacemi uloženými mimo samotné položky.

8. Vysvětlení pojmů#

Mergado XML jako univerzální jazyk#

Mergado XML funguje jako univerzální meziformát, přes který Mergado převádí všechna produktová data. Není nutné mít pro každý vstupní a výstupní formát samostatný převodník – stačí jedna společná struktura, do které se data přeloží.

Vlastní formát jako slovník a gramatická pravidla#

Vlastní formát určuje, jak jednotlivé elementy vašeho feedu „přeložit“ do Mergado XML. Jedná se o sadu pravidel, která umožní Mergadu rozpoznat strukturu téměř jakéhokoli feedu.

Vzorový feed jako cílový jazyk#

Při tvorbě výstupního formátu slouží vzorový feed jako definice toho, jak má výsledná struktura vypadat. Mergado z něj načte:

• kořenovou strukturu,
• názvy elementů,
• organizaci položek.

Tím získáte výstupní feed přesně podle vlastní specifikace.

Příklady převodů#

• Import (dodavatelský feed → formát e-shopu)
  • Mergado připraví strukturu tak, aby byla kompatibilní s formátem e-shopu, včetně cen, dostupností nebo parametrů.
• Export (interní data → Heureka, Google, vlastní platformy)
  • Pokud platforma nenabízí přímý export, lze pomocí vlastního formátu vytvořit výstup, který splní požadovanou specifikaci.