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

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ěží IS FLORES 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ě:

• 1 - pokud byla IS FLORES instalována jako singl verze (tj. demoverzní instalace nebo ostrá jednouživatelská).
• 0 - pokud byla IS FLORES instalována rovnou jako síťová verze volbou Nová ostrá instalace s licenčním klíčem, při níž byla v kroku Typ instalace zatržena možnost Síťová víceuživatelská instalace.

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.

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.

Je-li nastaveno na 1 je aktivní režim bezpečného ukončování klientské aplikace, při kterém nedochází k chybovým hlášením.

Implicitní hodnota je 1.

Interval, v kterém klient dává vědět serveru, že je stále aktivní. Aby tuto notifikaci mohl klient posílat, je nutné, aby mu operační systém přiděloval čas procesoru.

Implicitní hodnota je 60, t.j. 1 minuta.

Č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.

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 1, je aktivní režim pesimistického zamykání editace záznamů.

Implicitní hodnota je 1.

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.

Interval v sekundách, v jakém se budou obnovovat počty nevyřízených záznamů v aktivním menu. V případě zadání 0 vypnuto obnovování vypnuto.

Implicitní hodnota je 30 sekund.

Zda se má obnovovat počet nepřečtených zpráv.

Implicitní hodnota je 1.

Pokud je nastaveno na 1, bude se zapisovat informace o tom, že došlo ke změně dodavatelské ceny na artiklu. Informace se zapíše do pole Změnil na hlavičce artiklu.

Implicitní hodnota je 0.

Interval v sekundách, v jakém se budou kontrolovat nepřečtené interní vzkazy.

Implicitní hodnota je 120 sekund.

Interval v sekundách, v jakém se budou obnovovat aktivní plochy.

Implicitní hodnota je 300 sekund.

Intervaly obnovy jednotlivých aktivních ploch - pokud pro danou plochu existuje, je nadřazeno parametru ActiveDesktopRefreshInterval.

Je třeba uvést jako jmeno_plochy=počet sekund, kde jméno plochy je shodné se jménem souboru bez koncovky v adresáři roles.

Zda je povoleno měnit sklad na řádcích skladových dokladů svázaných s Provide dokumentem (napr. objednávkou). Před změnou nastavení kontaktujte dodavatele IS FLORES pro ověření funkčnosti ve vaší implementaci.

Implicitní hodnota je 0.

Expirace předpočítaných počtů nevyřízených záznamů u uzlu aktivního menu. Zadává se v minutách.

Implicitní hodnota je 30.

Zda počítat počty nevyřízených záznamů u uzlu aktivního menu na klientovi, pokud nejsou dostupné předpočítané hodnoty naplánovanou úlohou. Pokud je nastaveno na 0 (nebo není zadáno) a v systému není nastavena naplánovaná úloha typu "Výpočet počtu nezpracovaných záznamů aktivního menu", začne se v aktivním menu zobrazovat hodnota -2 znamenající "Platná předpočítaná hodnota nebyla nalezena".

Implicitní hodnota je 0.

Zda výchozí formát odesílaných emailů bude HTML.

Implicitní hodnota je 0.

Zda si pamatovat naposledy použitou tiskárnu.

Implicitní hodnota je 1.

Prodleva v milisekundách při hledání v číselnících pomocí lokátoru.

Implicitní hodnota je 333.

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é FLORES vzkazy.

Implicitní hodnota je 60 sekund.

Doba v sekundách, kdy je zobrazeno informační okno o FLORES 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 IS FLORES, 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.

Umožní zadat seznam uživatelů, kterým se nemá zobrazovat interní prohlížeč zabudovaný v systému IS FLORES (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"

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

• Je-li nastaveno na 0, spustí se aplikační server jako 32bit Windows aplikace, pokud je systém IS FLORES 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 32bit služba Windows (pouze u serveru XP/2003/Window 7/Windows 8/Windows 10), pokud je systém IS FLORES spouštěn na stejném počítači jako aplikační server.
• 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.

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.

Doba, po kterou je tolerována nečinnost klienta, pokud trvá nečinnost klienta delší dobu, je spojení s klientem ukončeno ze strany serveru. Udává se v sekundách. Činností klienta se myslí skutečná komunikace s aplikačním serverem nebo v pravidelných intervalech zasílaná notifikace.

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 serveru, využije se pouze u instalací s více než jedním aplikačním serverem na jednou počítači.

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

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.

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.

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.

Některé prvky skriptování jsou označeny atributem Deprecated. 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é).

Sekce OLE v nexus.cfg umožňuje registracicom objektů systému IS FLORES 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.

FloresOLELib.Application.Synonymum.ProgID
FloresOLELib.Application.Synonymum.ClassID
FloresOLELib.NxStrings.Synonymum.ProgID
FloresOLELib.NxStrings.Synonymum.ClassID
FloresOLELib.NxPinBoard.Synonymum.ProgID
FloresOLELib.NxPinBoard.Synonymum.ClassID
FloresOLE.Application.Synonymum.ProgID
FloresOLE.Application.Synonymum.ClassID
FloresOLE.NxStrings.Synonymum.ProgID
FloresOLE.NxStrings.Synonymum.ClassID
FloresOLE.NxPinBoard.Synonymum.ProgID
FloresOLE.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 FloresOLELib.dll i FloresOLE.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 FLORES 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 IS FLORES pod dalším ClassID a ProgID:

Syn, Synonyms

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

Spustíme FLORESOle.exe s parametrem -SYN

FLORESOle.exe -SYN

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

FloresOLELib.Application.Synonymum.ProgID=FloresOLELib.Application_???
FloresOLELib.Application.Synonymum.ClassID={91D10CD6-240B-4D9E-A0D8-052568BC0A8D}
FloresOLELib.NxStrings.Synonymum.ProgID=FloresOLELib.NxStrings_???
FloresOLELib.NxStrings.Synonymum.ClassID={8EB9983E-2DA1-49E9-9E16-73D9AB6C4648}
FloresOLELib.NxPinBoard.Synonymum.ProgID=FloresOLELib.NxPinBoard_???
FloresOLELib.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]
FloresOLELib.Application.Synonymum.ProgID=FloresOLELib.Application_SK
FloresOLELib.Application.Synonymum.ClassID={99eadd50-3b89-11e1-b86c-0800200c9a66}
FloresOLELib.NxStrings.Synonymum.ProgID=FloresOLELib.NxStrings_SK
FloresOLELib.NxStrings.Synonymum.ClassID={848eb990-3b89-11e1-b86c-0800200c9a66}
FloresOLELib.NxPinBoard.Synonymum.ProgID=FloresOLELib.NxPinBoard_SK
FloresOLELib.NxPinBoard.Synonymum.ClassID={673E17D4-964A-4350-9052-5372D92427CC}
FloresOLE.Application.Synonymum.ProgID=FloresOLE.Application_SK
FloresOLE.Application.Synonymum.ClassID={8d5594e0-3b89-11e1-b86c-0800200c9a66}
FloresOLE.NxStrings.Synonymum.ProgID=FloresOLE.NxStrings_SK
FloresOLE.NxStrings.Synonymum.ClassID={94785d20-3b89-11e1-b86c-0800200c9a66}
FloresOLE.NxPinBoard.Synonymum.ProgID=FloresOLE.NxPinBoard_SK
FloresOLE.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("FloresOLE.Application_SK") ' vytvoří instanci floresole.exe
Set mApplication = CreateObject("FloresOLELib.Application_SK") ' vytvoří instanci floresolelib.dll

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

UpdateNexusCfg

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 FLORESOle.exe s parametrem -UpdateNexusCfg a -Alias

FloresOle.exe --UpdateNexusCfg --Alias=SK

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

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

Alias

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.

SetAliasFromSuffix

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.

Je-li nastaveno na 1, bude i otevřené rozhraní používat skupiny záznamů v číselnících. Skupina se vybere podle nastavení uživatele, který se přihlašuje do otevřeného rozhraní.

Implicitní hodnota je 0.

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

Č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.

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

ServerName=firmsk.abra.eu
Username=api
Pasword=api
Port=80
Connection=firmsk

Výše uvedené údaje odpovídají výchozímu nastavení na napojení databáze provozované výrobcem. Viz napojení na veřejnou databázi firem.