Často kladené otázky k dokumentaci

V sekci kapitol FAQ naleznete buď odpovědi na často kladené otázky, nebo nejrůznější tipy a triky, jak řešit v systému ABRA Gen nejrůznější problémy. Vzhledem k tomu, že problematika může být obsáhlejší, jsou u jednotlivých odpovědí často odkazy do dalších oddílů on-line dokumentace.

Témata otázek:

FAQ

Otázka: S jakými porty a adresami komunikuje ABRA Gen? Které porty je nutné povolit?
Odpověď:

Jaké porty je potřeba povolit na proxy serveru:

  • pro vyhledávání v Helpu port 42262

  • pro AnyDesk port 433

  • Automatické aktualizace komunikují na standardním https protokolu, čili port 443

Seznam adres, se kterými ABRA Gen komunikuje, naleznete zde. Tento seznam průběžně aktualizujeme a doplňujeme.
Otázka: Nefunguje mi vyhledávání v dokumentaci (Helpu), co mám dělat?
Odpověď:

Pokud nefunguje hledání v Helpu, prověřte následující:

  • pro vyhledávání v Helpu je potřeba povolit port 42262 na proxy serveru

  • zda máte povolené Cookies

  • vyzkoušejte vyprázdnit cache na stránce klávesovou zkratkou Ctrl+F5
Otázka: Jak je to s aktualizací helpu k datu vydání verze? Našel jsem popis, který neodpovídá programu v dané verzi.
Odpověď:

NEDÍLNOU součástí dokumentace (helpu) jsou Změny ve verzích. Funkcionalita popsaná ve změnách ve verzi je aktuálně platná k dané verzi, a to i v případě, že by nějaká jiná část helpu obsahovala popis jiný (taková část helpu nemusí být k danému datu zatím zcela aktuální). Do dalších částí helpu jsou jednotlivé změny zapracovávány postupně. Před instalací update JE NUTNÉ se se změnami ve verzi PEČLIVĚ seznámit. Viz kap. Změny ve verzích a příslušné podkapitoly.
Otázka: Potřebuji nápovědu k funkci a nevím, kde ji hledat.
Odpověď:

Pokud potřebujete nápovědu k funkci a víte, na kterém konkrétním místě programu se nachází, pak její popis (nebo minimálně odkaz na její popis) naleznete nejrychleji tak, že v daném místě programu ABRA Gen stisknete klávesu F1 (hot-key, pomocí níž se vyvolává kontextový helpClosed Kontextovost helpu spočívá v tom, že se po vyvolání on-line nápovědy z programu přes funkční klávesu F1 zobrazí informace právě k té části a verzi systému ABRA, odkud byla nápověda vyvolána. Např. pokud budete právě v editaci hlavičky faktury, tak aktuální help stránka zobrazená po stisku F1 se bude týkat právě popisu položek faktury. k danému místu programu). Typicky se zobrazí kapitola popisující danou agendu, z níž se již můžete pomocí linků dostat do kapitol popisujících např danou záložku a v ní jednotlivé funkce.

Další možnost je hledat v on-line nápovědě pomocí navigace v menu, což je rychlé, pokud se v uspořádání nápovědy již orientujete a víte, kde hledat.

Pokud nevíte, kde přesně hledat nebo co přesně hledat, pak nejrychlejší způsob nabízí Fulltextové hledání (viz pole Hledat v horní části okna nápovědy) a zadat hledané slovo nebo řetězec (může jít i o sekvenci slov). Pochopitelně čím přesněji řetězec zadáte, tím rychleji dojdete k cíli, protože omezíte počet dohledaných výskytů.

Fulltextové hledání využívá technologii Elasticsearch, díky které se požadované informace vyhledají i v případě, že kapitoly helpu neobsahují řetězec přesně ve tvaru, ve kterém jste ho zadali (tzv. fuzzy shody).

Výsledný počet dohledaných kapitol a jejich pořadí závisí na různých okolnostech. Např. zda je hledaný text titulkem dané kapitoly, zda se nachází v nadpisu, v metadatech, kolikrát se v dané kapitole vyskytuje apod. Více viz kap. Použití nápovědy→Vlastnosti hledání. Dále viz kap. Vyvolání nápovědy.

Dohledaná slova jsou v dohledaných kapitolách graficky zvýrazněna podbarvením (lze vypnout pomocí tlačítka ). Pokud jsou obsažena ve sbalovacích prvcích (sbalovací menu či jiné aktivní prvky), 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 hledání na webové stránce (Ctrl+F). U hledání v rámci jedné webové stránky (Ctrl+F) 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 .
Otázka: Nemám přístup na web, abych si spustil online dokumentaci. Je nějaké řešení?
Odpověď:

V takovém případě se typicky objeví hlášení, že se nepodařilo otevřít stránku s on-line nápovědou s tím, že pravděpodobně nemáte přístup k internetu nebo oprávnění tyto stránky zobrazit.

Situaci, kdy má uživatel z nějakého důvodu zakázán přístup na web helpu systému ABRA Gen, lze ošetřit buď povolením výjimky k přístupu na uvedený web s dokumentací produktu ABRA Gen (požádejte svého systémového správce) nebo umístěním kopie dokumentace do lokálního úložiště a nastavením URL adresy k tomuto úložišti pomocí parametru HelpUrl v nexus.cfg v sekci Client (požádejte svého systémového správce, ať se obrátí na zákaznickou podporu dodavatele pro další informace). Je-li alternativní cesta k nápověda nastavena, bude systém po vyvolání on-line nápovědy z ABRA Gen místo na web přistupovat do tohoto lokálního úložiště.

Je třeba mít na paměti, že v tomto případě se dokumentace stažená do lokálního úložiště nijak sama automaticky neaktualizuje! Přijdete tedy o výhodou on-line dokumentace, která je průběžně automaticky aktualizována, aniž by toto uživatel musel nějak řešit a nové verze si průběžně ukládal do zmíněného lokálního úložiště.
Otázka: Po stisku F1 z aplikace se mi v prohlížeči neotevře online nápověda dle očekávání.
Odpověď:

Pokud nemůžete spustit online nápovědu, protože máte zakázán přístup na web, pak viz předchozí otázka Jak provozovat online dokumentaci, není-li přístup na web. Pokud máte přístup na web, a přesto máte potíže se spuštěním online nápovědy s tím, že se zobrazí např. hlášení , že se nepodařilo se najít výchozí webový prohlížeč, přestože jej máte nastaven, pak viz následující informace:

Online dokumentace zobrazuje v prohlížeči nastaveném jako "výchozí prohlížeč". Rozdíl může být v tom, jakým způsobem se výchozí prohlížeč určí.

  • Pokud není v nexus.cfg parametr HelpUrl nebo je prázdný, zobrazí se pomocí api funkce windows shellexecute (která vyvolá výchozí prohlížeč).

  • Pokud je v nexus.cfg nastavený parametr HelpUrl, dohledá se výchozí prohlížeč z registrů. (Důvodem je, že metoda shellexecute nefunguje spolehlivě dobře, pokud se dokumentace má zobrazoval z lokálního úložiště (file://...). Defaultní browser podle registrů se hledá ve větvích HKEY_CURRENT_USER, HKEY_CLASSES_ROOT. Pokud se nic nedohledá, zkusí se ty samé větve, ale pro 64b registr.

K dispozici je logování vyvolání nápovědy - název logu je AbraHelp. Více k logování viz Logování běhu aplikace. To můžete využít k odhalení problému, pokud vám výše uvedené informace nepomohly.
Otázka: Do panelu fulltextového hledání jsem zadal hledaný výraz, ale on-line help nevrací žádné výsledky, zobrazuje se pouze animovaný text Probíhá hledání, prosím čekejte....
Odpověď:

Tento stav zpravidla znamená, že máte zakázanou komunikaci se službou, která fulltextové vyhledávání poskytuje. Kontaktujte svého správce sítě a požádejte ho o povolení komunikace na adrese a portu 82.202.105.101:42262.
Otázka:

Nacházím se na stránce helpu, kde je mnoho rozbalovacích prvků, které jsou aktuálně sbaleny, takže nevidím obsažený text. Chci si je všechny rozbalit. ale rozbalovat je po jednom je pracné.
Odpověď:

K rychlému rozbalení resp. sbalení všech rozbalovacích resp. sbalovacích prvků na stránce slouží tlačítko v pravé horní části každé stránky. Více viz kap. Jak pracovat s on-line nápovědou - tlačítko Rozbalit vše v panelu nástrojů.

U hledání v rámci jedné webové stránky (Ctrl+F) 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 nebo použijte jiné hledání. Viz též často kladené otázky, Jak rychle hledat v helpu.