Skrypty można wykonywać:
●Z okna Edycja danych kadrowych – do każdej formatki przypisany może być jeden skrypt operujący na danych tej formatki,
●Z poziomu pulpitu.
Z poziomu pulpitu dostępne są funkcje służące do naczytania listy osób i ustawienia widoku dostępnych danych – formatki.
Tabela 50. Zestawienie funkcji do naczytania listy osób
Funkcja |
Co robi |
Parametry |
long naczytaj_liste ( long wybrani, string grupa ) |
naczytuje listę pracowników zwraca liczbę naczytanych pracowników lub wartość < 0 gdy wystąpi błąd. Opis błędów poniżej. |
wybrani: 1 – tak naczytuje listę pracowników wybranych, 0 – wszyscy, grupa – naczytuje tylko pracowników ze wskazanej grupy. (wszyscy = 0) domyślnie wybrani = 1 grupa = ' ' – wszyscy |
long ustaw_formatke ( long knrfrm, string idnuzy ) |
ustawia formatkę danych wg jakiej będą naczytywane dane pracowników zwraca 1 gdy OK, wartość < 0 gdy błąd. |
knrfrm – numer formatki danych podanie wartości – 3 powoduje naczytanie wszystkich danych – formatka pełna, idnuzy – identyfikator właściciela formatki, pominięcie parametru idnuzy powoduje wybór spośród formatek prywatnych, dodatkowe wartości = 'Prywatne', 'Kadry', 'Płace' |
Tabela 51. Zestawienie funkcji działających na danych poszczególnej osoby
long kadr_wart ( ref double wynik, string zakres, long dana, integer nrkold, date datapocz, date datakon) |
Funkcja podaje liczbę będącą elementem danej kadrowej typu wartość. |
long kadr_kod ( ref string wynik, string zakres, long dana, integer nrkold, date datapocz, date datakon) |
Funkcja podaje kod, będący elementem danych kadrowych zawierających kod. |
long kadr_kod_pelny ( ref string wynik, string zakres, long dana, integer nrkold, date datapocz, date datakon) |
Funkcja podaje opis kodu, będącego elementem danych kadrowych. |
long kadr_kod_opisowy (ref string wynik, string zakres, long dana, integer nrkold, date datapocz, date datakon ) |
Funkcja podaje pełny opis kodu (do 390 znaków), będącego elementem danych kadrowych zawierających kod. Jeśli pełny opis kodu nie został zdefiniowany funkcja zwróci opis kodu (tak jak funkcja: kadr_kod_pelny). |
long kadr_opis ( ref string wynik, string zakres, long dana, integer nrkold, date datapocz, date datakon) |
Funkcja podaje tekst będący elementem danej kadrowej typu opis lub dokument. |
long kadr_data ( ref date wynik, string zakres, long dana, integer nrkold ) |
Funkcja podaje wartość danej kadrowej typu data. |
long kadr_lmd ( ref integer lata, ref integer miesiace, ref integer dni, string zakres, long dana, integer nrkold, date datapocz, date datakon ) |
Funkcja podaje wartość wyrażenia lmd zawartego w danej kadrowej (typy: Z (okres czasu), X (lmd z kodem), Y (lmd)). |
long kadr_dowolna ( string zakres, long dana, integer nrkold, date datapocz, date datakon ) |
Funkcja służy do sprawdzenia występowania danej oraz/lub ustawienia znaczników zakresu (głównie "D" ). Patrz opis poniżej dotyczący wartości parametrów powyższych funkcji. |
long kadr_data_pocz ( ref date wynik, string zakres, long dana, integer nrkold, date datapocz, date datakon) |
Funkcja podaje datę początkową z zakresu dat danej kadrowej. |
long kadr_data_kon ( ref date wynik, string zakres, long dana, integer nrkold, date datapocz, date datakon) |
Funkcja podaje datę końcową z zakresu dat danej kadrowej. |
long liczba_dan_kadr ( string zakres, long dana ) |
Funkcja wyznacza liczbę wystąpienia danej kadrowej o określonym numerze w kartotece konkretnego pracownika. |
Powyższe funkcje zwracają 1 (nie dotyczy liczba_dan_kadr która zwraca liczbę wystąpień) gdy OK lub < 0 gdy błąd:
●-1 nieokreślony błąd
●-2 błąd parametrów wywołania
●-3 brak danej
●-4 typ danej niezgodny z typem oczekiwanego wyniku
●-5 brak wystarczających praw do wykonania funkcji
Parametr wynik (typ odpowiedni dla funkcji) [wymagany]:
●Żądana wartość zwracana jest w zmiennej podanej jako parametr wynik lub lata, miesiące, dni dla kadr_lmd.
Parametr zakres (typ string) [wymagany – może być ""]:
●"Z" – zapamiętaj wyszukaną daną jako startową do operacji na drzewiastej strukturze danych.
●"D" – szukaj danej w obrębie zapamiętanej struktury drzewiastej.
●"O" – szukaj danej względem ostatnio odczytanej danej tego typu (ten sam parametr "dana"; nrkold jest liczony względem ostatnio odczytanej tego typu).
●Można dowolnie łączyć lub nie podać żadnego.
Parametr dana (typ long) [wymagany]:
●Numer danej kadrowej jaką należy wyszukać i której wartość zwrócić.
●Dane podstawowe o numerach 100000 – 100006 dostępne są na każdej formatce.
Parametr nrkold (typ integer) [opcjonalny]:
●Parametr selekcji oznaczający numer kolejny wśród danych występujących w ustalonym zakresie; ujemna wartość oznacza przyjęcie numeracji odwrotnej niż kolejność wprowadzania danych
o(np. gdy w zakresie nie występuje "O" numer -2 oznacza daną przedostatnią); brak parametru spowoduje przyjęcie wartości –1 (ostatnia dana).
o(np. gdy w zakresie występuje "O" numer -1 oznacza daną poprzednią); brak parametru spowoduje przyjęcie wartości 0 (ostatnio wyszukana dana).
Uwaga
Gdy nie ma zakresu 'O' nrkold = 0 jest niedozwolony.
Parametr datapocz (typ datetime) [opcjonalny]:
●podanie tego parametru dla danej z zakresem dat spowoduje, że przy określaniu numeru kolejnego będą uwzględniane tylko dane, których zakres obejmuje datę określoną parametrem lub jakąkolwiek datę późniejszą; dla danych bez zakresu dat obecność parametru nie ma znaczenia dla działania funkcji.
Parametr datakon (typ datetime) [opcjonalny]:
●podanie tego parametru dla danej z zakresem dat spowoduje, że przy określaniu numeru kolejnego będą uwzględniane tylko dane, których zakres obejmuje datę określoną parametrem lub jakąkolwiek datę wcześniejszą; dla danych bez zakresu dat obecność parametru nie ma znaczenia dla działania funkcji.