Hlavní změny a zaniklé funkce ve verzi 5.19

Co se při upgradu z 5.17 na 5.19 mění v konfiguraci zákazníka: šablony, proměnné, workflow, kalkulace, tisky a crony. Určeno TAS konzultantům, kteří upgrade připravují se zákazníkem a ověřují ho po nasazení.

Kde vstupuje konzultant

Audit šablon před upgradem

Odstraněné konstrukce v šablonách

Graf procesu

Graf procesu již není instanční, je dopočítáván dynamicky a zobrazuje mnohem více informací než dříve.

Retranspilace kalkulací (jen z verzí pod 5.17.7)

V 5.19 se filter, find, some, every, reduce a sort s async callbackem nově přepisují na sekvenční smyčky; lodash metody se nechávají být.

Pokud jdete z 5.17.x nižší než 5.17.7, spusťte po upgradu:

validation.checkAsyncAwaitRetranspilationNeeded(tProcId?)

sys.retranspileCalculationsByProcessId(...)
sys.retranspileCalculationsByTaskId(...)
sys.retranspileGlobalScripts()

Pluginy

Nově přibyly pluginy docx-generator (1.0.2) a helpDocs (1.0.5). Ostatní pluginy mají v 5.19 nové verze a staré se tiše nenačtou – ověřte po upgradu, že je zákazník má všechny.

Změny ve workflow a grafu procesu

Změny v kalkulacích a skriptech

docxGenerator.generate() – změněný kontrakt

Funkce vrací seznam [{name, id}] místo jednoho DMSF_ID. Přibyla volba saveAsPdf.

// 5.17
const dmsfId = docxGenerator.generate(...);

// 5.19
const result = docxGenerator.generate(...);
const dmsfId = result[0].id;

Nové mapování skriptů (volitelná optimalizace)

Přibyly sloupce TEMPLATE_PRINT.PRNT_APPEND_SCRIPTS a TEMPLATE_TASKS.TTASK_APPEND_SCRIPTS. Tisky a dynamické podmínky tak mohou načítat jen podmnožinu CO skriptů místo všech.

Nové kalkulační funkce k nabídnutí

Nastavení povinné linky je zrušeno

TTASKLINK_IS_MANDATORY je zrušen end-to-end. Link označený jako povinný už sám o sobě neblokuje aktivaci úkolu – aktivace je nově čistě Petri-net based.

Toto řešení bylo používáno historicky.

Babel 8 – zpřísněná kontrola JSX v Case Overview a tiscích

Od verze 5.19 transpiluje TAS frontend skripty pomocí Babelu 8. Změna zpřísňuje kontrolu syntaxe v JSX a může způsobit, že se dosud funkční skripty Case Overview a tisků nepodaří uložit. Následující část popisuje, jak zasažené skripty poznat a opravit.

Čeho se změna týká

Pouze React skriptů transpilovaných na straně serveru při uložení:

• Case Overview,
• tisky (prints / PDF).

Backendových výpočtů, skriptů, cronů ani dynamických podmínek se změna netýká.

Příčina

V JSX může atribut obsahovat pouze jeden výraz. Pokud je v něm více hodnot oddělených čárkou, jde o sekvenční výraz. Babel 7 takový zápis tiše přijal a vyhodnotil jej na poslední operand – všechny předchozí hodnoty zahodil bez varování. Babel 8 z něj dělá tvrdou chybu překladu:

Sequence expressions cannot be directly nested inside JSX.
Did you mean to wrap it in parentheses (...)?

Jak poznat zasažený skript

Postup opravy

1. Otevřete skript a najděte řádek uvedený v chybové hlášce.
2. Zkontrolujte atribut, ve kterém jsou hodnoty oddělené čárkou.
3. Sloučte je do jednoho pole nebo objektu.
4. Uložte skript a ověřte chování komponenty – po opravě se poprvé projeví i dříve zahazované hodnoty.

Chybný zápis:

additionalVariables={
    [{taskName: 'Confirm the delivery'}],
    [{taskName: 'Change the billing status'}]
}

Správný zápis:

additionalVariables={[
    {taskName: 'Confirm the delivery'},
    {taskName: 'Change the billing status'}
]}

Na co si dát pozor

• Oprava mění chování. Po sloučení do pole začne komponenta pracovat i s hodnotami, které dosud zahazovala. Ověřte, že je výsledek skutečně žádoucí – nejde o čistě kosmetickou úpravu.
• Vzor bývá zkopírovaný. Netýká se jen jednoho atributu. Projděte na prostředí všechny Case Overview a tisky a hledejte jakýkoli prop zapsaný jako seznam hodnot oddělených čárkou.
• Chyba se hlásí ze serveru. Ačkoli jde o frontend kód, transpilace probíhá při uložení na backendu. Hlášku proto uvidíte jako chybu uložení, ne v konzoli prohlížeče.

Crony z pohledu konzultanta

Crony prošly kompletní přestavbou. Většina je DevOps práce, ale tři věci jsou na vás.

EWS mail crony se smažou

Konfiguraci pak přeneste do MS Graph cronů. Nové možnosti, které při tom využijete:

• clientSecret může být odkaz na Vault secret ve tvaru {{vault:name}},
• tlačítko Discover folders vypíše dostupné složky schránky,
• duplikace schránky pro rychlé založení dalšího cronu.

Změny chování, které zákazník pozná

Nové crony

Existující instance mají tabulku CRONS naplněnou, takže seed defaultních cronů je no-op. Nové crony je nutné založit ručně přes Administrace → Crony → „+“ a jsou defaultně neaktivní:

• DatabaseHealthReportCron,
• DatabaseIndexRebuildCron.

Zvažte se zákazníkem, jestli je aktivovat. Zároveň nastavte application.crons.consecutiveFailureThreshold (default 5) – po N po sobě jdoucích selháních odejde notifikační e-mail na chybové adresy cronu.

Co komunikovat zákazníkovi předem

Změny, které uživatelé uvidí nebo pocítí, a které nejdou vrátit zpět.

Novinky k nabídnutí zákazníkovi

• Plugin docx-generator – generování DOCX se přesunulo z jádra do pluginu, přibyla volba saveAsPdf.
• Plugin helpDocs – dokumentace přímo v aplikaci.
• Plugin Store – Administrace → Pluginy → záložka Plugin Store (jen když je nastaveno TAS_PLUGIN_STORE_URL). Instalace a odinstalace pluginů rovnou z GUI.
• MCP endpoint – POST /mcp/:scenario? zpřístupní TAS externím AI klientům (Claude Desktop, Claude Code) ve scénářích case-creation, case-editing, case-lookup, knowledge, account, administration. Jen přes API token, každé volání se auditovává.
• E-mail přes MS Graph – nový transport msgraph (app-only / Client Credentials) vedle basic, oauth2 a sendmail.
• Vlastní X-hlavičky v notifikacích – s podporou placeholderů a allowlistem.
• System Health – fleet-aware monitoring všech instancí s 48h historií, Database Activity nad běžícími dotazy.
• Konfigurace pluginů v GUI – Administrace → Konfigurace → záložka Plugins.

Konzultantský checklist po upgradu

Crony a integrace

• EWS crony přenesené na MS Graph, konfigurace z logu použita
• Ruční spuštění klíčových cronů (Run manually) proběhne bez chyby
• Seznam cronů odpovídá stavu před upgradem – aktivní i timing
• Odeslání e-mailu funguje: notifikace i report
• Upload do DMS, fulltext a náhledy fungují
• AD/LDAP synchronizace (AdSyncCron – v 5.19 opravena, dřív tiše nesynchronizovala nikoho)

Pluginy

• Všechny očekávané pluginy jsou v Administrace → Pluginy načtené (nekompatibilní se tiše přeskočí