user-manual.md

@@ -4,7 +4,7 @@
 
 [[_TOC_]]
 
-Aktuální k verzi 1.6.5
+Aktuální k verzi 1.8.0
 
 ## 1. Co je to Datová schránka?
 
@@ -23,7 +23,7 @@ Datovka je aplikace určená pro mobilní zařízení s operačním systémem An
 
 ### 2.1 Sekce nastavení aplikace
 
-Nastavení aplikace Datovka se provádí přes ikonu "tři pomlčky" v pravém horním rohu úvodní obrazovky. Po stisku se zobrazí rozcestník s možnostmi nastavení aplikace a přidáním nového účtu. Změny v nastavení aplikace na jednotlivých stránkách se ve většině případu aplikují ihned a není třeba nic explicitně potvrzovat. Ovšem, na některých stránkách se musí nastavené hodnoty potvrdit ikonou "fajky" v pravém horním rohu. Rozcestník obsahuje tyto položky:
+Nastavení aplikace Datovka se provádí přes ikonu "tři pomlčky" v levém horním rohu úvodní obrazovky. Po stisku se zobrazí rozcestník s možnostmi nastavení aplikace a přidáním nového účtu. Změny v nastavení aplikace na jednotlivých stránkách se ve většině případu aplikují ihned a není třeba nic explicitně potvrzovat. Ovšem, na některých stránkách se musí nastavené hodnoty potvrdit ikonou "fajky" v pravém horním rohu. Rozcestník obsahuje tyto položky:
 
 * **Přidat účet** - odkaz na stránku, kde je možné přidat do aplikace další účet (schránku).
 * **Hledat zprávu** - pokud existuje v aplikaci jeden nebo více účtů, odkaz Vás nasměruje na stránku, kde je možné vyhledávat zprávy podle různých kritérií (v případě více účtů se vyhledává přes všechny).
@@ -37,6 +37,7 @@ Nastavení aplikace Datovka se provádí přes ikonu "tři pomlčky" v pravém h
 * **Zobrazení logu** - zde je možné zobrazit ladící výpisy z běhu programu nebo starší výpisy zapsané do logovacích souborů. Výpisy či soubory lze v případě problémů s funkčností aplikace odeslat vývojářům přes ikonu vlaštovky v pravém horním rohu.
 * **Zobrazit panel logu** - otevře panel, který okamžitě zobrazuje ladící výpisy z běhu programu.
 * **Uživatelská příručka** - odkaz na tento dokument.
+* **O Datovce** - verze, stručný popis aplikace.
 
 **Poznámka: Ve výchozím nastavení Datovka uchovává obálky datových zprávy i jejich přílohy trvale v lokální databázi a tyto data nijak nemaže. Toto neplatí pro kompletní podepsané datové zprávy ve formátu ZFO. Ty je doporučeno průběžně exportovat/ukládat na jiné paměťové medium nebo PC.**
 
@@ -49,7 +50,7 @@ Pokud spustíte Datovku poprvé a provedli jste nastavení aplikace podle Vašic
 * Přihlašovací jméno, heslo a jednorázový kód
 * Přihlašovací jméno, heslo a SMS
 
-Účet bude v aplikaci vytvořen jen tehdy, podaří-li se úspěšně přihlásit na server ISDS pomocí zvolené metody a získat informace o uživateli a jeho datové schránce. Nejprve tedy vyberte požadovanou metodu přihlašování a pak je třeba vyplnit pole "Název účtu" (Vaše pojmenování účtu - např. název firmy), "přihlašovací jméno" (login) a "heslo". Tyto tři údaje jsou povinné a je nutné je vyplnit. Ostatní volby jsou volitelné. Lze povolit možnost zapamatování hesla v lokálním úložišti, dále je možné zvolit, jestli se obsah této schránky bude ukládat do lokálního úložiště zařízení (doporučeno) nebo dočasně do operační paměti zařízení (data budou po ukončení aplikace ztraceny - může vést k zahlcení paměti a pádu aplikace). Také je možné rozlišit, jestli se jedná o schránku v normálním (produkčním) provozu ISDS či testovacím prostředí ISDS.
+Účet bude v aplikaci vytvořen jen tehdy, podaří-li se úspěšně přihlásit na server ISDS pomocí zvolené metody a získat informace o uživateli a jeho datové schránce. Nejprve tedy vyberte požadovanou metodu přihlašování a pak je třeba vyplnit pole "Název účtu" (Vaše pojmenování účtu - např. název firmy), "přihlašovací jméno" (login) a "heslo". Tyto tři údaje jsou povinné a je nutné je vyplnit. Ostatní volby jsou volitelné. Lze povolit možnost zapamatování hesla v lokálním úložišti, dále je možné zvolit, jestli se obsah této schránky bude ukládat do lokálního úložiště zařízení (doporučeno) nebo dočasně do operační paměti zařízení (data budou po ukončení aplikace ztraceny - může vést k zahlcení paměti a pádu aplikace). Také je možné rozlišit, jestli se jedná o schránku v normálním (produkčním) provozu ISDS či testovacím prostředí ISDS. Dalším přepínačem lze zahrnout účet do hromadné synchronizace, kterou lze provést při dvou a více účtech (ve výchozím nastavení povoleno).
 
 Datovka si přihlašovací údaje a další nastavení (heslo jen pokud je pamatování povoleno) automaticky ukládá při ukončení aplikace. Při dalším spuštění aplikace se automaticky načtou a použijí pro přihlášení do DS.
 
@@ -78,7 +79,7 @@ Klepnete-li na stránce s účty na konkrétní název účtu (čtvercová ikona
 * Změnit nastavení účtu včetně přihlašovacích údajů.
 * Zobrazit informace o účtu, datové schránce a přihlášeném uživateli. 
 * Vytvořit a odeslat zprávu z tohoto účtu.
-* Vytvořit elektronické podání s požadavkém na výpisy z Ministerstva vnitra a Správy základních registrů.
+* Vytvořit elektronické podání s požadavkem na výpisy z Ministerstva vnitra a Správy základních registrů.
 * Importovat ZFO zprávy do účtu z interního nebo externího úložiště.
 * Vyhledat datovou schránku na portále Veřejné správy.
 * Vyčistit databázi souborů. Tato volba provede smazání všech příloh jednotlivých zpráv v databázi a vytvoří novou prázdnou databázi. Může se hodit například v případě, kdy chcete vymazat veškeré přílohy z důvodu nedostatku místa v lokálním úložišti.
@@ -107,7 +108,7 @@ Kompletní podepsané zprávy (formát ZFO) se ukládají do samostatné databá
 
 ### 2.5 Stažení obálek zpráv (synchronizace)
 
-Při stisknutí ikonky kulatých šipek v názvu účtu se provede synchronizace odeslaných i přijatých zpráv tohoto účtu se serverem ISDS. Staženy budou pouze obálky zpráv, pokud není v aplikaci nastaveno stahování kompletních zpráv. V případě, že máte více účtů, můžete synchronizovat všechny účty najednou stiskem ikonky vpravo na hoře vedle ikony s nastavením. Doporučujeme ovšem synchronizovat jednu schránku po druhé, předejte tak nežádoucímu stažení zpráv v ostatních účtech. 
+Při stisknutí ikonky kulatých šipek v názvu účtu se provede synchronizace odeslaných i přijatých zpráv tohoto účtu se serverem ISDS. Staženy budou pouze obálky zpráv, pokud není v aplikaci nastaveno stahování kompletních zpráv. V případě, že máte více účtů, můžete synchronizovat všechny účty najednou stiskem ikonky kruhových šipek vpravo nahoře. Doporučujeme ovšem synchronizovat jednu schránku po druhé, předejte tak nežádoucímu stažení zpráv v ostatních účtech. Synchronizaci všech účtů lze také provést rychlím potažením seznamu účtů z hora dolů (synchronizují se jen ty účty, které mají povolenu hromadnou synchronizaci).
 
 **Upozornění 1: Proces synchronizace způsobuje doručení zpráv ve vlastní datové schránce. Synchronizace může trvat delší dobu v závislosti na rychlosti vašeho připojení k síti internet. Aktivity během synchronizace účtů jsou průběžně zobrazovány ve stavovém panelu ve spodní liště hlavního okna. Nedoporučujeme během synchronizace provádět jiné operace s Datovkou a raději vyčkat na jejich dokončení.**
 
@@ -160,7 +161,7 @@ Datovka umožňuje do jisté míry vytvářet a odesílat datové zprávy.
 
 ##### 2.10.1 Vytvoření a odeslání zprávy
 
-Novou zprávu můžeme vytvořit tak, že na hlavní stránce klepneme na název účtu, ze kterého chceme zprávu odeslat. Pak je potřeba vyplnit předmět v záložce "Obecné", v záložce "Příjemci" přidat nebo vyhledat alespoň jednoho příjemce a v sekci "Přílohy" vybrat z interního nebo externího úložiště alespoň jednu přílohu (soubor). Celková velikost všech příloh zprávy by něměla přesáhnout 20MB, protože může být systémem ISDS odmítnuta. V sekci "Doplňující" je pak možné doplnit další položky obálky zprávy. Jsou-li všechny požadované položky vyplněny, přes ikonu "vlaštovky" v pravém horním rohu se může zpráva odeslat. V případě úspěšného odeslaní se zobrazí dialog s ID nově odeslané zprávy a zprava se vloží do lokální databáze do složky odeslané zprávy. Pokud se zprávu nepodaří odeslat do ISDS, zobrazí se dialog s popisem, co se nepodařilo nebo proč nebyla zpráva dodána do schránky příjemce.
+Novou zprávu můžeme vytvořit tak, že na hlavní stránce klepneme na název účtu, ze kterého chceme zprávu odeslat. Pak je potřeba vyplnit předmět v záložce "Obecné", v záložce "Příjemci" přidat nebo vyhledat alespoň jednoho příjemce a v sekci "Přílohy" vybrat z interního nebo externího úložiště alespoň jednu přílohu (soubor). Celková velikost všech příloh zprávy by neměla přesáhnout 20MB, protože může být systémem ISDS odmítnuta. V sekci "Doplňující" je pak možné doplnit další položky obálky zprávy. Jsou-li všechny požadované položky vyplněny, přes ikonu "vlaštovky" v pravém horním rohu se může zpráva odeslat. V případě úspěšného odeslaní se zobrazí dialog s ID nově odeslané zprávy a zprava se vloží do lokální databáze do složky odeslané zprávy. Pokud se zprávu nepodaří odeslat do ISDS, zobrazí se dialog s popisem, co se nepodařilo nebo proč nebyla zpráva dodána do schránky příjemce.
 
 ##### 2.10.2 Odpověď na došlou zprávu
 
@@ -178,6 +179,10 @@ Můžete použít existující zprávu jako šablonu pro vytvoření nové zprá
 
 Aplikace podporuje odesílaní komerčních poštovních datových zpráv. Při vytváření zprávy v sekci "Obecné" lze také předplatit odpověď na tuto zprávu. Podrobnější informace kolem odesílání poštovních zpráv lze nalézt na stránkách datových schránek.
 
+##### 2.10.6 Krátká textová zpráva jako PDF v příloze
+
+Od verze 1.8.0 je možné do nově vytvářené zprávy vložit krátkou textovou zprávu jako PDF příloha (podobně, jak je tomu u oficiálního webového rozhraní DS). Na stránce s vytvářením nové zprávy je záložka Text. Zde je možné zadat neformátovaný text, který můžete následně přiložit jako PDF soubor do přílohy datové zprávy. Textové pole podporuje jen čistý text a základní formátování, jako je odstavec a odřádkování (jiné formátování není a nebude podporováno). Symbolem oka nad textovým polem můžete prohlédnout vygenerované PDF, symbolem sponky pak vložíte PDF soubor jako přílohu do datové zprávy. Jakákoliv změna textu v poli vyžaduje znovu připojit PDF do příloh. Dojde tak p přepsání již přiloženého PDF. Před odesláním doporučujeme poslední přiložené/přepsané PDF pro jistotu ještě jednou otevřít a zkontrolovat, že opravdu obsahuje správný/vámi požadovaný text.
+
 ### 2.11 Import zpráv z formátu ZFO
 
 Datovka umožňuje import zpráv ve formátu ZFO do lokální databáze aplikace. Importovat se mohou soubory z lokálního nebo externího úložiště zařízení, SD karty či iCloud. Před samotným importem je třeba nejprve vybrat jeden či více souborů ZFO nebo celý adresář. Všechny importované soubory musí obsahovat platnou nepoškozenou zprávu. Importovat se budou pouze zprávy, které nejsou v databázi cílového účtu a u kterých je jednoznačně prokazatelné, že patří do datové schránky cílového účtu. V ostatních případech se import nezdaří. O výsledku importu jednotlivých zpráv jste průběžně informování.