Polecenia funkcji external

Dla skryptów uruchamianych na bazie czytelników, pobiera wartość parametru parametr z bazy głównej (uwaga: wymagana spacja między GET a nazwą parametru).

W SOWA-SQL jest to niepotrzebne, gdyż baza parametrów jest wspólna i można używać standardowej funkcji cfg(parametr).

zwraca kind rekordu, np: DEFU245T (rekord U, pole 245T) zwróci XTY, gdzie X - oznacza, że pole jest indeksowane.

Zwraca wartość pola z wybranej sekcji licencji

Jak MAIL S, ale wymaga podania dodatkowych wartości

• mime_type
• kind - rodzaj maila (taki sam jak litera przesyłana do skryptu generującego mail określająca rodzaj operacji)
• czyt_id - identyfikator rekordu czytelnika (sama liczba)
• set_time - zakres godzin kiedy e-mail może być wysłany w formacie hh,hh

Polecenie zwraca listę rekordów (oddzielonych pionową kreską) dla których zostanie wykonane następujące zapytanie SQL:

SELECT * FROM TBL_ITEMS_IDX WHERE FLD_STR_FIELD >= OD AND FLD_STR_FIELD <= DO AND FLD_KIND = KIND

czyli zostanie zwrócona lista rekordów, których wartość pola fld_str_field znajduje się w zakresie wartości od - do

typ_rekordu|sql_where|

stary|nowy

USERS?

USERS#user,profil,prawa

Składnia praw dla komendy USERS# jest identyczna jak dla komendy user klienta administracyjnego.

External USERS? zwróci listę wszystkich użytkowników systemu, w formacie identycznym jak komenda users export klienta administracyjnego, z tą różnicą iż zamiast podziału na linie, poszczególne wpisy są oddzielone pionowa kreską (|).

Komenda USERS#, przyjmuje argumenty w identycznym formacie, można przy jej pomocy zmieniać prawa i profil już istniejącego użytkownika, bądź dodać nowego (zostanie utworzony z hasłem: 1).

Komenda USERS# ma dwa dodatkowe znaczniki. Jeśli przed nazwą użytkownika wstawimy:

• "-" - wówczas konto danego użytkownika zostanie zdezaktywowane i nie będzie można się na niego zalogować, konto można aktywować wykonując komendę z tymi samymi parametrami, ale bez znaku "-"
• "*" - resetujemy hasło danego użytkownika do wartości "1".

Zmiana danych czytelnika. Drugi znak komendy precyzuje operację (i dereminuje też op_params, które zawierają kolejne parametry). Dostepne wartości op:

K - kod kreskowy. Rejestruje nowy kod kreskowy dla czytelnika i wizytę czytelnika w agendzie. op_params zawierać winno nowy kod kreskowy. jeśli zostanie podany pusty - unieważnia bieżący kod kreskowy czytelnika.

L - limit wypożyczeń. op_params zawiera nowy limit wypożyczeń.

W - data ważności. op_params zawiera nową datę ważności konta

B - blokada. op_params zawiera treść blokady konta

Z - korekta daty zapisu. op_params zawiera nową datę zapisu czytelnika

Pobiera pole f rekordu czytelnika o identyfikatorze rekord. Np. WYPFO123|Z.1 pobiera pierwsze wystąpienie pola Z rekordu O123

W przypadku SOWYSQL można tym samym eksternalem pobierać pola rekordu bazy podstawowej. (zob. eksternal WYPP).

Informacja o globalnym stanie konta czytelnika (we wszystkich agendach). Zwraca:

<wyp>|<rez>|<zam>|<kary>|<prz>

<wyp> - liczba wypożyczonych pozycji
<rez> - liczba rezerwacji
<zam> - liczba zamówień
<kary> - kwota niezapłaconych kar
<prz> - liczba pozycji przetrzymanych (których data zwrotu upłynęła)

Informacja o wypożyczeniu egzemplarza o identyfikatorze sn z uwzględnieniem prolongat. Zwraca:

<czytelnik>|W|<data_wyp>|<data_zwr>

Informacja o stanie konta czytelnika w agendzie. Zwraca:

<wyp>|<rez>|<zam>|<kary>|<kaucje>|<wizyta>|<prz>

<wyp> - liczba wypożyczonych pozycji
<rez> - liczba rezerwacji
<zam> - liczba zamówień
<kary> - kwota niezapłaconych kar
<kaucje> - kwota wpłaconych kaucji
<wizyta> - data ostaniej wizyty
<prz> - liczba pozycji przetrzymanych (których data zwrotu upłynęła)

UWAGA1: w SOWA2 jeśli rozliczanie=zawiera A (w sowa.inf) lub CFG_ROZLICZANIE zawiera A (parametr) to działa jak wyżej, inaczej zwraca wartości globalne (nie w agendzie). Dla SOWA2SQL analogiczną rolę pełni parametr wyp.penalty.default.settlements 

UWAGA2: w SOWA2 jeśli rozliczanie=zawiera C (w sowa.inf) lub CFG_ROZLICZANIE zawiera C (parametr) to kwota niezapłaconych kar zwracana jest globalnie, inaczej zwraca wartości w agendzie. Dla SOWA2SQL analogiczną rolę pełni parametr wyp.penalty.default.settlements

Informacja o zawartości konta czytelnika. Drugi znak komendy precyzuje operację i determinuje op_params. W przypadku zwracania listy - kolejne wiersze rozdzielane są znakiem o kodzie #13 (\r). Dostepne wartości op:

A - informacja o agendzie zapisu (zwraca numer agendy)

W - bieżący stan wypożyczeń. Zwraca listę wartości <sn>|<agenda>|<data_wyp>|<data_zwr>

H - historia wypożyczeń. Zwraca listę wartości <sn>|<agenda>|<data_wyp>|<data_zwr>

R - bieżący stan rezerwacji. Zwraca listę wartości <sn>|<agenda>|<status>|<data_rez>|<czas_rez>

Z - bieżący stan zamówień. Zwraca listę wartości <rekord>|<agenda>|<data_zam>|<czas_zam>|<data_max>

K - kary do zapłacenia. Zwraca listę wartości <agenda>|<data_nal>|<flag>|<sn>|<wartość>

P - wpłaty/wypłaty. Zwraca listę wartości <agenda_w>|<data_wpl>|<rodzaj>|<kwit>|<wartość>

O - odwiedziny. Jako op_params można podać numer agendy, jeśli się nie poda, zwraca listę dla wszystkich agend. Zwraca listę: <data>|<agenda>

o - Jako op_params należy podać <data>| lub <data>|<agenda> - Jeśli data odwiedzin wskazanej agendy jest większa lub równa podanej, zwracana jest ta data. W przypadku nie podania agendy, sprawdzane są wszystkie agendy.

w - Jako op_params należy podać <data>| lub <data>|<agenda> - Jeśli data wypożyczenia we wskazanej agendzie jest większa lub równa podanej, zwracana jest ta data. W przypadku nie podania agendy, sprawdzane są wszystkie agendy.

M - czyt|sn - zwraca liczbę wygenerowanych monitów

Informacja o rezerwacji egzemplarza o identyfikatorze sn. Zwaca:

<czytelnik>|<agenda>|<status>|<data_rez>|<czas_rez>

Sprawdza status dostępności i agendę dla egzemplarza o identyfikatorze sn. Zwraca łańcuch postaci <dostępność>|<agenda> - gdzie <dostępność> wyrażona jest kodem: D - dostępne, Nx - niedostępne z powodu x (Z - zarezerwowane, W - wypożyczone). Np. NZ|0 - egzemplarz należy do agendy o numerze "0", nie jest dostępny gdyż jest zarezerwowany.

W przypadku pozycji ubytkowanej dodatkowo zwracane jest <agenda>|<data>|<dokument>|<pozycja>|<nr_kol>

W przypadku pozycji zgłoszonej do ubytkowania (dostępność Nx gdzie x <> W i Z): <ubytek>|<data_wp><agenda>, zaś jeśli <ubytek>=P, dodatkowo <dokument>|<pozycja>

Informacja o wypożyczeniu egzemplarza o identyfikatorze sn. Zwraca:

<czytelnik>|<kas>|<data_wyp>|<data_zwr>

Informacja o wypożyczeniu egzemplarza o identyfikatorze sn. Zwraca:

<czytelnik>|<kas>|<data_wyp>|<data_zwr>|<prolongaty_automatyczne>

Dodaje i zwraca identyfikator nowego rekordu czytelnika (o kodzie rekordu "O"). Dalsze części do pary pole|wartść, które określają pola nowo tworzonego rekordu. Np. A.1|123|Z.1|michal@sokrates.pl|V.1|373298238232|. Polecenie to zawsze zwraca nowy rekord ID, nawet jeśli doszło do błędu, więc nie wiadomo czy dodano czytelnika, czy nie

UWAGA: w SOWA-SQL odpowiednikiem (ale zwracającym rezultat w razie błędu) jest external NEWOpole|wartość|...

Usuwanie pozycji. Drugi znak precyzuje operację i determinuje op_params (niżej podane zaraz za kodem operacji). DOstępne wartości op:

Z - rekord_ks|rekord_czt - Usunięcie zamówienia na rekord_ks dla czytelnika rekord_czt

R - sn - Usunięcie rezerwacji bez obsługi zamówienia

A - sn - Realizacja zamówienia na egzemplarz

E - sn - Usuwa egzemplarz ze wszystkich baz

Zamienia ustawienia prawa wypożyczanie (&W) oraz inne (&I) dla aktualnie zalogowanego użytkownika.

Ustawia przesłaną agendę jako nową agendę główną dla prawa wypożyczanie, jednocześnie przenosząc agendę z tego prawa, do prawa inne. 

przed: &W=01;&I=00,03,04,05,06
operacja: WYP:03
po: &W=03;&I=00,04,05,06,01

Zwraca komunikat błędu, lub pusty string.

Status egzemplarza. Zawsze zwraca co najmniej: <dostęp><powód>|<agenda>.

Jeśli <dostęp>=U dodatkowo zwraca informację o pozycji ubytkowanej, tj: <data>|<dokument>|<pozycja>|<nr_kol>

Jeśli <dostęp>=N zaś <powód> nie jest W lub Z dodatkowo zwraca informację o pozycji zgłoszonej do ubytkowania, tj: <ubytek>|<data_wp>, a jeśli <ubytek>=P to jeszcze <dokument>|<pozycja>

Oznaczenie dodania lub zmiany rekordu. Zwraca <rec_id>/<wersja>|<ipub_id>|<status>|<data>|<czas>|<lp>, gdzie:

<rec_id>/<wersja> - numer rekordu wraz z numerem wersji (numer wersji zwiększa się w przypadku ponownego dodania wcześniej usuniętego rekordu o tym samym numerze)
<ipub_id> - identyfikator powiązanego rekordu w IPUB
<status> - Status bieżący rekordu. N - nowy, U - zmieniony, D - usunięty
<data>, <czas> i <lp> - zarezerwowana dla operacji data, czas i numer pliku XML

Oznaczenie usunięcia rekordu. Zwraca j.w.

Pobranie informacji o wysłanym stanie egzemplarzy (nie trzeba podawać agendy). Zwraca listę wierszy (oddzielanych znakiem o kodzie #13):

<agenda>|<il_dostepnych>|<il_wypozyczonych>|<il_nieznane>|<il_namiejscu>

Pobranie informacji o powiązaniu rekordu i zarezerwowanie daty, czasu i numeru pliku dla operacji.

W przypadku SOWA2 zwraca <rec_id>/<wersja>|<ipub_id>|<status>|<data>|<czas>|<lp> (znaczenie jak w +);
W przypadku SOWASQL zwraca <rec_id>|<ipub_id>

Pobranie informacji o powiązaniu rekordu i daty, czasu oraz numeru pliku ostatniej wykonanej na nim operacji.

W przypadku SOWA2 zwraca <rec_id>/<wersja>|<ipub_id>|<status>|<data>|<czas>|<lp> (znaczenie jak w +);
W przypadku SOWASQL zwraca <rec_id>|<ipub_id>

Zwraca listę rekordów aktualizowanych w podanym czasie. Parametry od i do postaci rrrrmmddhhmmss.

Zwraca listę wierszy (oddzielanych znakiem o kodzie #13):

<datoczas>|<rec_id>|<wersja>|<status_zmiany>

gdzie jako status zmiany można otrzymać:

N - rekord nowo dodany do katalogu
U - rekord zaktualizowany w katalogu
D - rekord usunięty z katalogu (lub unieważniony)

Zwraca listę rekordów które zmieniły stan dostępności w podanym czasie. Parametry od i do postaci rrrrmmddhhmmss.

Zwraca listę wierszy (oddzielanych znakiem o kodzie #13):

<datoczas>|<rec_id>|<wersja>|<status_zmiany>

Zwraca listę rekordów wraz z ich powiązaniami.

Zwraca listę wierszy (oddzielonych znakiem o kodzie #13):

<rec_id>|<wersja>|<status_zmiany>|<ipub_id>

T

GET

• 0|komunikat błędu
• 1|lista pól z wynikami (wartości poszczególnych pól są oddzielone pionową kreską)
• 2|EOF