====== 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 [[prevod_dat|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//:

<code>
C:\Users\jmeno_uzivatele\AppData\Local\Programs\Spravce Export
</code>

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 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 | Přihlašovací heslo do Správce Export. |
| 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.
  * 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:

<code>
"%LOCALAPPDATA%\Programs\Spravce Export\SpravceExport.exe" svj1234 MojeHeslo Hafanova
</code>

Převod více agend za sebou (druhá má v názvu mezeru):

<code>
"%LOCALAPPDATA%\Programs\Spravce Export\SpravceExport.exe" svj1234 MojeHeslo Hafanova "Nova Ulice"
</code>

Převod všech agend:

<code>
"%LOCALAPPDATA%\Programs\Spravce Export\SpravceExport.exe" svj1234 MojeHeslo all
</code>

**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//:

<code>
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 *
</code>

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, 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**.

===== 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 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.