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.

Před nastavením automatického převodu je potřeba mít splněno následující:

1. Správce Export je nainstalovaný na počítači/serveru, odkud je možné čtení dat SSB.
2. 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).
3. 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.
4. 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.

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.

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 se zadávají za název programu a oddělují se mezerou. Záleží na jejich pořadí:

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.
• Pokud chybí některý z povinných parametrů, převod se neprovede a do logu se zapíše upozorně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.

Naplánovanou úlohu vytvoříme v Plánovači úloh systému Windows:

1. Ve vyhledávání Windows napíšeme Plánovač úloh (Task Scheduler) a otevřeme jej.
2. V pravém panelu klikneme na Vytvořit úlohu… (nepoužíváme Vytvořit základní úlohu, nabízí méně možností).
3. Na záložce Obecné vyplníme Název úlohy (například Správce Export - noční převod).
4. 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…
5. 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í.
6. 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.
7. 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).
8. Přejdeme na záložku Akce, klikneme na Nový… a jako akci ponecháme Spustit program.
9. Do pole Program nebo skript zadáme plnou cestu k aplikaci, například C:\Users\jmeno_uzivatele\AppData\Local\Programs\Spravce Export\SpravceExport.exe
10. Do pole Přidat argumenty (volitelné) zadáme pouze parametry (bez cesty k programu), například: svj1234 MojeHeslo Hafanova
11. Do pole Spustit v (volitelné) zadáme instalační složku aplikace, tedy C:\Users\jmeno_uzivatele\AppData\Local\Programs\Spravce Export
12. Na záložce Nastavení doporučujeme u volby Pokud úloha již běží, platí toto pravidlo ponechat Nespouštět novou instanci.
13. Ú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.

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.

• Ú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, zda se úlohu vůbec podařilo spustit.

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.

• 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 tuto část dat neprovede a do logu zapíše hlášení o uzamčených datech. Ideální je proto noční nebo ranní čas.
• Nespouštějte dva převody současně. 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).
• 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í).
• Bezpečnost. Heslo je v definici úlohy uloženo jako čitelný text. Ú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.