Automatický převod dat
Správce Export umí převod dat spustit i bez obsluhy - stačí jej spustit s parametry příkazové řádky. Aplikace se sama přihlásí, převede zadané agendy a ukončí se. Díky tomu lze převod naplánovat jako úlohu ve Windows (například každou noc) a data ve Správci tak budou vždy aktuální bez nutnosti ručního převodu.
Poznámka: Spuštění s parametry nenahrazuje nastavení agendy. Aplikace při automatickém převodu použije stejné nastavení agendy (cesta k datům SSB, vybrané celky, dokumenty, opravy, ostatní), které jsme uložili v okně nastavení agendy - viz kapitola Převod dat.
Než převod naplánujeme
Před nastavením automatického převodu je potřeba mít splněno následující:
Správce Export je nainstalovaný na počítači/serveru, odkud je možné čtení dat SSB.
Agenda je založená ve Správci a má uložené nastavení (především správnou cestu k datům SSB a vybrané celky).
Převod byl alespoň jednou úspěšně proveden ručně z aplikace. První převod agendy trvá vždy nejdéle a je vhodné jej provést pod dohledem.
Známe identifikátor (parametr) našeho Správce a heslo - tedy stejné údaje, které zadáváme do přihlašovací obrazovky aplikace.
Upozornění: Pokud jsou data SSB na síťovém disku, zadejte v nastavení agendy cestu ve tvaru UNC (například \\server\ssb\data\Hafanova), nikoliv přes přiřazené písmeno disku (například S:\data\Hafanova). Přiřazená písmena disků existují pouze pro přihlášeného uživatele a naplánovaná úloha je nemá k dispozici.
Kde je aplikace nainstalovaná
Správce Export se instaluje pro přihlášeného uživatele (nevyžaduje tedy práva správce počítače) a jeho instalační složka je v profilu uživatele, nikoliv v Program Files:
C:\Users\jmeno_uzivatele\AppData\Local\Programs\Spravce Export
Cestu ke své instalaci nejrychleji zjistíme jednou z těchto možností:
Do adresního řádku Průzkumníka souborů zadáme %LOCALAPPDATA%\Programs\Spravce Export a potvrdíme.
Klikneme pravým tlačítkem na zástupce Spravce Export na ploše, zvolíme Vlastnosti a cestu opíšeme z kolonky Cíl - cestou je pouze část v uvozovkách.
Upozornění: Protože je aplikace nainstalovaná v profilu konkrétního uživatele, je nutné naplánovanou úlohu spouštět pod tímtéž uživatelským účtem, pod kterým byla aplikace nainstalována. Pod jiným účtem se úloha nespustí - aplikace v jeho profilu neexistuje. Tento účet musí zároveň mít přístup k datům SSB.
Parametry aplikace
Parametry se zadávají za název programu a oddělují se mezerou. Záleží na jejich pořadí:
| Pořadí | Parametr | Povinný | Popis |
| 1. | ID parametru webu | ano | Identifikátor (parametr) našeho Správce - stejný, jaký zadáváme při přihlášení do aplikace. |
| 2. | Heslo | ano | Heslo administrátora webového portálu Správce (uživatele admin) - stejné, jaké zadáváme při přihlášení do aplikace. |
| 3. a další | Název agendy | ano | Název agendy, která se má převést. Agend lze uvést více za sebou - převedou se postupně jedna po druhé. Místo názvů lze uvést all pro převod všech agend. |
Pár poznatků k parametrům:
Název agendy musí být zadán přesně tak, jak je uveden ve Správci, včetně velkých a malých písmen.
Pokud název agendy nebo heslo obsahuje mezeru, je nutné jej uzavřít do uvozovek (například „Hafanova 1“).
Hodnotu all zadávejte malými písmeny a samostatně - není potřeba ji kombinovat s názvy agend.
Neexistující agendu program přeskočí a pokračuje dalšími agendami (hlášení se vypíše do okna s průběhem a výsledek spuštění bude chybový).
Pokud chybí některý z povinných parametrů, převod se neprovede a do logu se zapíše upozornění.
Příklady spuštění
Převod jedné agendy:
"%LOCALAPPDATA%\Programs\Spravce Export\SpravceExport.exe" svj1234 MojeHeslo Hafanova
Převod více agend za sebou (druhá má v názvu mezeru):
"%LOCALAPPDATA%\Programs\Spravce Export\SpravceExport.exe" svj1234 MojeHeslo Hafanova "Nova Ulice"
Převod všech agend:
"%LOCALAPPDATA%\Programs\Spravce Export\SpravceExport.exe" svj1234 MojeHeslo all
TIP: Než převod naplánujeme, doporučujeme si příkaz vyzkoušet ručně - otevřeme příkazový řádek (cmd), příkaz vložíme a spustíme. Pokud jsou parametry v pořádku, otevře se okno s průběhem převodu, kde vidíme, které domy a objekty se právě převádějí. Po dokončení se vypíše seznam převedených agend s hlášením a okno se po 30 sekundách samo zavře.
Nastavení naplánované úlohy
Naplánovanou úlohu vytvoříme v Plánovači úloh systému Windows:
Ve vyhledávání Windows napíšeme Plánovač úloh (Task Scheduler) a otevřeme jej.
V pravém panelu klikneme na Vytvořit úlohu… (nepoužíváme Vytvořit základní úlohu, nabízí méně možností).
Na záložce Obecné vyplníme Název úlohy (například Správce Export - noční převod).
Ve stejné záložce zkontrolujeme, že je u volby Při spuštění úlohy použít tento uživatelský účet uveden účet, pod kterým je Správce Export nainstalovaný. Případně jej změníme tlačítkem Změnit uživatele nebo skupinu…
Zaškrtneme Spustit, i když uživatel není přihlášen (jinak se úloha spustí jen tehdy, je-li uživatel právě přihlášen). Volbu Nechci ukládat heslo nezaškrtáváme - bez uloženého hesla nemá úloha přístup k síti a převod se nepřihlásí.
Volbu Spustit s nejvyššími oprávněními není potřeba zaškrtávat - aplikace se instaluje i aktualizuje do profilu uživatele a práva správce nepotřebuje.
Přejdeme na záložku Aktivační události, klikneme na Nový… a nastavíme, kdy se má převod spouštět (například Denně ve 2:00).
Přejdeme na záložku Akce, klikneme na Nový… a jako akci ponecháme Spustit program.
Do pole Program nebo skript zadáme plnou cestu k aplikaci, například C:\Users\jmeno_uzivatele\AppData\Local\Programs\Spravce Export\SpravceExport.exe
Do pole Přidat argumenty (volitelné) zadáme pouze parametry (bez cesty k programu), například: svj1234 MojeHeslo Hafanova
Do pole Spustit v (volitelné) zadáme instalační složku aplikace, tedy C:\Users\jmeno_uzivatele\AppData\Local\Programs\Spravce Export
Na záložce Nastavení doporučujeme u volby Pokud úloha již běží, platí toto pravidlo ponechat Nespouštět novou instanci.
Úlohu potvrdíme tlačítkem OK. Windows si vyžádají heslo k uživatelskému účtu, pod kterým se úloha bude spouštět.
Upozornění: Cesta i argumenty se zadávají odděleně - do pole Program nebo skript patří pouze cesta k SpravceExport.exe, do pole Přidat argumenty pouze parametry. Pokud vložíme celý příkaz do jednoho pole, úloha se nespustí.
Poznámka: Do polí Plánovače úloh doporučujeme psát plnou cestu včetně jména uživatele, nikoliv zkratku %LOCALAPPDATA%. Zkratka se totiž vyhodnocuje podle účtu, pod kterým úloha běží, a při záměně účtu by úloha přestala fungovat bez zřejmé příčiny.
Vytvoření úlohy příkazem
Zkušenější uživatelé (nebo IT správce) mohou úlohu vytvořit i jediným příkazem v příkazovém řádku. Následující příkaz vytvoří úlohu, která každý den ve 2:00 převede agendu Hafanova:
schtasks /create /tn "Spravce Export - nocni prevod" /tr "\"C:\Users\jmeno_uzivatele\AppData\Local\Programs\Spravce Export\SpravceExport.exe\" svj1234 MojeHeslo Hafanova" /sc daily /st 02:00 /ru "DOMENA\jmeno_uzivatele" /rp *
V parametru /ru musí být uveden stejný účet, pod kterým je aplikace nainstalovaná. Parametr /rp * zajistí, že se příkaz na heslo k tomuto účtu bezpečně dotáže.
Kontrola a průběh převodu
Úlohu je vhodné po vytvoření ručně spustit (v Plánovači úloh pravým tlačítkem na úlohu - Spustit) a ověřit, že převod proběhl.
Zda převod dopadl dobře, poznáme nejlépe ve webovém portálu Správce - u dat uvidíme aktuální hodnoty.
Podrobný průběh každého spuštění se zapisuje do textového logu ve složce Log v instalační složce aplikace (%LOCALAPPDATA%\Programs\Spravce Export\Log). V logu najdeme jak informace o převáděných agendách, tak případná chybová hlášení.
V Plánovači úloh ve sloupci Výsledek posledního spuštění vidíme výsledek převodu: 0 znamená, že se všechny agendy převedly bez chyb, 1 že se něco nepodařilo (přihlášení, neexistující agenda, nepřevedené domy, zamčená agenda…) - podrobnosti najdeme v logu. Výjimkou je den aktualizace aplikace, kdy úloha skončí s výsledkem 0 a skutečný výsledek převodu je jen v logu.
Poznámka: Log se zapisuje do instalační složky toho uživatele, pod kterým převod běžel. Pokud tedy převod spouštíme ručně pod svým účtem a naplánovaná úloha běží pod jiným, jsou to dva různé logy.
Doporučení a časté potíže
Neplánujte převod na dobu, kdy se v SSB pracuje. Pro převod sald, fondů a služeb potřebuje aplikace data SSB odemčená - pokud jsou v SSB otevřená příslušná okna, převod agendy skončí chybou Data SSB jsou uzamčena (u salda se nepřevedou jen dotčené domy). Ideální je proto noční nebo ranní čas.
Jednu agendu nelze převádět dvakrát současně. Pokud se agenda právě převádí (z jiné úlohy, jiného počítače nebo ze STARLITwebu), převod ji přeskočí s hlášením Agenda se právě převádí a pokračuje dalšími agendami. Pokud si zakládáme více úloh, naplánujte je s dostatečným odstupem, případně převádějte více agend jednou úlohou (více názvů agend za sebou). Zámek převodu, který byl násilně ukončen (např. vypnutím počítače), se sám uvolní nejpozději po 10 minutách.
Počítač/server musí být v naplánovaný čas zapnutý. Aplikace potřebuje také funkční internetové připojení a přístup k datům SSB.
Délka převodu. Převod velkého množství objektů může trvat i několik hodin - s tím je nutné počítat při volbě času spuštění.
Nová verze aplikace. Pokud je při automatickém spuštění k dispozici nová verze, aplikace ji nainstaluje sama na pozadí a naplánovaný převod následně spustí znovu se stejnými parametry. Do webového portálu se tedy data dostanou i v den, kdy vyšla aktualizace. Instalační složka se aktualizací nemění, cestu v úloze proto není potřeba upravovat.
Změna hesla. Pokud si změníme heslo do Správce, je nutné jej změnit i v argumentech naplánované úlohy, jinak se převod přestane provádět (v logu se objeví hlášení o nezdařeném přihlášení). Po 5 neúspěšných pokusech o přihlášení se přihlášení z daného počítače na 30 minut zablokuje - a to i do webového portálu.
Bezpečnost. Heslo je v definici úlohy uloženo jako čitelný text. Po aktualizaci, kterou spustila naplánovaná úloha, si parametry včetně hesla zapamatuje i zástupce na ploše - spuštěním zástupce se pak místo přihlašovací obrazovky rovnou spustí převod. Úlohu proto zakládejte na počítači/serveru, ke kterému mají přístup pouze oprávněné osoby.
Pokud se převod nedaří a z logu není zřejmá příčina, obraťte se prosím na technickou podporu a textový log ze složky Log přiložte k požadavku.