Instalační sady - obecně

V tomto oddíle popíšeme proces expertního importu instalační sady. Kroky, které se používají jen při instalaci nové verze, jsou označeny instalace, kroky, které se používají jen pro aktualizaci jsou označeny aktualizace. Scénář může spustit pouze uživatel s právem Expertní import. Proces importu probíhá následovně

1. Systém provede kontrolu, zda požadovaná verze systému ABRA Gen v instalační sadě odpovídá verzi instalovaného systému ABRA Gen nebo je instalovaná verze vyšší.
2. Systém se podle názvu instalační sady zjistí, zda se jedná o novou instalaci nebo o aktualizaci (tj. jestli v systému již neexistuje instalační sada téhož jména. Pokud ano, bude instalaci považovat za aktualizaci této sady).
3. Aktualizace: Systém porovná verzi existující sady s verzí importované sady.
4. Zobrazí se uvítací zpráva, popisující k čemu instalační sada slouží, licenční ujednání a další informace. Také zobrazí informaci, zda se jedná o aktualizaci nebo novou instalaci.
5. Supervisor nebo konzultant potvrdí zprávu.
6. Systém provede činnost Aktualizace/založení záznamu instalační sady.
7. Systém připraví množinu položek, které jsou shodné v nové verzi sady s již instalovaným objektem. Provádí se tak, že se porovná XML položek v nové verzi sady s XML, které se vygeneruje z instalovaných objektů. Tyto položky nemá smysl instalovat, protože v systému již existují.
8. Aktualizace: Pro každou položku zjistí, zda je položka v nové verzi sady aktualizována. Provádí se tak, že se porovná XML položek v nové verzi sady s XML položkami již nainstalované sady. Položky, které vůbec nejsou ve staré verzi původní sady se považují jako aktualizované.

9. Aktualizace: Pro každou položku nové verze sady provede Test uživatelské změny položky a výsledek si zaznamená. Systém zobrazí položky importované sady v následujícím seznamu. Pokud se jedná o aktualizaci, pak zobrazí jen aktualizované položky (změněné od poslední verze).

   • Kategorii (např. Reklamace)
   • Typ položky (např. Balíček skriptů, Uživatelsky definovatelné položky atd...)
   • Identifikace položky v uživatelské podobě (zajistí činnost Překlad identifikace položky)
   • Zařazení položky (zajistí činnost Překlad identifikace položky)
   • Stav - může nabývat několika hodnot, jejich popis viz dále Stav položky v Průvodci importem instalační sady.
   • Instalovat položku (označené položky budou instalovány, neoznačené pouze importovány)
   • Komentář importu (umožňuje uživateli zapsat důvod, proč instaluje nebo neinstaluje tuto položku)
10. Pro položky se stavem 2 a 3 uživatel může provést činnost Zobrazení verzí položky.
11. Uživatel může ručně odznačovat nebo označovat jednotlivé položky nebo hromadně všechny položky. K položkám může zapisovat komentář importu, do kterého zapíše, proč položku neinstaloval.
12. Systém se dotáže, zda si uživatel přeje vytvořit zálohu instalovaných objektů do záložní instalační sady. Pokud uživatel bude souhlasit, provede se činnost Zálohování instalovaných objektů.
13. Systém projde seznam označených položek a provede Instalace položky. Pořadí, v jakém bude instalovat položky instalační sady je uvedeno v tabulce Typy položek instalační sady, tučně označená čísla ve sloupci „Závislost“. Instalace: Systém spustí proceduru Install z knihovny Install z balíčku, jehož název je v položce typu Instalační balíček.
14. Aktualizace: Systém spustí spustí proceduru Update z téže knihovny. Jako parametr předá starou verzi instalační sady, která je instalována.
15. Pro všechny položky, které nejsou v nové verzi instalační sady, ale existují ve staré verzi instalované sady a byly v ní instalovány se provede činnost Odinstalace položek.
16. Systém provede činnost Zobrazení závěrečné zprávy.

Případné výjimky:

• Pokud se v kroku 1 zjistí, že instalovaná verze systému ABRA Gen je nižší než je požadováno, pak se instalace ukončí.
• Pokud se v kroku 2 zjistí, že se sada jmenuje „Záloha před instalací sady {jméno sady}“ pak se v seznamu sad pokusí dohledat sadu s daným názvem. Zobrazí uživateli dotaz, zda se jedná o vrácení změn provedených nad sadou "{jméno sady}". Pokud uživatel odpoví kladně, pak se k záložní sadě přistupuje jako k aktualizaci. Tedy dojde také k odinstalaci těch položek, které jsou v nalezené sadě (té původní) „navíc“ (oproti záloze). Jestliže se nepodaří sadu dohledat nebo uživatel odpoví na dotaz záporně, pak se k této sadě přistupuje jakoby se jednalo o instalaci nové sady.
• Pokud importovaná sada nepodporuje verze, pak se krok 3 neprovádí.
• Pokud se v kroku 2 zjistí, že verze importované sady je stejná nebo nižší než ta existující v systému, pak zobrazí varovnou zprávu, zda si uživatel přeje pokračovat.
• Pokud se v kroku 10. pro některou položku vyhodnotí, že má stav č. 6 – položka již existuje s jinou strukturou a nelze upravit, pak instalace končí.
• Pokud v krocích 15 dojde k chybě, pak zpracování bude pokračovat dále. Chybová zpráva se uloží, aby se mohla zobrazit v závěrečné zprávě.
• Pokud konzultant označí všechny položky jako neinstalovat, import sady skončí před zadáním parametrů instalace. Záznam s instalační sadou bude založen do systému nebo bude aktualizován záznam se starou verzí instalační sady.

V tomto oddíle popíšeme proces zjednodušeného importu instalační sady. Kroky, které se používají jen při instalaci nové verze, jsou označeny instalace, kroky, které se používají jen pro aktualizaci jsou označeny aktualizace.

1. Systém provede kontrolu, zda požadovaná verze systému ABRA Gen v instalační sadě odpovídá verzi instalovaného systému ABRA Gen nebo je instalovaná verze vyšší.
2. Systém se pokusí zjistit, zda se jedná o novou instalaci nebo o aktualizaci. Zjistí to podle toho, zda v systému je již instalována sada se stejným jménem.
3. Aktualizace: Systém porovná verzi existující sady s verzí importované sady.
4. Zobrazí se uvítací zpráva, popisující k čemu instalační sada slouží, licenční ujednání a další informace. Také zobrazí informaci, zda se jedná o aktualizaci nebo novou instalaci.
5. Supervisor nebo konzultant potvrdí zprávu.
6. Systém provede činnost Aktualizace/založení záznamu instalační sady.
7. Systém připraví množinu položek, které jsou shodné v nové verzi sady s již instalovaným objektem. Provádí se tak, že se porovná XML položek v nové verzi sady s XML, které se vygeneruje z instalovaných objektů. Tyto položky nemá smysl instalovat, protože v systému již existují.
8. Aktualizace: Pro každou položku zjistí, zda je položka v nové verzi sady aktualizována. Provádí se tak, že se porovná XML položek v nové verzi sady s XML položkami již nainstalované sady. Položky, které vůbec nejsou ve staré verzi původní sady se považují jako aktualizované.
9. Aktualizace: Pro každou položku nové verze sady provede Test uživatelské změny položky.
10. Systém zkontroluje, zda někdo založil položku, kterou se instalační sada chystá založit. Nerozlišuje se, zda se tato položka podstatně liší a technicky není možné provést přepsání. Např. Uživatelsky definovatelná položka má jiný datový typ než je požadováno.
11. Tento krok je ve zjednodušené verzi importu přeskočen.
12. Tento krok je ve zjednodušené verzi importu přeskočen.
13. Tento krok je ve zjednodušené verzi importu přeskočen.
14. Systém se dotáže, zda si uživatel přeje vytvořit zálohu instalovaných objektů do záložní instalační sady. Pokud uživatel bude souhlasit, provede se činnost Zálohování instalovaných objektů.
15. Pro všechny položky kromě těch určených z kroku 7, systém provede činnost Instalace položky.
16. Instalace: Systém spustí proceduru Install z knihovny Install z balíčku, jehož název je v položce typu Instalační balíček.
17. Aktualizace: Systém spustí spustí proceduru Update z téže knihovny. Jako parametr předá starou verzi instalační sady, která je instalována.
18. Pro všechny položky, které nejsou v nové verzi instalační sady, ale existují ve staré verzi instalované sady a byly v ní instalovány se provede činnost Odinstalace položek.
19. Systém provede činnost Zobrazení závěrečné zprávy.

Případné výjimky:

• Pokud se v kroku 1 zjistí, že instalovaná verze systému ABRA Gen je nižší než je požadováno, pak se instalace ukončí.
• Pokud importovaná sada nepodporuje verze, pak se krok 3 neprovádí.
• Pokud se v kroku 3 zjistí, že verze importované sady je stejná nebo nižší než ta existující v systému, pak se import ukončí.
• Pokud se v kroku 9 najde uživatelem modifikovaná položka, pak instalace končí.
• Pokud se v kroku 10 najde konfliktní položka, pak instalace končí.

Objekty, které byly součástí importované instalační sady a byly vybrány mezi položky určené k instalaci (viz položka Vybrat v průvodci importem instalační sady) se po dokončení tohoto průvodce na importní straně nainstalují (vytvoří).

Zde platí:

• Variantní vstupní formuláře - na importní straně se případné již existující variantní formuláře v daném umístnění (agenda + panel) nijak nemažou ani nepřepisují. Importované se vždy přidají jako nové. Proto, pokud importujete stejnou sadu opakovaně (např.  novou verzi) a v daném umístnění již nějaké variantní formuláře existují, je doporučeno nejdříve původní variantní formuláře vymazat. To můžete pohodlně provést např. v agendě Variantní formuláře.

  V dané umístění můžete mít samozřejmě i nějakou variantu var. vstupního formuláře, která s importovanou sadou nijak nesouvisí. Takovou samozřejmě nijak mazat nemusíte. Nicméně i tak po importu doporučujeme stav variantních formulářů po importu sad zkontrolovat (minimálně jejich pořadí, názvy apod.) - aby např. nedošlo ke zbytečným duplicitám názvů, či k nechtěným změnám v pořadí a tudíž i v automatickém výběru variant apod.

  Do v. 14.52 vč. platilo, že se na importní straně var. formulář přepsal, pokud byl identifikován jako ten, co byl naimportován sadou. To však bylo v řadě případů nežádoucí (uživatel mohl nechtěně přijít o změny, které v daných formulářích provedl).

Zde ostatní objekty platí: Pokud už na importní straně byly objekty nainstalovány a nedošlo k žádné jejich změně, znovu se k importu nenabízejí. Tj. při opakovaném importu instalační sady se tyto již nenabízejí v průvodci importem instalační sady (pokud se nejedná o novou verzi).