Použití nápovědy
Vyvolaná nápověda se zobrazí v okně vašeho webového prohlížeče, příp. výjimečně v okně pro spouštění agend (viz Jak vyvolat nápovědu).
Vzhled on-line dokumentace a práce s ní je obdobná práci s jinými www stránkami v prohlížeči.
Klikněte na obrázek
Umožňuje fulltextové hledání podle zadaného řetězce. Hledaný text zadejte do panelu hledání.
Panel hledání
Jedná se o ideální variantu v případě, že přesně nevíte, kde se požadovaná informace nachází, nebo ji nechcete hledat přes menu. Pak použijte fulltextové vyhledávání, které vám vypíše seznam kapitol, ve kterých se vyskytuje zadaný řetězec (nebo řetězec podobný zadanému, viz Vlastnosti hledání níže). Viz též často kladené otázky, Jak rychle hledat v helpu.
Občerstvení - obsah on-line helpu je pravidelně aktualizován. U některých prohlížečů může dojít za jistých okolností k tomu, že má prohlížeč "nacacheován" původní starý obsah. To se může projevit např. dlouhou odezvou při fulltextovém hledání (hledání je za běžných okolností rychlé a odezva okamžitá), chybným vykreslením některých prvků apod. Pokud na takovou skutečnost narazíte, proveďte občerstvení stránek (stisknutím klávesy F5).
- Hledání není case sensitive Je-li nějaká položka case insensitive, znamená to, že není citlivá na velká a malá písmena, neboli nerozlišuje velká a malá písmena. Tzn., že není rozdíl, je-li napsáno např. "Abc" nebo "abc". Opak je case sensitive..
-
Použitá technologie Elasticsearch podporuje následující funkcionalitu:
-
fuzzy shody - kromě zadaných výrazů se dohledají také témata obsahující jejich různé tvary (je podporováno ohýbání slov)
Pokud zadáte do hledaného výrazu slovo faktura, dohledají se i témata obsahující textové řetězce faktury, faktuře, fakturám atd.
- našeptávání - nabízení vyhovujících kapitol a v minulosti hledaných výrazů v průběhu psaní (včetně výrazů hledaných jinými uživateli)
- návrhy hledání podobných výrazů (Měli jste na mysli...?)
-
- Hledají se celá slova, nepoužívají se žádné divoké znaky (*,?).
- Nepoužívají se žádné logické operátory (AND, OR, NOT, NEAR).
- Vždy se prohledává kompletní obsah nápovědy - všechny kapitoly včetně PDF dokumentů (příruček).
- Vždy se prohledává obsah nápovědy pro jednu konkrétní verzi, produkt (ABRA Gen s daňovou evidencí, ABRA Gen s podvojným účetnictvím, ABRA Gen pro MSSQL/ABRA Gen pro Oracle) a lokalizaci.
-
Dohledaná slova jsou v dohledaných kapitolách graficky zvýrazněna podbarvením (lze vypnout pomocí tlačítka ). Viz panel nástrojů. Pokud jsou obsažena ve sbalovacích prvcích, tyto se automaticky rozbalí.
Proto je toto hledání výhodnější než hledání na jedné konkrétní stránce helpu jen pomocí prostředků běžného internetového hledání (Ctrl+F). U takového hledání se hledaný text nedohledá, pokud je obsažen v některém ze sbalovacích prvků, které jsou aktuálně sbaleny. Pokud jej chcete použít, nejprve sbalovací prvky rozbalte pomocí tlačítka . Viz panel nástrojů.
-
Kromě výše popsaného hledání přímo v helpu můžete využít i hledání pomocí internetového vyhledávače Google.
Pro vyhledání faktury přijaté v helpu pro CZ lokalizaci pro verzi 21.0 systému ABRA Gen zadáme do vyhledávacího řádku Googlu:
faktura přijatá site:help.abra.eu/cs/21.0
Pro vyhledání faktury přijaté v helpu pro SK lokalizaci pro verzi 21.0 systému ABRA Gen, ale pouze v sekci fakturace, zadáme do vyhledávacího řádku Googlu:
faktura prijatá site:help.abra.eu/sk/21.0 inurl:PartS_Prodej
Umístěn vpravo pod lištou s titulkem helpu v rámci kapitol (není na hlavní stránce). Zde naleznete ikony pro další práci v dané kapitole s následujícím významem:
Název | Popis |
---|---|
Slouží pro zrušení podbarvení, pomocí něhož jsou v dané kapitole graficky zvýrazněna klíčová slova hledaná přes panel Hledat (pozor, toto se netýká textů podbarvených z důvodů běžného hledání v prohlížeči pomocí ctrl+F). Viz Vlastnosti hledání. |
|
Slouží pro hromadné rozbalení/sbalení rozbalovacích prvků v dané kapitole (pokud tam takové jsou). Využijete, pokud chcete hledat v textech dané kapitoly prostředky hledání viz Vlastnosti hledání. |
|
Slouží pro vyvolání tisku dané kapitoly. | |
Slouží pro návrat na úvodní stránku on-line helpu help.abra.eu. Zde si můžete vybrat help pro jiný z dostupných produktů, z dostupných lokalizací či pro jinou verzi. Pro návrat na homepage helpu, kde se právě nacházíte, slouží tradičně kliknutí na produktovou ikonu. Pod produktovou ikonou je uvedeno, pro jakou verzi systému je help, v němž se aktuálně nacházíte. |
Pro lepší přehlednost se na stránkách helpu mj. používají:
-
Různé sbalovací/rozbalovací prvky - Např. sbalovací menu či jiné aktivní prvky. Rozbalí se po kliknutí na ně myší a zpřístupní informace v nich obsažené, po opětovném kliknutí se sbalí. Automaticky se rozbalí tehdy, pokud obsahují text hledaný přes vyhledávací panel helpu, viz výše Vlastnosti hledání.
Příklad (zde klikněte)Tento text se zobrazí po kliknutí myší na předchozí odkaz Příklad. Po opětovném kliknutí se tento text opět skryje. Použito typicky v případě často se opakujících či dlouhých textů, kdy dočasné skrytí zlepšuje přehlednost dané stránky.
-
Miniatury obrázků - Obrázky na stránce mohou být na stránce jen jako zmenšeniny, které se zobrazí v původní velikosti po kliknutí na daný obrázek.
Pod lištou hledání je k dispozici informační sekce, kde jsou mj. různá tlačítka na důležitá témata, tlačítka ke stažení příruček, možnost spustit instruktážní videa apod.
Pohybovat se zpět/dopředu po kapitolách, jak jste je postupně otvírali, můžete pomocí ovládacích prvků vlastního prohlížeče (tak jako při prohlížení běžných www stránek). Pohybovat se můžete samozřejmě i podle menu. Orientovat se můžete i pomocí navigační lišty pod hlavním panelem.
Pod lištou hledání je k dispozici informační sekce, kde jsou mj. různá tlačítka na důležitá témata, tlačítka ke stažení příruček, možnost spustit instruktážní videa apod.
Help je organizován následovně:
V menu Začínáme naleznete témata vhodná na začátek práce se systémem týkající se práce s nápovědou a dále vhodná pro první seznámení se s produktem, vč. příručky QuickStart a návodné výukové příručky ABRA Tutoriál, popis změn ve verzích apod.
V menu Popis systému je pak popis vlastního systému, přičemž nejdříve je zde k dispozici základní charakteristika systému, dále řada kapitol popisujících obecná pravidla platná pro celý systém (na něž se hojně odkazují všechny následné popisy). Dále jsou pak popisy jednotlivých agend.
V menu Administrace jsou pak k dispozici témata určená především pro administrátory systému, týkající se instalace, implementace systému, konfiguračních souborů, pomocných nástrojů apod.).
V menu Ostatní naleznete různé doplňující informace, přílohy, výkladový slovník, pdf příručky, video návody apod.
V menu FAQ jsou často kladené otázky .
Odkazování na konkrétní místo na stránce
V případě, že je třeba odkázat se na konkrétní místo na stránce helpu, lze v URL adrese využít:
-
URL parametr Highlight - za odkazem se použije notace ?Highlight="Hledaný text"
https://help.abra.eu/cs/23.0/G3/Content/Part01_Zmeny/2300.htm?Highlight="Bylo opraveno chybné chování HTM editoru"
Zadaný text pak bude zvýrazněn, je-li obsažen v nějakém aktivním rozbalovacím prvku, tento se rozbalí.
-
Bookmark - za odkazem se použije notace #NázevBookmarku
https://help.abra.eu/cs/23.0/G3/Content/Part80_FAQ/FAQ_API.htm#DatumoveHodnoty
Bookmarky jsou primárně vytvářeny autory dokumentace dle jejich potřeb a nevyskytují se tedy u všech položek. Navíc jsou ukryty v html kódu. Pro jejich zobrazení můžeme využít například rozšíření pro prohlížeč Chrome Display #Anchors.
-
Textový fragment - za odkazem se použije notace #:~:text=hledaný%20text.
https://help.abra.eu/cs/23.0/G3/Content/Part80_FAQ/FAQ_API.htm#:~:text=Jak%20používat%20v%20URL%20datumové%20hodnoty?
Možnosti textových fragmentů jsou pokročilé. Zde uvádíme pouze nejčastěji používaný způsob.
Vzhledem k použité dokumentační technologii není možné se odkazovat na obsah skrytý v rozbalovacím prvku. Výhodou jsou komplexnější možnosti, jak parametricky definovat text k označení.
Parametrizovatelná URL (lokalizace, číslo verze aj.)
Jak bylo řečeno v úvodní kap., helpy k jednotlivým produktům řady ABRA Gen jsou na samostatných URL adresách. V URL adrese je zakomponována vazba na příslušnou lokalizaci (cs/sk/ch), verzi (řada verzí, např. 17.03) a interní označení produktu (např. G3)).
K dispozici jsou mj. následující parametry a hodnoty, pomocí nichž lze konkrétní help volat:
lang: string, product: string, version: string, link: string = '/Content/Home.htm', branch: string
- lang: cs/sk/ch
- product: G1/G3/G4
- version: xx.xx/last
- branch: p/k
- link: /……………….htm
- v rámci link lze využívat i bookmarks (#) a Highlight (?Highlight)
Platí: lang, product, branch - mohou mít více hodnot oddělených středníkem ';', pak bude uživatel muset nejdříve vybrat na úvodní stránce helpu. Pokud mají parametry lang, product, version, branch (nepovinně) pouze jednu hodnotu, dojde k automatickému přesměrování.
Objasníme na příkladech:
Pokud byste se tedy např. potřebovali odkázat na ABRA Tutoriál v poslední nejaktuálnější verzi helpu (např. v nějakých vašich interních pokynech pro výuku nového zaměstnance) k produktu G3 pro CZ lokalizaci, mohlo by volání vypadat následovně:
https://help.abra.eu/?lang=cs&product=G3&version=last&link=Content/Tutorial00_Introduction/tutorial.htm
Příklad využití Highlight:
https://help.abra.eu/?lang=cs&product=G3&branch=p&version=last&link=/Content/Part01_Zmeny/Zmeny_ve_verzich.htm?Highlight="Následující kapitoly"
Příklad využití bookmark:
https://help.abra.eu/?lang=cs&product=G3&branch=p&version=last&link=/Content/Part01_Zmeny/Zmeny_ve_verzich.htm#linie_distribuce_schema
Tímto se ale jako běžný uživatel nemusíte zabývat. Pokud potřebujete help pro jiný z dostupných produktů v rámci řady ABRA Gen, z dostupných lokalizací či pro jinou verzi, můžete si jej pohodlně vybrat na úvodní stránce on-line helpu help.abra.eu.
Pro návrat na úvodní stránku helpu slouží tlačítko .
V minulosti (do verze 18.03 včetně) bylo možné omezit oblast hledání pomocí některého z nadefinovaných filtrů (a snížit tak počet dohledaných témat a zvýšit jejich relevantnost). Po kliknutí na ikonu filtru se zobrazil seznam dostupných oblastí hledání.
V nápovědě k verzi 18.13 byla tato možnost odstraněna. Změna souvisí s použitou novou technologií hledání (Elasticsearch), která nabízí nové možnosti a celkové zefektivnění procesu hledání, ale jeho implementace není s hledáním podle oblastí kompatibilní (v současné době).
Od verze 18.13 se tedy zadané výrazy vždy vyhledávají v celém obsahu helpu (pro danou verzi a lokalizaci). Nově se prohledává i obsah PDF dokumentů.