Uživatelský manuál
Stručný průvodce
Dashboard
Přehledy
Detail případu (Caseoverview)
Případ - Událost
Úkoly
Poznámky případu
Dokumenty
Nastavení uživatele
Oblíbené
Komponenta tabulky
FAQ
Novinky/Oznámení v Team assistant
Nastavení mobilní aplikace
Admin dokumentace
Platforma
Administrace
Crony
Autentizace a synchronizace
Nastavení mobilní aplikace pro vaše prostředí
Schéma
Dynamické tabulky
Archivace
Skripty
Licence
Servisní konzole
Naplánované úkoly
HR Agenda
Sekvence
CSP hlavičky - zásady zabezpečení obsahu
Logy
Správa novinek (Notifikační centrum)
Nastavení přístupového tokenu a vypršení platnosti relace
Šablona
Role
Self-hosted administration
Plánování
Uživatelé
Organizační struktura
Události
Překlady
NFC integrace
AXIOS API
AXIOS s využitím Trezoru
Axios s využitím certifikátů (SSL)
Výpočty a funkce
Integrace
TAS Forms
Pokročilé funkce a tipy
Filtrování v dynamickém listu pomocí URL parametru (statické)
Optimalizace přehledů s velkým počtem případů
AI Features
Produkt
Technický changelog
Business Changelog
Průvodce upgradem z předchozích verzí
Upgrade na 5.17
Upgrade na 5.7
Lodash upgrade v4.17.x (>v5.5)
Hlavní změny a zaniklé funkce (v5.3 > v5.7)
Podbarvení proměnných ve stavu Read-only (>v5.7.58)
Použití validačních funkcí
Upgrade na 5.3
Migrace dynamických podmínek
Úprava a kontrola tisku pdf
Úprava Popis úkolu vs Instrukce k úkolu
Transpilace forEach na for loop
Vykreslení HTML na Caseoverview
Rozdíly mezi TAS4 a TAS5 - kompletní přehled
Best Practices upgrade z TAS 4 na TAS 5
Technické požadavky a architektura
Status routes
Prerekvizity serveru
Bezpečnost a ochrana dat
Security
TAS Operations Runbook
Technologická architektura
Graceful Shutdown + Status Routes
Aktuality / Důležité informace
Getting Started
- Vše /
- Produkt
- Průvodce upgradem z předchozích verzí /
- Best Practices upgrade z TAS 4 na TAS 5
Best Practices upgrade z TAS 4 na TAS 5
Upgrade z TAS 4 na TAS 5 je velký proces, který vyžaduje pečlivou přípravu, komunikaci s klientem vč. jeho participace, testování a technické úpravy. Níže jsou uvedeny klíčové osvědčené postupy pro hladký průběh migrace.
Pracnost a příprava
- Klíčový první krok je kompletní srovnání testu dle produkce nebo vytvoření pre-prod prostředí, aby se testovalo nad reálnými šablonami, a nemíchaly se chyby z upgradu s chybami z historie testovacího prostředí.
- Důkladná příprava je zásadní – Je nutné aktivně komunikovat s klientem a včas představit nový TAS po designové stránce, zejména rozložení atributů na formulářích, vizuál detailů případů pro sladění očekávání. Změny na formulářích úkolů nebo detailech případů doporučujeme vzhledem k rozdílnému UI a UX verze 4 a 5.
- Testování se všemi stakeholdery – Vzhledem ke změně interface, se kterými pracují uživatelé, je doporučeno provést testování s maximem stakeholderů a uživatelů, aby nové GUI neviděli poprvé na produkci.
- Zapojení klienta – Klient musí jasně definovat, co potřebuje zobrazovat a jaké úpravy jsou pro něj klíčové.
- Pokud je součástí upgradu přechod do dockerizovaného řešení, je dobré nejdříve udělat přechod do dockerizace, a až po ověření funkčnosti provést upgrade. Pomůže to oddělit problémy se změnou infrastruktury od problémů z upgradu.
Klíčové oblasti vyžadující zásadní úpravy
Proměnné ve formulářích
- Přiřazení proměnných je nutné přepracovat do strukturovaných sekcí kvůli novým pravidlům designu.
- Nové rozložení proměnných vyžaduje strukturovanou úpravu, nelze jednoduše použít stávající nastavení.
- Pro přenos nastavení přiřazení proměnných z testovacího prostředí do produkčního je možnost použít funkce Export/Import přiřazení proměnných.
Přehled případu (CO)
- Pokud má být použit nový design, je nutné celý CO přepsat pomocí React komponent. Původní HTML zápis zůstává zpětně kompatibilní a lze jej zachovat.
- Je potřeba přehodnotit způsob, jakým jsou data strukturována a zobrazována.
Dynamické podmínky a WatchVars
- Nutné využití WatchVars – V TAS 5 se dynamické podmínky vyhodnocují odlišně kvůli optimalizaci rychlosti načítání.
- To, co v TAS 4 fungovalo rychle bez WatchVars, nyní vyžaduje explicitní WatchVars, aby se předešlo problémům s výkonem.
Příklad: Opakované vyhodnocování varReadOn může výrazně zpomalit práci ve formulářích.
Dynamické řádky
- Kontrola a optimalizace chování je klíčová, zejména u
runCondOnChange. - Nutné využití WatchVars – V TAS 5 se dynamické řádky vyhodnocují odlišně kvůli optimalizaci rychlosti načítání.
- Přidání posuvníků – Při větším objemu dat je nezbytné umožnit pohodlné procházení obsahu.
- V TAS4 se dynamické řádky vyhodnocovaly prakticky stejně, jako když v TAS5 mají
runAfterConds: Trueparametr (je tedy dobré ho defaultně přidat do všech dynamických řádků).
Integrace přes curl
- Je potřeba přetestovat integrace přes curl, individuálně i souběžně. V případě ssl chyb je třeba místo curl nově použít Axios (viz Axios).
- V případě přechodu na Axios je nezbytné kompletně přepracovat error handling.
Odezvy přehledů při větším množství dat
- TAS 5 jinak optimalizuje přehledy a práci s daty obecně, takže je velmi užitečné na testu vytvořit data, aby zhruba odpovídala produkci, a na případné performance bottle necky se přišlo před go-live.
Klíčové úpravy
Globální skripty
- Pozor na duplicitní globální skripty (např. funkce
commafyse může objevit vícekrát). - TAS 5 kombinuje React a tradiční skripty, což může vést k nečekaným chybám.
Jazykové mutace
- Je potřeba ověřit dostupnost jazykových mutací – některé jazyky nemusí být v nových React skriptech plně podporovány - je potřeba konzultantsky dodělat pokud chybí nějaký jazyk.
Odhalené skryté problémy
- Uživatelé věnují systému větší pozornost, což může odhalit starší skryté problémy.
- TAS 5 je přísnější – Některé věci, které v TAS 4 fungovaly, nemusí projít kontrolami v nové verzi. Pozor na potřebu změn v lodash funkcích ve výpočtech (viz Lodash upgrade).
Vylepšení a doporučení
Konzistence designu
- Nový design CO je dobře přijat, ale je důležité sladit jeho vizuální podobu i s úkoly.
- Klienti často požadují, aby rozložení úkolů odpovídalo CO.
Zapojení klienta
- Klienti sami neodhalí všechny problémy – je nutné je aktivně vést k definování požadavků.
- CO nejlépe vypadá se čtyřmi sloupci.
Přístup k redesignu
- Nelze kopírovat design TAS 4 – Je nutné akceptovat změny a přizpůsobit se novému konceptu.
- Zapojení klienta od začátku zajistí sladění očekávání.
- Doporučuje se nejdříve připravit koncept konzultantem a následně jej konzultovat s klientem.
Očekávání klientů
- Klienti předpokládají, že upgrade proběhne automaticky bez jejich zásahu.
- Je nutné je upozornit, že musí aktivně rozhodovat o novém nastavení.
Řízení vnímání problémů
- Je důležité správně komunikovat změny – problémy, které by se vyskytly i v TAS 4, nesmí být chybně považovány za důsledek upgradu.
- Některé problémy, jako např. změny organizační struktury, mohou být nesprávně spojovány s přechodem na TAS 5.
- Důležité je řízení očekávání klientů, aby se předešlo nedorozuměním. Klienti často nevědí co od upgrade očekávat.
Závěrečné doporučení
✅ Důkladná příprava a komunikace jsou klíčem k úspěšné migraci.
✅ Dodržování technické dokumentace k upgradu pomáhá předejít problémům.
✅ Předem počítat s nutností redesignu, zejména v oblasti proměnných, CO a dynamických podmínek.
✅ Klienti musí být od začátku informováni o změnách a jejich dopadech.
Při dodržení těchto doporučení lze minimalizovat problémy, optimalizovat výkon a zajistit hladký přechod na TAS 5.
Updated
by Frantisek Brych