XML feed - specifikace
XML feed je datový soubor, který obsahuje informace o jídelní/obědové nabídce Vaší restaurace v jednotlivých dnech.
Feed je nejčastěji generován přímo z databáze webu. Nevíte-li, jak XML feed získat, poraďte se se svým webmasterem, nebo se obraťte na poskytovatele platformy pro váše webové řešení.
Aby mohlo dojít k importu vaší obědové nabídky do našeho systému, je zapotřebí mít vytvořený tzv. XML soubor (nebo-li XML FEED), což je jednoduchý datový formát, pomocí kterého nám předáte informace o vaší obědové nabídce. XML soubor je automaticky generován z vašich stránek, a proto jeho vytvoření či úpravy konzultujte se svým webmasterem.
Může vypadat třeba takto:
<?xml version="1.0" encoding="utf-8"?>
<MENICKA>
<MENU>
<DATUM>10.11.2020</DATUM>
<JIDLO>
<TYP>polevka</TYP>
<NAZEV>Fazolová</NAZEV>
<CENA>20</CENA>
<ALERGEN>1,2,3,4</ALERGEN>
<FOTO>https://menicka.cz/fazolova-polevka.jpg</FOTO>
</JIDLO>
</MENU>
<MENU>
<DATUM>10.11.2020</DATUM>
<JIDLO>
<TYP>jidlo</TYP>
<NAZEV>Zeleninový salát s kuřecím masem</NAZEV>
<CENA>80</CENA>
<ALERGEN>1,2,3,4</ALERGEN>
<FOTO>https://menicka.cz/zeleninovy-salat.jpg</FOTO>
</JIDLO>
</MENU>
<MENU>
<DATUM>10.11.2020</DATUM>
<JIDLO>
<TYP>poznamka</TYP>
<NAZEV>K obědovému menu voda ZDARMA</NAZEV>
</JIDLO>
</MENU>
</MENICKA>
Význam jednotlivých značek v XML feedu
MENICKA
Kořenový element, v souboru je obsažen pouze jednou.
MENU
Element obsahuje informace o konkrétní polední nabídce, v souboru je obsažen tolikrát, kolik chcete importovat dnů. Např. v případě, že máte zadáno polední menu od pondělí do pátku je nutné do XML uvést 5x POLOZKA.
DATUM
Tento element určuje datum pro který se vztahuje tato konkrétní nabídka.
JIDLO
Konkrétní položka meníčka. Opakuje se tolikrát, kolik obědových položek ve zvoleném dnu máte.
Obsahuje tagy:- TYP - řetězec identifikující typ záznamu. Možné varianty jsou polévka pro označení polévky, jídlo pro označení hlavního jídla případně poznámka pro doplňující informaci.
- NAZEV - řetězec obsahující název jídla
- CENA - řetězec určující cenu jídla. Pokud položka cenu neobsahuje nemusí se uvádět.
- ALERGEN - řetězec obsahuje seznam alergenů daného jídla. Čísla alergenů oddělte čárkou. Tento řetězec není povinný.
- FOTO - řetězec obsahuje URL adresu s fotkou jídla. Podporované jsou formáty JPG a PNG. Max. velikost souboru je 3 MB a 3000px. Tento řetězec není povinný.
Zpracování XML souboru
Váš XML soubor stahujeme každý den v 06:00, abychom vždy zajistili aktuální nabídku. Z vaší strany je třeba vždy zajistit aktuálnost souboru, aby data byla co nejrelevantnější.
Pokud se nepodaří XML feed stáhnout, případně nebudete mít ještě v XML feedu zadány relevantní data, nic se neděje. Opakované stažení proběhne v 10:00, 11:00, 12:00 a 13:00.
Nejčastější chyby
1) Nenahrazení některých znaků (např. \"&\", \"<\", \">\") entitami
<NAZEV>Fish & Chips</NAZEV>
Možné řešení:
<NAZEV>Fish & Chips</NAZEV>
<NAZEV><![CDATA[Fish & Chips]]></NAZEV>
2) Neuzavřený element
<NAZEV>Fish & Chips3) Tagy malými písmeny
<nazev>Fish & Chips</nazev>
