Protokol eForm
Od 25. 5. 2018 je služba STORMWARE eForm zrušená, pretože nemôžeme 100% zaručiť súlad so Všeobecným nariadením o ochrane osobných údajov (GDPR). Existujúci užívatelia môžu túto službu naďalej používať, je ale potrebné si zabezpečiť iný server pre transport objednávok.
STORMWARE eForm definuje protokol "eform:" ako voľne použiteľný protokol pre import ľubovoľného XML súboru do ekonomického systému:
- Protokol eform by si mala pri spustení zaregistrovať aplikácia vášho ekonomického systému.
- Odovzdávaný parameter je názov XML súboru vrátane plnej cesty a prípony súboru.
- Druhou možnosťou je odovzdať parameter s príponou .htm alebo .html (súbor HTML), ekonomický systém musí použiť pre import iba časť súboru ("XML Data Island") začatou tagem <XML> a ukončenou tagem </XML>. Bližšie viď rozšírenie protokolu eform.
- Ekonomický systém by mal validovať, či dáta obsiahnuté v súbore sú vo formáte XML, či štruktúra XML zodpovedá definíciám prijímaných dokumentov, prípadne by mal vykonať transformáciu XML do prijímaného formátu, ak je známy spôsob prevodu.
- O úspechu (alebo problémoch) importu do ekonomického systému by mala aplikácia užívateľa informovať.
Príklad použitia: "eform:C:\Win95\Temp\Objednavka.xml"
Rozšírenie protokolu eform: (20.5.2002)
- Z dôvodu zvyšovania bezpečnosti bežne používaných programov na čítanie emailových správ (napr. Microsoft Outlook 2000) bola definícia protokolu rozšírená o spracovanie HTML súboru s vloženými dátami v podobe "XML Data Island".
- HTML súbor je rozpoznaný podľa prípony .htm alebo .html
- HTML súbor (vrátane obsiahnutého XML Data Island) musí byť v kódovaní Windows-1250.
- XML Data Island môže byť v HTML súbore iba jeden.
- XML Data Island musí začínať jednou zo 4 možných postupností znakov:
<XML>
<XML ...>
<xml>
<xml ...>
kde ... označuje ľubovoľný rad parametrov oddelených medzerou, na ktoré neberie ekonomický systém zreteľ. - XML Data Island musí končiť jednou z 2 možných postupností znakov:
</XML>
</xml> - V prípade vyvolania protokolu eform, kedy je odovzdávaný parameter názov HTML súboru vrátane plnej cesty a prípony súboru, musí ekonomický systém použiť pre import iba časť súboru medzi tagmy ohraničujúcimi XML Data Island, musí spracovať iba tieto XML dáta.
Príklad použitia: "eform:C:\Apps\Outlook\InternetTemp\Priloha.html"
Využitie v praxi:
Emailom zaslaný HTML súbor (ako príloha emailu od inej firmy) obsahuje okrem vizuálnej podoby skryté XML dáta (XML Data Island) a skript spustiteľný odkazom "importovať do ekonomického systému". Spustenie skriptu otvorí tento HTML súbor protokolom eform. Tým je aktivovaný ekonomický systém, ktorý obdrží názov HTML súboru, vyhľadá obsiahnutý XML Data Island, skontroluje správnosť a úplnosť XML dát (prípadne transformuje XML dáta do iného vhodného XML formátu), oznámi výsledok užívateľovi a umožní mu ovplyvniť priebeh importu.
Príklad skriptu obsiahnutého v HTML súbore.
Ďalšie informácie