Nastavení NET Genia

1. Nastavení NET Genia

• Nastavení NET Genia je k dispozici všem uživatelům s administrátorským oprávněním.
• Ikona pro vyvolání dialogu nastavení NET Genia je umístěna v toolbaru v navigační oblasti v administrátorském režimu. Toolbar se zobrazí kliknutím na ikonu ozubeného kolečka, nebo na nápis NET Genium umístěný napravo vedle této ikony.

1.1. Upozornění pro administrátora

• Ikona „Upozornění pro administrátora...“ v toolbaru „NET Genium“ otevře v novém okně stránku s textem upozornění a s komentáři administrátorů. Stránka je přístupná pouze uživatelům s administrátorským oprávněním.
• Text upozornění se uloží tlačítkem „Uložit upozornění pro administrátora“. Neprázdný text se zobrazí každému uživateli s administrátorským oprávněním po přihlášení jménem a heslem v přihlašovacím okně nebo v dialogu „Změna hesla“ a po vynucené změně hesla; po přihlášení jinými cestami (přihlášení přes Microsoft, přihlašovací ticket, Windows autentizace) se nezobrazí. Upozornění se zruší uložením prázdného textu.
• Tlačítko „Vložit komentář“ přidá komentář do tabulky „Komentáře (Historie)“ spolu s přihlašovacím jménem autora a datem. Do téže tabulky se zapisuje i každý uložený neprázdný text upozornění.
• Ikony v titulku tabulky „Komentáře (Historie)“ smažou celou historii, nebo jen záznamy starší než 6 měsíců.

1.2. Restartovat

• Položka „Restartovat“ v toolbaru „NET Genium“ restartuje NET Genium po potvrzení dotazu, bez zadávání hesla. Je-li potřeba promítnout konfigurační soubory do souboru „Web.config“ nebo „bin\RunScript.exe.config“, nabízí se místo ní položka „Dokončit aktualizaci“. Existuje-li konfigurační soubor „DenyLogin.txt“, nefungují ani tyto položky.
• Restart nejdříve upraví soubor „Web.config“ podle konfiguračních souborů „DenyCookieless.txt“, „ExecutionTimeout.txt“, „Framework.txt“, „MaxRequestLength.txt“, „SessionTimeout.txt“ a „SSL.txt“ a souboru „bin\ngef.dll.config“ a přesměrování verzí knihoven ze souboru „bin\ngef.dll.config“ doplní i do souboru „bin\RunScript.exe.config“ – změna těchto souborů se tak projeví i bez aktualizace NET Genia. Promítá se jen nastavení, které soubory zapínají nebo mění oproti výchozí hodnotě; smazáním konfiguračního souboru ani návratem k výchozí hodnotě se soubor „Web.config“ do původního stavu nevrátí. Totéž platí pro restart heslem na webové stránce „url-netgenia/restart“. Jiný restart webové aplikace (recyklace aplikačního poolu, výměna knihoven v adresáři „bin“) soubor „Web.config“ neupravuje.
• Položky se nabízejí pouze v plných instalacích NET Genia – v cloudové variantě NET Genium Online ani při existenci konfiguračního souboru „Demo.txt“ se nezobrazují.

2. Seznam záložek v dialogu nastavení NET Genia

• Obecné – Nastavení obecných vlastností NET Genia
• E-maily – Nastavení e-mailů
• Tiskové šablony – Nastavení tiskových šablon
• Oprávnění – Nastavení oprávnění
• Hesla – Nastavení hesel
• Barvy – Nastavení barev
• Ostatní – Nastavení ostatních vlastností

2.1. Záložka „Obecné“

2.1.1. Název

• Název NET Genia zobrazovaný v záložce webového prohlížeče.
• Název NET Genia je uložený v serverové proměnné „#portal#“.

2.1.2. Verze

• Verze NET Genia zobrazovaná v záhlaví portálu (na mobilním zařízení v titulku záhlaví) a jako předpona předmětu všech odchozích e-mailových zpráv.
• Hodnota může obsahovat HTML; v předmětu e-mailových zpráv se značky HTML odstraní.

2.1.3. Adresa portálu

• Intranetová adresa – seznam těchto adres oddělených Enterem bude použit při inicializaci NET Genia ve více instancích.
  • Je-li vyplněno více adres, sdílejí procesy webové aplikace nad touž databází (například více aplikačních poolů nebo serverů) informaci o změnách: změna aplikací (mimo jiné aplikačních skupin, aplikací, kategorií, nahlížecích stránek, editačních formulářů, ovládacích prvků, databázových dotazů, skriptů a práv k nim), povolených IP adres, veřejných externích funkcí nebo vlastní palety barev provedená v jednom procesu zneplatní uložené kopie těchto údajů i v ostatních procesech.
  • Není-li vyplněno více adres, nemusí se tyto změny v ostatních procesech nad touž databází projevit dříve než po jejich restartu.
  • Část Nastavení NET Genia, kterou si proces drží v paměti (například SMTP server pro e-maily odesílané NET Geniem, síla hesel nebo časové pásmo, ve kterém se zobrazují data), se v ostatních procesech nad touž databází projeví až po jejich restartu, bez ohledu na počet vyplněných adres.
• Internetová adresa – seznam těchto adres oddělených Enterem bude použit v e-mailových zprávách posílaných skriptem a zajistí možnost přesměrování uživatele do NET Genia ke konkrétním záznamům. Není-li internetová adresa vyplněná, použije se v e-mailových zprávách intranetová adresa.
• Seznam adres v každém z obou polí se ukládá v délce nejvýše 250 znaků; delší seznam se zkrátí.
• V cloudové variantě NET Genium Online se obě pole nezobrazují — adresu instance určuje její identifikátor („identifikator.netgenium.online“) a NET Genium ji do odchozích e-mailových zpráv doplňuje samo.

2.1.4. Časové pásmo

• Časové pásmo NET Genia je automaticky nastaveno na časové pásmo serveru, na kterém je NET Genium hostováno.
• Výběrem konkrétního časového pásma z rozbalovacího seznamu je možné toto nastavení změnit na požadovanou hodnotu.
• V cloudové variantě NET Genium Online se časové pásmo volí při registraci instance.
• Časové pásmo se uplatní na datumové údaje, které platforma sama zapisuje, i na jejich zobrazení — například na hodnoty proměnných „#now#“ a „#today#“ a na výchozí hodnoty datumových ovládacích prvků. Datum a čas doplňované tlačítky u datumových a časových polí a javascriptovými funkcemi „Now“ a „Now2“, aktuální datum v záhlaví a zvýraznění dnešního dne v kalendáři a plánovačích odpovídají časovému pásmu, ve kterém uživatel časy vidí (viz níže).
• Změna časového pásma nepřepočítává už uložené hodnoty, mění pouze jejich výklad. Je proto vhodné ho nastavit při zavádění instance, ne v průběhu jejího používání.
• Jednotliví uživatelé si mohou nechat časy zobrazovat ve svém vlastním časovém pásmu — v jejich uživatelském účtu k tomu slouží pole Časové pásmo a Zobrazovat časy v mém časovém pásmu. Převod je pouze zobrazovací: do databáze se hodnota vždy ukládá v časovém pásmu instance, takže podmínky databázových dotazů, hodnoty proměnných „#now#“ a „#today#“ ve skriptech ani statistické dotazy se nemění. Převádějí se jen hodnoty, které nesou čas — datum bez času (například datum splatnosti) není okamžikem a zůstává beze změny.
  • Pole Časové pásmo a Zobrazovat časy v mém časovém pásmu mají jen nově založené instalace NET Genia; do starších instalací se zatím nedoplňují.
  • V pásmu uživatele se zobrazují a zadávají hodnoty v editačním formuláři, v nahlížecí tabulce, v kalendáři, plánovačích a v exportu i importu dat nahlížecí tabulky. Filtry a hledání v nahlížecí tabulce se naopak zadávají v časovém pásmu instance, stejně jako hodnoty proměnných „#ng_...:value#“.
• Tiskové šablony a exporty se řídí časovým pásmem uživatele, který tiskne nebo exportuje. V e-mailu sestaveném krokem skriptu „Odeslat e-mail“ se časovým pásmem uživatele řídí hodnoty ovládacích prvků vypsané v jeho těle, a to pásmem uživatele, jehož akce e-mail odeslala — obvykle toho, jehož akce skript spustila. E-mail z ukládacích skriptů (OnBeforeSave, OnAfterSave) záznamu, u kterého uložení změnilo některý synchronizovaný sloupec, se odešle až spolu s odesláním změn k synchronizaci a rozhoduje uživatel, jehož akce toto odeslání spustila.

2.1.5. Formát data

• Formát data určuje pořadí dne a měsíce v krátkém datu napříč celou aplikací – při zobrazování i při zadávání a čtení datumů ve formulářích, filtrech a skriptech – bez ohledu na jazyk uživatele. Oddělovač (tečka nebo lomítko) a desetinný oddělovač čísel se řídí jazykem uživatele.
• Rozbalovací seznam obsahuje následující možnosti:
  • dd/mm/yyyy – den, měsíc, rok
  • mm/dd/yyyy – měsíc, den, rok

2.1.6. Výchozí mapa

• Výchozí mapa definuje výchozí geografický střed všech mapových podkladů, které v aktuálně zobrazované vizualizaci dat neobsahují žádné body na mapě. V ostatních případech je geografický střed vypočítán automaticky ze všech zobrazovaných bodů na mapě. Střed, na který si uživatel mapu posunul, si NET Genium pamatuje pro každého uživatele zvlášť a ten má přednost před oběma.
• Podle výchozí mapy se řídí vyhledávání adres uložených v ovládacích prvcích typu „TextBox“ s názvem „Najít na mapě“, „Nájsť na mape“ nebo „Find on map“.
• Rozbalovací seznam obsahuje následující možnosti:
  • Česká republika – vyhledávání adres nabízí mapové portály „maps.google.cz“ a „www.mapy.cz“.
  • Slovensko – vyhledávání adres nabízí mapový portál „maps.google.sk“.
• V cloudové variantě NET Genium Online se pole nezobrazuje a rozbalovací seznam nenabízí žádnou zemi — nastavení zůstává prázdné a NET Genium se chová stejně jako při volbě „Česká republika“.

2.1.7. Fulltextový katalog

• Katalog pro funkci fulltextového prohledávání obsahu souborových příloh. Obsah se prohledává jen u ovládacího prvku File a jen v souborech s vybranými příponami – detailní popis je uveden v samostatné příručce Editační formulář – File.
• Rozbalovací seznam obsahuje následující možnosti:
  • Žádný – během vyhledávání hodnot v nahlížecích tabulkách se neprohledává obsah souborových příloh; názvy souborů se prohledávají vždy.
  • Windows Search – během vyhledávání hodnot v nahlížecích tabulkách se prohledává i obsah souborových příloh pomocí fulltextového katalogu „Windows Search“. Detailní popis konfigurace fulltextového katalogu „Windows Search“ je uveden v samostatné příručce Instalace NET Genia na webovém serveru.
  • Indexing Service – během vyhledávání hodnot v nahlížecích tabulkách se prohledává i obsah souborových příloh pomocí služby „Indexing Service“ v katalogu, jehož název je zadaný v textovém poli pod rozbalovacím seznamem fulltextového katalogu. Služba „Indexing Service“ byla naposledy dostupná v operačním systému „Windows Server 2008“, proto doporučujeme její užívaní nahradit fulltextovým katalogem „Windows Search“. Detailní popis konfigurace fulltextového katalogu „Windows Search“ je uveden v samostatné příručce Instalace NET Genia na webovém serveru.
• V cloudové variantě NET Genium Online se rozbalovací seznam ani textové pole s názvem katalogu nezobrazují — fulltextové prohledávání souborových příloh není v cloudu k dispozici.

2.2. Záložka „E-maily“

2.2.1. Výchozí odesílatel všech zpráv

• E-mailová adresa, která bude nastavena jako výchozí odesílatel všech zpráv. E-mailové zprávy, které mají odesílatele z jiné domény, budou odeslány pomocí výchozího odesílatele všech zpráv. Původní odesílatel zprávy je v takovém případě zachován v hlavičce zprávy „Reply-To“, takže případné odpovědi jsou doručeny původnímu odesílateli. Má-li zpráva vlastní adresu pro odpověď, zůstane zachována ona.
• V cloudové variantě NET Genium Online je adresa pevně nastavena na „identifikator@netgenium.online“ podle identifikátoru instance a pole nelze editovat — žádná instance tak nemůže odesílat zprávy pod adresou jiné instance.

2.2.2. Systémová hlášení

2.2.2.1. Servisní e-mailová adresa

• E-mailová adresa administrátora určená pro zasílání systémových hlášení. Je-li adresa prázdná, nebudou systémová hlášení zasílána. Adresa na doméně „netgenium.com“ nedostává zprávy o odmítnutém přihlášení kvůli licencím ani zprávy o méně závažných chybách v aplikacích.
  • E-mailové zprávy bez jediného příjemce – s prázdnými poli Komu, Kopie i Skrytá kopie (do předmětu zprávy bude vloženo NG NO-RCPT:); zpráva, jejíž zadané adresy jsou všechny neplatné, se sem nepřesměruje
  • Zprávy o odmítnutém přihlášení kvůli vyčerpaným licencím nebo kvůli běhu bez platného licenčního klíče, při kterém smí být přihlášen jen jeden uživatel – zpráva se odešle při každém takovém odmítnutí ve webovém prohlížeči a přes webové služby knihovny „NETGeniumConnection“, při přihlášení tokenem přes integrovaný MCP server se neodesílá
  • Zprávy o chybách v aplikacích, je-li zaškrtnuté pole „Povolit automatické zasílání zpráv o chybách společnosti NetGenium“ na záložce „Ostatní“, a zprávy o chybách při synchronizaci záznamů

• V cloudové variantě NET Genium Online se na servisní e-mailovou adresu posílají také upozornění na docházející kredit, na nečinnost portálu a na selhání automatického dobíjení kreditu. Není-li servisní e-mailová adresa vyplněná, odcházejí tato upozornění na e-mailovou adresu, se kterou byl portál zaregistrován.

2.2.2.2. Odesílatel systémových hlášení

• E-mailová adresa, která bude nastavena jako odesílatel systémových hlášení.
• Je-li adresa prázdná, použije se adresa vyplněná jako „Výchozí odesílatel všech zpráv“. Není-li vyplněna ani ta, odesílají se zprávy o licencích z adresy „license@netgenium.com“ a hlášení o chybách v aplikacích nebo při synchronizaci záznamů z adresy „error@netgenium.com“.
• V cloudové variantě NET Genium Online se pole nezobrazuje a systémová hlášení odcházejí vždy z adresy výchozího odesílatele instance. Odesílatel ostatních zpráv (krok skriptu „Odeslat e-mail“, serverové funkce, formulář „Nová e-mailová zpráva“) se v cloudu rovněž vždy nahradí adresou výchozího odesílatele instance; nemá-li zpráva zadanou adresu pro odpověď, uvede se jako ona původní adresa odesílatele.

2.2.3. Server odchozí pošty

2.2.3.1. SMTP Server 1

• Název nebo internetová adresa poštovního serveru SMTP určeného pro odesílání e-mailových zpráv.
• Za název serveru je možné uvést port oddělený dvojtečkou, například „smtp.example.com:587“. Bez portu se použije výchozí port.
• Zaškrtávací pole „Server požaduje ověření“ zapíná přihlášení k serveru pomocí údajů „Název účtu“ a „Heslo“. Volba „SSL“ (šifrované spojení se serverem) se uplatní pouze spolu s ověřením.
• SMTP Server 1 je používán pro odesílání e-mailových zpráv prostřednictvím následujících příkazů:
  • Nahlížecí stránka – Nová e-mailová zpráva
  • Button – Otevřít formulář pro zadání nové e-mailové zprávy
  • Skript – Odeslat e-mail
  • Skript – SENDMAILMESSAGE()
  • Skript – SENDMAILINVITATION()
  • Skript – SENDMAILINVITATION2()
  • Skript – SCHEDULEMAILMESSAGE()
• V cloudové variantě NET Genium Online se celá sekce „Server odchozí pošty“ nezobrazuje a nastavit ji nelze — SMTP Server 1 je pevně nastaven na „localhost“, takže všechny instance odesílají poštu přes poštovní službu cloudového serveru. Nezobrazují se ani tlačítka „SMTP TEST 1“ a „SMTP TEST 2“.

2.2.3.2. SMTP Server 2

• Název nebo internetová adresa poštovního serveru SMTP určeného pro odesílání e-mailových zpráv.
• Port, pole „Server požaduje ověření“, volba „SSL“ a údaje „Název účtu“ a „Heslo“ mají stejný význam jako u SMTP Serveru 1.
• SMTP Server 2 je používán pro odesílání e-mailových zpráv prostřednictvím následujících příkazů:
  • Záložní SMTP Server – veškeré e-mailové zprávy, které se nepodaří odeslat napoprvé pomocí SMTP Serveru 1, jsou předány k odeslání pomocí SMTP Serveru 2. Pokud SMTP Server 2 není definován, nebo dojde k selhání při pokusu o odeslání zprávy pomocí SMTP Serveru 2, je e-mailová zpráva uložena do adresáře „SMTP“ ve formě „eml“ souboru, a o její opětovné odeslání se pokusí program „ResendEmlFiles.exe“, který je typicky spouštěn každých 30 minut pomocí naplánované úlohy.
  • Skript – SENDMAILMESSAGE2()
• V cloudové variantě NET Genium Online se SMTP Server 2 nezobrazuje a nelze ho vyplnit — záložní poštovní server v cloudu není k dispozici.

• Pokud není definován SMTP Server 1 ani SMTP Server 2, veškeré e-mailové zprávy jsou ukládány do adresáře „SMTP“ ve formě „eml“ souborů. Název „eml“ souboru tvoří datum a čas jeho vzniku a unikátní identifikátor GUID (např. „2026-06-09 10-20-20 8925b488-b4a8-4192-a503-60b74b853186.eml“). Program „ResendEmlFiles.exe“, který je typicky spouštěn každých 30 minut pomocí naplánované úlohy, je začne odesílat teprve poté, co je nastaven SMTP Server 1 nebo SMTP Server 2; do té doby zprávy neodesílá a pokusy o odeslání se nezapočítávají. Úspěšně odeslané zprávy programem „ResendEmlFiles.exe“ jsou z adresáře „SMTP“ smazány, neúspěšně odeslané zprávy se program „ResendEmlFiles.exe“ pokusí odeslat nejvýše 48x (naplánovaná úloha založená programem „Setup.exe“ běží od 6:00 do 24:00 po 30 minutách, takže 48 pokusů trvá zhruba den a čtvrt); zprávy, jejichž odeslání skončilo trvalou chybou (například chybná syntaxe adresy příjemce – „Bad recipient address syntax“), zkusí odeslat jen jednou. Následně tyto soubory v adresáři „SMTP“ ignoruje. Seznam neúspěšně odeslaných zpráv nebo již ignorovaných je uložen v konfiguračním souboru „SMTP/ResendEmlFiles.errors“.

2.2.3.3. SMTP TEST 1 a SMTP TEST 2

• Tlačítka „SMTP TEST 1“ a „SMTP TEST 2“ odešlou zkušební zprávu s předmětem „test“ na servisní e-mailovou adresu přes SMTP Server 1, resp. SMTP Server 2. Použijí se hodnoty právě vyplněné v dialogu, i když ještě nejsou uložené. Výsledek odeslání – „OK“, nebo text chyby – se zobrazí v hlášení.
• V cloudové variantě NET Genium Online se tlačítka nezobrazují.
• Bez platné servisní e-mailové adresy se zkušební zpráva neodešle a dialog vyzve k jejímu vyplnění.
• Odesílatelem zkušební zprávy je odesílatel systémových hlášení; není-li vyplněný, výchozí odesílatel všech zpráv, a není-li vyplněný ani ten, servisní e-mailová adresa.

2.3. Záložka „Tiskové šablony“

• Seznam tiskových šablon uložených v adresáři „Templates“ s možností přidávat nebo odebírat šablony z tohoto adresáře.
• Tiskové šablony z tohoto seznamu jsou nabízeny v ovládacích prvcích typu „File“ a „Button“.
• Nepoužívané tiskové šablony jsou zobrazeny kurzívou.
• Detailní popis tiskových šablon je uveden v samostatné příručce Tiskové šablony.

2.3.1. Statistika

• Odkaz „Statistika...“ pod seznamem tiskových šablon otevře přehled všech tlačítek v editačních formulářích a na nahlížecích stránkách a všech ovládacích prvků typu „File“, které některou tiskovou šablonu používají. U každého prvku uvádí použitou tiskovou šablonu a datum její poslední změny a umožňuje otevřít nastavení prvku.

2.3.2. Přidat šablonu

• Tlačítko pro vložení nové tiskové šablony do adresáře „Templates“.

2.4. Záložka „Oprávnění“

2.4.1. Správce uživatelských účtů

• Seznam uživatelských skupin nebo uživatelů, kteří:
  • mohou nastavit nové heslo ostatním uživatelům (s výjimkou uživatelů, kteří mají administrátorské oprávnění). Stejně jako u uživatelských skupin musí mít správce k uložení nového hesla právo záznam uživatele upravit.
  • mohou přidávat a odebírat uživatelské skupiny ostatním uživatelům; skupinu „Administrators“ smí přidat nebo odebrat pouze uživatel „Administrator“. K uložení změn v záznamu uživatele musí mít správce navíc právo záznam upravit, typicky jako spoluvlastník formuláře „Uživatel“.
  • mohou nastavit nové uživatelské skupiny u jednotlivých skupin oprávnění.
  • mohou odeslat chatovou zprávu celé uživatelské skupině nebo všem právě přihlášeným uživatelům (stejně jako uživatelé s administrátorským oprávněním).
  • vidí všechny sessions v seznamu uživatelů online (stejně jako uživatelé s administrátorským oprávněním). Ostatní uživatelé vidí pro každého uživatele online pouze jeden záznam za interaktivní přihlášení ve webovém prohlížeči a jeden záznam za ostatní přístupy (například MCP server nebo webové služby knihovny „NETGeniumConnection“), z časového hlediska vždy ten s nejnovějším datem přihlášení uživatele. Sloupce „IP adresa“ a „Licence“ se v seznamu uživatelů online zobrazují jen uživatelům s administrátorským oprávněním a správcům uživatelských účtů.
  • mohou v seznamu uživatelů online odhlásit relace ostatních uživatelů; relace uživatelů s administrátorským oprávněním smí odhlásit jen uživatel s administrátorským oprávněním. Toto omezení i omezení počtu záznamů na uživatele platí jen pro seznam uživatelů online; tabulka vložená proměnnou #usersonline# zobrazuje každému, kdo ji vidí, všechny relace, ve kterých uživatel pracoval během poslední hodiny, včetně sloupců „IP adresa“ a „Licence“ (administrátor a správce uživatelských účtů v ní vidí i relace, ve kterých uživatel nepracoval déle než hodinu – jsou zobrazené zesvětleně a licenci nečerpají), a správce uživatelských účtů v ní odhlásí i relaci uživatele s administrátorským oprávněním. Odhlášení relace přihlášené tokenem přes integrovaný MCP server přístup neukončí – další požadavek s platným tokenem se přihlásí znovu. Odhlášení relace přihlášené přes webové služby knihovny „NETGeniumConnection“ připojení ukončí – další volání metod skončí chybou a je nutné se přihlásit znovu.

2.4.2. Administrátoři s přístupem k MCP serveru

• Seznam uživatelů, kteří smí pracovat s integrovaným MCP serverem instance. Na výběr jsou uživatelé s administrátorským oprávněním, tedy členové skupiny „Administrators“, a uživatel „Administrator“. Uživatel „Administrator“ má přístup vždy; jeho zařazení do seznamu ale seznam učiní neprázdným, takže zařazením samotného uživatele „Administrator“ se MCP server omezí jen na něj.
• Je-li seznam prázdný, může MCP server používat kterýkoli uživatel s administrátorským oprávněním, který má vygenerovaný osobní MCP token.
• Je-li v seznamu alespoň jeden záznam, může MCP server používat pouze uživatel „Administrator“, tedy uživatel s databázovým ID 1, a uživatelé uvedení v seznamu. Ostatním uživatelům se požadavek odmítne odpovědí 403 a důvod se zapíše do protokolu „Auth“.
• Omezení se týká všech nástrojů MCP serveru, tedy čtení i zápisu dat, implementačního modelu i frameworkové dokumentace.
• Omezení platí i pro připojení AI nástroje přihlášením – administrátorovi, který v seznamu není, se místo obrazovky souhlasu zobrazí hlášení, že jeho účet nemá oprávnění pro přístup přes MCP server.
• Oprávnění osobního tokenu „Přístup přes vlastní API“ seznam neomezuje — vlastní API si autorizaci řeší samo.
• Administrátorovi, který v seznamu není, se na záložce „MCP token“ nenabízejí oprávnění tokenu „Čtení všech dat a modelu přes MCP server“ a „Zápis všech dat a modelu přes MCP server“.
• Detailní popis MCP serveru je uveden v samostatné příručce Integrovaný MCP server.

2.4.3. Povolené IP adresy

• Seznam povolených IP adres, ze kterých je možné se přihlásit do aplikace, pokud je uživatel členem zvolené uživatelské skupiny.
• Seznam povolených IP adres se používá pro nastavení restrikcí uživatelů, kteří jsou ve skupině „Administrators“, a mají tedy administrátorské oprávnění včetně možnosti administrátorského režimu. Administrátorský režim je následně povolen pouze v případě, že uživatel do aplikace přistupuje z konkrétních IP adres. Přistoupí-li z jiné IP adresy administrátor, který je zároveň členem jiné uživatelské skupiny, přihlásí se ve webovém prohlížeči – pokud mu to dovolí omezení jeho ostatních skupin – bez administrátorských práv; přes integrovaný MCP server ani přes webové služby knihovny „NETGeniumConnection“ se z takové IP adresy nepřihlásí. Administrátor, který je jen ve skupině „Administrators“, a vestavěný účet Administrator se z jiné IP adresy nepřihlásí vůbec. Nejsou-li v seznamu adresy pro skupinu „Administrators“, omezují administrátora adresy jeho ostatních uživatelských skupin stejně jako uživatele, který ve skupině „Administrators“ není – z IP adresy mimo ně se nepřihlásí vůbec, ve webovém prohlížeči ani přes integrovaný MCP server nebo webové služby knihovny „NETGeniumConnection“.
• Seznam povolených IP adres se používá pro nastavení restrikcí uživatelů, kteří nejsou ve skupině „Administrators“. V případě přístupu uživatele z jiné IP adresy je odebrána možnost přihlášení do aplikace. Uživatel, jehož žádná uživatelská skupina v seznamu není, omezený není. Je-li uživatel členem více uživatelských skupin uvedených v seznamu, stačí mu shoda s IP adresou kterékoliv z nich. Při práci v prohlížeči a při připojení přes webové služby knihovny „NETGeniumConnection“ se IP adresa ověřuje jen při přihlášení, MCP server ji ověřuje u každého požadavku. Z plochy serveru (IP adresa „127.0.0.1“) se omezení neuplatní. Ověření osobního MCP tokenu ve vlastním API seznam neposuzuje; detailní popis ověření je uveden v samostatné příručce API.
• Adresy uvedené pro skupinu „Administrators“ navíc určují, odkud lze nástrojem FileUpload nahrát soubor, jehož profil archiv ZIP po přenosu rozbaluje nebo jehož cílový adresář či cíl kopie je adresář „bin“ nebo „update“, nebo leží uvnitř něj. Bez jediné adresy pro tuto skupinu takové nahrání neprojde a výjimka pro IP adresu „127.0.0.1“ se na něj nevztahuje.
• Řádkem „IP: ?“ v konfiguračním souboru „RequestHeaders.txt“ lze kontrolu seznamu na serveru vypnout pro všechna přihlášení. Detailní popis je uveden v samostatné příručce Instalace NET Genia na webovém serveru.
• Povolená IP adresa může nabývat následujících hodnot:
  • 1.2.3.4 – přístup je povolen pouze pro tuto konkrétní IP adresu
  • 1.2.3 – přístup je povolen pro všechny IP adresy, kde souhlasí první tři části, hodnota čtvrté části může být libovolná
  • 1.2 – přístup je povolen pro všechny IP adresy, kde souhlasí první dvě části, hodnota třetí a čtvrté části může být libovolná
  • 1 – přístup je povolen pro všechny IP adresy, kde souhlasí první část, následují tři části mohou být libovolné
  • Adresa IPv6 se porovnává stejně, po částech oddělených dvojtečkou, a proto se zapisuje ve stejném textovém tvaru, v jakém ji NET Genium uvádí v logu „Auth“.
• Smazáním uživatelské skupiny se smažou i záznamy povolených IP adres této skupiny – v editačním formuláři „Uživatelská skupina“ i při smazání krokem skriptu „Smazat záznam“ nebo přes integrovaný MCP server.

2.4.4. Veřejné externí funkce

• Seznam veřejných externích funkcí, které smí klient zavolat bez předchozí autorizace serverem. U každé funkce se volí uživatelská skupina, které je přístupná: bez omezení je funkce přístupná komukoli včetně nepřihlášených uživatelů, jinak jen uživatelům s administrátorským oprávněním, resp. členům vybrané uživatelské skupiny. Omezit funkci na jednotlivého uživatele nelze.
• Definice veřejné externí funkce musí obsahovat pouze identifikátor externí funkce, tedy hodnotu parametru „string id“. Detailní popis externích funkcí je uveden v samostatné příručce Externí funkce, a dále u funkce „string ngef“ v samostatné příručce Serverové funkce.
• Smazáním uživatelské skupiny se smažou i záznamy veřejných externích funkcí této skupiny – v editačním formuláři „Uživatelská skupina“ i při smazání krokem skriptu „Smazat záznam“ nebo přes integrovaný MCP server.
• V cloudové variantě NET Genium Online se seznam veřejných externích funkcí nezobrazuje — externí funkce v cloudu nejsou k dispozici.

2.4.5. Přidat IP adresu

• Tlačítko vloží nový záznam povolené IP adresy s IP adresou, ze které administrátor právě přistupuje, a se skupinou „Administrators“.

2.4.6. Přidat externí funkci

• Tlačítko pro vložení nového záznamu veřejné externí funkce.
• V cloudové variantě NET Genium Online se tlačítko nezobrazuje.

2.5. Záložka „Hesla“

• Opakované zadání chybného hesla na webových stránkách chráněných hesly z této záložky (tiskové šablony, restart, AI model) dočasně zablokuje zadávání hesla – stránka místo přihlašovacího formuláře zobrazí hlášení „Čekejte prosím, váš požadavek je v pořadí...“ a po 5 sekundách se načte znovu. Totéž platí pro webové služby pro stažení a nahrání modelu a pro synchronizaci – po opakovaném chybném hesle odmítají další požadavky. Chybná hesla se počítají podle IP adresy, ze které relace začala: všichni nepřihlášení návštěvníci z jedné IP adresy sdílejí jedno počítadlo a každý přihlášený uživatel má pro tutéž adresu vlastní, takže chybná hesla přihlášeného uživatele nezablokují ostatní. Webové stránky, webové služby pro stažení a nahrání modelu (společně s nástrojem FileUpload) a synchronizace mají každé své počítadlo. Blokace odezní nejpozději hodinu po posledním chybném hesle. U AI modelu se za chybné počítá i správné heslo zadané z IP adresy, která není povolená. Každé chybné heslo se zapíše do logu „Auth“.

2.5.1. Vyžadovaná síla hesel

• Nastavení síly hesel určuje, jak komplexní musí být hesla při změně starých hesel za nové.
  • Žádná – Heslo může být prázdné.
  • Slabá – Heslo musí být alespoň 5 znaků dlouhé. Heslo expiruje každých 12 měsíců, a nové heslo může být stejné jako to předchozí.
  • Dobrá – Heslo musí být alespoň 8 znaků dlouhé, a musí obsahovat znaky alespoň ze 3 skupin {malá písmena, velká písmena, číslice, speciální znaky}. Heslo expiruje každých 12 měsíců, a nové heslo nesmí být stejné jako to předchozí.
  • Silná – Heslo musí být alespoň 12 znaků dlouhé (heslo administrátora alespoň 17 znaků), a musí obsahovat znaky ze všech skupin {malá písmena, velká písmena, číslice, speciální znaky}. Heslo expiruje každých 12 měsíců, a nové heslo nesmí být stejné jako žádné z předcházejících hesel.
• Speciální znaky: - _ , . : ; ! @ # $ % ^ & * = + ( ) { } [ ] < > / ? ' ` " | § a mezera
• Za malá a velká písmena se považují jen písmena bez diakritiky; písmena s diakritikou ani znaky mimo uvedený výčet speciálních znaků se do žádné skupiny nezapočítávají.
• Předchozí hesla se hledají v historii změn uživatele, takže smazáním historie se jejich seznam zkrátí. V editačním formuláři „Uživatel“ lze ponechat heslo shodné s dosavadním; při síle hesla „Silná“ ale ani tam nelze nastavit žádné jiné z předchozích hesel.
• Je-li nastavená síla hesla, nesmí heslo obsahovat žádné čtyři po sobě jdoucí znaky přihlašovacího jména (bez ohledu na velikost písmen).
• Je-li nastavená síla hesla, je přihlášení s přihlašovacím jménem „Administrator“ (bez ohledu na velikost písmen) a prázdným heslem v přihlašovacím okně, v dialogu „Změna hesla“, stránkou Login.aspx a přes webové služby knihovny „NETGeniumConnection“ možné jen z IP adresy 127.0.0.1.
• Je-li nastavená síla hesla, musí uživatel, který si heslo dosud nikdy sám nezměnil, při nejbližším přihlášení jménem a heslem zadat nové heslo. Rozhoduje jen změna hesla v dialogu „Změna hesla“ a na přihlašovací stránce (vynucená změna hesla a nastavení nového hesla po obnovení zapomenutého hesla) – heslo uložené v editačním formuláři „Uživatel“ se do ní nepočítá a lhůtu expirace nemění, a to ani tehdy, když si ho uživatel mění ve vlastním záznamu. Uživatel, který si heslo sám změnil, a to i před nastavením síly hesla, zadává nové heslo až po expiraci, tedy 12 měsíců od své poslední vlastní změny.

2.5.2. Tiskové šablony

• Heslo pro webovou stránku „url-netgenia/templates“, která je chráněná pouze tímto heslem, bez ohledu na oprávnění uživatele. Je-li heslo prázdné, nebude možné stránku použít.
• Heslo chrání jen tuto webovou stránku. V plné instalaci NET Genia lze soubory tiskových šablon z adresáře „Templates“ stáhnout také přímou adresou „url-netgenia/templates/název souboru“, a to i bez přihlášení; v cloudové variantě NET Genium Online je adresář „Templates“ přímou adresou nedostupný.
• Na stránce je možné stáhnout tiskové šablony z adresáře „Templates“ a v řádku „Aktualizovat šablonu“ tlačítkem „Procházet...“ nahradit existující šablonu souborem se stejným názvem. Přidávat nové šablony ani je mazat na ní nelze.
• Uživatel s administrátorským oprávněním spravuje tiskové šablony na záložce „Tiskové šablony“ dialogu nastavení NET Genia. Uživateli bez administrátorského oprávnění nabízí toolbar „NET Genium“ místo dialogu nastavení odkaz „Tiskové šablony...“ na tuto stránku.
• Existuje-li konfigurační soubor „DenyLogin.txt“, je webová stránka vypnutá, a to i z plochy serveru.
• Heslo je k dispozici pouze v plných instalacích NET Genia — v cloudové variantě NET Genium Online se pole nezobrazuje.

2.5.3. Restart

• Heslo vyžadované při restartu NET Genia na webové stránce „url-netgenia/restart“ mimo administrátorský režim. Je-li heslo prázdné, nebude možné NET Genium tímto způsobem restartovat.
• V administrátorském režimu se NET Genium restartuje bez hesla, viz kapitola [[#restartovat Restartovat]].
• Webová stránka pro restart NET Genia je umístěna na adrese „url-netgenia/restart“.
• Existuje-li konfigurační soubor „DenyLogin.txt“, je webová stránka vypnutá, a to i z plochy serveru.
• Heslo je k dispozici pouze v plných instalacích NET Genia — v cloudové variantě NET Genium Online se pole nezobrazuje a NET Genium restartuje provozovatel služby.

2.5.4. Synchronizace

• Je-li heslo prázdné, nebude možné synchronizovat data ze vzdáleného serveru s vaším NET Geniem.
• Kdo zná heslo pro synchronizaci, může v této instalaci zakládat, měnit a mazat záznamy libovolného editačního formuláře — příjem synchronizace neověřuje, které formuláře jsou s odesílatelem propojené. Heslo je proto vhodné volit silné, předávat jen propojeným instalacím a komunikovat přes protokol „https“.
• Heslo je k dispozici pouze v plných instalacích NET Genia — v cloudové variantě NET Genium Online se pole nezobrazuje a synchronizace dat mezi instancemi není podporovaná.

[[Kotva:heslo-ai-model]]

2.5.5. AI model

• Heslo vyžadované při automatizovaném stahování [[ai-modely AI modelu]] pomocí webových služeb a při nahrávání změn modelu zpět do NET Genia. Je-li heslo prázdné, nebude možné model automatizovaně stahovat ani nahrávat.
• Kdo zná heslo, může do této instalace nahrát změny modelu – zakládat, měnit a mazat aplikační skupiny, aplikace, kategorie, editační formuláře, nahlížecí stránky, ovládací prvky a skripty, zakládat a měnit databázové dotazy, uživatelské skupiny a skupiny oprávnění a nastavovat práva. Změny se zapisují jako účet Administrator, takže zahrnují i objekty, které ostatní administrátoři měnit nesmějí. Heslo je proto vhodné volit silné a přístup omezit seznamem „Povolené IP adresy“ pro skupinu „Administrators“.
• Webová stránka pro stažení modelu tímto heslem je umístěna na adrese „url-netgenia/ai“.
• Nástroj, který model stahuje a nahrává, se tímto heslem prokazuje – v konfiguračním souboru „ai-model.json“ je uvedeno jako hodnota klíče „ngPassword“. Po změně hesla je proto nutné upravit i tento konfigurační soubor.
• Heslo je v databázi uloženo pouze jako nevratný otisk, takže se v nastavení nikdy nezobrazí – zapomenuté heslo nelze zjistit, pouze přepsat novým.
• Kromě hesla se ověřuje také IP adresa, ze které se model stahuje nebo nahrává – obsahuje-li seznam „Povolené IP adresy“ na záložce „Oprávnění“ adresy pro skupinu „Administrators“, musí odpovídat některé z nich. Bez adres pro tuto skupinu se IP adresa neomezuje a z plochy serveru (IP adresa „127.0.0.1“) se omezení neuplatní.
• Heslo je k dispozici pouze v plných instalacích NET Genia. V NET Genium Online se pole vůbec nezobrazuje a model nelze automatizovaně stahovat ani nahrávat – v cloudu se AI asistent připojuje k [[mcp-server-pro-data integrovanému MCP serveru]] instance, který mu model vydává přímo.

2.5.6. Vygenerovat heslo

• Tlačítko vygeneruje náhodné heslo ve tvaru identifikátoru GUID a vypíše je do dialogu spolu s ikonou pro zkopírování do schránky.
• Vygenerované heslo se nikam neukládá – slouží pouze jako zdroj náhodné hodnoty, kterou je možné vložit do některého z hesel výše. Zobrazuje se jen jednou, proto si ho zkopírujte a bezpečně uložte.

[[Kotva:barvy]]

2.6. Záložka „Barvy“

• Seznam barev, které nabízí návrhář barev při editaci hodnoty v ovládacích prvcích typu „TextBox“ se zaškrtnutou volbou „Zobrazit návrhář barev v editačním formuláři“.
• Je-li seznam barev prázdný, nabízí návrhář barev výchozí barevnou paletu.

2.6.1. Přidat barvu

• Tlačítko pro vložení nového záznamu barvy.

2.7. Záložka „Ostatní“

2.7.1. Navigátor

• Nastavení typu navigátoru určuje, jakým způsobem navigační oblast vypisuje seznam aplikací.
  • Typ A – zobrazuje v navigátoru seznam všech aplikací včetně možností jejich editace.
  • Typ B – zrychluje práci s NET Geniem v administrátorském režimu, není však tak komfortní jako typ A.
• Volba se nabízí pouze u starého designu (do roku 2016); v aktuálním vzhledu NET Genia se v nastavení nezobrazuje.

2.7.2. E-Learning

• Nastavení stylu e-learningu určuje, jaký vzhled se bude používat pro vizualizaci e-learningových kurzů.
  • Styl A – zobrazuje e-learningové kurzy v příjemných barvách modré a oranžové a obsahuje obrázková navigační tlačítka.
  • Styl B – je spíše konzervativní a respektuje barevné nastavení NET Genia.
• V cloudové variantě NET Genium Online se volba stylu nezobrazuje.

[[Kotva:logovani-vykonu]]

2.7.3. Logování

• Logování slouží pro měření doby zpracování databázových dotazů, skriptů, nahlížecích stránek, editačních formulářů a externích funkcí.
  • Vypnuté – Doby zpracování na straně serveru nejsou měřeny.
  • Do databáze – Doby zpracování databázových dotazů, skriptů, nahlížecích stránek, editačních formulářů a externích funkcí jsou ukládány do databáze. Z těchto dat je možné zobrazovat agregované statistiky pomocí tlačítka „Logování“ přímo v nastavení daného ovládacího prvku, resp. jeho databázového dotazu, a dále v nastavení skriptu, nahlížecí stránky nebo editačního formuláře. Další možností je zobrazovat tyto statistiky na stránce reportů, kde jsou k dispozici i statistiky měření externích funkcí. Detailní popis reportů je uveden v samostatné příručce [[reporty Reporty]].
  • Na disk – Doby zpracování databázových dotazů, skriptů, nahlížecích stránek, editačních formulářů a externích funkcí jsou ukládány na disku do adresáře „Logs“.
  • Do databáze a na disk – Doby zpracování na straně serveru jsou ukládány do databáze a na disk současně.
  • Logování do konzole – samostatné zaškrtávací pole nezávislé na volbě logování. V dolní části okna webového prohlížeče zobrazí konzoli, do které se vypisují doby zpracování nahlížecích stránek, editačních formulářů, hlavní stránky s portlety a formuláře „Nová e-mailová zpráva“. Konzoli vidí všichni uživatelé, nejen administrátoři; na mobilních zařízeních se doby neměří.
    • Data Transferring Time – čas komunikace mezi klientem a serverem
    • Page Processing Time – čas zpracování stránky na straně serveru
    • Page Rendering Time – čas vykreslení stránky ve webovém prohlížeči
    • Total Waiting Time – celkový čas čekání na zobrazení stránky
  • Měřit spotřebu paměti – Sledování spotřeby paměti každého databázového dotazu, který načítá data.
    • Spotřeba paměti je vypočítána jako rozdíl alokované paměti procesu „w3wp.exe“ před a po úspěšném načtení dat z databáze.
    • Proces „w3wp.exe“ obsluhuje požadavky všech uživatelů webové aplikace, proto může být vypočítaná hodnota nepřesná, a může zahrnovat i paměťovou spotřebu jiných požadavků.
    • Vypočítaná hodnota může být i záporná, pokud během načítání dat proběhlo uvolnění paměti Garbage Collectorem.
    • Naměřená hodnota spotřeby paměti je k dispozici v reportech při zapnutém logování do databáze, a na disku v logovém souboru „Logs\Data-yyyy-MM.log“ u těch databázových dotazů, jejichž spotřeba paměti přesáhne 1GB (slovo „LastMemoryConsumption“).
  • Vymazat staré logy v databázi – Smaže z databáze všechna naměřená data, bez ohledu na jejich stáří.
  • Vymazat staré logy na disku – Smaže v adresáři „Logs“ logové soubory, jejichž název začíná datem, a soubory v datovaných podadresářích uživatelů, obojí starší než 7 dní. Ostatní soubory, například „System.log“ nebo měsíční logy s předponou (například „Data-yyyy-MM.log“), zůstávají zachovány.
• V cloudové variantě NET Genium Online nabízí rozbalovací seznam pouze možnosti „Vypnuté“ a „Do databáze“ — logování na disk k dispozici není. Nezobrazuje se ani volba „Měřit spotřebu paměti“.

[[Kotva:moznosti]]

2.7.4. Možnosti

• Povolit automatické zasílání zpráv o chybách společnosti NetGenium
  • Zaškrtnutí tohoto pole zapíná odesílání e-mailových zpráv o chybách, které v NET Geniu vzniknou při práci uživatelů bez administrátorského oprávnění. Chyby uživatelů s administrátorským oprávněním se neodesílají.
  • Zprávu o závažné chybě dostane technická podpora společnosti NetGenium a servisní e-mailová adresa, zprávu o méně závažné chybě pouze servisní e-mailová adresa. Méně závažná chyba se při prvním výskytu neohlásí; ohlásí se, až se zopakuje později než hodinu a nejpozději 24 hodin po předchozím zaznamenaném výskytu. Výskyty se evidují jen v paměti webové aplikace, takže restart evidenci vynuluje.
  • Táž chyba se ohlašuje nejvýše jednou za hodinu.
  • Zpráva obsahuje technický popis chyby (typ, text a výpis zásobníku volání), adresu stránky, přihlašovací jméno uživatele (je-li uživatel znám), jeho IP adresu, identifikaci jeho webového prohlížeče, název serveru, verzi operačního systému a .NET Frameworku, účet, pod kterým běží webová aplikace, a datum a čas chyby.
  • Bez zaškrtnutí tohoto pole se zprávy o chybách v aplikacích neodesílají technické podpoře ani na servisní e-mailovou adresu.
  • Při každé chybě se uživateli zobrazí chybové hlášení na samostatné stránce.
  • Nelze-li se připojit k databázi, zobrazí se místo toho hlášení „Během připojení k serveru SQL se vyskytla chyba!“ s odkazem „Zkusit znovu“ a důvod nedostupnosti databáze se zapíše do logového souboru „Errors.log“.
• Protokolovat používání nahlížecích stránek
  • Zaškrtnutí tohoto pole určuje, zda má být protokolováno používání jednotlivých nahlížecích stránek do databáze do aplikace „Nastavení“:
    • Protokolování do tabulky „Nastavení / Statistika“ – Navštívená nahlížecí stránka, Uživatel, Datum
    • Protokolování do tabulky „Nastavení / Statistika 2“ – Navštívená nahlížecí stránka, Počet návštěv
    • Protokolování do tabulky „Nastavení / Statistika 3“ – Navštívená nahlížecí stránka, Uživatel, Počet návštěv
  • Protokolování nahlížecích stránek slouží k odhalení málo používaných či vůbec nepoužívaných nahlížecích stránek danými uživateli.
  • Otevření té samé stránky tím samým uživatelem je zaprotokolováno do databáze pouze jednou za hodinu. Stejně se počítají i návštěvy v tabulkách „Nastavení / Statistika 2“ a „Nastavení / Statistika 3“.
  • Návštěvy anonymního uživatele se neprotokolují.
  • V cloudové variantě NET Genium Online se toto pole nezobrazuje.
• Povolit zasílání zapomenutých hesel na přihlašovací stránce
  • Zaškrtnutí tohoto pole určuje, zda má být na přihlašovací stránce vedle tlačítka „Přihlásit“ zobrazeno také tlačítko „Zapomenuté heslo“, které slouží pro odeslání pokynů k obnovení hesla na e-mailovou adresu daného uživatele.
  • Je-li vyplněná „Adresa portálu“, obsahuje e-mail odkaz pro nastavení nového hesla; odkaz je jednorázový a platí 1 hodinu. Není-li adresa portálu k dispozici, odešle se místo odkazu dočasné heslo se stejnou platností, kterým se uživatel přihlásí a heslo si vzápětí změní.
  • Nepoužitý odkaz i dočasné heslo zneplatní každé úspěšné přihlášení uživatele v prohlížeči (jménem a heslem, přes Microsoft, Google, Facebook nebo Apereo, integrovaným ověřováním Windows nebo přihlašovacím ticketem) i každé úspěšné přihlášení stránkou Login.aspx (metoda Uploader.Login_aspx knihovny NETGeniumConnection); o obnovení hesla je pak potřeba požádat znovu.
  • Každá žádost o obnovení hesla vytvoří vlastní odkaz, který platí 1 hodinu od této žádosti; nová žádost dřívější nepoužité odkazy nezneplatní. Dočasné heslo naopak platí jen to z poslední žádosti.
  • V cloudové variantě NET Genium Online se adresa portálu odvozuje z identifikátoru instance, takže odkaz funguje bez dalšího nastavení.
  • O obnovení hesla je možné požádat nejvýše pětkrát za 24 hodin pro každého uživatele a nejvýše třikrát za pět minut z jedné IP adresy.
  • Přihlašovací stránka odpoví vždy stejně, bez ohledu na to, zda zadaný uživatel existuje a má vyplněnou e-mailovou adresu — nelze tak zjišťovat platná uživatelská jména. Neexistuje-li zadaný uživatel nebo nemá platnou e-mailovou adresu, zaznamená se to do protokolu „Warnings“; výsledek odeslání e-mailu se nevyhodnocuje.
  • Po dokončení změny hesla přes odkaz nebo dočasné heslo dostane uživatel na svou e-mailovou adresu oznámení s datem, IP adresou a prohlížečem, ze kterého ke změně došlo.
  • V cloudové variantě NET Genium Online odcházejí oba e-maily — s odkazem i s oznámením o změně — ve vzhledu ostatních zpráv z cloudu, s tlačítkem místo holého odkazu a s přehledem údajů o požadavku. Klasická instalace posílá e-maily beze změny.
• Zasílat e-maily s tipy, jak portál rozjet
  • Pole se zobrazuje jen v cloudové variantě NET Genium Online. Zaškrtnutí tohoto pole určuje, zda NET Genium v prvních týdnech po registraci posílá e-maily s tipy, jak s portálem začít. Každý e-mail upozorňuje na krok, který v portálu ještě chybí: první práci v portálu (nejdříve 3. den po registraci), aplikaci postavenou umělou inteligencí (nejdříve 7. den) a připojení AI agenta přes MCP server (nejdříve 14. den). Každý e-mail odejde nejvýš jednou, jen do 30 dnů od registrace a jen v pracovní dny.

3. Aplikace „Nastavení“

3.1. Základní aplikace

• NET Genium obsahuje výchozí sadu editačních formulářů a k nim náležících nahlížecích stránek, které jsou bezpodmínečně nutné pro správnou činnost celé aplikace. Tyto editační formuláře jsou umístěny v aplikaci „Nastavení“.
• Aplikaci „Nastavení“ není možné smazat, ani přesunout do jiné aplikační skupiny.
• Úpravy editačních formulářů a nahlížecích stránek v této aplikaci může provádět pouze jeden uživatel s nejvyšším oprávněním – uživatel „Administrator“ s databázovým ID 1.
• Aplikace „Nastavení“ obsahuje následující editační formuláře a k nim náležící nahlížecí stránky:
  • Uživatel – databázová tabulka „susers“ se seznamem uživatelů
    • Celé jméno – celé jméno uživatele
    • Příjmení – příjmení uživatele
    • Jméno – jméno uživatele
    • Titul – titul uživatele
    • Přihlašovací jméno – přihlašovací jméno uživatele
    • Heslo – heslo uživatele
    • Jazyk – jazykové nastavení uživatele (cs, de, en, fr, sk)
    • Účet systému Windows – název doménového účtu uživatele v Active Directory, používaný pro zajištění automatického přihlašování do NET Genia bez nutnosti zadávání přihlašovacího jména a hesla
    • E-mail – e-mailová adresa uživatele
    • M-Heslo – heslo pro účet na mobilním zařízení Android
    • Skupina oprávnění – cizí klíč do číselníku skupin oprávnění, který definuje seznam uživatelských skupin, ve kterých je uživatel členem. Přiřazení uživatele do skupiny oprávnění je preferovaný způsob přidělování práv, nicméně je možné i ruční přiřazení seznamu uživatelských skupin viz další ovládací prvek „Uživatelské skupiny“.
    • Uživatelské skupiny – seznam uživatelských skupin, ve kterých je uživatel členem. Ruční přiřazení uživatelských skupin každému uživateli zvlášť není preferovaný způsob přidělování práv, doporučovaný způsob je výběrem skupiny oprávnění viz předchozí ovládací prvek.
  • Uživatelská skupina – databázová tabulka „susergroups“ se seznamem uživatelských skupin
    • Uživatelská skupina – název uživatelské skupiny
    • Popis – popis uživatelské skupiny
  • Skupina oprávnění – databázová tabulka „srightsgroups“ se seznamem skupin oprávnění
    • Skupina oprávnění – název skupiny oprávnění
    • Popis – popis skupiny oprávnění
    • Uživatelské skupiny – seznam uživatelských skupin, které definují skupinu oprávnění
  • Státní svátek – databázová tabulka „sholiday“ se seznamem aktuálních státních svátků. Obsah této tabulky je generován automaticky podle jazykového nastavení NET Genia.
    • Název svátku – název státního svátku
    • Datum – datum státního svátku
    • Půldenní – zaškrtávací pole pro účely volby půldenních státních svátků v Německu
  • Vzhled – databázová tabulka „slayout“ se seznamem používaných grafických vzhledů NET Genia
    • Název – název vzhledu
    • Uložit jako aktuální vzhled – zaškrtávací pole pro účely označení vzhledu jako aktuálního, a pro účely následného přegenerování CSS stylů.
    • Název fontu
    • Velikost textu
    • Barva písma
    • Záhlaví – Logo
    • Záhlaví – Obrázek na pozadí
    • ...
  • Neplatné přihlášení – databázová tabulka „sinvalidlogins“ se seznamem neplatných přihlášení do NET Genia
    • Datum – datum neplatného přihlášení
    • IP adresa – IP adresa, ze které byl učiněn pokus o přihlášení
    • Přihlašovací jméno – použité přihlašovací jméno
    • Heslo – vždy hodnota „*****“; zadané heslo se neukládá
  • Statistika – databázová tabulka „sstatistics“ se statistikou využívání nahlížecích stránek NET Genia
    • Nahlížecí stránka – navštívená nahlížecí stránka
    • Uživatel – přihlašovací jméno uživatele, který stránku navštívil
    • Datum – datum návštěvy
  • Statistika 2 – databázová tabulka „sstatistics2“ se statistikou využívání nahlížecích stránek NET Genia
    • Nahlížecí stránka – navštívená nahlížecí stránka
    • Session – počet návštěv
  • Statistika 3 – databázová tabulka „sstatistics3“ se statistikou využívání nahlížecích stránek NET Genia
    • Nahlížecí stránka – navštívená nahlížecí stránka
    • Uživatel – přihlašovací jméno uživatele, který stránku navštívil
    • Session – počet návštěv
  • Synchronizace – databázová tabulka „ssynchro“ se seznamem chyb vzniklých během synchronizace; některé chyby, například při rezervaci ID na protistraně, při lokálním přečíslování nového záznamu, při přípravě změny k odeslání nebo při odesílání e-mailů, se zapisují jen do logového souboru „Synchro-year-month.log“
    • Datum chyby
    • Editační formulář – název editačního formuláře, ve kterém došlo k chybě
    • ID záznamu – ID databázového záznamu, u kterého došlo k chybě
    • Chyba – popis chyby

3.2. Volitelné aplikace

• V adresáři „Install“ se nachází sada volitelných aplikací, které je možné do NET Genia naimportovat.
• Dostupné volitelné aplikace:
  • API – správa API klíčů pro přístup externích systémů do NET Genia pomocí samostatné webové aplikace (typicky s názvem „API“) a evidence SQL dotazů, jejichž obsah je možné pomocí API stahovat.
  • Applications – přehled a správa aplikací nainstalovaných v NET Geniu. Editační formuláře používají pohledy definované ve svém nastavení; tyto pohledy je nutné dodatečně vytvořit na záložce „Administrace“ příkazem „CREATE VIEW“.
  • Business Logins – evidence přihlašovacích údajů a tokenů pro komunikaci s API služeb Google, Facebook a Microsoft.
  • DataGrid Settings – ukládání a načítání individuálního nastavení datagridů do databáze. Aplikace používá serverové funkce „SAVEDATAGRIDSETTINGS“ a „LOADDATAGRIDSETTINGS“ a obsahuje příklad jejich použití.
  • E-learning – e-learningové kurzy a výukové materiály pro vzdělávání uživatelů.
  • E-mail – poštovní účty, kontakty a podpisy uživatelů pro ovládací prvek Email a formulář nové e-mailové zprávy, správa e-mailových šablon a přehled odchozí pošty odeslané pomocí nativního formuláře pro odesílání e-mailových zpráv.
  • FileUpload – správa souborů nahrávaných na webový server s NET Geniem, které využívá aplikace „FileUpload.exe“.
  • Licenses – monitoring čerpání licencí v NET Geniu aktuálně přihlášenými uživateli v čase.
  • Maps – mapové podklady a vizualizace geografických dat. Aplikace demonstruje práci s mapami a používání serverové funkce „PLACESONMAP“.
  • Practical information – seznam svátků a cizích slov.
  • Reset password – hromadný reset hesel a jejich zasílání e-mailem.
  • RUIAN – vyhledávání adres v Registru územní identifikace, adres a nemovitostí (RÚIAN). Vyhledávání obsluhuje externí funkce „RUIAN_Search“, kterou NET Genium samo neobsahuje – je nutné ji doplnit do souboru „ngef.dll“ jako volání metody „RUIAN.Adresa.Search“ knihovny „NETGeniumConnection.dll“ (viz [[externi-funkce Externí funkce]]). Metoda hledá adresy v tabulkách „ng_ruianobec“, „ng_ruianulice“ a „ng_ruianadresa“, které je nutné naplnit daty RÚIAN.
  • Services – monitoring služeb spouštěných na pozadí pomocí plánovače Windows nebo konzolových aplikací.
  • SMS – odesílání a příjem SMS zpráv. Aplikace je nutná pro běh služby „SMSService“.
  • Stats – editační formuláře pro čtení logů zaznamenaných NET Geniem při zapnutém logování do databáze. Editační formuláře používají pohledy definované ve svém nastavení; tyto pohledy je nutné dodatečně vytvořit na záložce „Administrace“ příkazem „CREATE VIEW“.
  • UNION – příklady databázové operace UNION pomocí pohledů. Editační formuláře používají pohledy definované ve svém nastavení; tyto pohledy je nutné dodatečně vytvořit na záložce „Administrace“ příkazem „CREATE VIEW“.
  • Web – správa webového obsahu publikovaného prostřednictvím NET Genia.

4. Konfigurační soubory

• Konfigurační soubory obsahují údaje, které jsou vyžadované pro správný běh webové aplikace, ale nejsou součástí databáze. Nachází se v adresáři „NETGenium\Config“ ve formě textových souborů, případně souborů ve formátu JSON.

• Většinu konfiguračních souborů čte NET Genium jen při startu webové aplikace, takže se vytvoření, změna nebo smazání souboru projeví až po restartu NET Genia (viz kapitola [[#restartovat Restartovat]]). Při každém použití se čtou soubory „UnderConstruction.txt“, „UnderConstruction2.txt“ a „Holidays.txt“. Soubory „ConnectionString.txt“ a „License.txt“ čte NET Genium za určitých podmínek znovu i za provozu, spolehlivě se ale i jejich změna projeví až po restartu. Licenční klíč nahraný nebo aktivovaný v dialogu „Žádost o licenční klíč“ platí hned v procesu webové aplikace, který ho přijal. Soubor „DenySynchro.txt“ čte knihovna NETGeniumConnection (externí funkce, Windows služby) při každém uložení záznamu. Aktualizační program „Update.exe“ čte soubor „Tester.txt“ a program „SqlBackup.exe“ soubor „UpdateArchive.txt“ samy při každém svém spuštění.

• BlindFriendly.txt – existence tohoto souboru zajistí, že nahlížecí tabulky, ovládací prvky „Calendar“, „Planner“, „TimeTable“ a „Tree“ a portlety na hlavní stránce nemají dynamicky zobrazovanou lištu s nástroji, ale statickou, která je stále zobrazena pod jejich titulkem. Soubor může volitelně obsahovat seznam typů ovládacích prvků oddělených enterem, na které se statická lišta omezí („DataGrid“, „Calendar“, „Planner“, „TimeTable“, „Tree“; portlety zastupuje hodnota „HTML“). Prázdný soubor platí pro všechny. Typy se porovnávají doslova, soubor bez typů proto nesmí obsahovat ani prázdný řádek.
• ConnectionString.txt – připojovací řetězec k databázi NET Genia
• Copyright.txt – zástupný HTML kód pro copyright zobrazovaný v navigační oblasti. Pokud soubor neexistuje, zobrazuje se v navigační oblasti textový řetězec „© 20xx NetGenium“. Druhou možností jak upravovat copyright je pomocí externí funkce NETGenium.Copyright, více v příručce [[externi-funkce#netgenium-copyright Externí funkce]].
• CustomIcons.txt – seznam zástupných ikon, které nahrazují výchozí ikony používané v aplikaci. Na každé řádce souboru je umístěna definice jedné ikony v následujícím formátu:
  „Images/Picker.gif:Images/Custom/Picker.svg“
• DefaultLanguage.txt – dvoupísmenná zkratka výchozího jazyka, ve kterém je lokalizována základní aplikace „Nastavení“, a který byl nastaven uživatelům „Administrator“ a „Anonymous“ při jejich vytvoření („cs“, „de“, „en“, „fr“, „sk“)
• Demo.txt – existence tohoto souboru zajistí, že ve webové aplikaci nebude možné ukládání nebo mazání čehokoliv. Soubor může volitelně obsahovat seznam databázových tabulek oddělených enterem, ve kterých budou změny povoleny. Například „susers_vf“ zajistí, že bude možné uživatelské přizpůsobení nahlížecích tabulek. Kde jsou změny zakázané, neodesílají skripty ani e-maily – krok „Odeslat e-mail“ ani serverové funkce pro odeslání e-mailu se nevykonají. V tabulkách, ve kterých jsou změny povolené, se e-maily odesílají jako obvykle. Zápisům, které provede vlastní kód externí funkce, demo režim nebrání: externí funkce volaná ze skriptu tlačítka, z prvku HTML, z JavaScriptu, z naplánované úlohy i jako callback „NETGenium.*“ mimo ukládání a mazání záznamu se vykoná stejně jako mimo demo režim (parametr „test“ na demo režimu nezávisí; výjimkou jsou callbacky „NETGenium.Import“ a „NETGenium.ImportXml“, které se v demo režimu nespustí), a vše, co zapíše do databáze přes předaný „DbCommand“ skriptu nebo přes vlastní „DbCommand“, se uloží – demo režim potlačí jen zápisy samotného skriptu.
• DenyContextMenu.txt – existence tohoto souboru zajistí, že se po kliknutí pravým tlačítkem myši na označený text v ovládacím prvku „RichTextBox“ a v ovládacím prvku „TextArea“ s datovým typem „Wiki“ nebo „Markdown“ nebude zobrazovat kontextové menu s formátováním, ale výchozí kontextové menu webového prohlížeče. Text se pak formátuje nástroji v liště nad ovládacím prvkem.
• DenyCookieless.txt – existence tohoto souboru zajistí, že bude webová aplikace vyžadovat používání cookies na straně klienta. Projeví se až poté, co aktualizace nebo restart NET Genia (viz kapitola [[#restartovat Restartovat]]) přepíše soubor „Web.config“; smazání souboru ale restart do souboru „Web.config“ nepromítne, projeví se až aktualizací NET Genia. Webová aplikace následně
  • nebude používat vkládání SessionID do URL každé webové stránky („.../netgenium/(S(33cipeb0js15bo1t1xhkupr4))/default.aspx“) a
  • nebude umožňovat přihlášení v jednom webovém prohlížeči pod různými uživatelskými účty na různých záložkách – webový prohlížeč slučuje jednotlivé session.
• DenyExport.txt – existence tohoto souboru zajistí, že bude zakázaný export aplikací ve webovém rozhraní NET Genia; program „ApplicationManager.exe“ spouštěný na serveru zákaz nerespektuje
• DenyInvalidLogins.txt – existence tohoto souboru zajistí, že se zablokování účtu po opakovaných neplatných přihlášeních neuplatní na přihlášení jménem a heslem ve webovém prohlížeči z IP adres, které jsou v seznamu „Povolené IP adresy“ uvedené pro skupinu „Administrators“; výjimka platí pro libovolné přihlašovací jméno zadané z takové adresy, na připojení přes webové služby knihovny „NETGeniumConnection“ se ale nevztahuje
• DenyLogin.txt – existence tohoto souboru zajistí, že přihlášení jménem a heslem bude možné jen z plochy serveru, resp. z IP adresy „127.0.0.1“. Odjinud se přihlašovací okno nezobrazí a přihlášení jménem a heslem se odmítne; uživatelé se odtud mohou přihlásit jen jinými cestami (přihlašovací ticket, přihlášení přes Microsoft, Windows autentizace). Připojení přes webové služby knihovny „NETGeniumConnection“ soubor neomezuje, integrovaný MCP server je naopak při jeho existenci vypnutý. Při existenci souboru jsou vypnuté také webové stránky pro restart NET Genia („url-netgenia/restart“) a pro editaci tiskových šablon („url-netgenia/templates“), a to i z plochy serveru. Soubor může volitelně obsahovat URL, na kterou bude uživatel přesměrován při pokusu o přihlášení do aplikace a po odhlášení. Adresa smí obsahovat proměnné „#viewpage#“, „#form#“ a „#id#“, za které se dosadí hodnoty parametrů „viewpage“, „form“ a „id“ adresy požadavku (chybí-li parametr, dosadí se 0), a proměnné „#loginname#“ a „#language#“, za které se dosadí přihlašovací jméno a jazyk uživatele z posledního přihlášení v témže prohlížeči. Obsahuje-li soubor proměnnou „#loginname#“ nebo „#language#“, uloží se přihlašovací jméno, resp. jazyk při přihlášení do cookie prohlížeče s platností 6 měsíců; bez cookie se dosadí prázdná hodnota.
• DenyStartSynchro.txt – existence tohoto souboru zajistí, že webová aplikace nebude odesílat frontu synchronizace sama; frontu pak odesílá jen program „StartSynchro.exe“ spouštěný naplánovanou úlohou
• DenySynchro.txt – existence tohoto souboru zajistí, že se změny nebudou zařazovat do fronty synchronizace ani odesílat na propojené servery; příjem synchronizace z jiných instalací tím zakázán není (ten zakazuje prázdné heslo pro synchronizaci)
• EncryptionKey.txt – šifrovací klíč pro šifrování sloupců „TextArea“ a „RichTextBox“. Při neexistenci tohoto souboru se pro šifrování dat používá výchozí šifrovací klíč. Použije se prvních 16 znaků souboru včetně případného zalomení řádku, kratší obsah se doplní znaky výchozího šifrovacího klíče. Hodnoty zašifrované dříve jiným klíčem nepůjde po změně klíče dešifrovat.
• ErrorLabel.txt – text, který proměnná „#errorlabel#“ vrací za textem „ERROR“; neexistuje-li soubor nebo je-li prázdný, proměnná obsahuje prázdný řetězec. Totéž, co vrací proměnná, se připojuje i k předmětu systémových e-mailů NET Genia. Detailní popis je uveden v samostatné příručce [[promenne Proměnné]].
• ExecutionTimeout.txt – maximální délka zpracování requestu, resp. webové stránky na straně serveru uváděná v hodinách, která se používá pro navýšení výchozí délky 5 hodin, typicky při potřebě spouštění dlouho trvajících skriptů. Maximální délka zpracování requestu má vliv na hodnotu atributu „executionTimeout“ v souboru „Web.config“, který po každé aktualizaci NET Genia na novou verzi nastavuje program „FinishUpdate.exe“ a při restartu z administrátorského režimu nebo heslem samotné NET Genium (viz kapitola [[#restartovat Restartovat]]).
• Framework.txt – soubor vytvářený automaticky se zjištěnou verzí .NET Frameworku, který je nastaven ve vlastnostech aplikačního poolu přidruženého k webové aplikaci NET Genia
• GoogleTranslationApiKey.txt – API klíč ke službě Google Translation API, využívaný pro překládání textů v ovládacích prvcích „RichTextBox“ a „TextArea“ s datovým typem „Wiki“ nebo „Markdown“ v editačním formuláři, dále v okně náhledu ovládacího prvku „RichTextBox“ a v panelu „Detaily“ nahlížecí tabulky. Při neexistenci tohoto souboru se ikona pro překládání textů vůbec nezobrazuje.
• GoogleTranslationLanguages.txt – seznam dvoupísmenných zkratek jazyků oddělených středníkem, které jsou nabízeny pro překládání textů. Při neexistenci tohoto souboru jsou nabízeny všechny jazyky nainstalované v NET Geniu.
• Holidays.txt – podmínka, podle které budou filtrovány načítané databázové záznamy státních svátků do datumových pickerů, do názvu dnešního státního svátku v záhlaví portálu, do vyznačení státních svátků v ovládacích prvcích „Calendar“, „Planner“ a „TimeTable“ a do funkcí „ADDWORKDAYS“, „MEASUREWORKDAYS“, „MEASUREWORKHOURS“, „jsMeasureWorkDays“ nebo „Date.addWorkDays“ – například „ng_country = 'USERDETAILS(ng_countryforholidays)'“
• License.txt – licenční klíč NET Genia. Detailní popis licenčního klíče je uveden v samostatné příručce [[bezpecnost-a-uzivatele#licencni-model Bezpečnost a uživatelé]].
• LoginByIdentity.txt – existence tohoto souboru zajistí, že bude součástí přihlašovacího okna do NET Genia zaškrtávací tlačítko určené pro automatické přihlášení uživatele pomocí integrovaného ověřování Windows bez nutnosti ručně zadávat přihlašovací jméno a heslo.
  • Pro tyto účely musí být uživatel definován v „Active Directory“ a název doménového účtu uživatele musí být v NET Geniu vyplněn v tabulce uživatelů (tabulka „susers“) ve sloupci „Účet systému Windows“ (sloupec „account“). Účet musí být vyplněný jen u jednoho uživatele – má-li ho více uživatelů, přihlášení se odmítne. Účet porovnává databáze podle řazení sloupce, takže na databázi Firebird s výchozím řazením, které rozlišuje velikost písmen, musí souhlasit s účtem ověřeným systémem Windows i ve velikosti písmen.
  • Proces automatického přihlášení uživatele zajišťuje pouze autentizaci uživatele, autorizaci zajišťuje NET Genium – každý uživatel má přidělený vlastní seznam uživatelských skupin, ve kterých je členem.
  • Nepřihlásí-li stránka „LoginByIdentity.aspx“ uživatele (například když se jeho účet v NET Geniu nenajde nebo přihlášení odmítne kontrola povolených IP adres), další otevření portálu v téže relaci prohlížeče už automatické přihlášení nezkouší a zobrazí přihlašovací okno; neplatí to, vyžaduje-li NET Genium cookies souborem „DenyCookieless.txt“. Automatické přihlášení se zkusí znovu, jakmile uživatel v přihlašovacím okně znovu zaškrtne automatické přihlašování.
  • Spolu s vytvořením souboru „LoginByIdentity.txt“ je nutné nakonfigurovat v IIS webovou stránku „LoginByIdentity.aspx“, aby podporovala integrované ověřování Windows, viz [[instalace-netgenium-webovy-server#nastaveni-loginbyidentity příručka pro instalaci NET Genia]].
• LoginByMicrosoft.txt – existence tohoto souboru zajistí, že bude součástí přihlašovacího okna do NET Genia zaškrtávací tlačítko určené pro automatické přihlášení uživatele pomocí integrovaného ověřování Microsoft bez nutnosti ručně zadávat přihlašovací jméno a heslo. Pro tyto účely musí být uživatel definován v „Azure Active Directory“, resp. "Microsoft Entra ID", a e-mailová adresa uživatele musí být v NET Geniu vyplněna v tabulce uživatelů (tabulka „susers“) ve sloupci „E-mail“ (sloupec „email“), a to právě u jednoho uživatele; na databázi Firebird s výchozím řazením se e-mail porovnává i ve velikosti písmen. Proces automatického přihlášení uživatele zajišťuje pouze autentizaci uživatele, autorizaci zajišťuje NET Genium – každý uživatel má přidělený vlastní seznam uživatelských skupin, ve kterých je členem. Spolu s vytvořením souboru „LoginByMicrosoft.txt“ je nutné nakonfigurovat NET Genium na portálu „[[https://portal.azure.com|target=_blank]]“, viz příručka [[konfigurace-prihlasovani-uzivatelu-pres-ms-entra Konfigurace přihlašování uživatelů přes MS Entra]].
• MaxExcelColumns.txt – maximální počet sloupců exportu dat z nahlížecí tabulky do formátu XLSX nebo XLS; při jeho překročení se export automaticky přepne na formát CSV. Neexistuje-li soubor nebo obsahuje-li nulu, počet sloupců se neomezuje. Detailní popis je uveden v samostatné příručce [[export-dat-z-datagridu Export dat z DataGridu]].
• MaxExcelRows.txt – maximální počet řádků exportu dat z nahlížecí tabulky do formátu XLSX nebo XLS; při jeho překročení se export automaticky přepne na formát CSV. Neexistuje-li soubor nebo obsahuje-li nulu, počet řádků se neomezuje. Detailní popis je uveden v samostatné příručce [[export-dat-z-datagridu Export dat z DataGridu]].
• MaxRequestCount.txt – maximální počet requestů anonymního uživatele (vestavěný účet, v jehož kontextu pracují anonymní webové formuláře) z jedné IP adresy za vteřinu, který nahrazuje výchozí limit 100 requestů za vteřinu – typicky ho navyšuje, menší číslo ho ale sníží; nula, záporné číslo nebo neplatný obsah znamená výchozí limit. U nepřihlášených návštěvníků se tímto limitem (výchozím i nastaveným) násobí i povolený objem dat za vteřinu, který je u editačních formulářů, výběrových dialogů a nahrávání souborů 50 MB (nebo hodnota ze souboru „MaxRequestLength.txt“) a u ostatních stránek 1 MB. Navýšení je aktuální především u anonymních webových formulářů, kde všichni uživatelé vystupují v kontextu jednoho nepřihlášeného uživatele. Pod tento limit spadá i každý návštěvník, který se dosud nepřihlásil, a všichni nepřihlášení návštěvníci z jedné IP adresy ho sdílejí. Pro přihlášené uživatele platí pevný limit 10 requestů za vteřinu, který tento soubor nemění. Oba limity se počítají zvlášť pro každý druh stránky – například pro editační formuláře, nahlížecí stránky včetně hlavní stránky s portlety, výběrové dialogy, nahrávání souborů a přihlašovací stránku – a po jejich překročení se místo stránky zpravidla zobrazí hlášení „Čekejte prosím, váš požadavek je v pořadí...“.
• MaxRequestLength.txt – maximální velikost requestu uživatele uváděná v MB, která nahradí výchozí limit 50 MB (menší hodnota limit sníží), typicky při potřebě pravidelného uploadování velkých souborů do databázových ovládacích prvků „File“ a „Image“ v editačním formuláři. Stejná hodnota určuje i limit objemu dat za sekundu, který ochrana proti přetížení povoluje u editačních formulářů, výběrových dialogů a nahrávání souborů. Velikost requestu má vliv na hodnoty atributů „maxRequestLength“ a „maxAllowedContentLength“ v souboru „Web.config“, které po každé aktualizaci NET Genia na novou verzi nastavuje program „FinishUpdate.exe“ a při restartu z administrátorského režimu nebo heslem samotné NET Genium (viz kapitola [[#restartovat Restartovat]]).
• MaxSyncCount.txt – maximální počet záznamů jednorázové synchronizace všech dat v databázové tabulce editačního formuláře, který se používá pro navýšení výchozího limitu 10 000 záznamů. Detailní popis jednorázové synchronizace je uveden v samostatné příručce [[editacni-formular Editační formulář]].
• MetaTags.txt – seznam HTML tagů, které se vkládají do každého editačního formuláře do hlavičky webové stránky mezi tagy „<head>“ a „</head>“
• MicrosoftOAuth.json – konfigurace přihlášení uživatelů přes Microsoft (Microsoft Entra ID) ve formátu JSON. Detailní popis je uveden v samostatné příručce [[konfigurace-prihlasovani-uzivatelu-pres-ms-entra Konfigurace přihlašování uživatelů přes MS Entra]]. Soubor využívají také služby „CRMService“, „InvoiceService“ a „PaymentService“ pro přihlašování k poštovní schránce přes OAuth2.
• NoFrames.txt – existence tohoto souboru zajistí, že bude používána bezrámová verze NET Genia – záhlaví a navigační oblast budou součástí HTML kódu portletů, nahlížecích stránek nebo editačních formulářů
• NoScript.txt – textová zpráva, která se automaticky vkládá dovnitř tagu „<noscript>“ do každého editačního formuláře, nahlížecí stránky, výběrového dialogu a konfiguračního dialogu a do stránky s portlety, a určuje zástupný text pro uživatele, kteří nemají povolený javascript ve svém webovém prohlížeči. Například:
  „Vážení uživatelé,
  Váš webový prohlížeč bohužel nepodporuje javascript, který je nutný pro správné zobrazení těchto stránek.
  Prosíme zapněte si jej.
  Děkujeme“
• OCRServer.txt – URL vzdáleného NET Genia, které poskytuje služby OCR. Adresu vrací proměnná „#ocrserver#“; samo NET Genium ji nikde nepoužije – uplatní se jen tehdy, když se proměnná předá funkcím „OCR2TEXT“, „OCR2HTML“ nebo „OCR2FILE“ jako parametr „url“, např. „OCR2TEXT(#ng_priloha#, #ocrserver#)“.
• PublicDirectory.txt – cesta k veřejnému adresáři na serveru, ze kterého ovládací prvek „File“ v editačním formuláři nabízí volbou „Procházet Cloud“ soubory z adresáře záznamu. Vyplněný soubor zároveň zobrazí v nástrojích editačního formuláře ikonu „Cloud...“, která obsah adresáře záznamu otevře; ikona se nezobrazuje v NET Genium Online, anonymnímu uživateli, na mobilním zařízení, v editačním formuláři, který má v poli „Poznámky“ zápis „DISABLEPAGETOOLS()“, a v uživatelském režimu v editačním formuláři, který zobrazuje prioritní HTML kód (ovládací prvek HTML se zaškrtnutým polem „Prioritní HTML kód umístěný před formulářem“). Detailní popis je uveden v samostatné příručce [[editacni-formular-file Editační formulář – File]].
• RequestHeaders.txt – řádky ve tvaru „klíč: hodnota“, ze kterých NET Genium používá jen řádek s klíčem „IP“: jeho hodnota je název přeposílací hlavičky, ze které se čte klientská IP adresa za reverzní proxy, a hodnota „?“ vypíná kontrolu seznamu „Povolené IP adresy“. Detailní popis je uveden v samostatné příručce [[instalace-netgenium-webovy-server#klientska-ip-za-proxy Instalace NET Genia na webovém serveru]].
• ResponseHeaders.txt – seznam hlaviček oddělených enterem, které se automaticky vkládají do odpovědí webových stránek NET Genia. Na každé řádce souboru je umístěna definice jedné hlavičky v následujícím formátu:
  „key: value“
  • Obsahuje-li hlavička „Content-Security-Policy“ direktivu „script-src“ ukončenou středníkem, doplní do ní NET Genium u uživatelů s administrátorským oprávněním a v dialozích, ve kterých si uživatel přizpůsobuje ovládací prvky (například nahlížecí tabulku), hodnotu „'unsafe-eval'“, pokud ji direktiva ještě neobsahuje. Direktiva „script-src“ bez středníku na konci se nemění.
  • Nezávisle na tomto souboru posílá NET Genium s webovými stránkami hlavičky „Cache-Control: no-store, no-cache, must-revalidate“, „X-Content-Type-Options: nosniff“ a „X-Frame-Options“ (viz „XFrameOptions.txt“), uživatelům s administrátorským oprávněním navíc „X-XSS-Protection: 0“. Hlavičku „Strict-Transport-Security: max-age=31536000; includeSubDomains; preload“ posílá při připojení přes HTTPS, při existenci souboru „SecureCookies.txt“ a při existenci souboru „SSL.txt“ bez obsahu nebo s adresou začínající „https://“ – kromě požadavků z IP adresy „127.0.0.1“. Hlavičku „Server“ z odpovědi odstraňuje.
• SecureCookies.txt – existence tohoto souboru zajistí, že bude mít každá cookie nastaven parametr „Secure“. Tímto konfiguračním souborem je nutné řídit chování parametru „Secure“ pouze u webových serverů, které mají nastavenou terminaci SSL na firewallu (například F5). Webové servery, které mají SSL certifikát nastavený přímo v IIS, tento konfigurační soubor nepotřebují, a parametr „Secure“ je každé cookie nastavován automaticky.
• SessionTimeout.txt – délka v minutách, po jejímž uplynutí dojde k ukončení session aktuálně přihlášeného uživatele z důvodu jeho neaktivity (výchozí 480 minut; přihlášení ve webovém prohlížeči ale nezávisle na této délce skončí nejpozději 24 hodin po přihlášení, takže hodnota vyšší než 1440 minut se v prohlížeči neprojeví – s výjimkou uživatele, kterého ověřil webový server (například integrovaným ověřováním Windows nebo klientským certifikátem) účtem shodným s jeho polem „Účet systému Windows“); projeví se až poté, co aktualizace nebo restart NET Genia (viz kapitola [[#restartovat Restartovat]]) přepíše soubor „Web.config“; návrat k výchozí hodnotě ani smazání souboru ale restart do souboru „Web.config“ nepromítne, projeví se až aktualizací NET Genia
• SingleLogin.txt – existence tohoto souboru zajistí, že bude mít uživatel aktivní vždy pouze poslední platné přihlášení do aplikace každého druhu. U předchozích session téhož druhu dojde k automatickému odhlášení. Druhy přihlášení jsou dva: interaktivní přihlášení v prohlížeči a všechna ostatní přihlášení dohromady, například přihlášení tokenem přes integrovaný MCP server, přes webové služby knihovny „NETGeniumConnection“ a přihlášení přes Windows z adresy s parametrem „autologin“. Služba připojená přes knihovnu „NETGeniumConnection“ a integrovaný MCP server se proto pod stejným účtem navzájem odhlašují. Přihlášení adresou s přihlašovacím ticketem a automatické přihlášení přes Microsoft, Google nebo Apereo patří k interaktivnímu přihlášení v prohlížeči.
• SimpleClick.txt – existence tohoto souboru zajistí, že bude pro otevírání záznamů z nahlížecích tabulek používáno jednoduché kliknutí. Výchozí nastavení pro otevírání záznamů z nahlížecích tabulek vyžaduje dvojité kliknutí. Má-li nahlížecí tabulka zapnuté zobrazení detailů, jednoduché kliknutí zobrazí detaily záznamu a záznam se otevírá dvojklikem nebo odkazem na začátku řádku.
• SSL.txt – existence tohoto souboru zajistí, že bude každý request přes nezabezpečený kanál „http“ automaticky přesměrován na „https“. Requesty z IP adresy „127.0.0.1“ se nepřesměrovávají. Obsah souboru přesměrování upravuje:
  • prázdný soubor nebo jiný obsah než hodnoty uvedené níže – request přes kanál „http“ se přesměruje na tutéž adresu s kanálem „https“,
  • URL stránky začínající „https://“ – na tuto URL bude uživatel přesměrován v případě pokusu o zobrazení NET Genia přes kanál „http“ a také při requestu přes kanál „https“, jehož adresa touto URL nezačíná,
  • URL stránky začínající „http://“ – request přes kanál „http“ se nepřesměruje a request přes kanál „https“ se přesměruje na tuto URL,
  • „auto“ – přesměrování se vypne úplně,
  • „http“ – soubor se chová, jako by neexistoval.
  • Obsah souboru se porovnává doslova, hodnota proto nesmí končit zalomením řádku.
• SysLog.txt – IP adresy „SysLog“ serverů oddělených středníkem, na které budou automaticky odesílána logová hlášení, viz kapitola [[#logovani Logování]]
• Tester.txt – existence tohoto souboru zajistí, že bude aktualizační program „Update.exe“ stahovat z internetu nové testerské verze NET Genia, které jsou určené pro partnery nebo vývojáře společnosti NetGenium za účelem ladění nových funkcí. Testerské verze mohou obsahovat chyby, nebo mohou být nestabilní!
• UnderConstruction.txt – existence tohoto souboru zajistí, že nebude možné používání webové aplikace, a každý request bude automaticky přesměrován na webovou stránku „UnderConstruction.aspx“ s hlášením o nedostupnosti aplikace. Soubor může volitelně obsahovat textovou zprávu, která se zobrazí namísto výchozího hlášení o nedostupnosti.
• UnderConstruction2.txt – existence tohoto souboru zajistí, že nebude možné přihlášení do aplikace nikomu jinému než uživatelům s administrátorským oprávněním, a každý request všech ostatních uživatelů, včetně již přihlášených, bude automaticky přesměrován na webovou stránku „UnderConstruction2.aspx“ s hlášením o nedostupnosti aplikace. Omezení se netýká anonymního uživatele – editační formuláře a nahlížecí stránky zpřístupněné anonymnímu uživateli zůstávají dostupné. Soubor může volitelně obsahovat textovou zprávu, která se zobrazí namísto výchozího hlášení o nedostupnosti.
• UpdateArchive.txt – definice záznamů, které archivuje program „SqlBackup.exe“ spouštěný s parametrem „/updatearchive“. Detailní popis je uveden v samostatné příručce [[utility Utility]].
• Version.txt – číslo aktuální verze NET Genia
• XFrameOptions.txt – hodnota hlavičky „X-Frame-Options“, která se vkládá do odpovědí webových stránek NET Genia. Hlavička „X-Frame-Options“ umožňuje sdělit webovému prohlížeči, zda může být webová stránka zobrazena v rámu.
  • Bez tohoto souboru, nebo je-li prázdný, má hlavička hodnotu „sameorigin“ – stránky NET Genia je možné zobrazit v rámu jen na webové stránce se stejným původem (stejný protokol, doména i port).
  • Hodnota „*“ hlavičku vynechá a zobrazení v rámu tak povolí i jiným doménám. Jakákoli jiná hodnota se do hlavičky vloží beze změny.
  • Stránky pro stažení souboru, obrázku a dokumentu a obrazovka souhlasu při připojení AI nástroje přihlášením posílají hlavičku vždy s hodnotou „deny“.

5. Souborové přílohy

• Souborové přílohy jsou uloženy na disku v adresáři „Files“. Každá souborová příloha má informaci o názvu souboru uloženou v databázi v tabulce „sfiles“, a na disku je uložena pod změněným názvem souboru. Název souboru na disku bez přípony je definován jako ID záznamu souborové přílohy v tabulce „sfiles“, přípona pak zůstává zachována. Příklad první souborové přílohy uložené v NET Geniu může být například „1.pdf“.
• Souborové přílohy vznikají uploadem souboru pomocí ovládacích prvků „File“ nebo „Image“ v editačním formuláři, vytvořením souborové přílohy serverovou funkcí ve skriptu apod.
• Adresář se souborovými přílohami je možné přesměrovat do jiného umístění na disku pomocí konfiguračního souboru „Files“ bez přípony, který je uložen napřímo ve stejnojmenném adresáři podobně jako bývají ostatní souborové přílohy. Obsah souboru „Files“ pak definuje cestu na disku k alternativnímu adresáři, do kterého mají být souborové přílohy ukládány.

[[Kotva:logovani]]

6. Logování

6.1. Logování incidentů

• Logování incidentů zajišťují dvě základní operace:
  • Ukládání logových hlášení do souborů na disk do adresáře „NETGenium\Logs“
  • Odesílání logových hlášení na „SysLog“ server

6.1.1. Logové soubory

• Logová hlášení se ukládají v adresáři „NETGenium\Logs“, mimo jiné do následujících souborů:
  • AI-year-month.log – Seznam změn implementačního modelu zapsaných přes webové služby nebo integrovaný MCP server a chyb při jejich nahrávání
  • Auth-year-month.log – Seznam úspěšných a neúspěšných přihlášení a odhlášení
  • Data-year-month.log – Seznam databázových dotazů, jejichž výsledek načtený do tabulky měl více než milion řádků (dotazy, které data mění, se nezapisují), nebo jejichž spotřeba paměti přesáhla 1GB
  • Download-year-month.log – Seznam stažených souborů
  • Errors.log – Seznam vzniklých chyb během práce uživatelů; část chyb se do něj záměrně nezapisuje, typicky vypršení časového limitu dotazu („Execution Timeout Expired.“) a uváznutí („deadlock“) a u uživatelů bez administrátorského oprávnění i chyby MS SQL Serveru, které NET Genium nevyhodnotí jako závažné; neošetřené chyby stránek tomuto omezení nepodléhají
  • Export-year-month.log – Seznam uživatelsky exportovaných dat
  • FinishUpdate.log – Seznam vzniklých chyb během aktualizace aplikace na novou verzi
  • Fulltext-year-month.log – Seznam vzniklých chyb při fulltextovém prohledávání souborových příloh
  • Google-year-month.log – Seznam chyb při volání služeb Google pro geokódování adres a překlad textů
  • Install.log – Záznamy programu „Setup.exe“: výsledek nastavení práv k adresáři NET Genia a k databázi MS SQL, neúspěšné pokusy o připojení k MS SQL Serveru, nepodaří-li se připojit k žádnému, a chyby při práci s konfigurací IIS
  • Install-year-month.log – Seznam chyb při načtení účtu „Administrator“ ze souboru „Config\Administrator.xml“ během zakládání systémových uživatelů nové databáze
  • MultiTableApplication-year-month.log – Seznam upozornění a chyb při vytváření aplikace průvodcem „Aplikace s pomocí AI“
  • Push-year-month.log – Seznam výsledků odesílání oznámení na mobilní telefon
  • ResendEmlFiles-year-month.log – Seznam příkazů komunikace se SMTP serverem při pokusu o opětovné odeslání e-mailových zpráv z fronty na disku, resp. z adresáře „NETGenium\SMTP“
  • RunningTasks.log – Seznam úloh, které běžely v okamžiku ukončení aplikace
  • RunScript-year-month.log – Seznam vykonaných skriptů prostřednictvím aplikace „RunScript.exe“
  • Scripts60sec-year-month.log – Seznam skriptů tlačítek spuštěných kliknutím, skriptů prvku „File“ při vytvoření dokumentu ze šablony a skriptů nového záznamu z prvků „Planner“ a „TimeTable“, jejichž zpracování trvalo 60 vteřin a déle
  • SMTP-year-month.log – Seznam úspěšně i neúspěšně odeslaných e-mailů
  • Synchro-year-month.log – Průběh odesílání fronty synchronizace a jeho chyby
  • System.log – Seznam informativních hlášek o spuštění aplikace (často souvisí se spuštěním nebo restartem aplikačního poolu)
  • Update.log – Seznam chyb aktualizace programem „Update.exe“ spouštěné s parametrem „-j“; při logování „Na disk“ nebo „Do databáze a na disk“ i průběh ruční aktualizace a aktualizace s parametrem „-j“
  • Version.log – Seznam změn databázové struktury souvisejících s novou verzí aplikace
  • Warnings.log – Seznam upozornění
  • yyyy-MM-dd.log – Denní log hlášení, která nemají vlastní logový soubor, například hlášení externích funkcí
• Při logování „Na disk“ nebo „Do databáze a na disk“ vznikají v adresáři „NETGenium\Logs“ podadresáře pojmenované podle přihlašovacího jména uživatele a v nich podadresáře pojmenované podle data (yyyy-MM-dd) s logy jednotlivých uživatelů, například se soubory „stables_stats.log“, „sviewpages_stats.log“ a „squerybuilder_stats.log“ se statistikami editačních formulářů, nahlížecích stránek a databázových dotazů. Podrobný průběh přihlášení přes Microsoft, Google, Facebook nebo Apereo (soubory „loginbymicrosoft.log“ a obdobné) se zapisuje do podadresáře uživatele, v jehož relaci přihlášení probíhá: při přihlášení do NET Genia do podadresáře anonymního uživatele, při získání tokenu JavaScriptovými funkcemi „loginByMicrosoft“, „loginByGoogle“ a „loginByFacebook“ do podadresáře přihlášeného uživatele.
• Adresář s logovými soubory je možné přesměrovat do jiného umístění na disku pomocí konfiguračního souboru „Logs“ bez přípony, který je uložen napřímo ve stejnojmenném adresáři podobně jako bývají ostatní logové soubory. Obsah souboru „Logs“ pak definuje cestu na disku k alternativnímu adresáři, do kterého mají být logové soubory ukládány.
• Logové soubory, které mají v názvu rok mezi pomlčkami (například měsíční logy „SMTP-rok-měsíc.log“), zabalí program „ResendEmlFiles.exe“ za roky, které skončily před více než měsícem, do archivů ZIP podle názvu logu a roku (například soubory „SMTP-2025-01.log“ až „SMTP-2025-12.log“ do archivu „SMTP-2025.zip“) v témže adresáři a původní soubory smaže. Detailní popis je uveden v samostatné příručce [[utility Utility]].

6.1.2. SysLog

• Odesílání logových hlášení je možné nastavit na více „SysLog“ serverů zároveň. Nastavení je provedeno pomocí konfiguračního souboru „SysLog.txt“ umístěného v adresáři „NETGenium\Config“.
• Pokud je konfigurační soubor „SysLog.txt“ vytvořen, a je v něm uvedena jedna IP adresa „SysLog“ serveru, nebo více IP adres „SysLog“ serverů oddělených středníkem, budou logová hlášení automaticky odesílána na uvedené „SysLog“ servery, a zároveň budou ukládána do adresáře „NETGenium\Logs“.
  • Na „SysLog“ servery se odesílají například hlášení logů „Auth“, „Errors“, „System“ a „Warnings“ a hlášení denního logu „yyyy-MM-dd.log“.
  • Některé logy, například „Download“, „Export“, „RunScript“, „SMTP“ a „Synchro“, se ukládají pouze do souborů v adresáři „NETGenium\Logs“ a na „SysLog“ servery se neodesílají.
• Při absenci konfiguračního souboru „SysLog.txt“ je logování prováděno pouze do souborů v adresáři „NETGenium\Logs“.
• Zprávy odesílané na „SysLog“ server mají následující formát, který používá mezeru jako oddělovač jednotlivých hodnot: „datum čas doménový_název_serveru aplikace kategorie typ_události přihlašovací_jméno_uživatele ip_adresa_uživatele zpráva“.
  • Kategorie – název logu, například Auth, Errors nebo System; u některých logů, například „AI“, „Data“ a denního logu, odpovídá kategorie typu události (System, Warnings nebo Errors)
  • Typ události – VERBOSE, NOTICE, WARNING, ERROR, FATAL

6.2. Logování rychlosti webové aplikace

• NET Genium loguje do databáze následující události:
  • Rychlost načtení editačních formulářů – do databázové tabulky „stables_stats“
  • Rychlost načtení nahlížecích stránek – do databázové tabulky „sviewpages_stats“
  • Rychlost databázových dotazů – do databázové tabulky „squerybuilder_stats“
  • Rychlost externích funkcí – do databázové tabulky „sngef_stats“
  • Rychlost skriptů – do databázové tabulky „sngscript_stats“
• Zapnutí nebo vypnutí logování se provádí v samostatném dialogu pod odkazem „Upravit NET Genium“ na záložce „Ostatní“:
  • Vypnuté – logování je vypnuté
  • Do databáze – logování probíhá pouze do databáze
  • Na disk – logování probíhá pouze na disk do adresáře „Logs“
  • Do databáze a na disk – logování probíhá do databáze a na disk do adresáře „Logs“
• Zobrazení agregovaných statistik z logů vytvořených v databázi je možné pomocí reportů, viz příručka [[reporty Reporty]].
• Logovací tabulky rostou, dokud z nich nejsou staré záznamy smazány. Mazání provádí program „SqlBackup.exe“ spouštěný s parametrem „/deletelogs“ – pro pravidelný úklid naplánovanou úlohou Windows, viz příručka [[utility Utility]]. Program „BackupServer.exe“ navíc odstraňuje záznamy starší než 1 měsíc před zálohou každé databáze, viz příručka [[zalohovani-a-obnoveni-zalohy-serveru Zálohování a obnovení zálohy serveru]].