Spis treści

I. Wstęp .............................................................................................................................................. 3

II. Uwarunkowania techniczne ............................................................................................................ 4

III. Integracja z prostymi systemami RCP ............................................................................................. 5

IV. Integracja z zaawansowanymi systemami RCP ............................................................................... 6

V. Import z innych systemów RCP ....................................................................................................... 9

VI. Automatyczne uruchomienie interfejsu przez importem danych ................................................ 13

 I. Wstęp

W niniejszym opracowaniu przedstawiono sposoby integracji zewnętrznych systemów

elektronicznej rejestracji czasu pracy z modułem KDPL systemu Streamsoft Prestiż.

Na wstępie omówiono uwarunkowania techniczne integracji, w dalszych częściach omówiono

dwie metody integracji :

 Integracja z prostymi systemami RCP, w której następuje import danych o zdarzeniach,

stosowana we współpracy między innymi z systemami HSK, Elnix.

 Integracja z zawansowanymi systemami RCP, w której importowane jest rozliczenie czasu

pracy, stosowana na przykład we współpracy z systemem UNIS RCP firmy AutoID.

 W końcowej części opracowania przedstawiono metodę postępowania w przypadku

innych systemów RCP.
II. Uwarunkowania techniczne

Aby import danych z systemów RCP był możliwy, muszą być spełnione następujące warunki:

 Musi być zainstalowana licencja systemu Streamsoft Prestiż na współpracę modułu

kadrowego z systemami RCP

 Pracownicy, którym chcemy importować dane z systemów RCP, w przypadku importu

danych o zdarzeniach muszą mieć w swoim zaszeregowaniu wzorzec ewidencji obecności
typu „od-do”, natomiast w przypadku importu rozliczonego czasu pracy indywidualne
wzorce obecności typu „godzinowego”.

 Na definicji wzorca obecności musi być określona data, od kiedy pobierać dane z systemu
RCP. Wszystkie zdarzenia przed tą zadaną datą będą ignorowane. Opcja ta umożliwia
płynne przejście z ręcznej ewidencji godzin pracy na ewidencję importowaną z systemu
RCP.
III. Integracja z prostymi systemami RCP

Proste systemy RCP służą jedynie do zbierania informacji o czasie przyjścia i wyjścia
pracowników. Do ewidencji czasu pracy w systemie Streamsoft Prestiż importowane są zdarzenia,
które przekładają się na czas rozpoczęcia i zakończenia pracy. Rozliczenie czasu pracy odbywa się w
systemie Streamsoft Prestiż.

Integrację uzyskujemy poprzez wykorzystanie funkcjonalności importu danych o zdarzeniach z

pliku tekstowego. Funkcjonalność ta jest dostępna w oknie kadrowym w menu Pracownik, Import /
Export w formacie TXT, Import rozliczenia czasu pracy RCP lub HSK.

Aby import danych o zdarzeniach był możliwy pracownicy muszą mieć wzorce obecności typu
„od-do”.

Plik z danymi o zdarzeniach musi być dostarczony w niżej opisanym formacie:

NNNNNNNNNNRRRRMMDDGGMMXR

gdzie:

NNNNNNNNNN numer pracownika w systemie RCP , na 10 znakach (pole w bazie danych typu
Integer – maksymalna liczba 2147483648 znaków), wyjustowany do prawej, ze spacjami wiodącymi
po lewej
RRRRMMDD data zdarzenia
GGMM godzina i minuta zdarzenia
X znak nieużywany
R rodzaj zdarzenia (0-wejście, 1-wyjście)

Przykład:

12320150105070000
123201501051500001
IV. Integracja z zaawansowanymi systemami RCP

Zaawansowane systemy RCP, poza funkcjonalnością rejestracji zdarzeń określających godzinę

rozpoczęcia i zakończenia pracy, wyposażone są zwykle w zawansowane oprogramowanie służące do
rozliczenia czasu pracy (czas nominalny, czas w nadgodzinach, w porze nocnej). Do ewidencji godzin
pracy w systemie Streamsoft Prestiż jest importowany rozliczony czas pracy, odpowiednio w
powyższych rodzajach godzin. Możliwy jest jednoczesny import danych do wzorca obecności jak i
danych o absencjach.

Podobnie jak w pierwszym przypadku, integrację uzyskujemy poprzez wykorzystanie

funkcjonalności importu rozliczonego czasu pracy z pliku tekstowego. Funkcjonalność ta jest
dostępna w oknie kadrowym w menu Pracownik, Import / Export w formacie TXT, Import rozliczenia
czasu pracy pełny.

Aby import danych o zdarzeniach był możliwy pracownicy muszą mieć w swoich
zaszeregowaniach podpięte indywidualne wzorce obecności typu „godzinowego”.

Plik z danymi o zdarzeniach musi być dostarczony w niżej opisanym formacie:

pesel; nazwisko; imię; data; ilość godzin do przepracowania; ilość godzin przepracowanych
normalnych; ilość nadgodzin 50%; ilość nadgodzin 100%; ilość godzin nocnych; symbol absencji

Wyjaśnienia

Pesel- identyfikator pracownika

Nazwisko -nazwisko pracownika

Imię - imię pracownika

Ilość godzin do przepracowania - zaplanowana ilość godzin pracy,w tym miejscu importowany jest
symbol czasu pracy, który musi być zdefiniowany we wzorcu obecności

Ilość godzin przepracowanych normalnych – podana w formacie HH:MM

Ilość nadgodzin 50% - podana w formacie HH:MM

Ilość nadgodzin 100% - podana w formacie HH:MM

Ilość godzin nocnych –podana w formacie HH:MM

Symbol absencji – opcjonalny symbol, eksportowany przez system RCP, jeśli absencja w danym dniu
wystąpiła.

Uwaga

Należy zadbać aby symbole absencji w systemie RCP oraz w systemie Streamsoft Prestiż były
takie same. System Streamsoft Prestiż pozwala na zdefiniowanie w słowniku własnych symboli
absencji, tak więc nie ma ograniczeń co do tych symboli, mogą to być symbole z aktualnego systemu.
Możliwe jest te\z działanie w drugą stronę – dopasowanie symboli w systemie RCP do symboli w w
systemie Streamsoft Prestiż.

Przykład dnia przepracowanego:

99999999999;20150105;8;8;0;0;0

(8 godzin zaplanowanych, 8 przepracowanych, bez nadgodzin i nocek)

Przykład dnia przepracowanego w nadgodzinach

99999999999;20150105;8;8;1:30;0;0

(8 godzin zaplanowanych, 8 przepracowanych w czasie normalnym, 1:30 w nadgodzinach 50%, bez

nocek)

Przykład dnia przepracowanego w porze nocnej

99999999999;20150105;8;8;0;0;8

(8 godzin zaplanowanych, 8 przepracowanych, bez nadgodzin, 8 godzin nocnych)

Przykład dnia przepracowanego w nadgodzinach w nocy

99999999999;20150105;8;0;1;30;0;8

(8 godzin zaplanowanych, 8 przepracowanych, 1:30 nadgodziny 100%, 8 godzin nocnych)

Przykład dnia urlopu:
99999999999;20150105;8;0;0;0;0;U

(8 godzin zaplanowanych, 0 przepracowanych, dodatkowo symbol absencji U)

Przykład dnia chorobowego w dzień roboczy:

99999999999;20150105;8;0;0;0;0;C

(8 godzin zaplanowanych, 0 przepracowanych, dodatkowo symbol absencji C)

Przykład dnia chorobowego w dzień wolny:

99999999999;20150105;0;0;0;0;0;C

(0 godzin zaplanowanych, 0 przepracowanych, dodatkowo symbol absencji C)

V. Import z innych systemów RCP

Klienci często zadają pytanie czy moduł KDPL systemu Streamsoft Prestiż będzie współpracował z
systemem RCP Bibi, Cerber, F7, czy też zupełnie innym. Odpowiedź na to pytanie jest twierdząca, o
ile dany system RCP potrafi wyeksportować istotne dane o zdarzeniach do pliku tekstowego w
jakimkolwiek czytelnym formacie. Są to dane:

 numer pracownika w systemie RCP

 data , godzina zdarzenia
 rodzaj zdarzenia

Procedura importu danych w takim przypadku jest dwuetapowa. W pierwszej kolejności, przy
pomocy interfejsu KonwersjaEwidencjiRCP przerabiamy plik zastany na plik o wymaganej strukturze
HSK. Drugim etapem jest import danych z uzyskanego przed chwilą pliku, metodą opisaną w punkcie
2.

Pliki eksportu z różnych systemów RCP zawsze mają inną strukturę, jednakże zawsze
posiadają wymagane dane. Jedynym wymogiem jest, aby wiersze z danymi zawsze były w stałej
strukturze, aby pola z danymi zawsze miały taką samą długość i były w tych samych miejscach.

Przykłady:

Plik F7_InOutData.txt – wynik eksportu danych z systemu F7

Plik cerber_import.txt – wynik eksportu danych z systemu Cerber

Odpowiednio parametryzując plik konfiguracyjny KonwersjaEwidencjiRCP.ini jesteśmy w

stanie „przerobić” dane z dowolnego pliku. W opracowaniu załączono program wykonywalny
KonwersjaEwidencjiRCP.exe oraz plik konfiguracyjny interfejsu KonwersjaEwidencjiRCP.ini
sparametryzowany do przeróbki pliku F7_InOutData.txt

Opis pól pliku konfiguracyjnego KonwersjaEwidencjiRCP.ini

PlikWejsciowy=f7_inoutdata.txt

Nazwa pliku wejściowego, uzyskanego z systemu RCP

PlikWyjsciowy=ewidencja.txt

Nazwa pliku wynikowego, w standardzie HSK, akceptowalnym przez moduł kadrowy systemu Prestiż

NumerPracownikaP=1

Numer kolumny z początkiem numeru pracownika

NumerPracownikaL=10

Długość (ilość znaków) na numer pracownika

RokP=11

Numer kolumny z początkiem roku zdarzenia

RokL=4

Długość (ilość znaków) na rok zdarzenia

MiesiacP=15

Numer kolumny z początkiem miesiąca zdarzenia

MiesiacL=2

Długość (ilość znaków) na miesiąc zdarzenia

DzienP=17
Numer kolumny z początkiem dnia zdarzenia

DzienL=2

Długość (ilość znaków) na dzień zdarzenia

GodzinaP=19

Numer kolumny z początkiem godziny zdarzenia

GodzinaL=2

Długość (ilość znaków) na godzinę zdarzenia

MinutaP=21

Numer kolumny z początkiem minuty zdarzenia

MinutaL=2

Długość (ilość znaków) na minutę zdarzenia

RodzajZdarzeniaP=23

Numer kolumny z początkiem rodzaju zdarzenia

RodzajZdarzeniaL=3

Długość (ilość znaków) na rodzaj zdarzenia

ZdarzenieWejscie=C/I

Ciąg znaków w pliku źródłowym oznaczających rodzaj zdarzenia : wejście

ZdarzenieWyjscie=C/O

Ciąg znaków w pliku źródłowym oznaczających rodzaj zdarzenia : wyjście

PomijacWierszeZaczynajaceSieOd=#$@

Różne systemy RCP, oprócz konkretnych danych o zdarzeniach, wysyłają do plików tekstowych różne
linie z komentarzami, informacjami o wersji programu itp. itd. Te wiersze zwykle nie zawierają
żadnych istotnych dla nas danych, zwykle te wiersze oznaczone są dodatkowymi znakami, często jest
to znak # oznaczający komentarz. W tym parametrze określamy konkretne znaki. Jeżeli
interpretowany wiersz z danymi w pliku zaczynać się będzie od jednego z tych znaków, wówczas
zostanie on pominięty w analizie.

Separator=;

Separator pól z danymi (jeśli istnieje)

Dysponując powyższą definicją interfejsu, na skutek uruchomienia interfejsu plik źródłowy z

systemu F7 o nazwie F7_inoutdata.txt zostanie przerobiony na plik o nazwie ewidencja.txt, w
formacie HSK wymaganym przez moduł importu danych w części kadrowej systemu Streamsoft
Prestiż.
VI. Automatyczne uruchomienie interfejsu przez importem
danych

Aby uprościć procedurę importu danych, możliwe jest automatyczne uruchomienie interfejsu
przed uruchomieniem procedury importu danych. W pliku konfiguracyjnym ewidencja.cd
modyfikujemy linię:

PlikEXE=

na:

PlikEXE=D:\rcp\KonwersjaEwidencjiRCP.exe

(W tym miejscu określamy lokalizację programu, który zostanie uruchomiony przed rozpoczęciem
procedury importu, w naszym przypadku lokalizację interfejsu)

Skutkiem powyższego działania, w pierwszej kolejności uruchomi się interfejs

KonwersjaEwidencjiRCP.exe, który przerobi (według ustawień w konfiguracji
KonwersjaEwidencjiRCP.ini) plik źródłowy uzyskany z systemu RCP na plik akceptowalny przez moduł
importu danych systemu Prestiż, w drugiej kolejności uruchomiony zostanie import danych z pliku
przerobionego (według ustawień pliku konfiguracji importu ewidencja.cd)
Wersja z dnia 28.04.2023