Popis datového rozhraní k iFIS*Osoby

Popis datového rozhraní pro aktualizaci iFIS/Osoby

Primární datový zdroj (personalistika, studentský systém nebo jiný centrální registr osob, dále CRO*) poskytuje pro potřeby aplikace iFIS komplexní a vždy aktuální informace o osobách. Tyto informace jsou v iFIS využívány výhradně pro potřeby účetních, finančních, ekonomických a nebo jiných správních agend.
Informace o osobách jsou pro běžné uživatele iFIS uzamčené pro změny, změny jsou prováděny výhradně na straně CRO. Změny dat může v odůvodněných případech operativně provést pouze oprávněný správce iFIS/Osoby.

Aktuální informace o osobách jsou z CRO do iFIS/Osoby replikovány dávkovým jednosměrným způsobem v předem naplánovaných časových intervalech. Časový plán pro spuštění aktualizace iFIS/Osoby nastavuje správce v iFIS/Plánování úloh.

CRO poskytuje přístup na aktuální data obvykle prostřednictvím datových pohledů v db Oracle, iFIS si tato data v naplánovaných termínech stahuje, na urovni svého datového výměníku je analyzuje, transformuje a ukládá do svých vlastních datových struktur iFIS/Osoby.

Struktura dat předávaných z CRO do iFIS/Osoby

 

CRO_OSB (Základní údaje o osobách)

Sloupec	Datový typ	Implicitní hodnota	Popis
EKJ_ID	NUMBER(10)         NOT NULL		Identifikátor ekonomické jednotky
OSB_ID	NUMBER(10)         NOT NULL		Identifikátor osoby, primární klíč primárního datového zdroje
PRIJMENI	VARCHAR2(40)     NOT NULL		Příjmení
POHLAVI	VARCHAR2(1)		Pohlaví M/Ž
TITUL	VARCHAR2(20)		Titul před jménem
JMENO	VARCHAR2(40)		Jméno
TITUL2	VARCHAR2(20)		Titul za jménem
FUNKCE	VARCHAR2(40)		Funkční zařazení osoby v organizaci (kvestor, učitel, vedoucí, řidič, asistent)
TYP_VZTAHU	VARCHAR2(3)		Hlavní typ vztahu osoby k organizaci (možné hodnoty musí být zaevidovány v doméně SUBJEKT-OSOBA, obvykle např. ZAM/STU, apod.
OS_CISLO	VARCHAR2(10)    NOT NULL		Osobní číslo (povinné, pokud není uváděno ROD_CISLO)
ROD_CISLO	VARCHAR2(10)    NOT NULL		Rodné číslo, sekundární klíč (hash obraz) nebo jiné jednoznačné číslo osoby (povinné, pokud není uváděno OS_CISLO)
OD	DATE                     NOT NULL	DEFAULT TRUNC(SYSDATE)	Platnost záznamu OD, datum platnosti osoby OD nesmí být v rozporu s platností OD jednotlivých pracovních vztahů (bez ohledu na druh a platnost vztahu)
DO_	DATE		Platnost záznamu DO, datum platnosti osoby DO_ nesmí být v rozporu s platností DO_ jednotlivých pracovních vztahů (bez ohledu na druh a platnost vztahu)
DEL	VARCHAR2(1)       NOT NULL	DEFAULT '-'	Příznak zrušení záznamu
KOMENTAR	VARCHAR2(2000)		Komentář k osobě

CRO_VZTAHY (Pracovně právní vztahy osob)

Sloupec	Datový typ	Implicitní hodnota	Popis
OSB_ID	NUMBER(10)          NOT NULL		Identifikátor osoby, primární klíč primárního datového zdroje
EJ	NUMBER(2)            NOT NULL		Číslo ekonomické jednotky – organizační součásti / pobočky / fakulty
NS	VARCHAR2(10)		Označení kmenového nákladové střediska.
TYP_VZTAHU	VARCHAR2(3)        NOT NULL		Typ vztahu osoby k organizaci (možné hodnoty musí být zaevidovány v doméně SUBJEKT-OSOBA), obvykle ZAM, STU, apod.
DRUH_VZTAHU	VARCHAR2(35)		Druh vztahu osoby k organizaci  (možné hodnoty musí být zaevidovány v FIS.TEKDRVZ). Jedná se o podrobnější členění k položce TYP_VZTAHU, např. typ vztahu ZAM se dále může členit na HPP, DPČ, DPP, apod.
VZTAH_CISLO	VARCHAR2(15)		Identifikační číslo vztahu (číslo zaměstnance, studenta, číslo identifikační karty, apod.)
KOMENTAR	VARCHAR2(2000)		Komentář ke vztahu osoby
OD	DATE                      NOT NULL	DEFAULT TRUNC(SYSDATE)	Platnost záznamu od (zahájeni vztahu), datum platnosti OD nesmí mladší, než je celková platnost OD uvedená u osoby viz. ale_osb.OD
DO_	DATE		Platnost záznamu do (ukončení vztahu), datum platnosti DO nesmí starší, než je platnost DO_ uvedená u osoby viz. ale_osb.DO_
KARTA_IDENT	VARCHAR2(255)		Nárok na ITIC, ISIC nebo jinou osobní kartu.
EXT_ID	VARCHAR2(16)		Jednoznačný identifikátor záznamu o vztahu k organizaci
HLAVNI	VARCHAR2(1)		Hlavní pracovní vztah je označený příznakem 'A', jedna osoba může mít pouze jeden vztah označený jako hlavní. Pomocí této položky může externí systém do iFIS předat informaci o tom, který z pracovních vztahů osoby je hlavní.

CRO_SPJ (Bankovní účty osob, mailová, telefonická a další jiná spojení)

Sloupec	Datový typ	Implicitní hodnota	Popis
OSB_ID	NUMBER(10)          NOT NULL		Identifikátor osoby, primární klíč primárního datového zdroje
SPJ_TYP	VARCHAR2(5)        NOT NULL	DEFAULT 'TLF'	Typ spojení TLF/FAX/MOB/MAIL/WEB/UCET/…
SPJ_UZPREDC	VARCHAR2(1)        NOT NULL	DEFAULT '-'	Příznak použití předčíslí
SPJ_PREDC	VARCHAR2(20)		Předčíslí (obvykle vyplňováno pouze v případě spojení TEL, FAX, MOB)
SPJ_CISLO	VARCHAR2(255)    NOT NULL		Číslo/ Mail / URL / Číslo bankovního účtu včetně předčíslí odděleného pomlčkou a kódu banky za lomítkem (číslo účtu musí odpovídat standardu MODULO11)
SPJ_KLAPKA	VARCHAR2(255)		TEL klapka / Oficiální označení měny bankovního účtu (DEFAULT = domácí měna)
HLAVNI	VARCHAR2(1)        NOT NULL	DEFAULT '-'	Příznak hlavního spojení (hlavní spojení je označeno příznakem '+', vedlejší spojení je označeno příznakem '-')
OD	DATE                      NOT NULL	DEFAULT TRUNC(SYSDATE)	Platnost spojení OD
DO_	DATE		Platnost spojení DO
DEL	VARCHAR2(1)        NOT NULL	DEFAULT '-'	Příznak zrušení spojení (zrušené spojení je označeno příznakem ‘+’)
KOMENTAR	VARCHAR2(2000)		Komentář ke spojení / Název bankovního účtu
SPJ_SYMBOL	VARCHAR2(10)		Symbol  spojení (může se jednat např. o specifický symbol bankovního účtu ČS nebo jiný obvyklý platební symbol – rodné číslo, číslo zaměstnance atd.)
EXT_ID	VARCHAR2(255)		Jednoznačný identifikátor záznamu o spojení

CRO_ADR (Adresy pracovišť, adresy trvalého bydliště)

Sloupec	Datový typ	Implicitní hodnota	Popis
OSB_ID	NUMBER(10)         NOT NULL		Identifikátor osoby, primární klíč primárního datového zdroje
ADR_NAZEV	VARCHAR2(60)		Název adresy
ULICE	VARCHAR2(60)		Ulice vč. č. popisného
KOMENTAR	VARCHAR2(2000)		Komentář k adrese
MST_NAZEV	VARCHAR2(40)     NOT NULL		Název místa (město/obec/…)
MST_NAZEV_LOCAL	VARCHAR2(40)		Cizojazyčný název místa
PSC	VARCHAR2(13)		Poštovní směrovací číslo
ZME_ID	VARCHAR2(3)        NOT NULL		Kódové označení země podle ISO 3166
VAD_TYP_OSB	VARCHAR2(5)        NOT NULL		Typ adresy k osobě (TRV..Adresa trvalého pobytu, PRA..Pracovní adresa, apod., viz reference na doménový číselník typů adres iFIS)
OD	DATE                      NOT NULL	DEFAULT TRUNC(SYSDATE)	Platnost adresy OD
DO_	DATE		Platnost adresy DO
DEL	VARCHAR2(1)        NOT NULL	DEFAULT '-'	Příznak zrušení adresy (zrušená adresa je označena příznakem ‘+’)
HLAVNI	VARCHAR2(1)        NOT NULL	DEFAULT '-'	Příznak hlavní adresy (hlavní adresa je označena příznakem ‘+’, vedlejší adresa je označena příznakem ‘-’). Vždy pouze jedna z adres jednoho typu (viz. VAD_TYP_OSB) může být označena jako hlavní.
EXT_ID	VARCHAR2(255)		Jednoznačný identifikátor záznamu o adrese

	Poznámka
	Sloupce označené NOT NULL, které nemají uvedenu implicitní hodnotu, jsou povinné a musí být v pohledech povinně uváděny. OSB_ID je interní identifikátor osoby a meziobjektový referenční klíč z CRO.

Popis zpracování dat na straně iFIS/Osoby

Aktualizace informací o osobách probíhá dávkovým způsobem buď na pokyn správce číselníku osob a nebo automaticky v naplánovaných časových intervalech.

Na základě rodného, osobního nebo jiného jednoznačného identifikačního čísla osoby se provede zjištění, zda se jedná o novou osobu. Pokud se jedná o novou osobu, provede se její registrace v iFIS/Osoby. Pokud osoba v evidenci iFIS již existuje, tak proběhne porovnání uložených dat oproti aktuálnímu snímku dat v CRO, uložené záznamy jsou v iFIS aktualizovány. Položka Komentář se aktualizuje přírůstkovým způsobem, tzn. že původní komentáře u jednotlivých záznamů zůstávají, nové nebo změněné komentáře jsou vždy doplněny za středník.

	Pozor
	Pokud osoba evidovaná v iFIS/Osoby není při aktualizaci nalezena v CRO, pak se tato osoba v souladu s nařízením GDPR ve všech evidencích a nadstavbových aplikacích iFIS automaticky anonymizuje.

Protokol o všech provedených změnách se ukládá v podrobné historii iFIS/Osoby.

 

Aktualizace dat v iFIS/Osoby se řídí podle nastavení systémových vstupních parametrů:

SYNC_ADR - synchronizovat adresy osob A/N, default 'A'

SYNC_SPJ - synchronizovat spojeni osob A/N, default 'A'

LOG_DATA - logovat datove zmeny A/N, default 'A'

ROD_CISLO - prenaset rodne cislo A/N, default 'A'

USER_VAD - VAD_ID podle prave prihlaseneho uzivatele A/N, default 'A'

UPD_ONLY - pouze aktualizace existujicich osob (nikoli insert) A/N, default 'N'

ZAMEN_SPJ - parametr pro UJEP kde nahrazuji cele spojeni A/N, default 'N'

USER_EXPIRE - aktualizace doby expirace uživatelských účtů A/N, default 'N'

IDENT_OPER - aktualizace externiho identifikatoru R_USERS_VW, default 'N', povolené hodnoty:

                 'I' = Insert - pouze doplnuje chybejici
                 'U' = Update - Updatuje(prepisuje) i stavajici hodnoty
                 'N' = Neaktivni (defaultni hodnota)

PRENOS_DAT - používání přenosu přes tabulky (rychlejší + kontrola duplicit), default 'A', povolené hodnoty:

                 'A' = ano (defaultni hodnota)
                 'N' = ne
                 'D' = Debugovací režim (vypisuje chyby a filtruje duplicity), default 'A'
                 'S' = Debugovací režim bez chybových hlášení

DEL_OSB - mazat osoby jež nejsou na rozhraní A/N, default 'A'

INT_SPJ_DEL - zneplatnění interních záznamů o spojení A/N, které nejsou v ext. systému, default 'N'

INT_BU_DEL - zneplatnění interních bankovních účtů A/N, které nejsou v ext. systému, default 'N'

REM_ADR_DEL - zneplatnění adres odebraných z rozhraní importu osob A/N, default 'N'

ZPOZDENI - prodloužení platnosti osob o uvedený počet dní, default hodnota 0

ZPOZ_CUC - prodloužení platnosti DO pro čísla účtů o zpoždění uvedené v par. ZPOZDENI A/N, default 'A'

PRIO - priorita importovaných záznamů, default 'HRM'

CODE_RC - přiřazování osob pomocí šifrovaného rodného čísla A/N, default 'N'

PRE - PL/SQL příkaz spuštěný před začátkem přenosu dat z rozhraní, default NULL

                 NULL - default hodnota
                 PL/SQL příkaz

VZT_CIS - nemazat/nepřepisovat číslo vztahu A/N, default 'A'

Počáteční sjednocení dat

Před samotnou implementací rozhraní pro aktualizaci iFIS/Osoby je vždy nutné provést důkladnou revizi dosud evidovaných dat v iFIS/Osoby. Obvykle to znamená především ruční doplnění aktuálních osobních, rodných a nebo jiných identifikačních čísel, zneplatnění duplicitních záznamů apod. Ve všech případech je doporučeno postupovat podle pokynů konzultantů iFIS.