|
|
| (Není zobrazeno 205 mezilehlých verzí od stejného uživatele.) |
| Řádek 1: |
Řádek 1: |
| == Zaměstnanci v insolvenčním rejstříku ==
| |
| Popis práce se sestavou - viz zde [[Srážky#Insolvence]].
| |
|
| |
|
| == Aktualizace báze dat ==
| |
| Před prvním spuštěním je potřeba [[Rozšiřující parametry#Doplnění rozšiřujících parametrů|doplnit rozšiřující parametry]].
| |
|
| |
| Aktualizace báze dat se provádí prostřednictvím KS klienta, což je samostatný program, který pracuje jako klient webové služby ISIR.
| |
| Tohoto klienta lze spouštět buď přímým spuštěním s danými parametry nebo prostřednictvím windows služby či spouštěče úloh.
| |
|
| |
| Databáze insolvenčního rejstříku ISIR obsahuje velké množství záznamu (ke dni 25.4.2012, cca 7.000.000 záznamů), které je potřeba zpracovat a vytvořit odpovídající bázi dat v databázi KS mzdy PROFi. Proto bude při prvním spuštění klienta zpracována kompletní databáze ISIR a po jejím zpracování bude klient při dalším spuštění zpracovávat pouze změny v databázi ISIR.
| |
|
| |
| Pro spouštění klienta doporučujeme využít dodanou windows službu (viz níže).
| |
|
| |
| == KS klient ==
| |
| KS klient je tvořen dvěma programy:
| |
| * Program pro aktualizaci báze dat (KSPortalServiceCommand)
| |
| * Windows služba (KSPortalService)
| |
|
| |
| === Program pro aktualizaci báze dat (KSPortalServiceCommand) ===
| |
| Jedná se o hlavní program KS klienta, který pro svou činnost vyžaduje zadání parametrů při spuštění. Tyto parametry určují jeho funkcionalitu. Funkcionalita programu na základě parametrů: /zInsolvence /cwebservice. Dvojice parametrů, při nichž dojde k naplnění báze dat z Insolvenčního rejstříku.
| |
|
| |
| <small>Příklad: KSPortalServiceCommand.exe /zInsolvence /cwebservice </small>
| |
|
| |
| === Windows služba (KSPortalService) ===
| |
| Jedná se o windows službu, která dle nastaveného intervalu (viz. konfigurační soubory) provádí řízené spouštění programu KSPortalServiceCommand.
| |
| ==== Instalace ====
| |
| Instalace windows služby se provádí utilitou ''InstallUtil.exe'', která je součástí NET Frameworku. Parametrem je cesta k instalačnímu souboru. Při instalaci se definuje účet pod kterým služba poběží.
| |
|
| |
| <small>Příklad: C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe C:\<cesta>\ksportalservice.exe </small>
| |
|
| |
| Po jejím správném nainstalování a spuštění ve správci služeb (Nástroje pro správu / Služby) provádí automatické pouštění programu KSPortalServiceCommand. KSPortalServiceCommand je automaticky spouštěn s patřičnými parametry, kdy dochází k automatickému odesílání změn v databázi KSmzdyPROFi do OKbase a to prostřednictvím webových služeb.
| |
|
| |
| ==== Odinstalace ====
| |
| Odinstalace se provádí utilitou ''InstallUtil.exe'' spuštěné s parametry. Prvním parametrem je /u a druhým cesta k instalačnímu souboru.
| |
|
| |
| <small>Příklad: C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe /u C:\<cesta>\ksportalservice.exe </small>
| |
|
| |
| === Konfigurační soubory ===
| |
| Součástí programů jsou konfigurační soubory KSPortalService.exe.config a KSPortalServiceCommand.exe.config. Musí být nakonfigurovány oba soubory a to stejně.
| |
| V těchto souborech je potřeba nakonfigurovat tyto sekce:
| |
| : Cestu k logovacímu souboru
| |
| : Databázové připojení
| |
| : Interval spouštění klienta windows službou (v příkladu je nastavena hodnota 10min (600000ms), což může být pro začátek ponecháno)
| |
|
| |
| <appSettings>
| |
| <!--Interval (v tisícinách sekundy) ve kterém windows služba spouští klienta webové služby-->
| |
| <add key="interval" value="600000"/>
| |
| <!--Název windows služby-->
| |
| <add key="ServiceName" value="KSPortalService_Insolvence"/>
| |
| <!—Cesta k logovacímu souboru-->
| |
| <add key="LogPath" value="d:\Test\"/>
| |
| </appSettings>
| |
|
| |
| <connectionStrings>
| |
| <!--Databázové připojení (atribut name="mzdy" musí zůstat zachován).-->
| |
| <add name="mzdy" connectionString="server=absint_pc;database=web_mzdy;uid=test;pwd=test"
| |
| providerName="System.Data.SqlClient"/>
| |
| </connectionStrings>
| |
|
| |
| V sekci <system.serviceModel> lze konfigurovat připojení k webové službě.
| |
|
| |
| ==== Nastavení DB připojení ====
| |
| Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze.
| |
|
| |
| Databázové připojení v KS klientovi definuje ConnectionString, který se nachází v sekci <connectionStrings> v souboru KSPortalServiceCommand.exe.config.
| |
|
| |
| Příklady ConnectionStringu: <br>
| |
| '''Pro MSSQL''' <br>
| |
| <add name="web_mzdy" connectionString="server=web_pc;database=mzdy;uid=test;pwd=test"
| |
| providerName="System.Data.SqlClient"/>
| |
|
| |
| '''Pro ODBC''' <br>
| |
| <add name="web_mzdy" connectionString="DSN=i_mzdy" providerName="System.Data.Odbc"/>
| |
|
| |
| '''Položky DB připojení''' <br>
| |
| * name - jméno DB připojení
| |
| * server - název nebo IP adresa počítače, na kterém běží DB server
| |
| * database - název databáze, ke které bude chtít být připojeni
| |
| * uid - login pro přístup do databáze
| |
| * pwd - heslo pro přístup do databáze
| |
|
| |
| == Logovací soubory ==
| |
| Pokud je KS klient spouštěn prostřednictvím windows služby a během jeho činnosti vzniknou chybové události, jsou informace o těchto událostech dostupné v prohlížeči událostí (Nástroje pro zprávu – Prohlížeč událostí) nebo v logovacím souboru Insolvence_log.xml.
| |
| Soubor Insolvence_log.xml je dostupný v umístění dle konfiguračního souboru (např. <add key="LogPath" value="d:\Test\"/>)
| |
|
| |
| <!-- Vypracoval:
| |
| Ing. Milan Žamboch
| |
| Programátor
| |
| KS - program, spol. s r.o.
| |
| Rokytnice 153
| |
| 755 01 Vsetín
| |
| tel: 571 499 474
| |
| milan .zamboch@ksprogram.cz
| |
| -->
| |
