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

Tento článek popisuje přechod na verzi TAS 5.17. Před zahájením upgradu je nutné projít přechodové dokumentace předchozích verzí.

V rámci verze 5.17 přibylo nových funkcionalit pro administrátory, které jsou popsány v Business changelogu.

Před upgradem na 5.17 je nutné projít přechodové dokumentace předchozích verzí
Dobrý pomocníkem při upgrade je pustit v servisní konzoli příkaz validation.validateTemplates();
Tato funkce vypíše použití všech nekompatibilních výpočtů a funkcí v rámci všech šablon.
Pozn. k tomuto musí být na prostředí nainstalovaný validation plugin.

Licence

Od verze 5.17 je vyžadována platná licence pro úpravy šablon. Bez licence je systém plně funkční, ale nelze upravovat šablony.

Licenci lze získat dvěma způsoby:

  • kontaktováním své kontaktní osoby u Neit Group,
  • online žádostí na webu teamassistant.app.

Po obdržení licence ji vložte v sekci Administrace.

Globální číselníky LOV - zánik funkce lib.setList()

Od verze 5.17 jsou všechny číselníky textů globální ("šablonovité") jakákoliv změna v číselníku se tedy projeví u všech běžících případů (mimo již vygenerované multiinstanční úkoly).

Řešení, které spoléhají na funkci setList() je tedy nutné přepsat na řešení s dynamickou tabulkou případně řešit "omezování" číselníků pomocí dynamických podmínek na formuláři.

Verzování šablon

Z platformy bylo odstraněno verzování šablon. Tato změna ovlivňuje strukturu URL adres — pokud třetí strany nebo konzultantský kód přímo volají endpointy šablon, je nutná úprava.

Původní zápis

Nový zápis

https://yourplatform.com/templates/template/27/1

https://yourplatform.com/templates/template/27/

https://yourplatform.com/templates/template/27/1/template-task/366

https://yourplatform.com/templates/template/27/template-task/366

Zkontrolujte veškerý konzultantský kód a integrace třetích stran, které odkazují na URL adresy šablon nebo úkolů, a aktualizujte je na nový formát.

Přesun FE serverových souborů na backend

Soubory jako manuály, loga a další assety již nejsou uloženy na FE serveru — byly přesunuty na backend. Zároveň došlo ke změně výchozích složek.

Podrobný manuál pro DevOps je popsaný zde.

Změna mapování složek:

Typ assetu

Původní umístění

Nový root

Loga schémat

uploads/schemaLogos

schema

Loga organizací

uploads/logos/org

org

Při přechodu je nutné aktualizovat mapování cest k assetům ve všech tiscích, Case Overview a dalším konzultantském kódu, který assety zobrazuje.

React tisky a Case Overview — použijte novou funkci getAsset():

Původní přímý odkaz na loga nebo další veřejné dokumenty již nebude fungovat.

getAsset(root: 'manuals' | 'logos' | 'org' | 'schema', path: string)

Příklad použití:

  //Before - v5.7
  <PrintFooter logoURL="/assets/logos/logo_element_horizontal.png" />
  //After - v5.17
  <PrintFooter logoURL={getAsset('logos','logo_element_horizontal.png')} />

//Before - v5.7
 <img alt="someImg" src="/assets/logos/logo_element_horizontal.png" />
//After - v5.17
<img alt="someImg" src={getAsset('logos','logo_element_horizontal.png')} />

V případě, že máte v dynamické tabulce odkaz přímo na soubor https://yourplatform.com/assets/logos/image.png pak je potřeba buď udělat update všech proměnných nebo si ošetřit aby se do funkce vkládal pouze název soborů a případná složka, pokud není např. přímo v logos.
//Before - v5.7
 <img id="top-logo" src={getVar('_logo')} alt="Logo" />
//After - v5.17
<img id="top-logo" src={getAsset('logos',getVar('_logo'))} alt="Logo" />

Staré (HTML) tisky — funkce getAsset() není dostupná. Zadejte přímo novou URL služby pro stažení assetu:

//V případě, že logo je uloženo přímo v logos (není ve složce)
<img alt="someImg" src="https://<backendUrl>/api/assets/download?root=logos&path=workflow.png" />

//Pokud je logo zanořené ve složce, je potřeba zadat cestu
<img alt="someImg" src="https://<backendUrl>/api/assets/download?root=logos&path=folder/workflow.png" />

Ukončení podpory EWS cronu v TAS 5.17

Od verze TAS 5.17 již není podporován cron pro vytěžování e-mailových schránek přes EWS (Exchange Web Services) — EwsCreateProcessesFromMailCron. Důvodem je ukončování podpory EWS ze strany Microsoftu. Náhradou je cron přes MS Graph — MsGraphCreateProcessesFromMailCron.

Před zahájením upgradu na 5.17 si zálohujte konfiguraci EWS cronu a nastavte cron jako neaktivní. Po upgradu nakonfigurujte vytěžování e-mailů přes MsGraphCreateProcessesFromMailCron. Z původní EWS konfigurace převezmete logiku složek; přihašovací údaje a ID složek je ale nutné získat znovu přes MS Graph (původní EWS folderId nejsou s MS Graph kompatibilní).

Postup před upgradem

  1. V administraci otevřete cron EwsCreateProcessesFromMailCron.
  2. Zkopírujte si celou JSON konfiguraci cronu do bezpečného souboru mimo TAS. Tuto zálohu budete potřebovat pro nastavení nového MS Graph cronu.
  3. Nastavte EWS cron jako neaktivní - pokud bude aktivní, upgrade se nepodaří.
  4. Teprve poté spusťte upgrade na verzi 5.17.

Dynamické podmínky - changeVarVal u dynamické tabulky

V případě, že se do dynamické tabulky vkládá v rámci changeVarVal hodnota [null] (toto se používá hlavně v šabloně faktur) tak tento zápis již není validní neprojde validace na BE, je potřeba upravit na prázdné pole [].

Úprava formátování v CaseVariablesTab

V komponentě CaseVariablesTab je potřeba upravit způsob zápisu Grid items. Původní zápis používal samostatné props (xs, sm, md, lg, xl), nový zápis je potřeba sloučit do jediného prop size s objektem hodnot.

Původní zápis:

<Grid item xs={row[index+1] === '' ? 12: (maxLength >= 4 ? 6 : 12)} sm={3} md={row[index+1] === '' ? (maxLength >= 4 ? 6 : 8) : (maxLength >= 4 ? 3 : 6)} lg={row[index+1] === '' ? (12/maxLength)*2 : 12/maxLength} xl={row[index+1] === '' ? (12/maxLength)*2 : 12/maxLength} key={index}>

Nový zápis:

<Grid
  item
  size={{
    xs: row[index + 1] === '' ? 12 : (maxLength >= 4 ? 6 : 12),
    sm: 3,
    md: row[index + 1] === '' ? (maxLength >= 4 ? 6 : 12) : (maxLength >= 4 ? 3 : 6),
    lg: row[index + 1] === '' ? (12 / maxLength) * 2 : 12 / maxLength,
    xl: row[index + 1] === '' ? (12 / maxLength) * 2 : 12 / maxLength,
  }}
>
Tato změna je součástí aktualizace MUI Grid komponent, kde byly breakpoint props nahrazeny jednotným prop size. Bez této úpravy dochází k nesprávnému formátování buněk — data jsou natěsnána u sebe.

Hesla lokálních účtů (přechod ze starší verze než 4.15)

Tato sekce se týká pouze prostředí přecházejících z verze nižší než 4.15.

Pokud prostředí běželo na verzi nižší než 4.3 a zároveň užívá lokální hesla, pak je nutné aby se každý uživatel alespoň jednou přihlásil ve verzích 4.3 až 5.7. Uživatelům, kteří se nepřihlásili ani jednou ve zmíněném intervalu verzí je nutné resetovat heslo.

Zrušení identUser v autentizačním modulu

V autentizačních modulech již není podporována funkce identUser. Místo ní se používá výhradně postAuthInstructions.

Podrobnosti konfigurace autentizačních modulů jsou popsány v článku Konfigurace autentizačních modulů.

Zrušení SharePoint API

SharePoint API bylo odstraněno z důvodu ukončení jeho podpory ze strany Microsoftu. Veškeré integrace se SharePointem je nutné přepracovat na MS Graph API. V případě potřeby je k dispozici vývojová podpora.

Zrušení SOAP konektoru v událostech

V rámci událostí byl odstraněn SOAP konektor. Veškeré napojení externích systémů lze realizovat prostřednictvím Axios API.

ISDOC jako plugin

Funkce ISDOC je nyní dostupná pouze jako plugin. Prostředí, která ISDOC využívají, musí mít příslušný plugin nainstalován.

Zrušení Cron.js — přechod na PostponedTaskCron

Původní Cron.js pro spouštění naplánovaných úkolů byl odstraněn. Nahrazuje ho PostponedTaskCron, který nabízí více možností konfigurace a lze ho klonovat.

PostponedTaskCron je dostupný již od verze 5.7. Podrobný popis nastavení naleznete v článku PostponedTaskCron — konfigurace.

Zrušení CleanPerfLogsCron - nahrazení CleanupCronem

CleanPerfLogsCron byl ve verzi 5.17 kompletně odstraněn. Jeho funkci nahradil CleanupCron.

Funkce getPdfFileAnnotations jako plugin

Funkce getPdfFileAnnotations byla přesunuta do pluginu. Pokud ji šablony využívají, musí mít prostředí příslušný plugin nainstalován.

Odstranění nepoužívaných databázových tabulek

Tato změna je čistě informativní a nevyžaduje žádný zásah ve standardních prostředích. Týká se pouze velmi starých prostředí, která vycházela z verze v2.

Byly odstraněny následující databázové tabulky:

Seznam odstraněných tabulek
ADDITINOAL_OBJECT_INFO
DMS_ACCESS_DIMENSIONS
DMS_ACCESS_RULE
DMS_ACCESS_SUBJECT
DMS_FILES
DMS_INDEX_QUEUE
DMS_WEBDAV_PATH
DYNAMIC_CONFIG
DYNAMIC_LIST
DYNAMIC_LIST_COLS
DYNAMIC_LIST_LIST
DYNAMIC_LIST_VALUES
GOOGLE_USERS
INSTANCE_TASK_CALCULATIONS
INSTANCE_TASK_VAR_PROC_MAP
ORGANIZATION_AUTH
PLAN_IPROC_LOG
SKILLS
SNAP_ORGSTR_REL
SSO
STAT_COLUMNS
STAT_PERIODS
STATS
TEMPLATE_PROCESS_VERSIONS
TEMPLATE_TASK_VAR_PROC_MAP
USER_CALENDAR
USER_CALENDAR_EVENTS
USER_PASS_HISTORY
USER_RIGHTS_DELEGATION
USER_SKILLS
USER_VICE_LOG
USER_VICE_ORG_RESTRICTIONS
W_USER_REL
INSTANCE_TASK_COMPLETION

Omezení dat v api/users

Od verze 5.17 byl rozsah dat vracených z endpointu /api/users výrazně omezen. Důvodem je omezení vystavování citlivých uživatelských atributů — včetně informací o počtu neúspěšných přihlášení, způsobu externího ověřování, interních identifikátorů i přímých odkazů na konkrétní uživatelské záznamy.

Response objekt před verzí 5.17

Původní response obsahoval následující strukturu:

{
  "user_full_name": "Test User1",
  "user_display_name": "Test User1",
  "user_name": "TESTUSER1",
  "user_first_name": "Test",
  "user_last_name": "User1",
  "user_status": "A",
  "user_email": null,
  "org_id": 1,
  "user_change_password": null,
  "user_password_last_change": "2025-06-13T18:42:26.000Z",
  "user_bad_login_count": 0,
  "user_title_prefix": null,
  "user_title_suffix": null,
  "user_external_login": null,
  "user_external_source": null,
  "user_comp": null,
  "user_comp_id": null,
  "user_comp_code": null,
  "login_count": 665,
  "external_id": null,
  "user_system": 0,
  "id": 14453,
  "meta": { "href": "/users/13423" }
}

Pole odebraná ve verzi 5.17

Z response objektu byla odstraněna následující pole:

  • user_change_password
  • user_password_last_change
  • user_bad_login_count
  • user_external_login
  • user_external_source
  • user_comp
  • user_comp_id
  • user_comp_code
  • login_count
  • external_id
  • id
  • meta.href — přímý odkaz na konkrétního uživatele

Od verze 5.17 již není možné vylistovat seznam všech uživatelů. Volání endpointu /api/users bez specifikace konkrétního záznamu vrátí chybu.

Ukončení podpory proměnné BIG/B

Jedná se o velmi staré instance, které tento typ používali.

Ve verzi 5.17 byla ukončena podpora typu proměnné BIG a jeho aliasu B.

Šablony, které tento typ proměnné stále používají, nemusí po upgradu fungovat správně. Před nasazením nové verze proto doporučujeme zkontrolovat existující šablony a upravit proměnné typu BIG/B na podporovaný typ.

Ve většině případů bude vhodné použít typ NUMBER pro číselné hodnoty nebo TEXT pro textové hodnoty.

Doporučená akce: Zkontrolujte šablony před upgradem a proveďte migraci proměnných BIG/B na odpovídající podporovaný typ.

Frantisek Brych Updated by Frantisek Brych

Migrace assetů z FE na backend (upgrade 5.17) — DevOps

Contact

Team assistant (opens in a new tab)

Powered by HelpDocs (opens in a new tab)