Přechod na Intranet 2.0

Tato stránka shromažďuje požadavky a postup přechodu existující aplikace Flexideo na Intranet 2.0. Přechod zahrnuje součinnost generovaných souborů aplikace, runtime Intranetu, serveru a případných vlastních rozšíření. Jednotlivé vrstvy budeme doplňovat na této stránce podle ověřených podkladů.

Zatím je zpracována část Replicator: nastavení cílové větve, plná replikace a kontrola instalovaných souborů. Požadavky ostatních vrstev dosud nejsou kompletně zmapovány; splnění této části samo o sobě nepotvrzuje dokončení celé migrace.

Replicator

Předpoklady

Použijte sestavení Replicatoru, které podporuje větev web-2.0 jak pro dokumentové formuláře, tak pro stránku výběru nového dokumentu. Podpora formulářů a jejich moderních skriptových závislostí byla doplněna 15. srpna 2026; podpora UTF-8 pro výběr nového dokumentu 1. září 2026. Tyto údaje označují historii implementace, nikoli ověřené minimální číslo distribuovaného instalačního balíku.

Před přechodem uchovejte dosavadní nastavení instance a instalované soubory pro možnost návratu. Na cílovém webu musí být připraven kompatibilní runtime Intranetu 2.0, zejména skripty msxml-shim.js a xslt-wrapper.js. Replicator do formulářů vloží odkazy na skripty; tato operace sama nepotvrzuje jejich přítomnost ani kompatibilitu na webu.

Nastavení v E-3

1. Otevřete nastavení příslušné aplikace/instance v Replicatoru.
2. Přejděte do E-3) Nastavení intranetu.
3. V seznamu vyberte položku targetversion. Tento popisek určuje katalog intranet.config-structure.mxl; XML název je target-version. Ve starší instanci se chybějící položka při otevření seznamu automaticky doplní s hodnotou legacy, stejně jako ostatní chybějící katalogová nastavení.
4. Do pole hodnoty vložte přesně web-2.0 a stiskněte Zapsat.
5. Uložte nastavení aplikace a teprve potom připravujte novou plnou verzi.

Do pole hodnoty se zadává pouze tento text:

web-2.0

Zápis targetversion=web-2.0 popisuje dvojici položka/hodnota; celý tento výraz ani XML se do pole hodnoty nevkládá.

V nastavení instance .xcf odpovídá volbě následující XML fragment:

<application_settings>
  <intra-settings>
    <target-version>web-2.0</target-version>
  </intra-settings>
</application_settings>

Fragment ukazuje umístění jedné hodnoty; ostatní obsah nastavení se zachová. Jde o nastavení konkrétní instance, společné pro GUI a Headless i pro generování a instalaci. Není to číslo replikační verze ani volba uložená v XDS. Pro dosavadní Intranet se používá hodnota legacy.

Replicator při čtení ořízne okolní mezery a převede hodnotu na malá písmena. Chybějící hodnota i jakýkoli text jiný než web-2.0 znamenají legacy. E-3 s podporou katalogu při zápisu ověřuje povolené hodnoty a prázdnou hodnotu tohoto přepínače odmítne. Ověřte také uloženou hodnotu v nastavení instance.

Používejte binárku s podporou katalogu a odpovídající doprovodné soubory. V system.xcf musí být jméno katalogu registrováno jako files/system/intranet-config-structure. Starší sestavení mělo chybu zobrazování textových elementů: samotná existence target-version v .xcf proto nezaručovala jeho dostupnost v E-3. Katalogová implementace původní průchod i zvláštní hard-code doplňování target-version nahrazuje.

Nutná plná replikace

Pro první přechod na Intranet 2.0 rozdílová replikace nestačí. Po uložení web-2.0 vytvořte novou verzi plnou replikací a proveďte její instalaci pro všechny role.

V prvním kroku kompletace XDS vypněte volbu rozdílové aktualizace (light-update, tvorba pouze změn). Při tvorbě stránek neomezujte běh na jedinou zkušební roli. Dokončete standardní replikační fáze včetně instalace nově vytvořeného balíku na cílovou instanci.

Důvodem je změna výstupního formátu i pro dokumenty, jejichž XDS se vůbec nezměnilo. Rozdílový režim může přeskočit nezměněné role a uvnitř role vybírá jen dokumenty označené k aktualizaci. Samotná změna nastavení cílového Intranetu tyto příznaky nenastavuje a rozdílový režim automaticky nevypíná. Část souborů by tak mohla zůstat v legacy podobě.

Pro technickou kontrolu plného režimu odpovídá vypnutá volba hodnotě CdatConfigVer.CreationUpdateOnly = False; v konfiguraci verze jde o atribut ConfigVer/creation/@changes-only. Tento přepínač je oddělený od nastavení application_settings/intra-settings/target-version.

Pouhé vygenerování konfigurace tlačítkem v E-3 neobnoví všechny formuláře. Stejně tak nestačí znovu instalovat balík vytvořený před změnou nastavení nebo ručně přepsat soubory pod roles: další replikace ruční změny přepíše.

Co se mění ve výstupu

Výstup	Chování při web-2.0
Běžné dokumentové formuláře form-g-xx.htm, včetně form-g-01.htm a form-g-99.htm	Deklarace <meta charset="utf-8">, instalační zápis UTF-8 bez BOM a odkazy na moderní skripty.
Výběr nového dokumentu role doc-select-new-g-xx.htm, například doc-select-new-g-01.htm	Deklarace <meta charset="utf-8"> a instalační zápis UTF-8 bez BOM; dokumentové skriptové závislosti se sem nedoplňují.
Univerzální formulář hromadné editace x_whole_edit (typ whole-form)	Od verze 9.87.17(c) dostává také moderní bootstrap před formcontrol.js; HTML struktura a ostatní skripty se zachovávají.

U běžného dokumentového formuláře i hromadné editace x_whole_edit je pořadí skriptů:

msxml-shim.js
xslt-wrapper.js
formcontrol.js

Odkazy se generují se zástupným markerem scripts##g##, který instalátor rozvine podle grafické varianty, například na scripts-g. Samotná volba nemění strukturu XDS ani další obsah formuláře.

UTF-8 bez BOM se přímo zapisuje v lokální a FTP instalační cestě. Mezilehlý pracovní formulář zachovává dosavadní kódování kvůli starší načítací cestě instalátoru; rozhodující je výsledný instalovaný soubor. Při instalaci přes HTTP se používá serverové rozhraní pro uložení souboru, proto ověřte skutečné kódování na cíli a HTTP hlavičku Content-Type: server nesmí deklarovat charset odporující UTF-8 obsahu.

Kontrola po instalaci

1. Ověřte uložené target-version=web-2.0 a dokončení plné tvorby i instalace pro všechny role. Pro první funkční kontrolu použijte alespoň dvě role s různými oprávněními nebo seznamy dokumentů.
2. V instalovaných form-g-01.htm, form-g-99.htm a doc-select-new-g-01.htm ověřte platné UTF-8 bez BOM a jedinou deklaraci <meta charset="utf-8">. Zkontrolujte i ostatní používané grafické varianty.
3. Ověřte pořadí skriptů v dokumentových formulářích a úspěšné načtení msxml-shim.js i xslt-wrapper.js z výsledných URL.
4. V cílovém prohlížeči, například Firefoxu, otevřete výběr nového dokumentu a dokumentový formulář. Zkontrolujte českou diakritiku, načtení a běžnou práci s dokumentem; samotná správná meta deklarace funkčnost nedokazuje.
5. Na oddělené legacy instanci ověřte, že její výstupy zůstávají v dosavadní podobě. Tuto kontrolu oddělte od migrované instance.

Stav ověření

Nastavení a generovací větve byly při přípravě této stránky 3. října 2026 ověřeny čtením kódu Replicatoru. Stránka nedokládá provedenou migraci ani runtime test konkrétní instance.

Poslední přímý implementační log z 1. září 2026 uvádí úspěšné statické kontroly a sestavení Headless. GUI kompilace prošla, ale dokončení buildu blokoval zamčený výstupní EXE. Regenerace rolí, kontrola v prohlížeči a regrese legacy větve i dokumentových formulářů tehdy neproběhly; položka proto zůstala ve stavu partial.

Při navazující implementaci katalogu 3. října 2026 prošlo sestavení GUI i Headless do odděleného výstupního adresáře. Headless projekt byl doplněn o chybějící referenci na existující CblvCmpFdtDocumentation. Prošly testy katalogového doplňování, zachování hodnot, validace a atomického odmítnutí konfliktů včetně skutečné zkompilované třídy nastavení. Interaktivní kontrola E-3 a kompletní migrace instance dosud neproběhly.

Další vrstvy přechodu

Následující části budou doplněny po ověření v příslušných zdrojích:

• Runtime Intranetu 2.0: distribuce a instalace runtime souborů, kompatibilní verze skriptů a konkrétní funkční změny.
• Server a webové prostředí: podporované konfigurace, HTTP kódování, případné závislosti, autentizace a provozní podmínky.
• Vlastní rozšíření aplikace: kompatibilita zákaznických skriptů, šablon, akcí a dalších úprav.
• Uvedení do provozu a návrat: společný přejímací scénář, pořadí nasazení jednotlivých vrstev a ověřený rollback.

Tyto body vymezují zbývající rozsah dokumentace; zatím nepředstavují ověřený instalační postup ostatních vrstev.