XML export kurzů na Jobs.cz a Temio Edumarket
Jak XML import funguje? XML export kurzů vám umožní automatickou synchronizaci informací o nabízených kurzech (název, popis, lektor, termín, místo a další důležité informace) mezi vaším systémem a službami Jobs.cz Kurzy a školení a Teamio Edumarket. Na Jobs.cz a v Teamiu Edumarket se zobrazují jen ta data, která jsou aktuálně obsažena ve vámi generovaném XML. Pokud v XML nemáte konkrétní kurz, nebo jeho termín, tento se také nezobrazuje na Jobs.cz a v Teamiu Edumarket. Citlivost k chybám: Pokud je celé XML nevalidní, nebo strojově nečitelné, nemůžeme vaše kurzy vůbec naimportovat. Chybí-li v XML povinné položky u jednotlivých kurzů, nejsou tyto kurzy importovány. Při importu jsou tyto kurzy a (nebo) jejich termíny "přeskočeny". Pokud jsou špatně (nevalidně) vyplněny nepovinné položky, jsou tyto kurzy i termíny importovány. Tyto nevalidní položky jsou "přeskočeny" a neimportují se. Robot bude XML stahovat každý den v brzkých ranních hodinách. Při nedostupnosti souboru nebo dlouhém načítání souboru nebude aktualizace provedena.
Jak XML feed vytvořit? Na prvním řádku uveďte hlavičku:
Je potřeba mít kódování opravdu ve formátu UTF 8. Nestačí jen kódování uvést do hlavičky souboru. Kódování souboru si ověřte např. ve vašem internetovém prohlížeči. Na dalším řádku uveďte uvozující tag "courses" a identifikátor firmy:
Identifikátor firmy je unikátní hash, který Vám přidělíme. Před přidělením sem můžete vložit např. jméno firmy bez diakritiky a mezer. Na další řádky vložte informace o jednotlivých kurzech s jejich popisem, kategorizací, termíny a lektory. Např.:
Marketing na Facebooku a dalších sociálních sítích <description> <strong>Sociální média: Definice, druhy a principy - proč řešit sociální média, co je WOM a jak využít virální šíření
- jak sociální média fungují, typologie uživatelů
- vyhodnocení komunikace, opuštění sociálních sítí.
]]> Marketing Čeština Sociální média <profession id="155">Marketingový analytik středně pokročilí Budova Lighthouse <price amount="3700" currency="CZK"/> Petr <surname>Novák ... ... ... ... <noterm> ... ... Informace o dalších kurzech vkládejte ve stejném formátu vždy za značku tak, aby byla dodržena správná posloupnost elementů. Za poslední vložený kurz vložíte ještě ukončení elementu: Pro lepší představu o struktuře a možnostech XML jsme připravili ukázkový XML soubor, který najdete zde: https://my.teamio.com/edumarket/admin/xml-export/
Dokumentace XML elementů XML soubor se skládá z jednotlivých elementů, u kterých je potřeba dodržet správné pořadí. Na následujících řádcích jsou jednotlivé elementy popsány. Je také dodrženo jejich správné pořadí. U povinných elementů a atributů je uvedeno "povinné", ostatní položky jsou volitelné. Čím více položek vyplníte, tím lépe uživatelé Váš kurz naleznou.
Uvozující element Uvozující element s identifikací verze XML a kódování. Element je povinný.
Element courses
Kořenová značka, v jejímž rámci je vše ostatní. Obsahuje jeden povinný atribut: company="...". Do tohoto atributu uveďte námi přidělený unikátní identifikátor. Tento identifikátor vám bude přidělen po vytvoření profilu firmy našim administrátorem. Identifikátor firmy naleznete také v administraci kurzů na https://my.teamio.com/edumarket/admin/ (položka idfirmy pro import). Element je povinný.
Elementy kurzu O kurzu vyplňte co nejvíce položek, díky tomu uživatelé váš kurz lépe najdou.
Element course elementy kurzu Základní element, který uzavírá všechny ostatní elementy. Kurzů může být v XML neomezené množství. Atributy: id="..."- povinný. Jedinečný a časově stálý identifikátor kurzu. Identifikátorem může být jakákoli číselná nebo textová hodnota. Maximální délka 100 znaků. Podmínkou je jeho unikátnost a časová stálost. Je důležité, aby atribut idse u daného kurzu v čase neměnil. Pokud se idkurzu mění, při každém importu původní kurz na Jobs.cz smažeme a vytvoříme nový identický kurz, který však má jiné URL. Změna URL pak kurz poškozuje v SEO i v našich marketingových aktivitách, což způsobí, že tento kurz bude mít méně poptávek.
Element name název kurzu Obsahuje název kurzu. Neuvádějte prosím celý název KAPITÁLKAMI. Maximální délka 255 znaků. Element je povinný.
Element description <description> Popis kurzu může být formátován pomocí pouze těchto HTML značek: <strong>
- Element je povinný.
Element image V atributu src="..."je uveden odkaz na ilustrační obrázek, který reprezentuje daný kurz. Ke kurzu je povolen pouze jeden ilustrační obrázek:
minimální rozměry obrázku jsou 300 x 225 px - větší obrázek poměrově zmenšíme, menší obrázek nebude zpracován poměr stran obrázků by měl být 4:3, pokud nedodržíte tento poměr stran, obrázek ořízneme na poměr stran 4:3 obrázek musí být dostupný na uvedené URL v době zpracování importu akceptované formáty obrázků: jpg, png, gif Element je nepovinný. Obrázek se zobrazí ve výsledcích vyhledávání a v detailu kurzu. Díky obrázku bude váš inzerát výraznější! Jaký zvolit obrázek ke kurzu? fotografie nebo ilustrace související s tématikou kurzu fotografie z již proběhlých termínů kurzu fotografie učebny nebo místa, kde bude výuka probíhat obrázek pomůcky nebo učebnice, které se budou při výuce používat
Element focus Název kategorie Tento element určuje zařazení kurzu do kategorií. Uvnitř elementu může / nemusí být název kategorie. obsahuje atribut id="...": počet uvedených kategorií je 1 - 3 kurz musí být zařazen do konkrétních podkategorií (id není dělitelné 100) idmusí odpovídat číselníku kategorií: http://www.jobs.cz/kurzy-a-skoleni/media/xml/focus.xml Element je povinný. Proč máme tak málo hlavních kategorií a podkategorií? Prototypy jsme testovali na uživatelích a zjistili jsme, že si mnohem lépe vyberou z omezeného počtu kategorií. Webové stránky se lidem lépe používají a rychleji najdou to, co hledají. Výsledky si pak dokáží upřesnit dle potřeby např. podle profesí a dalších parametrů jako je termín, lokalita, lektor nebo cena. Může se stát, že si žádnou z kategorií nevyberete, nebude odpovídat vašemu kurzu. V tomto případě vás prosíme o návrh kategorie nové. Zvážíme její přidání s ohledem na potenciál obsahu.
Element language název jazyka Slouží po uvedení vyučovacího jazyka kurzu. Uvnitř elementu můžete uvést název jazyka, obsahuje atribut id="...": Číselník id: 1 - čeština 2 - angličtina Element je nepovinný. Není-li element uveden, je kurzu nastaven jazyk "čeština".
Element keyword klíčové slovo Zde uvádějte klíčová slova, podle kterých bude váš kurz lépe dohledatelný. Maximální délka jednoho klíčového slova je 100 znaků. U jednoho kurzu může být zadáno maximálně 20 klíčových slov. Element je nepovinný. Jaká klíčová slova napsat? Jsou to slova nebo sousloví, která charakterizují váš kurz. Můžete použít např. slangové výrazy nebo dovednosti získané na kurzu. Nemusíte uvádět výrazy, které již máte v názvu nebo popisu kurzu, to je zbytečné.
Element profession <profession id="id profese">název profese Slouží pro přiřazení profese ke kurzu. Zde určíte pro jaké profese je kurz nejvhodnější. Těchto elementů může být několik za sebou, uvnitř elementu může být název profese. Element povinně obsahuje atribut id="...": počet uvedených profesí: 0 - 10. idmusí odpovídat číselníku profesí: http://www.jobs.cz/kurzy-a-skoleni/media/xml/profession.xml Element je nepovinný. Přidáním profesí své kurzy lépe dostanete k uživatelům. Díky správně zadaným profesím budeme moci zobrazovat relevantní nabídky vzdělávání a rozvoje všem uživatelům Jobs.cz a personalistům v aplikaci Teamio Edumarket.
Element level název úrovně Zde uvádějte úroveň požadovaných znalostí - těchto elementů může být několik za sebou. Uvnitř elementu může být název úrovně. Element povinně obsahuje atribut id="...">: úrovní může být uvedeno: 0 - 3 číselník id: 0 - nezáleží 1 - začátečníci 2 - středně pokročilí 3 - odborníci Element je nepovinný. Když není element uveden, je kurzu nastavena úroveň "nezáleží".
Elementy termínu K jednomu kurzu může být uvedeno více termínů konání kurzu. Tyto termíny uvádějte za sebou, každý s unikátním identifikátorem. Termín určují následující elementy. Pokud chcete inzerovat kurz bez termínu (např. e-learning nebo aktuálně žádný termín k danému kurzu nemáte vypsaný), podívejte se níže do kapitoly "Element noterm".
Element term <price .../> ... ... Element uzavírá termín kurzu - těchto elementů může být několik za sebou. Obsahuje několik atributů: id="..."- je povinný a v rámci kurzu je to jedinečný a časově stálý identifikátor termínu. Identifikátorem může být jakákoli číselná nebo textová hodnota. Maximální délka 100 znaků. Podmínkou je jeho unikátnost (v rámci kurzu) a časová stálost. state="..."- je nepovinný (defaultně 1), určuje stav termínu, jestli se má nebo nemá daný termín zobrazovat uživatelům. Může nabývat těchto hodnot: 0 - uzavřený (dočasně pozastaven, nezobrazuje se uživatelům), 1 - otevřený (zobrazuje se). Je důležité, aby atribut idse u daného termínu v čase neměnil. Pokud se idtermínu mění, při každém importu původní termín na Jobs.cz smažeme a vytvoříme nový identický termín, který však má jiné URL. Změna URL pak termín poškozuje v SEO i v našich marketingových aktivitách, což způsobí, že tento termín bude mít méně poptávek.
Element je povinný u kurzů s termíny.
Element date Tento element určuje datum a čas konání kurzu. A obsahuje dva následující atributy, které jsou povinné: from="..."- udává od kdy se tento termín kurzu koná. Formát data je yyyy-mm-ddThh:mm:ss: yyyy- rok zapsaný čtyřmi číslicemi mm- měsíc zapsaný dvěmi číslicemi (je-li jednočíselný pak je uvozen nulou) dd- den T- oddělovač data a času h- hodiny m- minuty s- sekundy to="..."- udává do kdy se tento termín kurzu koná. Formát data je shodný jako u atributu from="...". Element je pro kurz s termínem povinný. Datum termínu není možné po zadání změnit. V případě nutnosti změny již existujícího data u termínu kontaktuje zákaznickou podporu společnosti LMC.
Element price <price amount="cena bez DPH" currency="měna" vat="sazba DPH v %"/> Element určuje cenu kurzu v daném termínu (cena se u jednotlivých termínů může lišit). Je možné také uvést slevu z ceny. Obsahuje následující atributy: amount="..."povinný, cenu za kurz bez DPH, celé číslo bez mezer currency="..."nepovinný, měna ceny, mohou být použity následující hodnoty: CZK, EUR - pokud není atribut uveden, použijeme CZK vat="..."nepovinný, sazba DPH v % jen číslo, znak % neuvádějte pokud je daný kurz osvobozen od DPH, uveďte sazbu "0" pokud není atribut uveden, použijeme aktuální základní sazbu DPH platnou v ČR Element je pro kurz s termínem povinný.
Element address upřesnění adresy
Určuje místo konání kurzu. U kurzů v České republice je možné uvést obec (město) nebo přesnou adresu. U zahraničních kurzů stačí uvést pouze stát. Je možné také místo adresy uvést, že kurz je online. Má následující atributy: country="..."- kód státu nepovinný atribut pokud ho neuvedete, použijeme výchozí hodnotu, kterou je "cz" (Česká republika) tj. je důležité ho uvést u kurzů v zahraničí číselník kódů států: http://www.jobs.cz/kurzy-a-skoleni/media/xml/country.xml city="..."- název obce (města) povinný atribut pro kurzy v ČR
volitelný pro kurzy v zahraničí street="..."- název ulice, volitelný atribut registry_number="..."- číslo popisné, volitelný atribut house_number="..."- číslo orientační, volitelný atribut zip="..."- PSČ, volitelný atribut flag="online"- označení e-learningu/online kurzů/webinářů (bez adresy konání) nepovinný atribut pokud uvedete tento atribut, neuvádějte žádné další atributy Jako textovou informaci tohoto elementu lze volitelně uvést upřesnění adresy - např. "Budova Lighthouse Towers, 11. patro". Element je pro kurz s termínem povinný. Adresy v ČR validujeme proti databázi adres, proto je důležité, aby byla adresa zadána správně a jednoznačně. Jinak nedojde k importu daného termínu kurzu.
Velmi doporučujeme uvádět u kurzů přesné adresy. Uživatelé ocení jasnou informaci a díky přesné adrese můžeme uživatelům zobrazit mapku s místem konání kurzu. Příklady zadání přesné adresy v ČR Adresa ve městě i s upřesněním: Budova Lighthouse Towers, jedenácté patro Adresa v obci bez ulic, bez upřesnění: Příklad zadání obce (města) v ČR Příklady zadání adresy v zahraničí (Francie) Francouzská riviera, Cannes
Příklad zadání e-learningu/online kurzu/webináře (bez adresy)
Element lector Tento element určuje lektora daného termínu nebo na něj odkazuje. Stačí, když je lektor uveden v XML jen jednou, a v ostatních případech se na něj už jen odkazuje. Element je nepovinný. Proč uvádět lektora? Lektoři jsou totiž pro naše uživatele velmi důležití, častokrát hledají přímo jejich jméno. Lektor dokáže ovlivnit celkový dojem z kurzu. Proto uvedené jméno lektora a jeho vyplněný profil dokáže přilákat potenciální účastníky vašeho kurzu. Varianta s uvedením položek lektora jméno <surname>přijmení .. ..
Zadání lektora včetně dalších elementů upřesňujících informace o lektorovi. Povinný je atribut id="...", který musí být v rámci dokumentu unikátní (pro daného lektora). Na zde uvedené idse poté můžete odkazovat v celém XML dokumentu (viz. specifikace následujícího elementu). Varianta s odkazem Odkaz na již existujícího lektora. Obsahuje atribut ref="...", v tomto atributu uvádějte odkaz na existující idlektora. Element firstname jméno Zde uveďte jméno lektora. Element je povinný. Element surname <surname>přijmení Zde uveďte příjmení lektora. Element je povinný. Element degrees_before <degrees_before>tituly před jménem Zde uvádějte tituly před jménem lektora. Element je nepovinný. Element degrees_after <degrees_after>tituly za jménem Zde uvádějte tituly za jménem lektora. Řetězec neuvozujte čárku, uvádějte jen samostatné tituly, např.: <degrees_after>Ph.D., MBA Od příjmení budou tituly čárkou odděleny automaticky. Výsledek tedy bude: Ing. Jan Novák, Ph.D., MBA Element je nepovinný. Element description <description> Zde uveďte základní informace o lektorovi (krátké CV). Popis lektora může být formátován pomocí pouze těchto HTML značek: <strong>
- Element je nepovinný. Element skills <skills> Zde uvádějte dovednosti, specializace nebo získané certifikáty lektora. Dovednosti lektora můžou být formátovány pomocí pouze těchto HTML značek: <strong>
Element je nepovinný. Element image V atributu src="..."uveďte odkaz na fotografii lektora. K lektorovi je povolena pouze jedna fotografie: minimální rozměry fotografie jsou 220 x 220 px - větší fotografie poměrově zmenšíme, menší fotografie nebude zpracována poměr stran fotografie by měl být 1:1, pokud nedodržíte tento poměr stran, fotografii ořízneme na poměr stran 1:1 fotografie musí být dostupná na uvedené URL v době zpracování importu akceptované formáty fotografie: jpg, png, gif Element je nepovinný.
Elementy kurzu nabízeného bez termínu Inzerci kurzu bez termínu doporučujeme pro tyto případy: e-learning/online kurz aktuálně žádný termín k danému kurzu nemáte vypsaný, ale přesto chcete kurz inzerovat s "termínem po dohodě" Pokud chcete inzerovat kurz bez termínu, musíte místo elementu termínu (term) použít element noterm.
Element noterm <noterm> <price .../> ... ... Element uvádějte u každého kurzu pouze jednou. Pokud má kurz termín, cenu i místo konání dohodou, můžete uvést zkrácenou verzi: <noterm /> Element je povinný, pokud chcete nabízet kurz bez termínu. Pokud v rámci jednoho kurzu uvedete zároveň elementy termi noterm, dáme přednost elementu terma kurz se naimportuje s termíny.
Element price Element určuje cenu kurzu. Podrobný popis viz výše. U kurzů nabízených bez termínu je možné uvést také atribut flag="custom". Tím nám říkáte, že "cena kurzu je dohodou": <price flag="custom"/> Element je u kurzů nabízených bez termínu nepovinný. Pokud ho neuvedete, znamená to pro nás, že "cena kurzu je dohodou".
Element address Určuje místo konání kurzu. Podrobný popis viz výše. U kurzů nabízených bez termínu je možné uvést také atribut flag="custom". Tím nám říkáte, že "místo konání kurzu je dohodou": Kurzy bez termínu jsou často e-learningy/online kurzy. V takovém případě uveďte atribut flag="online":
Element je u kurzů nabízených bez termínu nepovinný. Pokud ho neuvedete, znamená to pro nás, že "místo konání kurzu je dohodou".
Element lector Tento element určuje lektora nebo na něj odkazuje. Podrobný popis viz výše. Element je nepovinný.
Povinné a nepovinné informace Souhrn povinných a nepovinných informací ke kurzům a jejich případné omezení. Tyto informace odpovídají jednotlivým elementům nebo atributům. Získáte tak rychlý přehled o datech, která si musíte připravit pro funkční export. Bez správně vyplněných povinných položek nelze kurz naimportovat a zobrazovat našim uživatelům.
Položky firmy idfirmy, povinné, unikátní identifikátor přidělený od LMC
Položky kurzu Povinné idkurzu, omezení na 100 znaků elementy kurzu název kurzu, omezení na 255 znaků název kurzu popis kurzu, formát: html, povolené tagy: p, strong, ul, li <description> zařazení kurzu do pokategorie (focus idpodle číselníku), omezení: alespoň jedno zařazení, idnení dělitelné 100 (zařazení do konkrétní podkategorie) Název kategorie termín kurzu, viz. níže, omezení: alespoň jeden Nepovinné ilustrační obrázek kurzu, omezení: nejvýše jeden, minimální rozměr: 300 x 225 px, poměr stran: 4:3 (pokud použijete jiný poměr stran, obrázek ořízneme), formát: jpg, png, gif jazyk kurzu (podle číselníku), při neuvedení použijeme default id1 čeština název jazyka klíčová slova, každé klíčové slovo je omezeno na 100 znaků, maximálně 20 klíčových slov u jednoho kurzu klíčové slovo vazba na profese (vhodné pro, idpodle číselníku)., omezení: nejvýše deset <professionid="id profese">název profese úroveň kurzu (id podle číselníku), omezení: nejvýše tři., při neuvedení použijeme default: 0 nezáleží název úrovně
Položky termínu Povinné idtermínu, omezení na 100 znaků elementy termínu datum termínu OD, formát: ISO (2012-08-26T09:00:00) nebo YYYY-MM-DD datum termínu DO, formát: ISO (2012-08-26T09:00:00)nebo YYYY-MM-DD
cena, viz níže místo konání, viz níže Nepovinné stav (id podle číselníku), defaultně = 1 (otevřený termín) elementy termínu lektor, viz níže
Položky kurzu nabízeného bez termínu Povinné element noterms uvedením dalších údajů: <noterm>volitelně elementy ceny, místa konání, lektora element noterm, kdy je cena i místo konání dohodou: <noterm/> Nepovinné cena, viz níže místo konání, viz níže lektor, viz níže
Položky ceny cena - uvádějte cenu bez DPH <priceamount="cena bez DPH"currency="měna" vat="sazba DPH v %"> měna, při neuvedení použijeme default = CZK <price amount="cena bez DPH"currency="měna"vat="sazba DPH v %"> sazba DPH v % (znak % neuvádějte), při neuvedení použijeme aktuální základní sazbu DPH platnou v ČR, pokud je daný kurz osvobozen od DPH, uveďte sazbu "0" <price amount="cena bez DPH" currency="měna"vat="sazba DPH v %"/> cena dohodou - je možné zadat pouze u kurzu nabízeného bez termínu: <priceflag="custom"/>
Položky místa konání stát - je důležitý pro zahraniční kurzy, pro české ho není nutné uvádět upřesnění adresy město - je povinné ho uvést u kurzů v ČR, volitelně pro zahraniční kurzy upřesnění adresy ulice - uvedení je volitelné upřesnění adresy číslo popisné - uvedení je volitelné upřesnění adresy číslo orientační - uvedení je volitelné upřesnění adresy PSČ - uvedení je volitelné upřesnění adresy upřesnění adresy (např. "Budova Lighthouse Towers, 11. patro") - uvedení je volitelné upřesnění adresy online kurz/e-learning - v tomto případě zadejte adresu takto: místo konání dohodou - je možné zadat pouze u kurzu nabízeného bez termínu:
Položky lektora
Povinné Pokud byl lektor již v XML exportu lektor uveden: stačí pouze uvést pouze referenci na idjiž definovaného lektora V případě, že není použita reference, pak jsou povinnými položkami: unikátní idlektora elementy lektora jméno jméno příjmení <surname>přijmení Nepovinné titul před jménem, omezení: prostý text bez omezení délky <degrees_before>tituly před jménem titul za jménem, omezení: prostý text bez omezení délky <degrees_after>tituly za jménem fotografie lektora, omezení: nejvýše jedna, minimální rozměr: 220 x 220 px, poměr stran: 1:1 (pokud použijete jiný poměr stran, fotografii ořízneme), formát: jpg, png, gif popis lektora, formát: html, povolené tagy: p, strong, ul, li <description> dovednosti lektora, formát: html, povolené tagy: p, strong, ul, li <skills>
Číselníky Číselníky se automaticky aktualizují dle naší databáze. Pro aktuální data doporučujeme XML s číselníky automaticky stahovat z níže uvedených URL. Číselník kategorií kurzů: http://www.jobs.cz/kurzy-a-skoleni/media/xml/focus.xml Číselník kategorií profesí: http://www.jobs.cz/kurzy-a-skoleni/media/xml/profession.xml Číselník států: http://www.jobs.cz/kurzy-a-skoleni/media/xml/country.xml
Ověření validity XML Validitu XML ověříte XSD schématem, které najdete zde: https://my.teamio.com/edumarket/admin/xml-export/ Jak si validitu ověřit: Validace XML proti XSD je možná pomoci nástroje XmlLint (pro Windows jej najdete zde: http://www.zlatkovic.com/libxml.en.html XmLint spustit a zadejte následující příkaz: xmllint --noout --schema course.xsd název-vašeho-suboru.xml Můžete využít také on-line nástroj: http://www.freeformatter.com/xml-validator-xsd.html
