Komunikace webových služeb mezi IS ENVITA a API může probíhat dvěma způsoby.
Oba způsoby jsou navrženy tak, aby zajišťovaly flexibilní a efektivní správu komunikace s API a umožňovaly uživatelům snadný přístup ke klíčovým funkcím webových formulářů.
Přímá obsluha přes aplikaci ENVITA
Uživatelé mohou komunikovat s webovými službami přímo přes běžící aplikaci IS ENVITA. Tento přístup je vhodný zejména pro jednoduché případy, kdy uživatel pracuje přímo s webovým formulářem z prostředí mobilního telefonu, přičemž je IS ENVITA spuštěna.Služba registrovaná ve Windows
Pro komunikaci s webovými službami je možné využít samostatnou službu ISEnvita.Service.exe, která se zaregistruje do systému jako služba Windows. Tato služba je zodpovědná za správu připojení a obsluhu požadavků mezi IS ENVITA a API. V takovém případě nemusí být nutně spuštěna IS ENVITA, přesto z mobilního telefonu zašlete k vybranému autovraku fotografii a uložíte ji do databáze nebo vytvoříte dávky odpadu do Podkladů k evidenci.
Registrace služby ve Windows
Zaregistrování služby ve Windows spuštěním příkazu v příkazové řádce a to podle verze operačního systému. Pokud máte 32 bitový systém je příkazový řádek zapsán takto: sc create "ISEnvita.Service" binpath="C:\Program Files (x86)\Inisoft\ISENVITA\ISEnvita.Service.exe".
Pokud máte 64 bitový operační systém, pak je příkaz tento: sc create "ISEnvita.Service" binpath="C:\Program Files (x86)\Inisoft\ISENVITA\ISEnvita.Service_x64.exe"
Po provedení tohoto příkazu se vytvoří služba do Windows a je třeba ji donastavit a spustit v aplikaci Služby ve Windows.
- na službě klikněte pravým tlačítkem myši a vyberte nabídku Vlastnosti
- přejděte na záložku Přihlášení a tam vyberte Tento účet
- pokud používáte databázi na LocalDB, pak zadejte jméno a heslo ve Windows, pod kterým služba následně poběží.
- pokud používáte databázi na SQL serveru, pak nechte volbu Místní systémový účet.
- pokud používáte databázi na LocalDB, pak zadejte jméno a heslo ve Windows, pod kterým služba následně poběží.
- spusťte službu
Smazání zaregistrované služby pomocí příkazu sc delete "ISEnvita.Service"
Technická specifikace
Systémové požadavky pro běh služby jsou identické s těmi, které platí pro běžný provoz desktopové aplikace ENVITA. Při spuštění služba automaticky navazuje odchozí spojení na wss://formulare-api.envita.cz pomocí zabezpečeného WebSocket protokolu (wss, port 443).
Z pohledu IT správy není potřeba instalovat či provozovat žádné webové servery, NAT rule, nebo veřejné IP adresy. Jediné, co musí být na perimetru zákaznické sítě povoleno, je HTTPS provoz na výše uvedené URL. Všechny interakce s cloudovým rozhraním API probíhají šifrovaným kanálem.
V rámci prostředí ENVITA Cloud je vedle samotného API provozována i webová aplikace na adrese https://formulare.envita.cz, která slouží jako frontend pro koncové uživatele. K přístupu postačí běžný webový prohlížeč, zařízení není nijak omezeno typem ani OS.
Přihlášení uživatele probíhá pomocí WEB ID (unikátní identifikátor cílové ENVITA instance) spolu s uživatelským jménem a heslem, které se spravují výhradně v rámci zákaznické lokální instalace IS ENVITA. Nastavení uživatelských rolí a oprávnění je tak plně pod kontrolou zákazníka.
Důležité: Webové formuláře ani API neuchovávají žádná data – veškeré dotazy a operace jsou zpracovávány v reálném čase proti lokální instanci IS ENVITA. Pokud ISEnvita.Service.exe neběží, nebo není API dostupné, frontend (webové formuláře) přestane fungovat.