Pom15

Insolvence - aktualizace dat - informace o zaměstnancích v insolvenčním řízení v aplikaci KS mzdy. Jedná se o doplňkový modul aplikace zpřístupněný na vyžádaní (objednávka).

Popis řešení

Zde je popsáno řešení automatického zjišťování insolvenčních dlužníků v aplikaci. Informace o těchto dlužnících jsou uloženy v databázi informačního systému veřejné správy - Insolvenční rejstřík (ISIR). Pro účely automatického zjišťování insolvenčních dlužníků je na straně ISIR k dispozici webová služba ISIR_CUZK_WS, která umožňuje on-line dotazování na řízení vedená v insolvenčním rejstříku za pomoci identifikačních údajů dlužníka. Tato on-line webová služba poskytuje pouze stručné informace o insolvenčních řízeních vedených s osobami na území ČR. Jejím účelem je poskytnutí informace, zda je na danou osobu (fyzickou či právnickou) vedeno insolvenční řízení a v jakém je stavu. Webová služba tedy neposkytuje podrobné informace o průběhu insolvenčního řízení a rovněž neposkytuje zveřejněné dokumenty. Webová služba čerpá data z vlastní databáze, která je v pravidelném intervalu 1 hodiny synchronizována s databází Insolvenčního rejstříku ISIR. Služba tak poskytuje stejné údaje jako webové rozhraní Insolvenčního rejstříku (https://isir.justice.cz), avšak s maximálním zpožděním 1 hodiny.

Aplikace KS mzdy přímo nekomunikuje s webovou službou ISIR_CUZK_WS. Důvodem je snaha o zajištění maximální dostupnosti informace o dlužnících. Ke komunikaci s webovou službou ISIR_CUZK_WS slouží KS klient, což je samostatný program, který zjištěné informace o dlužnících ukládá do databáze aplikace KS mzdy. Informace o vlastních zaměstnancích, kteří jsou vedeni jako dlužníci v insolvenčním řízení, jsou potom dostupné v sestavě Zaměstnanci v insolvenčním rejstříku (MP 016).

Zaměstnanci v insolvenčním rejstříku (sestava)

Popis práce se sestavou - viz zde Insolvence.

Aktualizace báze dat

Před prvním spuštěním je potřeba doplnit rozšiřující parametry. Skrytý rozšiřující parametr insr_last_id je totiž použit k uchování posledního zpracovaného záznamu z ISIR.

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

K činnosti klienta je vyžadováno běhové prostředí .NET Framework 4.

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

zpět