Aktualizace pomocí utility MaPSetup
Aktualizace pomocí utility MaPSetup je jeden z možných způsobů aktualizací aplikací Ks mzdy, KS portál a Aplikační server KS, ostatní způsoby aktualizace jsou popsány v následujících samostatných stránkách:
Umístění
Utilita MaPSetup je součástí aplikace KS mzdy a je tedy ve složce MaP. MaPSetup lze stáhnout i zde jako ZIP archív MaPSetup.zip, který rozbalte do libovolné složky.
Poslední změny
Ve verzi 10.0 byla pro volbu AS zrušena volba "jednoduchý režim" a "expertní režim", nyní je pouze jeden. V okně s výběrem akce, pro produkt AS, se volba "Instalace" změní na "Změna instalace (přidání/odebrání instance)" pokud je AS nainstalován. Tato volba otevírá okno pro konfiguraci seznamu instancí AS, okno vychází z původního okna "Expertní konfigurátor AS". Bylo zamezeno volit si u každé instance AS umístění mimo instalační složku, volba názvu podsložky zůstala. Ruční vložení a smazání řádku v seznamu instancí bylo zakázáno a nyní slouží k tomuto účelu tlačítka "Přidat instanci" a "Odebrat instanci". V prvním sloupci "Akce" je informace, zda bude provedena aktualizace/instalace či odebrání instance. Byl přidán sloupec "TCP Port" pro možnost změnit si předdefinovaný port webových služeb aplikačního serveru. Opraveno přehození připojovacích řetězců k databázi mezi jednotlivými instancemi po odebrání instance AS (která nebyla poslední instancí). Kompletní seznam změn ve verzi 10.0 je zde.
Funkcionalita
1. Spusťte aplikaci MaPSetup.exe.
Poznámka: Spouštějte aplikaci pod účtem s oprávněním Správce počítače (Windows: Účty - Správce), jinak nemusíte mít oprávnění měnit soubory aplikace. Pokud je toto splněno, objeví se po spuštění v titulku okna nápis [Administrátor].
2. V prvním okně vyberte produkt.
3. Další okna spouští samotnou aktualizaci (příp. slouží k nastavení konfigurace před aktualizací či provedení jiných akcí).
| Produkt | Okno č. 2 | Okno č. 3 |
| ||
| ||
|
| |
|
|
Pokud je již nainstalováno nejnovější sestavení aplikace, zobrazí se hláška: 
.
Instrukce a parametry MaPSetup
Pomocí instrukcí a parametrů lze dosáhnout cíleného spouštění, např. aktualizace konkrétního typu, do určitého adresáře, apod. Mohou být založeny například 3 ikony, každá pro aktualizaci samostatného produktu.
| Instrukce | Popis |
| /UPDATE | Provede akci aktualizace. Povinné. |
| /NOCHECK | Vypne kontrolu, zda-li je už nové sestavení (verze) nainstalováno a zaktualizuje. Nepovinné. |
| /REGISTER | Zaregistruje DLL knihovny do registru. Povinné, pokud nejsou registrované knihovny. Jinak nepovinné. |
| /CLOSE | Automaticky se zavře poslední okno po provedení aktualizace. Nepovinné. |
| /AUTO | Automaticky se stiskne tlačítko Další nebo Aktualizovat. Nepovinné. |
| /SILENT | Tichý režim bez GUI. Nepovinné |
| /NOLOG | Nebude logovat. Nepovinné |
| /FORCEVERSION | Vynutí specifickou verzi. |
| /SETPROXY | MaPSetup (Proxy) |
| /PROXY | MaPSetup (Proxy) |
| /SINGLE | Též pro odstranění hlášky, kdy MaPSetup je vyhodnocen jinými programy jako "vir". Pozor: nedochází ke stažení nové verze MaPSetup. |
| Parametr | Popis |
| /TYPE typ | Může nabývat jednu z těchto hodnot:
Povinný parametr. |
| /ICO identifikační číslo | Identifikační číslo IČ organizace (platné u typů TK, WK), pro níž je sestavení uvolněno. Pokud není uvedeno, zaktualizuje se na poslední standardní sestavení (uvolněné všem uživatelům). |
| /DLL složka | Zaregistruje DLL knihovny (COM komponenty knihoven KSOleModul.dll a KSNetBridge.dll) do registru s explicitním uvedením cesty (platné u typu TK). (Pokud je KS mzdy PROFi nainstalován na serveru a uživatelé jej spouštění vzdáleně, pak musela být na lokálním počítači uvedená cesta do serverového umístění KS mzdy PROFi. Pokud již DLL knihovny jsou zaregistrované, je opakované použití parametru zbytečné.) Registrace DLL již není nutná (díky main.exe.manifest), pokud však již byla provedena, může být toto potřeba, pokud hodnota v registru odkazuje na již neplatné umístění. Nepovinné. |
| /AKTUALIZOVAT_Z | Pro typ TK. Nepovinné. Aktualizuje soubory jak na lokálním počítači tak na vašem aktualizačním serveru. Platí pro případ, kdy se aplikace KS mzdy PROFi na lokálních stanicích aktualizují z umístění uvedeného v parametru AKTUALIZOVAT_Z (sk.13); v tom případě je parametr povinný, jinak si lokální stanice opět stáhne starou verzi z vašeho aktualizačního serveru. |
| /INSTANCE1 složka | Aktualizuje portál v umístění uvedeném za tímto parametrem (platné jen pro typ WK - pro něj povinné). |
| /INSTANCE2 složka | Aktualizuje portál v umístění uvedeném za tímto parametrem - pokud existuje i vedlejší instance (platné jen pro typ WK - pro něj povinné). |
- Na pořadí a velikosti písmen v instrukcích a parametrech nezáleží.
- Stejně tak nezáleží na sklonu lomítka.
- Pokud se povinné parametry či instrukce pro daný typ neuvedou, spustí se grafické rozhraní MaPSetup.
- V případě, že se v cestě u některého z parametrů (DLL, AKTUALIZOVAT_Z, INSTANCE1, INSTANCE2) vyskytuje mezera, uvozte tuto cestu uvozovkami " ".
Příklady
Aktualizace KS mzdy PROFi
MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK /AKTUALIZOVAT_Z "X:\KS Program\AktualizaceAplikace" MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK /NOCHECK
Aktualizace aplikace KS portál
MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal\Hlavni /INSTANCE2 D:\KSPortal\Test
Uvedené IČ je pouze ilustrativní.
Poznámky
Soubory pro aktualizaci (sbalené ve formě .ZIP) jsou získávány z webu [1]. Počítač toho, kdo provádí aktualizaci, tedy nesmí mít blokován přístup k této adrese antivirem či podnikovým firewalem.
Cesta pro aktualizaci aplikace KS mzdy PROFi je vyhledána automaticky z registrů Windows. HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft Windows/Current Version/APPPath/main.exe. Pokud je zde více klíčů, bere se v úvahu první, výchozí.
