Další akce spojené s instalací (UDF knihovny apod.)

Obsah této kapitoly nemá pro systém ABRA Gen pro Oracle, resp. ABRA Gen pro MSSQL význam.

V rámci instalace ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím probíhá automaticky několik souvisejících akcí. Zde zmíníme následující:

Pro správný chod systém ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím vyžaduje, aby v cestě instalace Firebird v podadresáři UDF (např. c:\Program Files\Firebird\Firebird_2_5\UDF\) byly k dispozici Udf knihovny (soubory nxudf*.dll resp. libnxudf*.so) odpovídající verze nebo verze kompatibilní. Tyto udf knihovny s deklaracemi doplňkových funkcí pro FB jsou nutné pro spuštění některých agend ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím(např. Kniha majetku zpětně k datu, funkce využívané při Zaúčtování žádostí apod.)

Popis Udf funkcí viz kap. Seznam UDF funkcí (uživatelsky definovaných funkcí).

V instalaci jsou k dispozici jak 32-bitové, tak 64-bitové UDF verze příslušných knihoven.

Instalační program ABRA Gen tyto knihovny instaluje automaticky vždy při instalaci nové verze (32bit i 646bit). Instalační program nainstaluje Udf knihovny vždy znovu, tj. i kdyby již na daném počítači byly instalovány z jiné instalace, pak je přepíše příslušnou verzí z instalace. Udf knihovny jsou zpětně kompatibilní, tj. starší verze ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím umí pracovat s novější verzí Udf knihoven. Opačně to ale neplatí!

Tzn., že pokud na jednom počítači provozujete starší verzi ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím a nainstalujete si novější verzi (např. jako demoverzi), bude starší verze s novější verzí Udf knihoven bez problémů pracovat. Pokud byste ale provozovali novější verzi ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím a poté si nainstalovali starší verzi, pak by novější verze ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím v agendách využívajících funkce z Udf knihoven mohla vykazovat chyby. Viz rovněž Často kladené otázky a odpovědi - otázka Začaly se mi objevovat chyby typu "function XY is not defined". Dále viz Odinstalace ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím.

Udf knihovny jsou automaticky instalovány při instalaci - defaultně do cesty instalace FB. Jsou-li umístěny jinde, musí k nim být zadána odpovídající cesta v konfiguračním souboru FB.

Po update ABRA Gen je doporučeno provést kontrolu aktuálnosti příslušných souborů. Viz Další akce spojené s instalací nové verze (update) ABRA Gen.

Pokud jste instalovali novou verzi Firebird s tím, že instalační program nové verze ABRA Gen zatím neproběhl, jelikož nejdříve potřebujete spustit systém ABRA Gen v původní verzi a provést obnovu dat (aby nejdříve došlo k povýšení čísla ODS databáze a mohli jste pokračovat v procesu update ABRA Gen), musíte si tyto knihovny do příslušného adresáře nakopírovat ručně! Soubory nxudf*.dll resp. libnxudf*.so naleznete v cestě instalace systému ABRA Gen v podadresáři udfs (dle použitého databázového serveru Firebird, např. ABRAGx\udfs\Win32\).

Pro správný chod systém ABRA Gen s daňovou evidencí, resp. ABRA Gen s podvojným účetnictvím vyžaduje, aby v cestě instalace Firebird (např. c:\Program Files\Firebird\Firebird_3_0\) byly k dispozici ICU knihovny (soubory icudt69.dll, icuin69.dll a icuuc69.dll) odpovídající verze nebo verze kompatibilní. Tyto ICU knihovny jsou nutné pro správnou funkčnost databáze Firebird s kódováním Unicode, tedy od verze ABRA Gen 22.1 a vyšší.

Instalační program ABRA Gen tyto knihovny instaluje automaticky vždy na závěr instalace nové verze. Instalační program nainstaluje ICU knihovny vždy znovu, tj. i kdyby již na daném počítači byly instalovány z jiné instalace, pak je přepíše příslušnou verzí z instalace.

Po dokončení instalace je potřeba, aby se uživatel Windows, na kterém instalace probíhala odhlásil ze svého Windows účtu a následně se přihlásil. Tato operace aktivuje vytvoření proměnné do souboru firebird.msg, který je součástí instalace Firebird. To umožní následně v případě problémů lépe interpretovat chybové hlášky systému ABRA Gen.

V případě, že po dokončení instalace neproběhne odhlášení z účtu Windows a dojde při spuštění ABRA Gen k nějaké chybě, budete v rámci chybového hlášení upozornění na aktivaci proměnné v souboru firebird.msg.

Zobrazená chyba obsahuje informaci o tom, že podrobnosti o chybě je možné zobrazit až po aktivaci proměnné v souboru firebird-msg.

ICU knihovny se instalují pouze v případě operačního systému Windows. V rámci operačního systému Linux jsou již knihovny součástí instalace databázového serveru Firebird.

Ve výjimečných případech se může stát, že bude potřeba doinstalovat ICU knihovny ručně. Tyto případy mohou nastat zejména, kdy z nějakého důvodu nedoběhne proces instalace do konce, nebo je instalátor z nějakého důvodu přerušen a instalace ICU knihoven v takovém případě nenastane. V takovém případě je potřeba provést následující postup:

1) Vyhledejte složku, kde máte ABRA Gen nainstalovanou. Zde najdete podadresáře distrib a icu. Například C:\AbraGen\distrib\icu\. Z tohoto adresáře je potřeba zkopírovat všechny soubory (podle verze aplikačního serveru si vyberte složku s 32-bit nebo 64-bit soubory) do složky, kde máte instalován databázový server Firebird, např. C:\Program Files\Firebird\Firebird_3_0\

2) V dalším kroku je potřeba v adresáři s instalovaným databázovým serverem najít podadresář intl, např. C:\Program Files\Firebird\Firebird_3_0\intl a zde soubor fbintl.conf. Soubor otevřete například v Poznámkovém bloku pro editaci a na začátek souboru doplňte následující text: 

intl_module = builtin {
	icu_versions = 6.9 default
}

3) Nyní je nutný restart databázového serveru Firebird. Poté proveďte ještě odhlášení z účtu Windows a následně se do něj opět přihlaste. Tato operace je nutná z důvodu vytvoření proměnné ve Windows do souboru firebird.msg. Tato proměnná pomáhá při následných problémech lépe interpretovat chyby v chybových hlášeních.

Po instalaci se provedou mj. následující záznamy, které jsou pak používány pro předvyplňování při následných instalacích nebo je dle nich prováděna odinstalace:

  • Záznam v Přidat/Odebrat programy - přidá se jeden záznam s ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím do seznamu aktuálně nainstalovaných programů v Přidat/Odebrat programy, přičemž platí, že v seznamu Přidat/Odebrat programy je vždy jen jeden záznam a to ten, který ukazuje na poslední provedenou instalaci, a to i v případě, že máte více instalací ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím. Objasníme na příkladě:

    Mějme instalaci ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím, kterou si označíme jako ABRA-Demo, v registrech a v Přidat/Odebrat programy je jen jeden záznam ukazující na ABRA-Demo. Poté si nainstalujeme systém podruhé (ale ne jako update původní instalace, ale jako novou samostatnou instalaci do jiného adresáře a označíme si ji jako ABRA-Ostrá. Záznamy v registry a v Přidat/Odebrat programy se přepíší údaji poslední instalace, tj. ukazují na ABRA-Ostrá. Pozor, v takovém případě při odebrání z Přidat/Odebrat programy by se odebrala ABRA-Ostrá (dále viz odinstalace).

    V Přidat/Odebrat programy se může vyskytovat teoreticky i více zástupců ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím a to tehdy, pokud jste dříve provedli více instalací starších verzí ABRA Gen s daňovou evidencí resp. ABRA Gen s podvojným účetnictvím(v. 2.xx). Pokud jste však měli instalaci verze 2.xx a nyní jste provedli její update na v.3.xx, její záznam se zaktualizuje a nezdvojí.

  • Záznamy do souboru Unins000.dat a do registrů - do speciálního souboru Uninst000.dat v adresáři instalace se zapíší aktuální údaje o poslední instalaci, mj. název složky v menu Start apod. Dále se některé důležité údaje z poslední instalace zapíší i do registrů (jako např. cesta k odinstalačnímu programu, potřebná pro odinstalaci a nalezení odpovídajícího souboru Unins000.dat).