Importy

Import je uložená definice jednoho datového vstupu: odkud data přicházejí, v jakém formátu a co z nich se má do systému zapsat — produkty, parametry, typy produktů, štítky, sklady a zásoby.

O funkci

Katalog a zásoby často nevznikají v e-shopu, ale v nadřazeném systému nebo u dodavatele. Import je opačný směr než export: data přijímá a pravidelně jimi aktualizuje katalog, aby je nikdo nemusel přepisovat ručně.

Import sám o sobě nic nespouští. Je to pojmenovaná definice, na kterou se odkazuje jejím kódem ten, kdo import spouští:

• automatizace podle plánu — typicky pro feed, který si systém stahuje z pevné adresy,
• napojený systém přes sběrnici — import proběhne ve chvíli, kdy ze systému dorazí nová data.

Ve výpisu ani v detailu importu proto tlačítko pro ruční spuštění není.

Definici zakládá a nastavuje obvykle implementační tým, protože formát zdroje určuje technický adaptér. V administraci pak správce e-shopu dolaďuje hlavně mapování — do kterých skladů, typů produktů, skupin štítků a položek menu se mají hodnoty ze zdroje zapsat.

Cesta v administraci

Nastavení > Export & Import > Importy

Výpis importů

Výpis importů — každý řádek je jedna definice vstupu; tužka ve sloupci Akce otevírá úpravu.

• Název: pojmenování vstupu pro orientaci v administraci.
• Kód: jednoznačný identifikátor, pod kterým import hledá automatizace i napojený systém. Dva importy nemohou mít stejný kód.
• ID: interní číslo záznamu. Výpis je podle něj řazený od nejnovějšího.
• Akce: tužka otevře úpravu importu v panelu vpravo, šipka vedle ní nabízí další akce s řádkem, mezi nimi smazání.

Podle sloupců Název, Kód a ID můžete výpis řadit. Pole Vyhledat… hledá v názvu i kódu. Tlačítkem Nový založíte novou definici.

Kód neměňte za chodu

Automatizace i napojený systém najdou import jen podle kódu. Když kód přejmenujete, nebo import smažete, další běh skončí chybou „Import se nezdařil kvůli chybě." — dokud kód neupravíte i tam, odkud se import spouští.

Import produktů z tabulky je jinde

Hromadné úpravy produktů tabulkou (XLSX) nejsou tento typ importu — soubor se nahrává přímo ve výpisu produktů. Tady jde o pravidelné vstupy z okolních systémů.

Založení a úprava importu

Import se upravuje v panelu Upravit import (nový v panelu Nový import), který má pět záložek. Změny uložíte tlačítkem Uložit a projeví se při příštím běhu importu.

Každá část importu — produkty, sklady, zásoby, dodavatelé, typy produktů, skupiny štítků, štítky produktů a menu — má vlastní přepínač Importovat …. Vypnutou část import při běhu přeskočí a její další nastavení jsou zašedlá, hodnoty si ale ponechají. Pole Transformace u jednotlivých částí nabízí úpravy dat, které jsou na instalaci k dispozici pro danou část; jejich výběr je práce pro implementační tým.

Záložka Základní — identifikace importu a technické údaje o zdroji.

• Název (povinné): pojmenování ve výpisu.
• Kód (povinné, jedinečný): identifikátor, pod kterým import spouští automatizace nebo napojený systém, například feed-dodavatel.
• Adaptér (povinné): výběr z adaptérů, které jsou na instalaci k dispozici; nabídka ukazuje jejich technické názvy. Volí ho implementační tým.
• URL feedu (povinné): adresa zdroje, například https://data.example.com/katalog.xml. Formulář přijme adresu začínající http, https, imap, ftp nebo sftp — imap je přístup do e-mailové schránky, ftp a sftp přístup k souboru na serveru (viz níže). Adaptér pro sběrnici adresu nepoužívá, formulář ji ale vyžaduje i tak.
• Logovat: přepínač. Výsledek každého běhu se do audit logu zapisuje bez ohledu na něj.

Mapování hodnot ze zdroje

Karty mapování se objeví až u uloženého importu. Řádky v nich přibývají samy, jak import hodnoty ze zdroje při běhu poznává — u definice, která ještě neproběhla, jsou karty prázdné. Každá karta je samostatný seznam s vyhledáváním; ve filtraci lze zobrazit Jen nenamapované řádky.

Přiřazení změníte tužkou u řádku: v panelu vyberete cíl a uložíte. Ukládá se jen tento jeden řádek, ne celý import. U skladů a typů produktů jde přiřazení i zrušit.

Panel Hodnoty — převod hodnot jedné skupiny ze zdroje na hodnoty štítků v e-shopu.

U skupin štítků převádí panel Hodnoty jednotlivé hodnoty — například hodnotu nerez ze zdroje na hodnotu Ocel v e-shopu. Hodnotu vybíráte jen z přiřazené skupiny štítků a jedné hodnotě v e-shopu odpovídá nejvýš jedna hodnota ze zdroje. Dokud skupina ze zdroje nemá přiřazenou existující skupinu štítků, je ikona Hodnoty neaktivní.

Strategie u skladů, zásob, typů produktů, skupin štítků a menu má dvě volby, výchozí je Absolutní:

• Absolutní — import podle zdroje zakládá, co v e-shopu chybí, a upravuje, co už přiřazené je.
• Inkrementální — u typů produktů a skupin štítků import nic nezakládá ani neupravuje, jen zapíše novou hodnotu ze zdroje do mapování k ručnímu přiřazení. U skladů založí jen sklady, které ještě nemají přiřazení, a stávající nemění.

Feed, který dodavatel posílá e-mailem

Když dodavatel feed nezveřejňuje na adrese, ale posílá ho jako přílohu e-mailu, může URL obsahovat přístup do schránky, například imap://import%40example.com:heslo@example.com:993/INBOX?subject=Sklad&attachment=%2F%5C.csv%24%2F. Za imap:// je přihlašovací jméno (znak @ se píše jako %40), heslo, server s portem 993 nebo 143 a složka (bez ní INBOX). Za otazníkem jsou nepovinné filtry: subject (předmět obsahuje text), from (odesílatel), attachment (vzor názvu přílohy), limit (kolik nejnovějších zpráv se prohlédne, bez něj 10) a unseen=0 (číst i přečtené zprávy — jinak jen nepřečtené). Import vezme nejnovější zprávu s vyhovující přílohou; starší zprávy se berou jako vyřízené s ní, protože nesou zastaralý stav. Novější zprávy bez přílohy zůstanou nedotčené. Když se ke schránce nejde přihlásit, složka neexistuje nebo je vzor přílohy chybný, běh skončí hláškou „Import se nezdařil kvůli chybě.". Schránku čte jen adaptér, který pro dodavatele připraví implementační tým — adaptér XML feedu čte pouze http a https. Heslo je v poli URL feedu vidět v čitelné podobě, proto pro import použijte samostatnou schránku.

Soubor na serveru přes FTP nebo SFTP

Pokud dodavatel soubor vystavuje na svém serveru, může URL feedu mít tvar sftp://uzivatel:heslo@example.com/export/feed.xml (případně s portem za názvem serveru, například :2222). Formulář u adresy ftp a sftp kontroluje, že obsahuje přihlašovací jméno, heslo, server i cestu k souboru — jinak import neuloží a ukáže hlášku s ukázkou správného tvaru. Soubor ale stáhne jen adaptér, který to umí a který pro dodavatele připraví implementační tým; adaptér XML feedu čte pouze http a https. Heslo je i tady vidět v čitelné podobě.

Co přesně import ze zdroje dostane, určuje adaptér. Přepínače ve formuláři rozhodují, které z toho import zapíše.

Průběh importu

Při každém běhu systém načte data ze zdroje a zpracuje je po částech: nejdřív sklady, parametry a typy produktů, pak dodavatele, produkty, štítky a nakonec zásoby. Části s vypnutým přepínačem Importovat … přeskočí. Hodnoty ze zdroje, které ještě nemají přiřazení, zapíše do mapování — proto se po prvním běhu naplní karty mapování. Při strategii Absolutní typy produktů a skupiny štítků, které v e-shopu chybí, rovnou založí.

Jak import zachází s chybami:

Situace	Co se stane	Záznam v audit logu
vše v pořádku	data se zapíšou	Import proběhl úspěšně.
jeden produkt nejde uložit	tento produkt se přeskočí, ostatní se zapíšou	Import proběhl s chybami.
zdroj nejde stáhnout	import skončí dřív, než cokoli zapíše	Import se nezdařil kvůli chybě.
data ve zdroji nejdou přečíst	import skončí u části, kterou nešlo přečíst; další části se už nezpracují	Import se nezdařil kvůli chybě.
import s daným kódem neexistuje	import se nespustí	Import se nezdařil kvůli chybě.

Po úspěšném běhu — i s chybami u jednotlivých produktů — systém přepočítá automatické ceny importovaných produktů, pokud je zapnutá volba Přepočítat ceny, a se zapnutou volbou Přeindexovat produkty je aktualizuje ve vyhledávání.

Časté dotazy (FAQ)

Jak často import běží?

Podle toho, kdo ho spouští. Import navázaný na automatizaci běží podle její frekvence, kterou najdete ve výpisu automatizací. Import přes sběrnici proběhne pokaždé, když z napojeného systému dorazí data.

Kde zjistím, že import proběhl?

V audit logu — každý běh tam zapíše jeden z výsledků z tabulky výše. U importu spouštěného automatizací je navíc vidět datum ve sloupci Naposledy proběhlo.

Import proběhl s chybami. Které produkty chybí?

Přeskočené produkty jsou uvedené u záznamu běhu v audit logu. Ostatní produkty z téhož běhu jsou zapsané normálně, takže stačí opravit data u zdroje a počkat na další běh.

Chceme načítat ceník od dodavatele. Je to tento import?

Záleží na tom, v jaké podobě data přicházejí. Formát zdroje určuje adaptér, který je součástí platformy — napojení nového formátu je práce pro implementační tým. Jednorázovou úpravu cen v katalogu zvládnete i sami přes hromadné úpravy tabulkou.

Související dokumentace

• Exporty
• Automatizace — plánované spouštění importu
• Audit log — výsledek každého běhu
• Typy produktů — typy a parametry, na které se mapuje
• Sklady — sklady, na které se mapují sklady ze zdroje
• Hromadné úpravy produktů (XLSX) — import z tabulky v agendě produktů
• Přehled integrací — kdy stačí feed a kdy je potřeba propojení se systémem
• Výměna dat — samostatná stránka se připravuje