STORMWARE POHODA Vlastnosti STORMWARE eForm Protokol eform

Protokol eForm

Od 25. 5. 2018 je služba STORMWARE eForm zrušena, nemůžeme totiž 100% zaručit soulad s Obecným nařízením o ochraně osobních údajů (GDPR). Stávající uživatelé mohou tuto službu nadále používat, je ale potřeba zajistit si jiný server pro transport objednávek.

STORMWARE eForm definuje protokol "eform:" jako volně použitelý protokol pro import libovolného XML souboru do ekonomického systému:

• Protokol eform by si měla při spuštění zaregistrovat aplikace vašeho ekonomického systému.
• Předávaný parametr je název XML souboru včetně plné cesty a přípony souboru.
• Druhou možností je předat parametr s příponou .htm nebo .html (soubor HTML), ekonomický systém musí použít pro import pouze část souboru ("XML Data Island") uvozenou tagem <XML> a ukončenou tagem </XML>. Blíže viz rozšíření protokolu eform.
• Ekonomický systém by měl validovat, zda data obsažená v souboru jsou ve formátu XML, zda struktura XML odpovídá definicím přijímaných dokumentů, případně by měl provést transformaci XML do přijímaného formátu, je-li známý způsob převodu.
• O úspěchu (nebo poblémech) importu do ekonomického systému by měla aplikace uživatele informovat.

Příklad použití: "eform:C:\Win95\Temp\Objednavka.xml"

Rozšíření protokolu eform: (20.5.2002)

• Z důvodu zvyšování bezpečnosti běžně používaných programů pro čtení emailových zpráv (např. Microsoft Outlook 2000) byla definice protokolu rozšířena o zpracování HTML souboru s vloženými daty v podobě "XML Data Island".
• HTML soubor je rozpoznán podle přípony .htm nebo .html
• HTML soubor (včetně obsaženého XML Data Island) musí být v kódování Windows-1250.
• XML Data Island smí být v HTML souboru pouze jeden.
• XML Data Island musí začínat jednou ze 4 možných posloupností znaků:
  <XML>
  <XML ...>
  <xml>
  <xml ...>
  kde ... označuje libovolnou řadu parametrů oddělených mezerou, na které nebere ekonomický systém zřetel.
• XML Data Island musí končit jednou ze 2 možných posloupností znaků:
  </XML>
  </xml>
• V případě volání protokolu eform, kdy je předávaný parametr název HTML souboru včetně plné cesty a přípony souboru, musí ekonomický systém použít pro import pouze část souboru mezi tagy ohraničujícími XML Data Island, musí zpracovat pouze tato XML data.

Příklad použití: "eform:C:\Apps\Outlook\InternetTemp\Priloha.html"

Využití v praxi:
Emailem zaslaný HTML soubor (jako příloha emailu od jiné firmy) obsahuje kromě vizuální podoby skrytá XML data (XML Data Island) a skript spustitelný odkazem "importovat do ekonomického systému". Spuštění skriptu otevře tento HTML soubor protokolem eform. Tím je aktivován ekonomický systém, který obdrží název HTML souboru, vyhledá obsažený XML Data Island, zkontroluje správnost a úplnost XML dat (případně transformuje XML data do jiného vhodného XML formátu), oznámí výsledek uživateli a umožní mu ovlivnit průběhu importu.

Příklad skriptu obsaženého v HTML souboru.

Další informace