Jak spustit automatizaci importů a exportů

Import

Importní XSD schémata a příklady struktury XML naleznete v našem dalším manuálu. 

Vkládání dat pomocí speciální sestavy

Importní soubory lze také sdružit do jednoho souboru a to tak, že obsahy jednotlivých dílčích importů budou vloženy do root elementu (<data></data>) hlavního importního souboru. V tomto případě již nezáleží na pořadí jednotlivých dílčích importů v hlavním importním souboru.

Postup importu dat na internetový obchod

Příprava:

Pro import dat na internetový obchod byl na FTP serveru vyhrazen adresář „files/universalTransport/import/“. Pokud adresář neexistuje, je nutné zajistit jeho vytvoření.
 

Nahrání importních souborů na FTP server:

Před nahráním importovaných souborů do vyhrazeného adresáře je potřeba smazat veškerý jeho obsah, aby nedošlo k importu zastaralých XML souborů. Poté je možné nahrát importní soubory do importního adresáře na FTP serveru.

Zavolání importní URL adresy pro zpracování dat:

URL adresa je unikátní v rámci internetového obchodu. O tuto adresu si můžete zažádat u podpory internetového obchodu.

Příklad URL adresy: http://mojedomena.cz/customdatafeed/5A6001D2-0872-46F4-9B14-173263BC590B?*

* Parametry

• task=runImport -> Aplikace zajistí import všech XML souborů v importním adresáři. Stránka vrací výsledek ID logu daného importu.
• task=importStatus&logBatchId={ID log záznamu} -> Aplikace zjistí, v jakém stavu je import pro dané ID logu. Výsledkem je XML se stavem importu.

Vysvětlivky:
LogBatch/@DateStart: atribut obsahuje datum a čas startu importu
LogBatch/@DateEnd: atribut obsahuje datum a čas ukončení importu
LogBatch/@State: atribut obsahuje stav importu (3 – ok, 2 – varování, 1 – chyba)
LogBatch/SubLogBatch: element obsahuje dílčí operace importu
LogBatch/Logs: element obsahuje podrobnější popisy operací importu včetně chyb
LogBatch/Logs/Log: element obsahuje detailní popis dané operace
LogBatch/Logs/Log/@State: atribut obsahuje stav importu (3 – ok, 2 – varování, 3 – chyba)
LogBatch/Logs/Log/@Code: atribut obsahuje kód dané operace
LogBatch/Logs/Log/@CategoryCode: atribut obsahuje kód kategorie operace
LogBatch/Logs/Log/@Message: atribut obsahuje textovou zprávu o stavu dané operace
LogBatch/Logs/Log/LogDetail: element obsahuje XML s přehledem o událostech importu
 

Export

Exportovat lze tyto entity:

• Objednávky

Zavolání exportní URL pro export objednávek z internetového obchodu:

URL adresa je unikátní v rámci internetového obchodu. O tuto adresu si můžete zažádat u podpory internetového obchodu.

Příklad URL adresy: http://mojedomena.cz/customdatafeed/5A6001D2-0872-46F4-9B14-173263BC590B?*

* Parametry jsou odděleny oddělovačem "&":

• task=export -> Aplikace zahájí export dle vstupních parametrů

  • from={číslo objednávky od} -> Filtrování objednávek od zadaného čísla objednávek.

  • to={číslo objednávky do} -> Filtrování objednávek do zadaného čísla objednávek.

  • datefrom={datum od} -> Filtrování objednávek od zadaného data.

  • dateto={datum do} -> Filtrování objednávek do zadaného data.

  • exported={true/false} -> Filtrování objednávek dle příznaku exportován (bExported).

  • setasexported={true/false} -> Aplikace zapíše příznak exportován na všech vyexportovaných objednávkách.

• task=result -> Aplikace zapíše externí ID objednávky (například z IS) k dané objednávce a zároveň ji nastaví příznak exportováno.

  • ids={seznam id objednávek oddělených „,“}

  • externalIds={seznam externích id objednávek oddělených „,“}

  • seznamy ids a externalIds musí mít stejný počet záznamů pro spárování (tzn. ID objednávky na 3. pozici v seznamu ids bude spárováno s externím ID na 3. pozici v seznamu externalIds)