Pom4

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 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.

Příklad: KSPortalServiceCommand.exe /zInsolvence /cwebservice

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ěží.

Příklad: C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe C:\<cesta>\ksportalservice.exe

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.

Příklad: C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe /u C:\<cesta>\ksportalservice.exe

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>
  <add key="interval" value="600000"/>
  <add key="ServiceName" value="KSPortalService_Insolvence"/>
  <!—Cesta k logovacímu souboru-->
  <add key="LogPath" value="d:\Test\"/>
</appSettings>

<connectionStrings>
  <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:
Pro MSSQL
<add name="web_mzdy" connectionString="server=web_pc;database=mzdy;uid=test;pwd=test" providerName="System.Data.SqlClient"/>

Pro ODBC
<add name="web_mzdy" connectionString="DSN=i_mzdy" providerName="System.Data.Odbc"/>

Položky DB připojení

• 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\"/>)