Uwaga

Dyrektywy dotyczące importu danych (obiektów) do dokumentu Nieobecności zaczynają się od znaku # oddzielonego od dyrektywy właściwej spacją.

W poszczególnych wierszach pliku nagłówkowego z dyrektywami w podanej niżej kolejności powinny być zamieszczone zestawy znaków (dyrektywy) oznaczające:

●Niezależnie od rodzaju importowanych nieobecności:

o# %NOWY – dyrektywa dotyczy pliku z danymi do importu do dokumentów.

o# %IDENT[nazwa] – po znakach # %IDENT w nawiasach należy umieścić unikalny identyfikator nadawany w tabelach importu kompletowi jednocześnie importowanych plików z danymi. Dyrektywa służy do wyznaczenia zestawów, w ramach których następuje kontrola spójności merytorycznej danych o nieobecnościach, a także do wskazania zestawu w buforze przeznaczonego do importu lub ponownego sprawdzenia po dokonaniu zmian w SIMPLE.ERP.

o# %IMPOBJ – dyrektywa informuje o tym CO BĘDZIE IMPORTOWANE; oznacza „import obiektów”, tj. import wartości danych do dokumentu i danych kadrowych do drzewka nieobecności w odróżnieniu od tradycyjnego importu tylko wartości danych kadrowych.

●W kolejnym wierszu nagłówka powinno być zamieszczone słowo kluczowe informujące jakiego rodzaju nieobecności będą w pliku z danymi do importu, i tak:

o# %RODZOBJ[NIEOBPLATNE] – słowo kluczowe NIEOBPLATNE zarezerwowane jest dla Nieobecności płatnych. Dyrektywa informuje o tym, że plik zawiera informacje dotyczące Nieobecności płatnych.

o# %RODZOBJ[NIEOBNIEPLATNE] – słowo kluczowe NIEOBNIEPLATNE zarezerwowane jest dla Nieobecności niepłatnych. Dyrektywa informuje o tym, że plik zawiera informacje dotyczące Nieobecności niepłatnych.

o# %RODZOBJ[NIEOBZUS] – słowo kluczowe NIEOBZUS zarezerwowane jest dla Nieobecności rozliczanych w ZUS. Dyrektywa informuje o tym, że plik zawiera informacje dotyczące Nieobecności rozliczanych w ZUS.

●Po wierszu określającym, rodzaj nieobecności należy zamieść kolejno dyrektywy wspólne dla wszystkich rodzajów nieobecności:

o# %TRYB_MIGRATORA[n] – dyrektywa złożona określająca tryb pracy migratora, gdzie liczba zawarta w nawiasach jest sumą FLAG, z których każda oznacza inne zachowanie programu. I tak:

▪# %TRYB_MIGRATORA[0] – import informacji do bufora; wyłącznie kontrola formalna i merytoryczna.

▪# %TRYB_MIGRATORA[1] – import informacji do bufora; sprawdzenie i import nieobecności gdy brak błędów i ostrzeżeń w całej paczce.

▪# %TRYB_MIGRATORA[2] – import informacji do bufora; sprawdzenie i import nieobecności w których nie było błędów. Błędne dane są pomijane.

▪# %TRYB_MIGRATORA[256] – powtórna kontrola formalna i merytoryczna wcześniej wczytanych informacji do bufora. Wymaga podania identyfikatora (# %IDENT) wcześniej zaimportowanego pliku.

▪# %TRYB_MIGRATORA[257] – (256+1) powtórna kontrola formalna i merytoryczna informacji wczytanych do bufora wcześniej oraz import nieobecności gdy brak błędów i ostrzeżeń w całym pliku. Wymagane podanie identyfikatora (# %IDENT) wcześniej zaimportowanego pliku.

▪# %TRYB_MIGRATORA[258] – (256+2) powtórna kontrola formalna i merytoryczna informacji wczytanych do bufora wcześniej oraz import poprawnych danych. Błędne dane są pomijane. Wymagane podanie identyfikatora (# %IDENT) wcześniej zaimportowanego pliku.

▪# %TRYB_MIGRATORA[4] – tryb kasowania; sprawdzenie co ewentualnie można skasować. Informacja o błędach.

▪# %TRYB_MIGRATORA[8] – tryb kasowania; sprawdzenie co można skasować i kasowanie jak nie ma błędów.

▪# %TRYB_MIGRATORA[260] – tryb kasowania; (256+4) powtórne sprawdzenie wcześniej wczytanych informacji do bufora oraz lista co można skasować. Wymagane podanie identyfikatora (# %IDENT) wcześniej zaimportowanego pliku.

▪# %TRYB_MIGRATORA[264] – tryb kasowania; (256+8) powtórne sprawdzenie wcześniej wczytanych informacji do bufora oraz sprawdzenie co można skasować i kasowanie jak nie ma błędów. Wymagane podanie identyfikatora (# %IDENT) wcześniej zaimportowanego pliku.

●# %UZUPELNIENIE_LP[T] – T lub N; dyrektywa dotycząca uzupełniania informacji o liście płac. Domyślnie przyjmowana jest wartość T. Gdy w SIMPLE.ERP uda się znaleźć listę płac na podany okres nieobecności zostanie ona wpisana do dokumentu nieobecności.

●# %ZAPIS_DO_GRAFIKA [T] – T lub N; dyrektywa informująca czy zaimportowane nieobecności mają być wpisane do grafika – domyślna wartość T

●# %ZAPIS_DO_GRAFIKA_OD[YYYY.MM.DD] – data od. Zapis do grafika będzie dotyczył wyłącznie okresu podanego od daty w dyrektywie. Brak tej dyrektywy oznacza, że zapis do grafika odbywa się zawsze.

●# %PILNOWANIE_BIL_GODZ[T] – T lub N, domyślnie na tak. Sprawdzanie podanych sekund – musi być co najmniej 1800. Nieobecności niepłatne – automatyczne rozliczenie podanej nieobecności jak miesiąc rozliczenia nie jest podany. Dyrektywa dotyczy sprawdzenia: suma godzin z grafika = suma godzin z dokumentu. Gdy nie są równe to błąd uniemożliwiający import (gdy tryb T), jak tryb N to rozmieszczenie podanych godzin w dni robocze proporcjonalnie. Gdy na podany okres nieobecności pracownik nie ma przypisanego kalendarza, to pobieramy dane dla kalendarza Ustawowego – dni wolne..., jak dalej brak danych to dni wolne zostaną ustawione na sobotę i niedzielę. Niezgodna wartość – wystawiona wartość rozrzucana po dniach roboczych z kalendarza pracownika, reszta do ostatniego dnia, jak nie ma kalendarza to kalendarz ustawowy.

●Dyrektywy z podaniem daty sterujące wymagalnością podawania dni i godzin roboczych:

o# %WYMAGANE_GODZ_OD[YYYY.MM.DD] – domyślna wartość 1900.01.01.

o# %UZUPELNIANE_GODZ_OD_DO[YYYY.MM.DD YYYY.MM.DD] – domyślna wartość 1900.01.01 3000.12.31

oZasada działania:

▪Dla dokumentów po dacie wymagania godzin – gdy wartość dni i godzin roboczych będzie zero, a nieobecność będzie w zakresie dat uzupełniania nastąpi próba wyliczenia godzin. Jeżeli nie uda się z sytemu wyliczyć wartości będzie zgłaszany błąd.

▪Dane przed datą wymagania – jeżeli będą miały wartość zero, a daty będą mieściły się w zakresie uzupełniania godzin, nastąpi próba wyliczenia godzin. Wartość zerowa będzie traktowana jak poprawna wartość.

▪Z uzupełniania wyłączone są pozycje (dokument), które w danej 400060<L,!> edycja dzienna mają wartość T.

▪Łączenie nieobecności w jeden dokument następuje po ciągłości dat od do i rodzaju nieobecności.

▪Status pozycji dokumentu po imporcie – jeżeli będzie lista płac – W, brak listy – Z.

●Dyrektywy standardowe do plików importu:

o%SEPARATOR – wyznaczenie separatora informacji, np. średnik.

o%NIE – ustalenie, że program działa w trybie dopisywania informacji. Jest to JEDYNY tryb obsługiwany przez migrator. Odnalezienie informacji o istniejących obiektach w systemie SIMPLE.ERP aktywnych w tym samym okresie czasu co importowane będzie sygnalizowane jako błąd i zablokuje import.

o%TRYB DO – tryb dopisywania; aktualnie kasowanie danych jeszcze nie jest obsłużone.

Pliki z danymi do importu powinny być tworzone z uwzględnieniem zasad:

●Format plików do importu powinien być w stronie kodowej ANSI.

●W nagłówkowych wierszach opisu pól nie powinno być separatorów.

●Dyrektywy (opisy pól) powinny być zgodne z zawartością pliku z danymi.

●Pola w pliku muszą odpowiadać kolejnym opisom z nagłówka.

W plikach z danymi do importu dokumentów nieobecności powinny być zestawy danych dedykowanych odrębnie do każdego z trzech rodzajów nieobecności, w tym w plikach do importu:

●Nieobecności płatnych – dane o numerach od 400000 do 400080,

●Nieobecności niepłatnych – dane o numerach od 400500 do 400620,

●Nieobecności rozliczanych w ZUS – dane o numerach od 400200 do 400360.

Tabela 16. Opis danych do importu nieobecności płatnych

Tabela 17. Opis danych do importu nieobecności niepłatnych

Tabela 18. Opis danych do importu nieobecności rozliczanych w ZUS

Procedura importu danych i nieobecnościach zawiera następujące fazy sprawdzenia:

●Wykrycie informacji powielających/sprzecznych z już zawartymi w bazie.

●Kontrola wewnętrznej spójności danych:

oZgodność ze słownikami z ERP,

oZgodność zakresów dat – w zbiorze informacji z ERP połączonych z danymi importowanymi,

oReguły biznesowe – np. na raz jedna nieobecność nie robocza w tym czasie.

●Sprawdzenie zakresu wartości w datach początkowych i końcowych danych. Data początkowa i końcowa muszą być z zakresu 1800-01-02 - 3000-12-31. Jeżeli daty przy danych w pliku są poza tym zakresem, wtedy są systemowo ustawiane na DP=1800-01-02, DK=3000-12-31.

Wyniki kontroli są dostępne w formie raportu tworzonego na koniec każdego importu. Raport można zapisać w formie pliku Excel, w menu System->Zapisz jako->okno wyboru miejsca zapisu i nadania nazwy pliku->Zapisz. Może to ułatwić analizę.

Po spełnieniu wszystkich warunków importu, dane z pliku zostaną zapisane we wskazanej teczce jako odpowiednie dokumenty nieobecności: płatnej/niepłatnej/rozliczanej w ZUS i w odpowiadających im drzewkach danych nadzorowanych.

Przykładowe pliki z dyrektywami do wczytania danych do bufora lub wczytania i importu do SIMPLE.ERP oraz kontroli poprawności danych.

Nieobecności płatne – plik wczytania danych do bufora bez importu do SIMPLE.ERP

Plik dyrektyw:

# %NOWY

# %IDENT[NIEOBP_TEST_20190801_1100]

# %IMPOBJ

# %RODZOBJ[NIEOBPLATNE]

# %TRYB_MIGRATORA[0]

# % ZAPIS_DO_GRAFIKA_OD[2005.01.01]

%SEPARATOR ;

%NIE

%TRYB DO

Plik opisujący dane:

@START OPISU

400000<K,X->

400000<DP,YYYY.MM.DD->

400000<DK,YYYY.MM.DD->

400010<K,XX->

400020<W,####->

400030<W,#######->

400040<K,XXXX->

400050<D,YYYY.MM.DD->

400060<L,X->

400070<K,X->

400080<O,XXXXXXXXXX->

@KONIEC OPISU

Plik z danymi do importu:

268;P;2019.05.06;2019.05.17;70;10;80;R;2019.05.17;N;W;

Rysunek 932.  Zapis do pliku informacji o wykonaniu operacji importu danych do bufora

Nieobecności niepłatne – plik wczytania danych do bufora i importu do SIMPLE.ERP

Plik dyrektyw:

# %NOWY

# %IDENT[NIEOBP_TEST_20190801_1100]

# %IMPOBJ

# %RODZOBJ[NIEOBNIEPLATNE]

# %TRYB_MIGRATORA[1]

# % ZAPIS_DO_GRAFIKA_OD[2005.01.01]

%SEPARATOR ;

%NIE

%TRYB DO

Plik opisujący dane:

@START OPISU

400500<K,X->

400500<DP,YYYY.MM.DD->

400500<DK,YYYY.MM.DD->

400510<K,XX->

400520<W,####->

400530<W,#######->

400540<K,XXXX->

400550<D,YYYY.MM.DD->

400560<L,X->

400570<K,X->

400580<O,XXXXXXXXXX->

400590<K,XXX->

@KONIEC OPISU

Plik z danymi do importu:

270;B;2019.05.06;2019.05.17;40;10;80;R;2019.05.17;N;U;;111;

Rysunek 933.  Fragment informacji o zaimportowanych danych

Nieobecności rozliczane w ZUS

Plik dyrektyw:

# %NOWY

# %IDENT[NIEOBP_TEST_20190801_1100]

# %IMPOBJ

# %RODZOBJ[NIEOBZUS]

# %TRYB_MIGRATORA[1]

# % ZAPIS_DO_GRAFIKA_OD[2005.01.01]

%SEPARATOR ;

%N

%TRYB DO

Plik opisujący dane:

@START OPISU

400200<K,X->

400200<DP,YYYY.MM.DD->

400200<DK,YYYY.MM.DD->

400210<K,XX->

400220<O,XXXXXXXXXXXXXXXXXXXXXX->

400230<W,###->

400240<K,X->

400250<K,XX->

400260<D,YYYY.MM.DD->

400270<K,XX->

400280<W,####@##->

400290<D,YYYY.MM.DD->

400300<K,XXX->

400305<W,###->

400310<W,####@##->

400320<W,####@##->

400330<W,####->

400340<W,#######->

400350<O,XXXXXXXXXX->

400360<O,XXXXXXXXXX->

@KONIEC OPISU

Plik z danymi do importu:

269;C;2019.01.02;2019.01.14;01;ZLA1234;0;;1;2011.03.05;01;2000,00;2019.01.02;331;;;;9;259200;;;

Rysunek 934. Informacja o przyczynie niezaimportowania dokumentu nieobecności rozliczanej w ZUS