==== Nastavení aplikace ==== Chování aplikace se nastavuje jednak na úrovni Orsoft Open a jednak v aplikaci samotné. === Nastavení Orsoft Open === Smart aplikace Odečítač ZIS komunikuje Orsoft Open na úrovni webových služeb standardem SOAP. Nastavení portu je v Administrace / Parametry / Konfigurace / Internet. V poli URL pro server WS je třeba vyplnit IP adresu serveru (nebo nechat 0.0.0.0 pro aktuální IP adresu) a port. Doporučujeme port 8099 (ostré) a 8100 (test). **//Pozor! Pokud máte dvě prostředí - ostré a test - nesmí být na obou stejný port! //** {{:orsoftopen:z0:oz:z0_oz_internet.jpg}} Pokud chcete provozovat aplikaci v ONLINE režimu zvažte následující varianty: * na Androidu nainstalujte VPN pro přístup do lokální sítě * použijte SIM kartu s pevnou IP adresou a povolte na firewallu do lokální sítě jen tuto IP adresu a jen na určitý port. Použijte přesměřování na IP adresu Open serveru. Další nastavení chování odečtů jsou v ZIS / Parametry / Konfigurace / ZIS Základní konfigurace {{:orsoftopen:z0:oz:z0_oz_zis_konfig.jpg}} * **Při přenosu z OZ změnit datum na poslední v měsíci** - Pře zápisu odečtu z odečtového zařízení se v položkách dávky změní datum odečtu na poslední den v měsíci dle mes_odectu a rok_odectu (tedy rok a měsíc odečtové dávky) * **Při nulovém odečtu dát NEFA** - Pokud je množství odečtu 0, tak nastaví na položce dávky příznak NEFA="A", tedy tento řádek nepůjde do ODEČTŮ. * **Při zápisu odečtu zkontroluj odběratele** - Pokud se mezi nahráním položky dávky do OZ změnil na OM odběratel (většinou antidatováním), tak při návratu odečtu zpět provádí kontrolu zda odběratel na řádku odečtu = aktuálnímu odběrateli na OM. V případě, že se liší tak dojde k: * přepsání položek odběratele na položce dávky (id Z6A, číslo odběratele a název odběratele) * přepsání id hlavičky smlouvy - dohledá se přes platné řádky položek smluv Veškerá komunikace mezi Orsoft Open a OZ je logována v souboru Z_OZ_RRRRMMDD.log - tyto denní soubory jsou v adresáři ./log/ === Nastavení Aplikace Odečítač ZIS === Veškerá nastavení aplikace se provádí v Nastavení aplikace, kam má přístup jenom ADMIN. Nastavení je rozděleno do několika logických skupin: * Komunikace se ZIS * Nastavení aplikace * Práce s mapami * Práce s databází == URL SOAP Serveru == Jedná se o nastavení "endpointu" webových služeb. URL je ve formátu: ** http://XXX.XXX.XXX.XXX:YYYY/Z0OrsoftZISWS?wsdl ** Kde XXX.XXX.XXX.XXX je IP adresa Open Serveru a YYYY je číslo portu, na kterém poslouchá server webových služeb. Pro ověření, že server webových služeb funguje je možné dát tuto adresu do prohlížeče: {{:orsoftopen:z0:oz:z0_oz_firefox_wsdl.jpg?800}} == Test připojení - Hello == Vyzkouší, zda je spojení na server. == Odečítači == Seznam odečítačů, kteří mají přístup k aplikaci. Červeně jsou ADMINi. == Poznámky == Číselník poznámek. Synchronizuje se s číselníkem Z0OMPOZ. V ZISu je to ZIS / Parametry / Číselníky / Odběrných míst / Poznámky OM. == Umístění vodoměru == Číselník umístění vodoměru na OM. Synchronizuje se s číselníkem Z0UMISTOM. V ZISu je to ZIS / Parametry / Číselníky / Odběrných míst / Číselník umístění OM v objektu. Tento údaj se dá změnit při zápisu odečtu v odečtovém zařízení. Dál se zapisuje na OM do záložky Parametry / Umístění VDM - par 3 Tento údaj se zobrazuje přímo v seznamu OM k odečtu - zkratka vpravo. {{:orsoftopen:z0:oz:z0_oz_umisteni_vdm.jpg}} == ONLINE režim == ONLINE režim předpokládá, že OZ má stále kontakt se Serverem Openu. Viz [[:orsoftopen:z0:oz:03_nastaveni|Nastavení]] == ONLINE režim - odečty == Při ONLINE režimu dochází k odeslání odečtu na server ihned při zadání tlačítka "HOTOVO" u odečtu. K odeslání odečtu dochází asynchronně. Pokud není zapnut režim ONLINE, tak se odečty odesílají přes [[:orsoftopen:z0:oz:04_davky|Práce s dávkami]]. == ONLINE režim - fotografie == Při ONLINE režimu dochází k odeslání ihned po pořízení fotografie z aplikace k přenosu **všech** neodeslaných fotografií do ZISu. Pokud není zapnut režim ONLINE, tak se odečty odesílají přes [[:orsoftopen:z0:oz:04_davky|Práce s dávkami]]. == Zobrazovat neodečtené == Příznak, zda v dávce zobrazovat všechna odběrná místa určená k odečítání nebo jen ty, které dosud nejsou odečteny. Pokud máme zvolenu variantu VŠECHNY, tak jsou OM v seznamu rozlišena barevně: * bez barvy (černé pozadí) - dosud neodečtena * šedá - Lístek * zelená - odečteno * modrá - odečteno a již odesláno do ZISu - **NELZE JIŽ UPRAVOVAT** == Třídění v dávce == Lze si vybrat, zda třídit dle: * Pořadí na trase //(změna pořadí na trase se dělá v ZISu nad odběrnými místy - menu Další / Změna pořadí na trase)// * Dle odběratele - podle názvu * Dle čísla OM - vzestupně dle čísla odběrného místa * Dle čísla VDM - vhodné například, když je odečítač v šachtě a nemůže si uvědomit, kde vlastně je tak si může dohledat OM dle čísla VDM :) == Použít SAF == Tzv. SAF - Storage Access Framework je bezpečnostní vymoženost Android 7 a vyšších. Aplikace nemůže psát na SD kartu sama o sobě. Musím mu v SAF povolit určité místo, kam psát. Při stisk Použít SAF vyberte kořen SD karty. Tam bude založen adresář ZIS a v něm podadresář: * images * images / full - fotografie OM v plném rozlišení - zůstávají zde stále (dokud je správce nevymaže na úrovni souborového systému) * images / not_sync - fotografie OM zmenšené na rozlišení dle konfigurace. Jsou zde dokud nejsou poslány do ZISu. * images / sync - fotografie OM se sem přesunou po synchronizaci - zůstávají zde stále (dokud je správce nevymaže na úrovni souborového systému) == Velikost fotografií (px) == Maximální velikost fotografií, které se přesunují do elektronických dokumentů v ZISu. Jedná se o velikost delší strany (ať už PORTRAIT nebo LANDSCAPE) == Povolit správu dávek odečítačům == Standardně mají povolenu správu dávek jen osoby s rolí "ODECITAC_ADMIN". Po zatržení této volby můžou do správy dávek i ostatní odečítači bez "ADMIN". == Práce s mapami (OSM) == Aplikace používá Open Street Map. Stahuje si celou ČR v jednom balíku (nikoli jako Tiles, ale jako vektory). == Cesta k mapovému souboru czech_republic.map == Tato cesta nemůže být na SD kartě. Musí to být např. /storage/emulated/0/ZIS/czech_republic.map K napsání správné cesty k vnitřnímu úložišti použijte např. TotalCommander == URL umístění souboru czech_republic.map == Neměnte http://ftp-stud.hs-esslingen.de/pub/Mirrors/download.mapsforge.org/maps/v5/europe/czech-republic.map == Download mapy == Z výše uvedeného URL stáhne mapu - cca 500MB == Práce s databází == Pomocné práce s databází. Dělejte pouze po dohodě s implementátorem.