Konfigurační soubor Nexus.cfg - oddíly a parametry

Nexus

Nexus

Nexus.cfg

Soubor NEXUS.CFG slouží pro základní konfiguraci systému. Vytváří se automaticky během instalace a má strukturu běžného INI souboru s několika sekcemi. Typicky obsahuje sekce [Client] a [Server]. Může ale mít i řadu dalších sekcí.

Dále je uveden seznam jednotlivých sekcí a popis vybraných konfiguračních parametrů souboru NEXUS.CFG.

Nexus

Nexus

Nexus.cfg

Slouží pro nastavení, zda má běžet v lokálním (nesíťovém) nebo síťovém režimu. Pokud je nastaveno na 1, poběží ABRA Gen v jednouživatelské konfiguraci bez aplikačního serveru, což je výchozí konfigurace pro Demo a Free verzi. Pokud je 0, jedná se o síťový provoz proti aplikačnímu serveru. Viz též Instalace síťových verzí - Správné nastavení parametrů Local, ServerName, ProviderType.

Implicitní hodnota je 1.

Parametr Local se při instalaci nastaví následovně:

Pokud tedy provádíte rozšíření ze singl instalace na instalaci síťovou, musíte mj. správně nastavit hodnotu parametru Local v souboru nexus.cfg.

Nexus

Nexus

Nexus.cfg

Jméno nebo IP adresa počítače, na kterém běží aplikační server v síťové konfiguraci. V jednouživatelské (lokální) konfiguraci nemá smysl. Viz též Instalace síťových verzí - Správné nastavení parametrů Local, ServerName, ProviderType.

Je možné místo jména počítače použít zástupné jméno localhostClosed V počítačové terminologii localhost znamená odkaz na právě používaný počítač, tj. alias pro "tento počítač" resp. na většině počítačů alias pro speciální vyhrazenou IP adresu 127.0.0.1 (v protokolu IPv4) nebo ::1 (v protokolu IPv6). Typicky je používán jako alias pro "vlastní počítač", ale nemusí tomu tak být (může být použit např. při definice spojení mezi dvěma aplikacemi ležícími na "tomtéž" serveru (z hlediska jedné aplikace leží ta druhé na tom samém právě používaném počítači). pro identifikaci stejného PC (síťový režim s apl. serverem, kdy ale klient a aplikační server běží na tomtéž PC).

ServerName=192.168.1.5

ServerName=Petr-PC

ServerName=localhost

Viz též příklady konfigurace v popisu Nesíťový/síťový provoz obecně.

Slouží k vypnutí/zapnutí kontroly, která ověřuje spuštění databázového serveru FB. Parametr se aplikuje pouze při lokální instalaci. Pokud je nastaveno na 1, kontroluje se, zda je spuštěn FB. Pokud je 0, kontrola je vypnuta. Implicitní hodnota je 1.

Časový interval v sekundách, po který bude klient čekat na odpověď serveru během TCP komunikace.

Implicitní hodnota je -2 (klient čeká na odpověď serveru nekonečně dlouho).

Velikost bufferu klienta v Bytech pro příjem.

Implicitní hodnota je 32 768, t.j. 32KB.

Velikost bufferu klienta v Bytech pro odesílání.

Implicitní hodnota je 32 768, t.j. 32KB.

Množství použitých vláken (threadů) při importu dat ze souborů databázového exportu (*.DBE). Defaultní počet je určen počtem procesorů × 2. Například DBExportThreadCount=2 (použijí se dvě vlákna pro plnění dat). Data se postupně načítají v blocích o 250 záznamech, každý blok se pak přiřadí vláknu a to následně blok zapíše do databáze.

Zde je možné nastavit spojení, ke kterému se bude připojovat OLE rozhraní, nastavení lze provést pomocí packed GUID spojení, nebo @NázevSpojení.

Číslo určí počet záznamů uložených v rámci jedné transakce při obnově dat. Čím je číslo vyšší, tím více rostou nároky na využití operační paměti. Naopak čím je číslo nižší, tím více roste režie s transakcemi databázového serveru. Číslo může být v intervalu <10..1000>.

Implicitní hodnota je 250.

Číslo určí počet bytů v rámci obnovy dat, které se maximálně načtou v rámci jedné transakce. Pokud je tohle číslo překročeno, transakce se odkomituje bez ohledu na nastavení RestoreTransactionRecordCount.

Nastavení zabrání případnému vyčerpání volné paměti v případě obnovy záznamů, které obsahují velká data.

Implicitní hodnota je 100000000.

Je-li nastaveno na 0, deaktivuje se simulace pesimistického přístupu k řešení konfliktů při souběžné editaci záznamů.

Implicitní hodnota je 1.

Časová platnost editačního zámku v milisekundách. Pokud je aktivována simulace pesimistického zamykání záznamů (viz také parametr PessimisticEditLock), udává dobu (od zahájení editace záznamu), po kterou nemůže být editace stejného záznamu zahájena znovu. Po vypršení této doby zámek zanikne a editace pokračuje v optimistickém režimu (konflikt při ukládání znamená ztrátu provedených změn pro jednoho z uživatelů).

Implicitní hodnota je 600000 (10 minut).

Uživatel s privilegiem Opravovat záznamy, které již opravuje jiný uživatel může existující zámek ještě před vypršením zrušit a nahradit vlastním (čímž připraví autora původního zámku o provedené změny).

Udává hodnotu v sekundách, po kterou je zobrazena informace o nově přijatých vzkazech. V případě zadání 0 se okno nezobrazí.

Implicitní hodnota je 10 sekund.

Pokud je nastaveno na 1, bude se většina výsledků SQL dotazů, které nevrací mnoho dat, kešovat. V současnosti použito pouze při tisku reportů.

Implicitní hodnota je 1.

Maximální velikost keše pro výsledky SQL dotazů v bytech. Má smysl jen pro QueryCaching = 1.

Implicitní hodnota je 5242880. (5 MB).

Maximální počet objektů v keši. Má smysl jen pro QueryCaching = 1. Uplatní se buď QueryCachingMaxCacheSize nebo QueryCachingMaxCacheCount, podle toho, která hodnota dříve přesáhne nastavené maximum.

Implicitní hodnota je 100 objektů.

Pokud je nastaveno na 1, přesune pomocnou tabulku SELDAT ze sekce WHERE do sekce FROM DynSQL dotazu, kde ji připojí pomocí JOIN konstrukce k hlavní tabulce. Dotaz je pak ve většině případů rychlejší. (Tabulka SELDAT se používá k filtrování za výběrové podmínky z nějakého číselníku, pokud se vybere 50 a více položek.).

Implicitní hodnota je 1.

Slouží pro kešování hodnot v uživatelsky přidaných sloupcích. Číslo určuje počet záznamů, které se budou kešovat v každém sloupci. Pokud je zvolena 0, hodnoty se nebudou kešovat.

Implicitní hodnota je 100.

Pokud je nastaveno na 1, pak se při práci s tabulkou SELDAT spouští pomocný dotaz, který vynutí uklizení tabulky SELDAT. Má smysl jen pro DB platformu FB.

Implicitní hodnota je 0.

Udává časový interval v minutách, který musí uplynout, aby se opět spustil pomocný dotaz pro uklizení tabulky SELDAT. Na začátku práce s tabulkou SELDAT se spustí vždy, poté až minimálně v odstupech, zadaných tímto parametrem.

Implicitní hodnota je 60.

Vypíná nebo zapíná kešování SQL dotazů na aplikačním serveru.

Pokud je nastaveno na 1, je kešování vypnuto.

Implicitní hodnota je 0.

Interval v sekundách, ve kterém se kontrolují nové ABRA vzkazy.

Implicitní hodnota je 60 sekund.

Doba v sekundách, kdy je zobrazeno informační okno o ABRA vzkazech.

Implicitní hodnota je 5 sekund.

Umožní spustit obnovu zálohy pořízené na novější verzi DB Enginu, než na které probíhá obnova.

Implicitní hodnota je 0.

Ovlivňuje, zda se při posílání e-mailů z různých částí systému ABRA Gen, daný e-mail vytvoří přes OLE rozhraní Outlooku, nebo přes SimpleMAPI rozhraní. (Netýká se míst, které využívají protokol mailto: nebo přímý přístup na SMTP. Více viz help.

Pokud je nastaveno na 0, pak e-mail bude posílat prostřednictvím SimpleMAPI rozhraní, přičemž se volá e-mailový klient, který je výchozím klientem pro SimpleMAPI.

Pokud je nastaveno na 1, pak je-li výchozím klientem pro SimpleMAPI rozhraní Outlook a je k dispozici OLE Outlooku, bude se e-mail posílat pomocí OLE rozhraní Outlooku; jinak jako při hodnotě 0.

Pokud je nastaveno na 2, pak se e-mail bude posílat pomocí OLE rozhraní Outlooku.

Pokud je nastavena jiná hodnota, pak jako při hodnotě 0.

Není-li SimpleMAPI rozhraní, výchozí e-mailový klient či OLE rozhraní Outlooku k dispozici, systém to ohlásí. Implicitní hodnota je 1.

Vytvořením/odesláním e-mailu přes OLE se řeší problém, kdy adresáti e-mailů nejsou schopni otevřít přílohy (dostávají je jako winmail.dat, což je způsobeno MS formátem e-mailů RTF, který bohužel Outlook chybně dosadí při odesílání e-mailů ze systému ABRA přes simple MAPI (např. odeslání tiskové sestavy přes e-mailového klienta) i v případě, že má nastaveno, aby tak nečinil). Použitím OLE technologie se potlačí vytvoření přílohy winmail.dat. Viz též help.

Umožní zadat seznam uživatelů, kterým se nemá zobrazovat interní prohlížeč zabudovaný v systému ABRA Gen (komponenta Embeded Web Browser). Např. v e-mailech, ISDOC dokumentech apod. Jedná se o řešení obcházející náhodný výskyt chyby ieframe.

WebBrowserBlackList=" Ředitel - Jaroslav Novák";"Supervisor"

Parametr určuje, zda má být při zobrazení modálního okna jeho pozadí překryto stínem. Na pomalejších počítačích nebo terminálových serverech může zobrazení stínu způsobovat problémy. Tento parametr doplňuje parametr spuštění -noveil, který má před parametrem veil přednost.

Pokud je nastaveno na 0, pak se závoj nebude zobrazovat.

Pokud je nastaveno na 1, pak se závoj bude zobrazovat.

Implicitní hodnota je 0.

Parametr umožňuje zadat alternativní URL nápovědy. Je-li nastavena, pak se po vyvolání nápovědy ze systému ABRA Gen použije tato nová URL namísto výchozí, která nemusí být vždy žádoucí. Typické scénáře:

  • Uživatel nemá k dispozici internetové připojení a nápovědu potřebuje mít umístěnou na svém lokálním nebo síťovém disku.

    HelpUrl=file:///D:/G3_CZ/Default.htm

    HelpUrl=file://///apolon/dat/G3_CZ/Default.htm

    Pro získání jednorázové offline kopie nápovědy kontaktujte zákaznickou podporu dodavatele. Pokud byste nápovědu získali svépomocí nějakým obecným nástrojem určeným ke stahování statického obsahu webových stránek, nápověda by nebyla plně funkční, zejména by v ní nefungovalo vyhledávání.

  • Uživatel chce používat nápovědu k vyšší verzi systému ABRA Gen, než kterou má nainstalovanou.

    HelpUrl=https://help.abra.eu/cs/19.2/G3/Default.htm

V rámci provádění skladové uzávěrky - ať již úplné (k datu nebo za období) nebo pouhého ocenění skladových pohybů se na dílčí skladové karty ukládají napočtené průměrné skladové ceny. Více viz položky v sekci Průměrná skladová cena. Tímto parametrem je možné ukládání napočtených průměrných skladových cen na dílčí skladové karty vypnout (SaveAverageStorePrices=0).

V minulosti byla tato funkcionalita velmi časově náročná a proces skladové uzávěrky výrazně zpomalovala. Proto bylo ukládání průměrných skladových cen na dílčí karty ve výchozím nastavení deaktivováno a v případě potřeby jej bylo nutné zapnout parametrem Ukládat průměrné skladové ceny na dílčí skladové karty v agendě Firemní údaje.

Ve verzi 18.13 došlo v oblasti aktualizace průměrných skladových cen k výrazné optimalizaci, uvedený parametr byl zrušen a průměrné ceny se při skladových uzávěrkách ukládají na dílčí skladové karty vždy (pokud není ukládání zakázáno nastavením tohoto parametru na hodnotu 0).

Výchozí hodnota parametru je 1 (tzn. napočítané průměrné ceny na dílčí skladové karty ukládat).

Parametr ovlivňuje chování našeptávače. Obsah našeptávače se aktualizuje jen ve chvílích, kdy v příslušné editační číselníkové položce přestanete měnit obsah.

Výchozí hodnota parametru je 600 (tj. našeptávač se zobrazí nebo aktualizuje až poté, co uživatel na 600 milisekund přestane psát). Nastavení je společné pro všechny našeptávače.

Příliš nízké hodnoty mohou negativně ovlivnit výkon systému.

Parametr ovlivňuje způsob ukládání nastavení (cookies a cache) doplňku Internetový prohlížeč používaného v Definovatelných formulářích. Možné hodnoty:

  • 0 (výchozí) - Nastavení prohlížeče se ukládá do složky "<UserDir>\AppData\Roaming" (při Active Directory sdílené). Pro nastavení prohlížeče v ní ABRA Gen vytvoří následující adresářovou strukturu: "ABRA Software\chromium\cache\<ID_Spojeni>\<ID_Uzivatele>".

    Pro každé spojení a každého uživatele ABRA Gen (resp. uživatele Windows) se vytváří samostatné úložiště cookies a cache. V případě, že se jedná o instalaci s Active Directory, adresář Roaming by měl být při přihlášení uživatele Windows z jakékoli stanice vždy stejný.

    Díky uložení dat do uživatelského profilu se doplněk při opakovaném zobrazení otevře vždy se stejným nastavením (např. s přihlášeným uživatelem, pokud to daná stránka vyžaduje a pokud se při přihlášení zatrhne volba "Zůstat přihlášený").

  • 1 - složka pro uložení nastavení prohlížeče se nevytváří a nastavení se ukládají pouze do paměti. Při opakovaném zobrazení doplňku nejsou hodnoty nastavení z minulého zobrazení k dispozici.

Použitý mechanismus ukládání nastavení prohlížeče má jedno známé omezení - pro každé spuštění ABRA Gen je vytvořeno pouze jedno úložiště. Pokud dojde k otevření agendy jako jiný uživatel, cookies pro prohlížeč se načítají z úložiště uživatele přihlášeného v okamžiku spuštění ABRA Gen. Do tohoto původního úložiště se také ukládají provedené změny nastavení v prohlížeči.

Parametr má hodnotu 0 nebo 1 a ovlivňuje zobrazení vývojářské konzole v definovatelném formuláři HTML editor. Pro zobrazení konzole má parametr tvar ShowChromiumDevTool=1.

Parametr povoluje (GlobalScriptingLock=0) nebo zakazuje (GlobalScriptingLock=1) paralelní spouštění skriptů.

Výchozí hodnota parametru je 0.

Zapnout globální zámek může mít smysl například v situaci, kdy voláte uložené skripty z Web API a nejste si jistí, zda jsou vaše skripty "thread safe". (Samotná technologie skriptování nezaručuje, že nikdo nenapíše skript potenciálně způsobující problémy související s vícevláknovou bezpečností.)

Pokud skripty přesto potřebujete používat (než jejich fungování ve vícevláknovém režimu prověříte), dočasným nastavením GlobalScriptingLock=1 zajistíte, že se skripty budou spouštět po jednom (v celém systému poběží v daný okamžik vždy maximálně jeden skript) a k žádným teoretickým problémům nebude moci dojít.

Parametr zakazuje (QRFuncIfErrorAsFalse=0), nebo povoluje (QRFuncIfErrorAsFalse=1) vyhodnocení QR funkce IF s chybou přes větev False.

Pokud se QR funkce IF vyhodnotí s chybou a přepínač je nastaven na QRFuncIfErrorAsFalse=1, vykoná se větev False. Přepnutím na hodnotu 1 je simulováno vyhodnocení QR funkcí z předchozích verzí.

Pokud se QR funkce IF vyhodnotí s chybou a přepínač je nastaven na QRFuncIfErrorAsFalse=0, není vykonána žádná větev IF a funkce vrátí chybu.

Výchozí hodnota je 0.

Tento parametr je pouze dočasný a z budoucích verzí bude odstraněn. Před jeho odstraněním budeme zákazníky všas informovat.

Parametr ovlivňuje chování uvolňování objektů ve skriptingu. Od verze 23.1 se vrací nutnost uvolňovat objekty vytvářené ve skriptingu pomocí funkce FREE .

Při případných problémech ve skriptech po přechodu na verzi 23.1 je dočasně možné automatické uvolňování znovu spustit tímto parametrem, přepnutím na hodnotu 1, a je potřeba informovat dodavatele aplikace prostřednictvím helpdesku.

Výchozí hodnota je 0.

Tento parametr je pouze dočasný a z budoucích verzí bude odstraněn. Odstranění je plánováno do 31.12.2022. Před jeho odstraněním budeme zákazníky včas informovat.

Pokud je tato volba zapnutá - nastavena na hodnotu 1, tak se v případě změny sloupce v tabulce vždy provede vytvoření nového sloupce, překopírování dat z původního sloupce a zrušení původního sloupce. Tato volba má vliv pouze pro databázovou platformu Oracle. Zapnutím parametru dojde ke zpomalení aktualizace. Výchozí hodnota je 0.

Pravdivostní parametr s defaultní hodnotou 0. Pomocí tohoto parametru lze při paralelním tisku přes API a skriptování zamknout funkci NxPrintByIDs, čímž se provede serializace tiskových úloh. Předejde se tak případným chybám při paralelním tisku.

Pokud je parametr nastaven na AutoSkipUpdateTables=1, pak umožňuje přeskočení operací (kromě operace create) na tabulkách a na objektech závislých na dané tabulce v případě, že tabulka neexistuje nebo je synonymem. Přeskočené operace jsou následně zapsány do logu.

Výchozí hodnota parametru je 0.

Pokud je parametr nastaven na AutoSkipUpdateTables=1, pak umožňuje přeskočení operací (kromě operace create) na tabulkách a na objektech závislých na dané tabulce v případě, že tabulka neexistuje nebo je synonymem. Přeskočené operace jsou následně zapsány do logu.

Výchozí hodnota parametru je 0.

Typ a spouštění aplikačního serveru.

  • Je-li nastaveno na 0, spustí se aplikační server jako Windows aplikace, pokud je systém ABRA Gen spouštěn na stejném počítači jako aplikační server. Viz parametr ServerName.
  • Je-li nastaveno na 1, spustí se aplikační server jako služba Windows, pokud je systém ABRA Gen spouštěn na stejném počítači jako aplikační server. Viz parametr ServerName.
  • Je-li nastaveno na 2, aplikační server se nespouští. Tato volba se typicky volí při běhu aplikačního serveru na vyhrazeném počítači (Windows i Linux). V tomto případě administrátor zajistí start aplikačního serveru standardním způsobem po startu OS.

Implicitní hodnota je 0. V produkčním prostředí je doporučená hodnota 2.

Viz též Instalace síťových verzí - Správné nastavení parametrů Local, ServerName, ProviderType.

Pro 64bit aplikační server neexistuje varianta automatického spouštění. Spouští se pouze služba AppServerS.exe.

V případě služby Windows je nejprve nutné službu zaregistrovat, což se provede spuštěním z příkazové řádky: <cesta>\AppServerS.exe /INSTALL, resp. <cesta>\AppServer64.exe /INSTALL.

Jméno souboru i s cestou v kontextu serveru, který implementuje sdílenou repozitoř.

Implicitní hodnota je <cesta>\NxStg.dll.

Jméno souboru i s cestou v kontextu serveru, který obsahuje data sdílené repozitoře.

Implicitní hodnota je <cesta>\Storage.STF.

Maximální počet nevyužitých spojení s databází. Pokud je -1, není tento počet nijak kontrolován a upravován. Má význam zejména v rozsáhlých síťových instalacích. Jedná se o kompromis mezi časem potřebným k vytvoření spojení s SQL serverem a tím, že každé zbytečně vytvořené spojení čerpá jisté zdroje serveru (paměť, TCP/IP spojení atd.).

Implicitní hodnota je 0.

Doba životnosti nevyužitého spojení s databází (v sekundách). Nevyužitá spojení jsou odložena, a pokud nejsou v definované době znovu využita nějakým klientem, uvolní se.

Implicitní hodnota je 360, t.j. 6 minut.

Časový interval v sekundách, po který bude server čekat na dodání dat od klienta během TCP komunikace.

Implicitní hodnota je 60 sekund (jestliže data z klienta nedorazí na server ve stanoveném intervalu, bude jej server považovat za nefunkčního a ukončí s ním komunikaci).

Číslo TCP/IP portu, pomocí něhož spolu klient a server komunikují. Pro konkrétní aplikační server a všechny jeho klienty musí být toto nastavení stejné, jinak by komunikace principiálně nefungovala. Proto se nastavení nalézá pouze v jedné ze sekcí (v server) i když si informaci z něho čerpá jak serverová tak i klientská strana. Tohoto nastavení se využívá také u instalací s více než jedním aplikačním serverem na jednou počítači kde musí každý z aplikačních serverů mít nastaven svůj vlastní komunikační port.

Implicitní hodnota je 8090.

Doplněk ke jménu služby Windows aplikačního a Web API serveru. Využije se u instalací s více než jedním aplikačním, resp. Web API serverem na jednou počítači.

Hodnota parametru nesmí obsahovat znak tečky (.) - v takovém případě se služba nenainstaluje, ani se nezobrazí žádné chybové hlášení.

Parametr byl zrušen. Jako náhrada byly přidány odpovídající informace do nástroje AppServerProp.

Cesta k dynamické knihovně OCI (Oracle Call Interface).

Výchozí hodnota je prázdný řetězec (cesta se dohledá automaticky).

Cesta k dynamické knihovně OCI (Oracle Call Interface), která je vhodná pro 32-bitové aplikace (např. instalátor, DBTool, skripty atp.), pokud uživatel používá 64-bit aplikační server.

Pokud se parametr nastaví, tak ve 32bit Windows programech jejich nastavení překryje nastavení parametru OCIDLL. V ostatní případech (64bit aplikace, linuxové aplikace) se nastavení parametru nebere v potaz, vždy se načtou hodnoty z OCIDLL.

Výchozí hodnota je prázdný řetězec (cesta se dohledá automaticky).

Cesta k dynamické knihovně fbclient.dll na Windows nebo libfbclient.so na Linuxu.

Výchozí hodnota je prázdný řetězec (cesta se dohledá automaticky).

Cesta k dynamické knihovně fbclient.dll na Windows nebo libfbclient.so na Linuxu, která je vhodná pro 32-bitové aplikace (např. instalátor, DBTool, skripty atp.), pokud uživatel používá 64-bit aplikační server.

Pokud se parametr nastaví, tak ve 32bit Windows programech jejich nastavení překryje nastavení parametru FBClientDLL. V ostatní případech (64bit aplikace, linuxové aplikace) se nastavení parametru nebere v potaz, vždy se načtou hodnoty z FBClientDLL.

Výchozí hodnota je prázdný řetězec (cesta se dohledá automaticky).

Vypíná nebo zapíná větší krok při generování identifikátorů objektů (tzv. OID).

Pokud je nastaveno na 1, OID se generují po kroku 1296. Pokud je nastaveno 0, OID se generují po kroku 36 (tedy jako dosud).

Implicitní hodnota je 0.

NetBIOS název domény pro přihlášení přes doménový server na OS Windows. Podrobně viz Přihlášení přes doménový server.

Čas, po který bude spojení čekat na nějakou komunikaci. Po uplynutí tohoto času začne aplikační server kontrolovat, zda spojení není přerušené. Výchozí hodnota je 360(s).

Interval mezi dvěma pokusy o navázání spojení s klientem. Výchozí hodnota je 1(s).

Určuje, zda se pro instanci ABRA Gen má používat Vizualizace dat.

Je-li podpora zapnuta, ale potřebujete nějakou instanci systému ABRA Gen či spojení ABRA Gen spustit bez Vizualizace dat, můžete tak učinit také prostřednictvím jiných nastavení. Viz Jak potlačit zobrazení Vizualizace dat.

Implicitní hodnota je 1. Tj. pokud není parametr uveden, je podpora zapnuta.

Určuje port, na kterém se má Vizualizace dat spouštět.

Implicitní hodnota je 8081.

Určuje server, na kterém se má Vizualizace dat hledat. Implicitní hodnota je localhost.

Určuje protokol pro komunikaci s Vizualizací dat (může by http nebo https).

Implicitní hodnota je http.

Cesta k adresáři Javy.

Výchozí hodnota je cesta do kořenového adresáře systému ABRA Gen do podadresáře AbraBI\<jre.linux nebo jre.win>\.

Pokud je hodnota nevyplněná, tak to, do jaké složky Javy jakého operačního systému v podadresáři AbraBI si má systém ABRA Gen sáhnout, systém ABRA Gen pozná podle spuštěného aplikačního serveru. Např. pokud je spuštěný linuxový aplikační server, sáhne si do složky AbraBI\jre.linux\.

Cesta musí být zakončena lomítkem.

JREPath=c:\Java\jre1.8.0_161\

Cesta, která se připojí k url adrese pro získání dat z Vizualizace dat. Typicky se použije tehdy, když Vizualizace dat neběží na vestavěném aplikačním serveru Jetty, ale např. na Apache Tomcat.

Implicitní hodnota je nevyplněno.

Určuje, zda má aplikační server spouštět automaticky Vizualizaci dat.

Určuje, zda se při spuštění aplikačního serveru vymaže občas dočasných adresářů vestavěného aplikačního serveru Jetty.

Implicitní hodnota je True.

Slouží pro konfiguraci webové aplikace Úkoly v případě, že z důvodu specifické síťové konfigurace webová aplikace nedokáže automaticky získat informace potřebné ke komunikaci s aplikací ABRA Gen.

Parametr slouží k zadání alternativní URL adresy, na které se nachází webová aplikace Úkoly (respektive statická HTML stránka obsahující odkazy pro načtení aplikace z internetu). Podrobnosti naleznete v popisu aplikace Úkoly, konkrétně v sekci Poznámky k umístění aplikace a připojení k datům.

V parametru je možné použít substituční proměnnou {connection}, za kterou se dosadí název nebo alias aktuálního spojení.

URL=https://api.companyname.com/{connection}/webapps/tasks

Implicitní hodnota obsahuje adresu a port, na kterých běží aplikační server a aktuální spojení:

{protokol}://{server}:{port}/{spojení}/app/tasks

V případě problémů se zprovozněním aplikace s využitím alternativní URL adresy kontaktujte dodavatele systému.

Slouží pro konfiguraci serveru proxy. Systém ABRA Gen umožňuje přistupovat přímo k internetovým zdrojům např.: Hlavní okno pro spouštění agend může být konfigurováno s odkazy do sítě internet. A pokud je v dané komunikační infrastruktuře (firmě) pro přístup k internetu používán tzv. Proxy server, je třeba zadat následující podrobnosti připojení, aby bylo možné z aplikace ABRA Gen k síti internet přistupovat.

IP adresa serveru proxy.

Implicitní hodnota je prázdný řetězec, spojení bez serveru proxy.

Číslo TCP/IP portu, na kterém běží http server proxy.

Implicitní hodnota je 0.

Jméno uživatele pro ověření serverem proxy.

Implicitní hodnota je prázdné jméno.

Heslo uživatele pro ověření serverem proxy.

Implicitní hodnota je prázdné heslo. V závislosti na nastavení parametru ProxyPasswordType může být heslo uložené jako prostý text nebo zašifrované.

Je-li nastaveno na 1, systém předpokládá, že hodnota parametru ProxyPassword obsahuje heslo v zašifrované podobě.

K zašifrování použijte nástroj Zašifrování hesla pro proxyserver v agendě Pomocné nástroje administrace.

Implicitní hodnota je 0 (což znamená, že hodnota parametru ProxyPassword obsahuje heslo ve formě prostého textu).

Je-li nastaveno na 1, mohou uživatelé konfigurovat individuální server proxy. Lokální nastavení pak bude upřednostněno před globálním.

Implicitní hodnota je 1.

Zda je povolena podpora ladění skriptů pomocí nástroje ScriptDebugger. Pokud není uvedeno, je podpora zapnuta. Zapnutá podpora může ve výjimečných případech na některých konfiguracích windows způsobovat pomalejší start systému ABRA Gen.

Parametr pro konfiguraci portu. Není-li nastaven, použije se výchozí hiodnota.

Výchozí hodnota: 8438

Některé prvky skriptování jsou označeny atributem DeprecatedClosed Atribut označující nějaký prvek jako zastaralý. Typicky se jedná o prvek, který je v budoucnu určen ke zrušení (byl např. nahrazen nějakým jiným prvkem, jinou funkcionalitou).. Takto označené prvky lze zatím ve skriptování používat, ale v budoucnosti se s nimi nepočítá, protože byly nahrazeny alternativním kódem.

Aby se takové prvky nenabízely k použití, lze je skrýt nastavením parametru HideDeprecated = 1.

Implicitní hodnota je nula (při ní deprecated prvky nejsou skryté).

Některé prvky skriptování jsou označeny atributem Malfunction. Takto označené prvky nefungují správně a v budoucnosti budou ze skriptingu odstraněny. Aby se takové prvky nenabízely k použití, lze je skrýt nastavením parametru HideMalfunction = 1.

Implicitní hodnota je nula (při ní malfunction prvky nejsou skryté).

Slouží pro konfiguraci otevřeného rozhraní.

Sekce OLE v nexus.cfg umožňuje registraci com objektů systému ABRA Gen pod dalším ClassID a ProgID, což umožňuje registraci "dalšího" OLE na jednom PC. V této sekci se nastaví nové názvy pro objekty a jejich ClassID. CLassID je UUID, které je možné vygenerovat například na stránce: http://www.famkruithof.net/uuid/uuidgen.

AbraOLELib.Application.Synonymum.ProgID
AbraOLELib.Application.Synonymum.ClassID
AbraOLELib.NxStrings.Synonymum.ProgID
AbraOLELib.NxStrings.Synonymum.ClassID
AbraOLELib.NxPinBoard.Synonymum.ProgID
AbraOLELib.NxPinBoard.Synonymum.ClassID
AbraOLE.Application.Synonymum.ProgID
AbraOLE.Application.Synonymum.ClassID
AbraOLE.NxStrings.Synonymum.ProgID
AbraOLE.NxStrings.Synonymum.ClassID
AbraOLE.NxPinBoard.Synonymum.ProgID
AbraOLE.NxPinBoard.Synonymum.ClassID

U každého com objektu je potřeba nastavit nové unikátní ProgID a ClassID, viz výše. Jakmile je všechno nastaveno, je třeba com objekt přeregistrovat. Tj. po úpravě Nexus.cfg je potřeba znovu zaregistrovat AbraOLELib.dll i AbraOLE.exe pomocí agendy Nastavení klienta!

Kromě původní registrace je pak com objekt dostupný i pod registrací zadanou v této sekci.

Díky tomu je možné provozovat současně com objekty z různých instalací systému ABRA současně - samozřejmě za předpokladu, že mají parametry, zadané v této sekci, odlišné.

Pokud se parametry změní nebo smažou a objekt byl takto zaregistrovaný, zůstanou záznamy v registrech. Ty se v případě potřeby musí odstranit ručně. Proto je lepší před případnou změnou provést odregistraci, která provede úpravu registrů automaticky.

Původní ClassID a ProgID com objektů zůstává zachováno a ukazuje na naposled zaregistrovanou instanci com objektů.

Šablonu pro všechny výše uvedené parametry je možné vygenerovat spuštěním AbraOle.exe s parametrem -SYN nebo -SYNONYMS. Případně si lze sekci [OLE] nechat zadat i automaticky pomocí parametrů -UpdateNexusCfg, -Alias a -SetAliasFromSuffix.

Parametry pro podporu registrace com objektů systému ABRA Gen pod dalším ClassID a ProgID:

Spuštěním AbraOle.exe s parametrem -SYN nebo -SYNONYMS lze vygenerovat šablonu pro všechny výše uvedené parametry.

Spustíme ABRAOle.exe s parametrem -SYN:

ABRAOle.exe -SYN

V dialogovém okně se zobrazí šablona pro vložení do Nexus.cfg.


AbraOLELib.Application.Synonymum.ProgID=AbraOLELib.Application_???
AbraOLELib.Application.Synonymum.ClassID={91D10CD6-240B-4D9E-A0D8-052568BC0A8D}
AbraOLELib.NxStrings.Synonymum.ProgID=AbraOLELib.NxStrings_???
AbraOLELib.NxStrings.Synonymum.ClassID={8EB9983E-2DA1-49E9-9E16-73D9AB6C4648}
AbraOLELib.NxPinBoard.Synonymum.ProgID=AbraOLELib.NxPinBoard_???
AbraOLELib.NxPinBoard.Synonymum.ClassID={4C51A7F0-B41D-4B08-9F38-8604A5F000A8}
atd.

Znaky ??? příp. ProgID je třeba nahradit vlastním unikátním názvem a takto to vložit jako sekci OLE do Nexus.cfg. Poté je třeba OLE komponenty přeregistrovat.


[OLE]
AbraOLELib.Application.Synonymum.ProgID=AbraOLELib.Application_SK
AbraOLELib.Application.Synonymum.ClassID={99eadd50-3b89-11e1-b86c-0800200c9a66}
AbraOLELib.NxStrings.Synonymum.ProgID=AbraOLELib.NxStrings_SK
AbraOLELib.NxStrings.Synonymum.ClassID={848eb990-3b89-11e1-b86c-0800200c9a66}
AbraOLELib.NxPinBoard.Synonymum.ProgID=AbraOLELib.NxPinBoard_SK
AbraOLELib.NxPinBoard.Synonymum.ClassID={673E17D4-964A-4350-9052-5372D92427CC}
AbraOLE.Application.Synonymum.ProgID=AbraOLE.Application_SK
AbraOLE.Application.Synonymum.ClassID={8d5594e0-3b89-11e1-b86c-0800200c9a66}
AbraOLE.NxStrings.Synonymum.ProgID=AbraOLE.NxStrings_SK
AbraOLE.NxStrings.Synonymum.ClassID={94785d20-3b89-11e1-b86c-0800200c9a66}
AbraOLE.NxPinBoard.Synonymum.ProgID=AbraOLE.NxPinBoard_SK
AbraOLE.NxPinBoard.Synonymum.ClassID={E53F3D8A-E6E1-4C32-931B-AFB4C37638D0}

Takto zaregistované OLE je možné pak zavolat například následovně (uvedený příklad je ve VisualBasic skriptu):

Set mApplication = CreateObject("AbraOLE.Application_SK") ' vytvoří instanci abraole.exe
Set mApplication = CreateObject("AbraOLELib.Application_SK") ' vytvoří instanci abraolelib.dll

Parametr /SYN Lze použít i v kombinaci s parametry /SetAliasFromSuffix a /Alias=<alias>. Pak se místo '???' zobrazí zadaný alias.

Jeden z parametrů umožňující automatické zadání sekce [OLE] do souboru nexus.cfg. Alternativa k parametru /syn, adekvátně se upraví nexus.cfg.

Zapíše do souboru nexus.cfg do sekce [OLE] konfiguraci otevřeného rozhraní s aliasem zadaným parametrem /SetAliasFromSuffix nebo /Alias.

Syntaxe: --UpdateNexusCfg nebo -UpdateNexusCfg nebo /UpdateNexusCfg

Spustíme ABRAOle.exe s parametrem -UpdateNexusCfg a -Alias

AbraOle.exe --UpdateNexusCfg --Alias=SK

Zapíše do nexus.cfg do sekce [OLE]:

[OLE]
AbraOLELib.Application.Synonymum.ProgID=AbraOLELib.Application_SK
AbraOLELib.Application.Synonymum.ClassID={CBF07152-783E-4C05-A30E-9F0DC57AE330}
AbraOLELib.NxStrings.Synonymum.ProgID=AbraOLELib.NxStrings_SK
AbraOLELib.NxStrings.Synonymum.ClassID={85F67B03-6EB9-46AE-8796-ED1280B62EF3}
AbraOLELib.NxPinBoard.Synonymum.ProgID=AbraOLELib.NxPinBoard_SK
AbraOLELib.NxPinBoard.Synonymum.ClassID={C7253585-CC7A-4558-AA88-37851B4B1344}
AbraOLE.Application.Synonymum.ProgID=AbraOLE.Application_SK
AbraOLE.Application.Synonymum.ClassID={3421789B-DD12-42CD-B1F3-AEC9D260113E}
AbraOLE.NxStrings.Synonymum.ProgID=AbraOLE.NxStrings_SK
AbraOLE.NxStrings.Synonymum.ClassID={C58B0207-425C-4763-B2AF-62DFC86D9FC8}
AbraOLE.NxPinBoard.Synonymum.ProgID=AbraOLE.NxPinBoard_SK
AbraOLE.NxPinBoard.Synonymum.ClassID={8F2CA3A4-8880-45A3-9DF0-E8CF6F5A24AC}
NxServ.NxAccRep.Synonymum.ProgID=NxServ.NxAccRep_SK
NxServ.NxAccRep.Synonymum.ClassID={55477D3D-9B2F-43AF-A293-104CA69A9DB7

Jeden z parametrů umožňující automatické zadání sekce [OLE] do souboru nexus.cfg. Vezme jako alias text za znakem '=' nebo ':'.

Syntaxe: --Alias nebo -Alias nebo /Alias

  • /Alias=<alias>
  • /Alias:<alias>

Parametr lze použít i v kombinaci s parametrem /Syn. Pak se místo '???' zobrazí zadaný alias.

Syntaxe: --SetAliasFromSuffix nebo -SetAliasFromSuffix nebo /SetAliasFromSuffix

Jeden z parametrů umožňující automatické zadání sekce [OLE] do souboru nexus.cfg. Vezme jako alias hodnotu ServiceNameSuffix ze sekce [Server].

Parametr lze použít i v kombinaci s parametrem /Syn. Pak se místo '???' zobrazí zadaný alias.

Parametry jsou case-insensitive, je tedy možné použít /UpdateNexusCfg, /updatenexuscfg i /UPDATENEXUSCFG.

Je-li nastaveno na 1, bude zobrazena ikona AbraOLE v oznamovací oblasti Windows.

Implicitní hodnota je 0.

Slouží k nahrazení ostrého registru DPH za testovací, který slouží k testování registru nespolehlivých plátců.

Je-li nastaveno na 1, bude k zavolání webové služby použita adresa WebServiceURL.

Slouží pro dosazení testovací služby registru DPH pro nespolehlivé plátce (http://mfwwwit-1.mfcr.cz/adistc/axis2/services/rozhraniCRPDPH.rozhraniCRPDPHSOAP).

Slouží k ovlivňování tzv. nepoužitých čísel.

Zvýšením hodnot parametrů CleanInterval, CleanCorrectedTimeDelta a NewOrdNumberTryInterval je možné snížit režii čisticího mechanismu (snížit jeho dopad na vytížení systému). Nevýhodou je prodloužení časového intervalu mezi událostí, která způsobila ztrátu nepoužitého čísla dokladu, a uvolněním tohoto čísla k opětovnému použití.

Časový interval v sekundách, během kterého se spouští čistící proces. Tj. interval, po kterém se systém pokusí záznamy, které mají v tabulkách DocQueueUnusedNumbers, AccDocQueueUnusedNumbers a CRMActivityQueueUnusedNumbers ve sloupci Reserved hodnotu A, přepnout na hodnotu N.

Výchozí hodnota je 20, minimální 10.

Časový rozdíl v sekundách, který určuje, jak minimálně staré záznamy bude čistící proces zpracovávat.

Toto opatření je proto, aby se zabránilo pokusům o odblokování nepoužitého čísla, pokud ukládání dokladu ještě neskončilo.

Výchozí hodnota je 30, minimální 10.

Časový interval v sekundách, během kterého se systém pro přidělování čísla dokladu pokouší opakovaně získat nepoužité číslo. Opakované získávání se děje jen v případě chyb plynoucích z konkurenčního přístupu k databázi.

Výchozí hodnata je 30, minimální 1.

Limit pro maximální počet najednou opravovaných čísel (ve všech spojeních na databázi dohromady, viz podrobnější vysvětlení níže).

Výchozí hodnota je 20.

Čisticí proces zvyšuje počet spojení aplikačního severu (případně přímo aplikace ABRA Gen v případě jednouživatelské instalace) s databázovým serverem.

Pro každé spojení na databázi v ABRA Gen se otevřou tři spojení mezi databázovým serverem a aplikačním serverem, případně aplikací: jedno pro doklady, druhé pro hromadně účtované doklady a třetí pro CRM aktivity. Každé z těchto spojení si otevře vlastní čisticí spojení, které opravuje nepoužitá čísla. Jakmile se spojení na nějakém čísle "zasekne" (číslo z nějakého důvodu není možné uvolnit, např. je blokováno jinou akcí) na delší dobu než jednu sekundu, zůstane spojení otevřené (dokud nepomine důvod, proč oprava čísla není možná) a vytvoří se nové čisticí spojení, které pokračuje dál (odblokovává další čísla). Nové spojení se může opět zaseknout, načež se vytvoří další. Tímto způsobem může počet čisticích spojení postupně narůstat.

Za standardních okolností by k situacím bránícím rušením rezervací nepoužitých čísel nemělo docházet, čisticí proces by měl běžet plynule a počet otevřených spojení s databázovým serverem by neměl trvale stoupat. Pokud však taková situace nastane, může dojít k vyčerpání dostupných databázových spojení.

Z tohoto důvodu byl zaveden limit pro maximální počet najednou opravovaných čísel, který se nastavuje parametrem MaxProcessed. Jakmile je dosaženo tohoto limitu (případně výchozí hodnoty 20), nová čisticí spojení se již nevytvářejí. Čisticí proces se pozastaví a znovu se rozběhne až po pominutí důvodu, který brání odblokování některého z čísel. Čištění pokračuje do doby, než je opět dosaženo limitu. Proto již nedochází k případům, kdy z důvodu nemožnosti opravit větší počet nepoužitých čísel dojde k nekontrolovatelnému nárůstu čisticích spojení.

Otevřené čisticí procesy (včetně čisticích procesů "zaseklých" na momentálně neopravitelných číslech) blokují ukončení aplikačního serveru - aplikační server se ukončí až po korektním doběhnutí všech čisticích procesů.

Slouží k ovlivňování chování funkcionality obecné ochrany dat.

Časový interval obnovy cache ochrany dat. Udává se v sekundách, výchozí hodnota je 36000 (10 hodin).

Nastavení intervalu na příliš nízkou hodnotu může mít výrazný negativní dopad na odezvy systému ABRA Gen.

Slouží pro logování běhu systému ABRA Gen a je popsáno v samostatné kapitole.

Např.:

  • [Logs] pro zapnutí samotného logování
  • [Log.ExceptionHook] pro logování chyb typu "výjimky"
  • [Log.ExceptionHooked] pro logování zapínání/vypínání logování chyb typu "výjimky"
  • [Log.Licence] pro lepší diagnostiku využití licencí
  • [Log.SCM] pro logování SCM (např. časy načítání jednotlivých datových zdrojů do SQL Lite, dotazování SQL Lite,...)
  • [Log.SQL] pro logování probíhajících SQL dotazů, atd.
  • atd.

Více viz kap. Logování běhu aplikace.

Slouží k ovlivňování chování panelů definovatelných údajů, viz Technická specifikace panelů definovatelných údajů.