Pom15: Porovnání verzí

Z Prirucky
 
(Není zobrazeno 840 mezilehlých verzí od stejného uživatele.)
Řádek 1: Řádek 1:
''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).
== Číselníky ==
{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Souhrn údajů'''
|'''Čtení'''
|'''Zápis'''
|'''Význam'''
|-
| [[WebAPI Střediska|Strediska ]]
| Ano
| Ano
| Číselník středisek
|-
| [[WebAPI Skupiny středisek |SkupinyStredisek ]]
| Ano
| Ano
| Číselník skupiny středisek
|-
| [[WebAPI Divize|Divize ]]
| Ano
| Ano
| Číselník divizí
|-
|-
| [[WebAPI Pracovní místa|PracovniMista ]]
| Ano
| Ano
| Číselník pracovních míst
|-
| [[WebAPI CiselnikJazyku|CiselnikJazyku]] || || || Číselník jazyků
|-
| [[WebAPI CiselnikStupnuVzdelani|CiselnikStupnuVzdelani]] || || || Číselník stupňů vzdělání
|-
| [[WebAPI iTutor_Courses|iTutor_Courses]] || || ||
|}


== Popis řešení ==
== Zaměstnanci ==
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 
{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
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.
|- style="background-color: #eeeeee"
|'''Souhrn údajů'''
|'''Čtení'''
|'''Zápis'''
|'''Význam'''
|-
| [[WebAPI Kmenové údaje|KmenoveUdaje ]]
| Ano
| Ano
| Evidence zaměstnanců
|-
| [[WebAPI Vzdělání|Vzdelani ]]
| Ano
| Ano
| Dosažené vzdělání zaměstnanců
|-
| [[WebAPI Jazykové znalosti |JazykoveZnalosti ]]
| Ano
| Ano
| Jazykové znalosti zaměstnanců
|-
| [[WebAPI Rodinní příslušníci|RodinniPrislusnici ]]
| Ano
| Ano
| Rodinní příslušníci
|-
| [[WebAPI Rodinní příslušníci slevy|RodinniPrislusniciSlevy ]]
| Ano
| Ano
| Daňové zvýhodnění rodinných příslušníků
|-
|-
| [[WebAPI Kontakty|Kontakty]]
| Ano
| Ano
| Kontakty (telefonní čísla, emaily)
|-
| [[WebAPI Poznamky|Poznamky]] || || || Poznámky
|-
| [[WebAPI Platby |Platby ]]
| Ano
| Ano
| Platby zaměstanců


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).
|-
| [[WebAPI Pracovní povolení|PracovniPovoleni ]]
| Ano
| Ano
| Pracovní povolení cizinců
|-
| [[WebAPI Požadavky|Požadavky]] || ||  || [[Požadavky]]
|}


== Zaměstnanci v insolvenčním rejstříku (sestava) ==
== Pracovní poměry ==
Popis práce se sestavou - viz zde [[Insolvence]].
{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Souhrn údajů'''
|'''Čtení'''
|'''Zápis'''
|'''Význam'''
|-
| [[WebAPI Pracovní poměry |PracovniPomery ]]
| Ano
| Ano
| Pracovněprávní poměry zaměstnanců
|-
| [[WebAPI Pracovní postup|PracovniPostup ]]
| Ano
| Ne
| Pracovní postup zaměstnanců
|-
| [[WebAPI Dovolená|Dovolena ]]
| Ano
| Ne
| Dovolená v hodinách (legislativa 2021)
|-
| [[WebAPI Benefitní volno|BenefitniVolno ]]
| Ano
| Ne
| Benefitní volna zaměstnanců
|-
| [[WebAPI MimoevidencniStavy|MimoevidencniStavy]] || Ano || Ne || [[Mimoevidenční stav]]
|}


== Aktualizace báze dat ==
== Mzdy ==
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]]. <small>Skrytý rozšiřující parametr insr_last_id je totiž použit k uchování posledního zpracovaného záznamu z ISIR.</small>
{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Souhrn údajů'''
|'''Čtení'''
|'''Zápis'''
|'''Význam'''
|-
| [[WebAPI Zpracované mzdy |ZpracovaneMzdy ]]
| Ano
| Ne
| Mzdy zaměstnanců a odvody podniku.
|-
| [[WebAPI Zpracovaná docházka|ZpracovanaDochazka ]]
| Ano
| Ano
| Sesumovaná docházková data pro mzdy
|-
| [[WebAPI Plánované směny|Plánované směny]] ||  ||  ||
|-
| [[WebAPI KumulacePoVyuctovani|KumulacePoVyuctovani]] || Ano || Ne || Měsíční kumulace a další údaje po vyúčtování za os.číslo.
|}


Aktualizace báze dat se provádí prostřednictvím KS klienta, což je samostatný program, který pracuje jako klient webové služby ISIR.
== Ostatní ==
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.
{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Souhrn údajů'''
|'''Čtení'''
|'''Zápis'''
|'''Význam'''
|-
| [[WebAPI Pracovní pomůcky|PracovniPomucky]]
| Ano
| Ano
| Přiřazení prac. pomůcek zaměstnancům


<small> 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. </small>
|-
 
| [[WebAPI Služební cesty výdaje |SluzebniCestyVydaje ]]
Pro spouštění klienta doporučujeme využít dodanou windows službu (viz níže).
| Ano
 
| Ne
== KS klient ==
| Cestovní výdaje/náhrady
K činnosti klienta je vyžadováno běhové prostředí '''.NET Framework 4'''.
|-
 
| [[WebAPI Služební cesty|SluzebniCesty ]]
KS klient je tvořen dvěma programy:
| Ano
* '''Program pro aktualizaci báze dat (KSPortalServiceCommand)'''
| Ne
* '''Windows služba (KSPortalService)'''
| Služební cesty
 
|-
=== Program pro aktualizaci báze dat (KSPortalServiceCommand) ===
| [[WebAPI Služební cesty vyučtování|SluzebniCestyVyuctovani ]]
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.
| Ano
 
| Ne
<small>Příklad: KSPortalServiceCommand.exe /zInsolvence /cwebservice </small>
| Vyúčtování služebních cest
 
|-
=== Windows služba (KSPortalService) ===
| [[WebAPI Služební cesty zálohy|SluzebniCestyZalohy ]]
Jedná se o windows službu, která dle nastaveného intervalu (viz. konfigurační soubory) provádí řízené spouštění programu KSPortalServiceCommand.
| Ano
==== Instalace ====
| Ne
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ěží.
| Zálohy na služební cesty
 
|}
<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
-->
 
[[Insolvence|zpět]]

Aktuální verze z 16. 2. 2022, 15:49

Číselníky

Souhrn údajů Čtení Zápis Význam
Strediska Ano Ano Číselník středisek
SkupinyStredisek Ano Ano Číselník skupiny středisek
Divize Ano Ano Číselník divizí
PracovniMista Ano Ano Číselník pracovních míst
CiselnikJazyku Číselník jazyků
CiselnikStupnuVzdelani Číselník stupňů vzdělání
iTutor_Courses

Zaměstnanci

Souhrn údajů Čtení Zápis Význam
KmenoveUdaje Ano Ano Evidence zaměstnanců
Vzdelani Ano Ano Dosažené vzdělání zaměstnanců
JazykoveZnalosti Ano Ano Jazykové znalosti zaměstnanců
RodinniPrislusnici Ano Ano Rodinní příslušníci
RodinniPrislusniciSlevy Ano Ano Daňové zvýhodnění rodinných příslušníků
Kontakty Ano Ano Kontakty (telefonní čísla, emaily)
Poznamky Poznámky
Platby Ano Ano Platby zaměstanců
PracovniPovoleni Ano Ano Pracovní povolení cizinců
Požadavky Požadavky

Pracovní poměry

Souhrn údajů Čtení Zápis Význam
PracovniPomery Ano Ano Pracovněprávní poměry zaměstnanců
PracovniPostup Ano Ne Pracovní postup zaměstnanců
Dovolena Ano Ne Dovolená v hodinách (legislativa 2021)
BenefitniVolno Ano Ne Benefitní volna zaměstnanců
MimoevidencniStavy Ano Ne Mimoevidenční stav

Mzdy

Souhrn údajů Čtení Zápis Význam
ZpracovaneMzdy Ano Ne Mzdy zaměstnanců a odvody podniku.
ZpracovanaDochazka Ano Ano Sesumovaná docházková data pro mzdy
Plánované směny
KumulacePoVyuctovani Ano Ne Měsíční kumulace a další údaje po vyúčtování za os.číslo.

Ostatní

Souhrn údajů Čtení Zápis Význam
PracovniPomucky Ano Ano Přiřazení prac. pomůcek zaměstnancům
SluzebniCestyVydaje Ano Ne Cestovní výdaje/náhrady
SluzebniCesty Ano Ne Služební cesty
SluzebniCestyVyuctovani Ano Ne Vyúčtování služebních cest
SluzebniCestyZalohy Ano Ne Zálohy na služební cesty