Pom4: Porovnání verzí

Z Prirucky
Řádek 1: Řádek 1:
Popis práce se sestavou
== Zaměstnanci v insolvenčním rejstříku ==
Zaměstnanci v insolvenčním rejstříku (MP 016)
Popis práce se sestavou - viz zde [[Srážky#Insolvence]].
== Popis sestavy ==
 
Sestava zobrazuje seznam zaměstnanců, kteří jsou vedeni jako dlužníci v databázi informačního systému veřejné
správy - Insolvenční rejstřík (ISIR). Podkladem pro vytvoření sestavy jsou data uložena v databázi aplikace KS mzdy.
Pro správné zobrazení dat v sestavě je potřeba zajistit jejich průběžnou aktualizaci. Aktualizace báze dat je popsána
níže v kap. 2.
Umístění sestavy MP 016 v menu:
– Sestavy / Mzdové sestavy / Srážky; záložka: Insolvence
Sestava MP 016 obsahuje tyto údaje:
– Kmenové středisko
– Osobní číslo
– Zaměstnanec
– Rodné číslo
– Datum poslední změny
– Informace o aktuálnosti dat


== Aktualizace báze dat ==
== Aktualizace báze dat ==
Řádek 25: Řádek 10:
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.
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 (kap. 3.2).
Pro spouštění klienta doporučujeme využít dodanou windows službu (viz níže).


== KS klient ==
== KS klient ==
Řádek 35: Řádek 20:
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.
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:
<small>Příklad: KSPortalServiceCommand.exe /zInsolvence /cwebservice </small>
KSPortalServiceCommand.exe /zInsolvence /cwebservice


=== Windows služba (KSPortalService) ===
=== Windows služba (KSPortalService) ===
Řádek 43: Řádek 27:
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ěží.
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
<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.
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.
Řádek 50: Řádek 34:
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.
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
<small>Příklad: C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe /u C:\<cesta>\ksportalservice.exe </small>


=== Konfigurační soubory ===
=== Konfigurační soubory ===
Řádek 59: Řádek 43:
: 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)
: 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>
<appSettings>
<!--Interval (v tisícinách sekundy) ve kterém windows služba spouští klienta webové služby-->
  <!--Interval (v tisícinách sekundy) ve kterém windows služba spouští klienta webové služby-->  
<add key="interval" value="600000"/>
  <add key="interval" value="600000"/>
<!--Název windows služby-->
  <!--Název windows služby-->
<add key="ServiceName" value="KSPortalService_Insolvence"/>
  <add key="ServiceName" value="KSPortalService_Insolvence"/>
<!—Cesta k logovacímu souboru-->
  <!—Cesta k logovacímu souboru-->
<add key="LogPath" value="d:\Test\"/>
  <add key="LogPath" value="d:\Test\"/>
</appSettings>
</appSettings>
<connectionStrings>
 
<!--Databázové připojení (atribut name="mzdy" musí zůstat zachován).-->
<connectionStrings>
<add name="mzdy" connectionString="server=absint_pc;database=web_mzdy;uid=test;pwd=test"
  <!--Databázové připojení (atribut name="mzdy" musí zůstat zachován).-->
providerName="System.Data.SqlClient"/>
  <add name="mzdy" connectionString="server=absint_pc;database=web_mzdy;uid=test;pwd=test"
</connectionStrings>
  providerName="System.Data.SqlClient"/>
</connectionStrings>


V sekci <system.serviceModel> lze konfigurovat připojení k webové službě.
V sekci <system.serviceModel> lze konfigurovat připojení k webové službě.
Řádek 80: Řádek 65:
Databázové připojení v KS klientovi definuje ConnectionString, který se nachází v sekci <connectionStrings> v souboru KSPortalServiceCommand.exe.config.
Databázové připojení v KS klientovi definuje ConnectionString, který se nachází v sekci <connectionStrings> v souboru KSPortalServiceCommand.exe.config.


Příklady ConnectionStringu:
Příklady ConnectionStringu: <br>
'''Pro MSSQL''' <br>
'''Pro MSSQL''' <br>
<add name="web_mzdy" connectionString="server=web_pc;database=mzdy;uid=test;pwd=test"
<add name="web_mzdy" connectionString="server=web_pc;database=mzdy;uid=test;pwd=test"

Verze z 11. 7. 2013, 12:46

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


Citováno z „http://prirucky.ksprogram.cz/index.php?title=Pom4&oldid=13998“