Adatbázis terv
Adatbázis modell
Sémák
bob
A BOB keretrendszer táblái és tárol eljárásai.
ukk
Az utalványkezelő központot kiszolgáló rendszer saját táblái és tárol eljárásai.
exchange
A távoli rendszerek (például NAVI) azonosítóját tartalmazó segédtáblák.
Általános (rendszer-szintű) triggerek
A
bob.trigger
tárolt eljárás jellemzően minden táblához hozzá van rendelve, az alábbi eseményekkor:
-
BEFORE INSERT OR UPDATE OR DELETE ON … FOR EACH ROW
-
AFTER INSERT OR UPDATE OR DELETE ON … FOR EACH ROW
Feladata:
--* INPUTS
--* -
--* RESULT
--* Hibakódok:
--* - bob_trigger_001: Mind létrehozáskor, mind módosításkor kötelező megadni az aktív felhasználót, a modult és a fiókot.
--* - bob_trigger_002: Nincs a megadott felhasználónak aktív munkamenete (pl.: lejárt munkamenet esetén).
--* - bob_trigger_003: Nincs a paraméterként megadott modulcímkének megfelelő modul bejegyezve vagy a felhasználónak
--* semmilyen joga sincs az adott modulhoz.
--* - bob_trigger_004: A létrehozás ideje és a létrehozó felhasználó nem változhat.
--* - bob_trigger_005: Már lett a megadott űrlapkóddal beírva rekord ('vissza' gomb elleni védelem).
--* SYNOPSIS
--* Elvégzi az adott táblával kapcsolatos alapvető ellenőrzéseket és a az események naplózását.
--* Kezelt események: új rekord beírása, rekord módosítása.
--* A működés ismertetése:
--* - Magas (info) szintű naplózási szint esetén bejegyzi a tranzakció megkezdését a naplófájlba (INSERT, UPDATE és DELETE eseménynél is).
--* - Új rekord beírása vagy rekord módosítása esetén a tranzakció végrehajtása előtt
--* - ha nem lett megadva az aktív felhasználó (=NEW.lock_user_id=), a modul (=NEW.lock_modul_label=) és
--* az aktuális fiók (=NEW.lock_account_name=), akkor =bob_trigger_001= hibával megszakítja a tranzakciót.
--* - ha nincs a paraméterként megadott felhasználónak (=NEW.lock_user_id=) megfelelő aktív felhasználó
--* (például lejárt a munkamenet), akkor =bob_trigger_002= hibával megszakítja a tranzakciót.
--* - ha nincs a paraméterként megadott modulnévnek (=NEW.lock_modul_label=) megfelelő modul bejegyezve vagy
--* a felhasználónak semmilyen joga sincs az adott modulhoz, akkor =bob_trigger_003= hibával megszakítja a tranzakciót.
--* - ha van megadva űrlapazonosító kód (=NEW.lock_form_code=), akkor megvizsgálja, hogy szerepel-e az adatbázisban.
--* Ha igen, akkor =bob_trigger_005= hibával megszakítja a tranzakciót.
--* - Új rekord beírása esetén a tranzakció végrehajtása előtt beállítja az alábbi mezők értékét:
--* - a rekord létrehozásának időpontja (=NEW.creation_time=) legyen a tranzakció időpontja;
--* - a létrehozó felhasználó (=NEW.creation_user_id=) legyen az aktuális felhasználó (=NEW.lock_user_id=);
--* - az utolsó módosítás időpontját tartalmazó mező (=NEW.modification_time=) értéke legyen =NULL= érték;
--* - az utolsó módosítást kezdeményező felhasználót tartalmazó mező (=NEW.modification_user_id=) értéke legyen =NULL= érték;
--* - Rekord módosítása esetén a tranzakció végrehajtása előtt
--* - ha a rekord létrehozásának időpontja (=NEW.creation_time=) vagy a létrehozó felhasználó (=NEW.creation_user_id=)
--* változott, akkor =bob_trigger_004= hibával megszakítja a tranzakciót.
--* - az utolsó módosítás időpontja (=NEW.modification_time=) legyen a tranzakció időpontja;
--* - az utolsó módosítást kezdeményező felhasználó (=NEW.modification_user_id=) legyen az aktuális felhasználó (=NEW.lock_user_id=);
--* - Mind rekord beírása, mind rekord módosítása esetén a =NEW.lock_account_name=, =NEW.lock_user_id= és
--* =NEW.lock_modul_label= mezők értékét törölni kell a tranzakció végrehajtása előtt, így ellenőrizhető lesz,
--* hogy a legközelebbi tranzakció esetén is valóban meg lett adva.)
--* - Magas (info) szintű naplózási szint esetén bejegyzi a tranzakció végét a naplófájlba (INSERT, UPDATE és DELETE eseménynél is).
--* NOTES
--* -
Általános (projekt-szintű) triggerek
Az
ukk.trigger
tárolt eljárás jellemzően minden táblához hozzá van rendelve, az alábbi eseményekkor:
-
BEFORE INSERT OR UPDATE OR DELETE ON … FOR EACH ROW
-
AFTER INSERT OR UPDATE OR DELETE ON … FOR EACH ROW
Feladata:
--* INPUTS
--* -
--* RESULT
--* Hibakódok:
--* - ukk_trigger_001 -- nincs a megadott egyedazonosítónak (eid) megfelelő entitás
--* - ukk_trigger_002 -- egyedazonosító nem változhat
--* - ukk_trigger_003 -- nem lehet két ugyanolyan ID-vel ugyanaz az entitás
--* SYNOPSIS
--* Elvégzi az adott táblával kapcsolatos alapvető ellenőrzéseket és a az események naplózását.
--* Kezelt események: új rekord beírása, rekord módosítása.
--* - Beszúrás esetén, ha nincs megadva egyedazonosító, akkor generálni kell a rekordazonosító alapján.
--* - Beszúrás esetén, ha van megadva egyedazonosító, akkor ellenőrizni kell, hogy van-e már ilyen egyed.
--* - Beszúrás esetén, ha van megadva egyedazonosító, akkor nem lehet megegyező érvényességű rekord.
--* - Módosítás esetén az egyedazonosító nem változhat.
--* NOTES
--* -
Csak idősoros táblák esetén használt trigger:
--* INPUTS
--* -
--* RESULT
--* Hibakódok:
--* - ukk_tsigger_001 -- elmúlt érvényességi kezdettel rendelkező rekord nem változtatható vagy törölhető
--* - ukk_tsigger_002 -- érvényesség kezdete (valid_from_time) kötelező mező
--* - ukk_tsigger_003 -- elmúlt érvényességi kezdet nem állítható be
--* - ukk_tsigger_004 -- nem lehet két ugyanolyan érvényességi kezdettel ugyanaz az entitás
--* - ukk_tsigger_005 -- érvényesség kezdete nem változhat
--* SYNOPSIS
--* Elvégzi az adott táblával kapcsolatos alapvető ellenőrzéseket és a az események naplózását.
--* Kezelt események: új rekord beírása, rekord módosítása.
--* - Törlés és módosítás esetén, ha az érintett rekord érvényessége elmúlt, akkor hibaüzenet.
--* - Új rekord bejegyzése és módosítás esetén, ha az új érvényesség elmúlt, akkor hibaüzenet.
--* - Ha nincs megadva érvényesség kezdete, akkor hibaüzenet.
--* - Módosítás esetén az érvényesség kezdete nem változhat.
--* - A változásokat (beszúrás, módosítás, törlés) jegyezni kell az archív táblában.
Táblák és tulajdonságaik
személy (bob.persons
)
- person_id - a személy egyedi azonosítója (létrehozáskor az ID értékét kapja)
- person_timezone - eltérés GMT-től (Budapest:+1)
- person_firstname - keresztnév
- person_lastname - vezetéknév
- person_fullname - megjelenítendő név (ha nincs kitöltve, akkor prefix+lastname+firstname)
- person_name_prefix - név előtag
- person_nicname - becenév / megszólítás
- person_sex - neme (1:férfi;2:nő)
- person_mothers_name - anyja neve
- person_previous_name - előző név / születési név
- person_birthday - születésnap
- person_birthplace - születés helye
- person_mother_lang_code - anyanyelv
- person_lang_code - a felületen használni kívánt nyelv. ha nincs megadva, akkor az anyanyelv értékét kapja
- person_status - active:aktív, deleted:törölt, unregistered:nem regisztrált külső regisztráció esetén
- person_regcode - regisztrációs kód külső regisztráció esetén
- person_regcode_timeout - regisztráció érvényesítésének ideje (a nem regisztrálók egy idő után törlődnek)
- person_description_tkey - megjegyzés
felhasználó (bob.users
)
- person_id - a személy egyedi azonosítója (a bob.persons táblára mutat)
- user_status - active:aktív; inactive:passzív; deleted: törölt (törölt esetben a user_name értéke legyen NULL)
- user_activate_time - felhasználó érvényességének kezdete
- user_expire_time - felhasználó érvényességének vége
- user_name - felhasználói név belépéshez
- user_password - kódolt jelszó
- user_password_change - jelszó utolsó változtatásának időpontja
- user_session_time - munkamenet lejárati ideje (mp)
- user_session_time_type - munkamenet lejárati idejének típusa (start:belépéstől; click:kattintástól)
- user_session_code_every_click - igaz, ha minden kattintáskor új munkamenet-azonosítót kell generálni
- user_start_right_id - a kezdő modult és műveletet meghatározó jog
- user_authentication - internal:belső hitelesítés; external:külső (LDAP, PAM, stb.) hitelesítés;
Szabályok:
szervezet (bob.organizations
)
- park_id - székhely (központi telephely) azonosítója
- organization_tax_number - adószám
- organization_tradereg_number - cégjegyzékszám
- organization_stat_number - statisztikai számjel
- organization_shortname_tkey - rövid név nyelvi kódja (képernyőre)
- organization_fullname_tkey - teljes név nyelvi kódja (például hivatalos iratokra), ha nincs, akkor a teljes név jelenik meg
- organization_description_tkey - megjegyzés nyelvi kódja
munkavállaló (ukk.lnk_employee
)
Mezők ismertetése:
- person_id
- organization_id
külső személy (ukk.outer_person
)
Kibocsátók rendszereitől kapott (importált) személyek listája.
Nem azonos a rendszer felhasználóihoz tartozó személyekkel, de kapcsolódhat azokhoz.
Mezők ismertetése:
- financial_ident - pénzügyi azonosító
- person_id - a rendszer által adminisztrált személy azonosítója (opcionális)
- email_address - e-mail cím
- full_name - megjelenítendő név (opcionális)
- sex - neme (1:férfi;2:nő) (opcionális)
- mothers_name - anyja neve (opcionális)
- previous_name - előző név / születési név (opcionális)
- birth_year - születésnap (opcionális)
- birth_day - születésnap (opcionális)
- birthplace - születés helye (opcionális)
- address - lakcím vagy postacím (opcionális)
- description - megjegyzés (opcionális)
A bob.users.person_id és az ukk.outer_person.person_id mezők alapján közvetett kapcsolatban áll a két tábla.
Szabályok:
- A
financial_ident
egyedi.
- A
person_id
egyedi.
iroda (ukk.office
)
Mezők ismertetése:
- label - azonosító címke üzleti logika számára (kulcsmező)
- short_name - rövid név
- full_name - teljes név (opcionális)
- email_address - elsődleges e-mail cím
- phone_number - elsődleges telefonszám (opcionális)
- zip_code_id - irányítószám
- city_id - település
- country_id - ország
- address_line_1 - cím első sora
- address_line_2 - cím második sora (opcionális)
- person_id - irodavezető
- description - megjegyzés (opcionális)
Szabályok:
- A
label
mező normalizált szöveg, kulcsként NEM használjuk.
- TODO: Nem törölhető, ha nyitott ajánlatkérés (ukk.request_offer) hivatkozik rá.
ukk.create_office()
- Új iroda létrehozása
A iroda alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _EmailAddress varchar -- elsődleges e-mail cím
--* _PhoneNumber varchar -- elsődleges telefonszám
--* _ZipCodeId integer -- irányítószám
--* _CityId integer -- település
--* _CountryId integer -- ország
--* _AddressLine_1 varchar -- cím első sora
--* _AddressLine_2 varchar -- cím második sora
--* _PersonId integer -- irodavezető
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_office_001 --Hiányzó paraméter: _Label
--* ukk_create_office_002 --Hiányzó paraméter: _ShortName
--* ukk_create_office_003 --Hiányzó paraméter: _EmailAddress
--* ukk_create_office_004 --Hiányzó paraméter: _ZipCodeId
--* ukk_create_office_005 --Nem érvényes (FK) paraméter: _ZipCodeId
--* ukk_create_office_006 --Hiányzó paraméter: _CityId
--* ukk_create_office_007 --Nem érvényes (FK) paraméter: _CityId
--* ukk_create_office_008 --Hiányzó paraméter: _CountryId
--* ukk_create_office_009 --Nem érvényes (FK) paraméter: _CountryId
--* ukk_create_office_010 --Hiányzó paraméter: _AddressLine_1
--* ukk_create_office_011 --Hiányzó paraméter: _PersonId
--* ukk_create_office_012 --Nem érvényes (FK) paraméter: _PersonId
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_office(
--* 'ukk',
--* 'ukk_office',
--* 1,
--* NULL,
--* 'eger',
--* 'Egri iroda',
--* NULL,
--* 'eger@utalvanykezelo.hu',
--* '+36 20 999-9999',
--* 100,
--* 1000,
--* 1,
--* 'Mátyás Király út 100.',
--* NULL,
--* 42,
--* NULL
--* );
ukk.edit_office()
- Létező iroda adatainak módosítása
Létező iroda adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _EmailAddress varchar -- elsődleges e-mail cím
--* _PhoneNumber varchar -- elsődleges telefonszám
--* _ZipCodeId integer -- irányítószám
--* _CityId integer -- település
--* _CountryId integer -- ország
--* _AddressLine_1 varchar -- cím első sora
--* _AddressLine_2 varchar -- cím második sora
--* _PersonId integer -- irodavezető
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_office_001 -- egyedazonosító megadása kötelező
--* ukk_edit_office_002 -- nem létező iroda
--* ukk_edit_office_003 -- Hiányzó paraméter: _Label
--* ukk_edit_office_004 -- Hiányzó paraméter: _ShortName
--* ukk_edit_office_005 -- Hiányzó paraméter: _EmailAddress
--* ukk_edit_office_006 -- Hiányzó paraméter: _ZipCodeId
--* ukk_edit_office_007 -- Nem érvényes (FK) paraméter: _ZipCodeId
--* ukk_edit_office_008 -- Hiányzó paraméter: _CityId
--* ukk_edit_office_009 -- Nem érvényes (FK) paraméter: _CityId
--* ukk_edit_office_010 -- Hiányzó paraméter: _CountryId
--* ukk_edit_office_011 -- Nem érvényes (FK) paraméter: _CountryId
--* ukk_edit_office_012 -- Hiányzó paraméter: _AddressLine_1
--* ukk_edit_office_013 -- Hiányzó paraméter: _PersonId
--* ukk_edit_office_014 -- Nem érvényes (FK) paraméter: _PersonId
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_office(
--* 'ukk',
--* 'ukk_office',
--* 1,
--* NULL,
--* 1,
--* 'eger',
--* 'Egri iroda',
--* NULL,
--* 'eger@utalvanykezelo.hu',
--* '+36 20 999-9999',
--* 100,
--* 1000,
--* 1,
--* 'Mátyás Király út 100.',
--* NULL,
--* 42,
--* NULL
--* );
ukk.list_office()
- Irodák listázása
Irodák listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- iroda állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* address_line_1 varchar -- cím első sora
--* address_line_2 varchar -- cím második sora
--* person_id integer -- irodavezető
--* description varchar -- megjegyzés
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* email_address varchar -- elsődleges e-mail cím
--* phone_number varchar -- elsődleges telefonszám
--* zip_code_id integer -- irányítószám
--* city_id integer -- település
--* country_id integer -- ország
--*
--* Hibakódok:
--* ukk_list_office_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_office( now() );
ukk.read_office()
- Iroda adatainak visszaadása
Iroda adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- jármű azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- iroda állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* email_address varchar -- elsődleges e-mail cím
--* phone_number varchar -- elsődleges telefonszám
--* zip_code_id integer -- irányítószám
--* city_id integer -- település
--* country_id integer -- ország
--* address_line_1 varchar -- cím első sora
--* address_line_2 varchar -- cím második sora
--* person_id integer -- irodavezető
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_office_001 -- egyedazonosító megadása kötelező
--* ukk_read_office_002 -- nem megfelelő egyedazonosító
--* ukk_read_office_003 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_office( 1, now() );
ukk.set_office()
- Iroda állapotának beállítása
Átírja a iroda állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- a változtatandó csoportosítási cél azonosítója
--* _Status -- iroda állapota (active:aktív, deleted:törölt)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_office_001 -- egyedazonosító megadása kötelező
--* ukk_set_office_002 -- nem létező iroda
--* ukk_set_office_003 -- állapot megadása kötelező
--* ukk_set_office_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_office(
--* 'ukk',
--* 'ukk_office',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_office()
- Irodák egyszerűsített listázása
Irodák listázása az adott időpontban.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- iroda állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* address_line_1 varchar -- cím első sora
--* address_line_2 varchar -- cím második sora
--* person_id integer -- irodavezető
--* description varchar -- megjegyzés
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* email_address varchar -- elsődleges e-mail cím
--* phone_number varchar -- elsődleges telefonszám
--* zip_code_id integer -- irányítószám
--* city_id integer -- település
--* country_id integer -- ország
--*
--* Hibakódok:
--* ukk_simplelist_office_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_office( now() );
kibocsátó (ukk.mandator
)
Mezők ismertetése:
- label - azonosító címke üzleti logika számára (kulcsmező)
- short_name - rövid név
- full_name - teljes név (opcionális)
- url - a kibocsátó honlapja (és az utalványokra vonatkozó információk) elérési útvonala
- picture_id - jellemző kép (public.files) (opcionális)
- description - megjegyzés (opcionális)
Szabályok:
- A
label
mező normalizált szöveg, kulcsként használjuk.
- Nem törölhető, ha nem törölt utalványtípus (ukk.voucher_type) hivatkozik rá.
ukk.create_mandator()
- Új kibocsátó létrehozása
A kibocsátó alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Url varchar -- a kibocsátó honlapja (és az utalványokra vonatkozó információk) elérési útvonala
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_mandator_001 --Hiányzó paraméter: _Label
--* ukk_create_mandator_002 --Hiányzó paraméter: _ShortName
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_mandator(
--* 'ukk',
--* 'ukk_mandator',
--* 1,
--* NULL,
--* 'tesco',
--* 'Tesco',
--* 'TESCO-GLOBAL Áruházak Zrt.',
--* 'http://tesco.hu/szolgaltatasok/utalvany/tesco-utalvanyok',
--* NULL
--* );
ukk.edit_mandator()
- Létező kibocsátó adatainak módosítása
Létező kibocsátó adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _Label varchar -- rövid név
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Url varchar -- a kibocsátó honlapja (és az utalványokra vonatkozó információk) elérési útvonala
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_mandator_001 -- egyedazonosító megadása kötelező
--* ukk_edit_mandator_002 -- nem létező kibocsátó
--* ukk_edit_mandator_003 -- Hiányzó paraméter: _Label
--* ukk_edit_mandator_004 -- Hiányzó paraméter: _ShortName
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_mandator(
--* 'ukk',
--* 'ukk_mandator',
--* 1,
--* NULL,
--* 2,
--* 'liter',
--* 'l',
--* 'liter',
--* NULL
--* );
ukk.list_mandator()
- Kibocsátók listázása
Kibocsátók listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* url varchar -- a kibocsátó honlapja (és az utalványokra vonatkozó információk) elérési útvonala
--* description varchar -- megjegyzés
--* voucher_type_count integer -- hivatkozó utalványtípusok száma
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_mandator();
ukk.read_mandator()
- Kibocsátó adatainak visszaadása
Kibocsátó adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- jármű azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- kibocsátó állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* url varchar -- a kibocsátó honlapja (és az utalványokra vonatkozó információk) elérési útvonala
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_mandator_001 -- egyedazonosító megadása kötelező
--* ukk_read_mandator_002 -- nem megfelelő egyedazonosító
--* ukk_read_mandator_003 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_mandator( 1, now() );
ukk.labelread_mandator()
- Kibocsátó adott időpontban érvényes adatainak visszaadása egyedazonosító címke megadásával
Kibocsátó adott időpontban érvényes adatainak visszaadása egyedazonosító címke megadásával.
--* INPUTS
--* _Label -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* url varchar -- a kibocsátó honlapja (és az utalványokra vonatkozó információk) elérési útvonala
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_mandator_001 -- egyedazonosító címke megadása kötelező
--* ukk_read_mandator_002 -- nem megfelelő egyedazonosító
--* ukk_read_mandator_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.labelread_mandator( 'label' );
ukk.set_mandator()
- Kibocsátó állapotának beállítása
Átírja a kibocsátó állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó csoportosítási cél azonosítója
--* _Status, -- kibocsátó állapota (active:aktív, deleted:törölt)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_mandator_001 -- egyedazonosító megadása kötelező
--* ukk_set_mandator_002 -- nem létező kibocsátó
--* ukk_set_mandator_003 -- állapot megadása kötelező
--* ukk_set_mandator_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_mandator(
--* 'ukk',
--* 'ukk_mandator',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_mandator()
- Kibocsátók egyszerűsített listázása
Kibocsátók listázása az adott időpontban.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- jármű azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- kibocsátó állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* url varchar -- a kibocsátó honlapja (és az utalványokra vonatkozó információk) elérési útvonala
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_simplelist_mandator_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_mandator( now() );
kibocsátó képviselője (ukk.lnk_mandator_person
)
Mezők ismertetése:
- mandator_id - kibocsátó
- person_id - személy azonosítója
beváltási hálózat / franchise (ukk.cashing_network
)
Mezők ismertetése:
- label - azonosító címke üzleti logika számára (kulcsmező)
- short_name - rövid név
- full_name - teljes név (opcionális)
- description - megjegyzés (opcionális)
Szabályok:
- Nem törölhető, amíg aktív beváltóhely (ukk.cashing_site) hivatkozik rá.
ukk.create_cashing_network()
- Új beváltóhely hálózat létrehozása
A beváltóhely hálózat alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_cashing_network_001 --Hiányzó paraméter: _Label
--* ukk_create_cashing_network_002 --Hiányzó paraméter: _ShortName
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_cashing_network(
--* 'ukk',
--* 'ukk_cashing_network',
--* 1,
--* null,
--* 'coop',
--* 'Coop',
--* 'Coop Üzletlánc',
--* NULL
--* );
ukk.edit_cashing_network()
- Létező beváltóhely hálózat adatainak módosítása
Létező beváltóhely hálózat adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_cashing_network_001 --Hiányzó paraméter: _Label
--* ukk_create_cashing_network_002 --Hiányzó paraméter: _ShortName
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_cashing_network(
--* 'ukk',
--* 'ukk_cashing_network',
--* 1,
--* null,
--* 'coop',
--* 'Coop',
--* 'Coop Üzletlánc',
--* NULL
--* );
ukk.list_cashing_network()
- Beváltóhely hálózatok listázása
Beváltóhely hálózatok listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--* cashing_site_count integer -- hivatkozó beváltóhelyek száma
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_cashing_network();
ukk.read_cashing_network()
- Beváltóhely hálózat adatainak visszaadása
Beváltóhely hálózat adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- jármű azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- beváltóhely hálózat állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_cashing_network_001 -- egyedazonosító megadása kötelező
--* ukk_read_cashing_network_002 -- nem megfelelő egyedazonosító
--* ukk_read_cashing_network_003 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_cashing_network( 1, now() );
ukk.labelread_cashing_network()
- Beváltóhely hálózat adott időpontban érvényes adatainak visszaadása egyedazonosító címke megadásával
Beváltóhely hálózat adott időpontban érvényes adatainak visszaadása egyedazonosító címke megadásával.
--* INPUTS
--* _Label -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_cashing_network_001 -- egyedazonosító címke megadása kötelező
--* ukk_read_cashing_network_002 -- nem megfelelő egyedazonosító
--* ukk_read_cashing_network_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.labelread_cashing_network( 'label' );
ukk.set_cashing_network()
- Beváltóhely hálózat állapotának beállítása
Átírja a beváltóhely hálózat állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó csoportosítási cél azonosítója
--* _Status, -- beváltóhely hálózat állapota (active:aktív, deleted:törölt)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_cashing_network_001 -- egyedazonosító megadása kötelező
--* ukk_set_cashing_network_002 -- nem létező beváltóhely hálózat
--* ukk_set_cashing_network_003 -- állapot megadása kötelező
--* ukk_set_cashing_network_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_cashing_network(
--* 'ukk',
--* 'ukk_cashing_network',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_cashing_network()
- Beváltóhely hálózatok egyszerűsített listázása
Beváltóhely hálózatok listázása az adott időpontban.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- jármű azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- beváltóhely hálózat állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_simplelist_cashing_network_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_cashing_network( now() );
beváltóhely (ukk.cashing_site
)
Mezők ismertetése:
- cashing_network_id - beváltási hálózat / franchise (opcionális)
- short_name - rövid név
- full_name - teljes név (opcionális)
- email_address - elsődleges e-mail cím (opcionális)
- phone_number - elsődleges telefonszám (opcionális)
- zip_code_id - irányítószám
- city_id - település
- country_id - ország
- address_line_1 - cím első sora
- address_line_2 - cím második sora (opcionális)
- description - megjegyzés (opcionális)
Szabályok:
- Nem törölhető, amíg érvényes utalvány-beváltóhely (ukk.lnk_voucher_type_cashing) hivatkozik rá.
ukk.create_cashing_site()
- Új beváltóhely létrehozása
A beváltóhely alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _CashingNetworkId integer -- beváltóhely hálózat
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _EmailAddress varchar -- elsődleges e-mail cím
--* _PhoneNumber varchar -- elsődleges telefonszám
--* _ZipCodeId integer -- irányítószám
--* _CityId integer -- település
--* _CountryId integer -- ország
--* _AddressLine_1 varchar -- cím első sora
--* _AddressLine_2 varchar -- cím második sora
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_cashing_site_001 --Hiányzó paraméter: _ShortName
--* ukk_create_cashing_site_002 --Hiányzó paraméter: _ZipCodeId
--* ukk_create_cashing_site_003 --Nem érvényes (FK) paraméter: _ZipCodeId
--* ukk_create_cashing_site_004 --Hiányzó paraméter: _CityId
--* ukk_create_cashing_site_005 --Nem érvényes (FK) paraméter: _CityId
--* ukk_create_cashing_site_006 --Hiányzó paraméter: _CountryId
--* ukk_create_cashing_site_007 --Nem érvényes (FK) paraméter: _CountryId
--* ukk_create_cashing_site_008 --Hiányzó paraméter: _AddressLine_1
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_cashing_site(
--* 'ukk',
--* 'ukk_cashing_site',
--* 1,
--* null,
--* 1,
--* '660. SZ. ABC EGER',
--* '660. számú ABC EGER',
--* NULL,
--* '+36 56/516-626',
--* 539,
--* 1333,
--* 1,
--* 'Hadnagy út 18.',
--* NULL,
--* NULL
--* );
ukk.edit_cashing_site()
- Létező beváltóhely adatainak módosítása
Létező beváltóhely adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _CashingNetworkId integer -- beváltóhely hálózat
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _EmailAddress varchar -- elsődleges e-mail cím
--* _PhoneNumber varchar -- elsődleges telefonszám
--* _ZipCodeId integer -- irányítószám
--* _CityId integer -- település
--* _CountryId integer -- ország
--* _AddressLine_1 varchar -- cím első sora
--* _AddressLine_2 varchar -- cím második sora
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_cashing_site_001 -- egyedazonosító megadása kötelező
--* ukk_edit_cashing_site_002 -- nem létező beváltóhely
--* ukk_edit_cashing_site_003 -- Nem érvényes (FK) paraméter (érvénytelen kulcs): _CashingNetworkId
--* ukk_edit_cashing_site_004 -- Hiányzó paraméter: _ShortName
--* ukk_edit_cashing_site_005 -- Hiányzó paraméter: _ZipCodeId
--* ukk_edit_cashing_site_006 -- Nem érvényes (FK) paraméter: _ZipCodeId
--* ukk_edit_cashing_site_007 -- Hiányzó paraméter: _CityId
--* ukk_edit_cashing_site_008 -- Nem érvényes (FK) paraméter: _CityId
--* ukk_edit_cashing_site_009 -- Hiányzó paraméter: _CountryId
--* ukk_edit_cashing_site_010 -- Nem érvényes (FK) paraméter: _CountryId
--* ukk_edit_cashing_site_011 -- Hiányzó paraméter: _AddressLine_1
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_cashing_site(
--* 'ukk',
--* 'ukk_cashing_site',
--* 1,
--* NULL,
--* 1,
--* 1,
--* '660. SZ. ABC EGER',
--* '660. számú ABC EGER',
--* NULL,
--* '+36 56/516-626',
--* 539,
--* 1333,
--* 1,
--* 'Hadnagy út 18.',
--* NULL,
--* NULL
--* );
ukk.list_cashing_site()
- Beváltóhelyek listázása
Beváltóhelyek listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* cashing_network_id integer -- beváltóhely hálózat
--* cashing_network_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* address_line_1 varchar -- cím első sora
--* address_line_2 varchar -- cím második sora
--* description varchar -- megjegyzés
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* email_address varchar -- elsődleges e-mail cím
--* phone_number varchar -- elsődleges telefonszám
--* zip_code_id integer -- irányítószám
--* city_id integer -- település
--* country_id integer -- ország
--* lnk_voucher_type_cashing_count integer -- hivatkozó utalvány-beváltóhelyek száma
--*
--* Hibakódok:
--* ukk_list_cashing_site_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_cashing_site( now() );
ukk.read_cashing_site()
- Beváltóhely adatainak visszaadása
Beváltóhely adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar --
--* cashing_network_id integer -- beváltóhely hálózat
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* email_address varchar -- elsődleges e-mail cím
--* phone_number varchar -- elsődleges telefonszám
--* zip_code_id integer -- irányítószám
--* city_id integer -- település
--* country_id integer -- ország
--* address_line_1 varchar -- cím első sora
--* address_line_2 varchar -- cím második sora
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_cashing_site_001 -- egyedazonosító megadása kötelező
--* ukk_read_cashing_site_002 -- nem megfelelő egyedazonosító
--* ukk_read_cashing_site_003 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_cashing_site( 1, now() );
ukk.set_cashing_site()
- Beváltóhely állapotának beállítása
Átírja a beváltóhely állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó csoportosítási cél azonosítója
--* _Status,
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_cashing_site_001 -- egyedazonosító megadása kötelező
--* ukk_set_cashing_site_002 -- nem létező beváltóhely
--* ukk_set_cashing_site_003 -- állapot megadása kötelező
--* ukk_set_cashing_site_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_cashing_site(
--* 'ukk',
--* 'ukk_cashing_site',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_cashing_site()
- Beváltóhelyek egyszerűsített listázása
Beváltóhelyek listázása az adott időpontban.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar --
--* cashing_network_id integer -- beváltóhely hálózat
--* address_line_1 varchar -- cím első sora
--* address_line_2 varchar -- cím második sora
--* description varchar -- megjegyzés
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* email_address varchar -- elsődleges e-mail cím
--* phone_number varchar -- elsődleges telefonszám
--* zip_code_id integer -- irányítószám
--* city_id integer -- település
--* country_id integer -- ország
--*
--* Hibakódok:
--* ukk_simplelist_cashing_site_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_cashing_site( now() );
pénznem (ukk.currency
)
Mezők ismertetése:
- label - azonosító címke üzleti logika számára (kulcsmező)
- short_name - rövid név
- full_name - teljes név (opcionális)
- description - megjegyzés (opcionális)
Szabályok:
- A
label
mező normalizált szöveg, kulcsként használjuk.
- Nem törölhető, amíg aktív címlet (ukk.denomination) hivatkozik rá.
ukk.create_currency()
- Új pénznem létrehozása
A pénznem alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_currency_001 --Hiányzó paraméter: _Label
--* ukk_create_currency_002 --Hiányzó paraméter: _ShortName
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_currency(
--* 'ukk',
--* 'ukk_currency',
--* 1,
--* NULL,
--* 'ft',
--* 'Ft',
--* 'Forint',
--* NULL
--* );
ukk.edit_currency()
- Létező pénznem adatainak módosítása
Létező pénznem adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _Label varchar -- rövid név
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_currency_001 -- egyedazonosító megadása kötelező
--* ukk_edit_currency_002 -- nem létező pénznem
--* ukk_edit_currency_003 -- Hiányzó paraméter: _Label
--* ukk_edit_currency_004 -- Hiányzó paraméter: _ShortName
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_currency(
--* 'ukk',
--* 'ukk_currency',
--* 1,
--* NULL,
--* 2,
--* 'euro',
--* '€',
--* 'Euro',
--* NULL
--* );
ukk.list_currency()
- Pénznemek listázása
Pénznemek listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* -
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--* denomination_count integer -- hivatkozó címletek száma
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_currency();
ukk.read_currency()
- Pénznem adatainak visszaadása
Pénznem adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- jármű azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- pénznem állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_currency_001 -- egyedazonosító megadása kötelező
--* ukk_read_currency_002 -- nem megfelelő egyedazonosító
--* ukk_read_currency_003 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_currency( 1, now() );
ukk.labelread_currency()
- Pénznem adott időpontban érvényes adatainak visszaadása egyedazonosító címke megadásával
Pénznem adott időpontban érvényes adatainak visszaadása egyedazonosító címke megadásával.
--* INPUTS
--* _Label -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_currency_001 -- egyedazonosító címke megadása kötelező
--* ukk_read_currency_002 -- nem megfelelő egyedazonosító
--* ukk_read_currency_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.labelread_currency( 'label' );
ukk.set_currency()
- Pénznem állapotának beállítása
Átírja a pénznem állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó csoportosítási cél azonosítója
--* _Status, -- pénznem állapota (active:aktív, deleted:törölt)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_currency_001 -- egyedazonosító megadása kötelező
--* ukk_set_currency_002 -- nem létező pénznem
--* ukk_set_currency_003 -- állapot megadása kötelező
--* ukk_set_currency_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_currency(
--* 'ukk',
--* 'ukk_currency',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_currency()
- Pénznemek egyszerűsített listázása
Pénznemek listázása az adott időpontban.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- jármű azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- pénznem állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_simplelist_currency_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_currency( now() );
mértékegység (ukk.unit
)
Mezők ismertetése:
- label - azonosító címke üzleti logika számára (kulcsmező)
- short_name - rövid név
- full_name - teljes név (opcionális)
- description - megjegyzés (opcionális)
Szabályok:
- A
label
mező normalizált szöveg, kulcsként használjuk.
- Nem törölhető, amíg aktív címlet (ukk.denomination) hivatkozik rá.
ukk.create_unit()
- Új mértékegység létrehozása
A mértékegység alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_unit_001 --Hiányzó paraméter: _Label
--* ukk_create_unit_002 --Hiányzó paraméter: _ShortName
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_unit(
--* 'ukk',
--* 'ukk_unit',
--* 1,
--* NULL,
--* 'db',
--* 'db',
--* 'darab',
--* NULL
--* );
ukk.edit_unit()
- Létező mértékegység adatainak módosítása
Létező mértékegység adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _Label varchar -- rövid név
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_unit_001 -- egyedazonosító megadása kötelező
--* ukk_edit_unit_002 -- nem létező mértékegység
--* ukk_edit_unit_003 -- Hiányzó paraméter: _Label
--* ukk_edit_unit_004 -- Hiányzó paraméter: _ShortName
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_unit(
--* 'ukk',
--* 'ukk_unit',
--* 1,
--* NULL,
--* 2,
--* 'liter',
--* 'l',
--* 'liter',
--* NULL
--* );
ukk.list_unit()
- Mértékegységek listázása
Mértékegységek listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--* denomination_count integer -- hivatkozó címletek száma
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_unit();
ukk.read_unit()
- Mértékegység adatainak visszaadása
Mértékegység adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- jármű azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- mértékegység állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_unit_001 -- egyedazonosító megadása kötelező
--* ukk_read_unit_002 -- nem megfelelő egyedazonosító
--* ukk_read_unit_003 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_unit( 1, now() );
ukk.labelread_unit()
- Mértékegység adott időpontban érvényes adatainak visszaadása egyedazonosító címke megadásával
Mértékegység adott időpontban érvényes adatainak visszaadása egyedazonosító címke megadásával
--* INPUTS
--* _Label -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_unit_001 -- egyedazonosító címke megadása kötelező
--* ukk_read_unit_002 -- nem megfelelő egyedazonosító
--* ukk_read_unit_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.labelread_unit( 'label' );
ukk.set_unit()
- Mértékegység állapotának beállítása
Átírja a mértékegység állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó csoportosítási cél azonosítója
--* _Status, -- mértékegység állapota (active:aktív, deleted:törölt)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_unit_001 -- egyedazonosító megadása kötelező
--* ukk_set_unit_002 -- nem létező mértékegység
--* ukk_set_unit_003 -- állapot megadása kötelező
--* ukk_set_unit_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_unit(
--* 'ukk',
--* 'ukk_unit',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_unit()
- Mértékegységek egyszerűsített listázása
Mértékegységek listázása az adott időpontban.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- jármű azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- mértékegység állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_simplelist_unit_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_unit( now() );
általános forgalmi adó (ukk.sales_tax
)
Mezők ismertetése:
- label - azonosító címke üzleti logika számára (kulcsmező)
- tax_rate - ÁFA mértéke
- factor - szorzó
- short_name - rövid név
- full_name - teljes név (opcionális)
- description - megjegyzés (opcionális)
Szabályok:
- A
label
mező normalizált szöveg, kulcsként használjuk.
ukk.create_sales_tax()
- Új általános forgalmi adó létrehozása
A általános forgalmi adó alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _TaxRate numeric -- ÁFA mértéke
--* _Factor numeric -- szorzó
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_sales_tax_001 --Hiányzó paraméter: _Label
--* ukk_create_sales_tax_002 --Hiányzó paraméter: _ShortName
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_sales_tax(
--* 'ukk',
--* 'ukk_sales_tax',
--* 1,
--* NULL,
--* '27',
--* 27,
--* 0.2126,
--* '27%',
--* '27 százalékos ÁFA',
--* NULL
--* );
ukk.edit_sales_tax()
- Létező általános forgalmi adó adatainak módosítása
Létező általános forgalmi adó adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _Label varchar -- rövid név
--* _TaxRate numeric -- ÁFA mértéke
--* _Factor numeric -- szorzó
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_sales_tax_001 -- egyedazonosító megadása kötelező
--* ukk_edit_sales_tax_002 -- nem létező ÁFA típus
--* ukk_edit_sales_tax_003 -- Hiányzó paraméter: _Label
--* ukk_edit_sales_tax_004 -- Hiányzó paraméter: _TaxRate
--* ukk_edit_sales_tax_005 -- Hiányzó paraméter: _ShortName
--* ukk_edit_sales_tax_006 -- érvényesség kezdete nem lehet kisebb, mint a tranzakció időpontja
--* ukk_edit_sales_tax_007 -- érvényesség kezdete nem lehet nagyobb vagy egyenlő, mint az érvényesség vége
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_sales_tax(
--* 'ukk',
--* 'ukk_sales_tax',
--* 1,
--* NULL,
--* 2,
--* 'liter',
--* 'l',
--* 'liter',
--* NULL
--* );
ukk.list_sales_tax()
- Általános forgalmi adók listázása
Általános forgalmi adók listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* tax_rate numeric -- ÁFA mértéke
--* factor numeric -- szorzó
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_list_sales_tax_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_sales_tax( now() );
ukk.read_sales_tax()
- Általános forgalmi adó adatainak visszaadása
Általános forgalmi adó adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- jármű azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- általános forgalmi adó állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* tax_rate numeric -- ÁFA mértéke
--* factor numeric -- szorzó
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_sales_tax_001 -- egyedazonosító megadása kötelező
--* ukk_read_sales_tax_002 -- nem megfelelő egyedazonosító
--* ukk_read_sales_tax_003 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_sales_tax( 1, now() );
ukk.set_sales_tax()
- Általános forgalmi adó állapotának beállítása
Átírja a általános forgalmi adó állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó csoportosítási cél azonosítója
--* _Status, -- általános forgalmi adó állapota (active:aktív, deleted:törölt)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_sales_tax_001 -- egyedazonosító megadása kötelező
--* ukk_set_sales_tax_002 -- nem létező általános forgalmi adó
--* ukk_set_sales_tax_003 -- állapot megadása kötelező
--* ukk_set_sales_tax_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_sales_tax(
--* 'ukk',
--* 'ukk_sales_tax',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_sales_tax()
- Általános forgalmi adók egyszerűsített listázása
Általános forgalmi adók listázása az adott időpontban.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- jármű azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- általános forgalmi adó állapota (active:aktív, deleted:törölt)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* tax_rate numeric -- ÁFA mértéke
--* factor numeric -- szorzó
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_simplelist_sales_tax_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_sales_tax( now() );
címlet (ukk.denomination
)
Mezők ismertetése:
- short_name - rövid név (például "500 Ft", "1 évad")
- full_name - teljes név (például "1 évados bérlet") (opcionális)
- par - váltás alapjául szolgáló névérték
- price - ár (opcionális)
- currency_label - pénznem (opcionális)
- is_par_override - névérték utalványtípusonként felülbírálható? (default: hamis)
- is_price_override - ár utalványtípusonként felülbírálható? (default: hamis)
Szabályok:
- TODO: (SQL) Ha az ár meg van adva, akkor a pénznem is kötelező.
- Nem törölhető, amíg érvényes utalványtípus (ukk.voucher_type_denomination) hivatkozik rá.
ukk.create_denomination()
- Új címlet létrehozása
A címlet alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Par numeric -- váltás alapjául szolgáló névérték
--* _Price numeric -- ár
--* _CurrencyLabel varchar -- pénznem
--* _IsParOverride boolean -- névérték utalványtípusonként felülbírálható?
--* _IsPriceOverride boolean -- ár utalványtípusonként felülbírálható?
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_denomination_001 --Hiányzó paraméter: _ShortName
--* ukk_create_denomination_002 --Hiányzó paraméter: _Par
--* ukk_create_denomination_003 --Hiányzó paraméter: _IsParOverride
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_denomination(
--* 'ukk',
--* 'ukk_denomination',
--* 1,
--* null,
--* '500 Ft',
--* '500 forintos utalvány',
--* 500,
--* 500,
--* 'ft',
--* false,
--* false
--* );
ukk.edit_denomination()
- Létező címlet adatainak módosítása
Létező címlet adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Par numeric -- váltás alapjául szolgáló névérték
--* _Price numeric -- ár
--* _CurrencyLabel varchar -- pénznem
--* _IsParOverride boolean -- névérték utalványtípusonként felülbírálható?
--* _IsPriceOverride boolean -- ár utalványtípusonként felülbírálható?
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_denomination_001 -- egyedazonosító megadása kötelező
--* ukk_edit_denomination_002 -- nem létező címlet
--* ukk_edit_denomination_003 -- Hiányzó paraméter: _ShortName
--* ukk_edit_denomination_004 -- Hiányzó paraméter: _Par
--* ukk_edit_denomination_005 -- Nem érvényes (FK) paraméter (érvénytelen kulcs): _CurrencyLabel
--* ukk_edit_denomination_006 -- Hiányzó paraméter: _IsParOverride
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_denomination(
--* 'ukk',
--* 'ukk_denomination',
--* 1,
--* NULL,
--* 1,
--* '500 Ft',
--* '500 forintos utalvány',
--* 500,
--* 500,
--* 'ft',
--* false,
--* false
--* );
ukk.list_denomination()
- Címletek listázása
Címletek listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* par numeric -- váltás alapjául szolgáló névérték
--* price numeric -- ár
--* currency_label varchar -- pénznem
--* currency_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* is_par_override boolean -- névérték utalványtípusonként felülbírálható?
--* is_price_override boolean -- ár utalványtípusonként felülbírálható?
--* voucher_type_denomination_count integer -- hivatkozó lehetséges címletek száma
--*
--* Hibakódok:
--* ukk_list_denomination_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_denomination( now() );
ukk.read_denomination()
- Címlet adatainak visszaadása
Címlet adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota (active, deleted)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* par numeric -- váltás alapjául szolgáló névérték
--* price numeric -- ár
--* currency_label varchar -- pénznem
--* is_par_override boolean -- névérték utalványtípusonként felülbírálható?
--* is_price_override boolean -- ár utalványtípusonként felülbírálható?
--*
--* Hibakódok:
--* ukk_read_denomination_001 -- egyedazonosító megadása kötelező
--* ukk_read_denomination_002 -- nem megfelelő egyedazonosító
--* ukk_read_denomination_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_denomination( 1, now() );
ukk.set_denomination()
- Címlet állapotának beállítása
Átírja a címlet állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó csoportosítási cél azonosítója
--* _Status,
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_denomination_001 -- egyedazonosító megadása kötelező
--* ukk_set_denomination_002 -- nem létező címlet
--* ukk_set_denomination_003 -- állapot megadása kötelező
--* ukk_set_denomination_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_denomination(
--* 'ukk',
--* 'ukk_denomination',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_denomination()
- Címletek egyszerűsített listázása
Címletek listázása az adott időpontban.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* par numeric -- váltás alapjául szolgáló névérték
--* price numeric -- ár
--* currency_label varchar -- pénznem
--* is_par_override boolean -- névérték utalványtípusonként felülbírálható?
--* is_price_override boolean -- ár utalványtípusonként felülbírálható?
--*
--* Hibakódok:
--* ukk_simplelist_denomination_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_denomination( now() );
utalvány-típus (ukk.voucher_type
)
Mezők ismertetése:
- mandator_id - kibocsátó
- short_name - rövid név
- full_name - teljes név (opcionális)
- unit_label - mértékegység
- barcode - vonalkód (opcionális)
- default_validity_date - a jövőben bejegyzendő utalványok alapértelmezett lejárati dátuma (opcionális)
- is_once_used - egyszer felhasználható utalvány?
- url - az utalványtípusra vonatkozó információk elérési útvonala (opcionális)
- safety_notes - biztonsági jegyek, azonosítók szöveges ismertetése (opcionális)
- picture_id - jellemző kép (public.files) (opcionális)
- warning_limit - ezen névérték feletti ügylet risztást vált ki
- description - megjegyzés (opcionális)
Szabályok:
- TODO: (SQL) 'default_validity_date' megadásakor nem lehet múltbéli
ukk.create_voucher_type()
- Új utalványtípus létrehozása
A utalványtípus alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _MandatorLabel varchar -- kibocsátó
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _UnitLabel varchar -- mértékegység
--* _Barcode varchar -- vonalkód
--* _DefaultValidityDate date -- a jövőben bejegyzendő utalványok alapértelmezett lejárati dátuma
--* _IsOnceUsed boolean -- egyszer felhasználható utalvány?
--* _Url varchar -- az utalványtípusra vonatkozó információk elérési útvonala
--* _SafetyNotes varchar -- biztonsági jegyek, azonosítók szöveges ismertetése
--* _PictureId integer -- jellemző kép (public.files)
--* _WarningLimit integer -- ezen névérték feletti ügylet risztást vált ki
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_voucher_type_001 --Hiányzó paraméter: _MandatorLabel
--* ukk_create_voucher_type_002 --Nem érvényes (FK) paraméter: _MandatorLabel
--* ukk_create_voucher_type_003 --Hiányzó paraméter: _ShortName
--* ukk_create_voucher_type_004 --Hiányzó paraméter: _IsOnceUsed
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_voucher_type(
--* 'ukk',
--* 'ukk_voucher_type',
--* 1,
--* null,
--* 1,
--* 'Puebla Sport',
--* 'Puebla Sportutalvány',
--* 'ft',
--* NULL,
--* NULL,
--* true,
--* 'http://puebla.hu/utalvanyaink/utalvany-fajtak',
--* NULL,
--* NULL,
--* 50000,
--* NULL
--* );
ukk.edit_voucher_type()
- Létező utalványtípus adatainak módosítása
Létező utalványtípus adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _MandatorLabel varchar -- kibocsátó
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _UnitLabel varchar -- mértékegység
--* _Barcode varchar -- vonalkód
--* _DefaultValidityDate date -- a jövőben bejegyzendő utalványok alapértelmezett lejárati dátuma
--* _IsOnceUsed boolean -- egyszer felhasználható utalvány?
--* _Url varchar -- az utalványtípusra vonatkozó információk elérési útvonala
--* _SafetyNotes varchar -- biztonsági jegyek, azonosítók szöveges ismertetése
--* _PictureId integer -- jellemző kép (public.files)
--* _WarningLimit integer -- ezen névérték feletti ügylet risztást vált ki
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_voucher_type_001 -- egyedazonosító megadása kötelező
--* ukk_edit_voucher_type_002 -- nem létező utalványtípus
--* ukk_edit_voucher_type_003 -- Hiányzó paraméter: _MandatorLabel
--* ukk_edit_voucher_type_004 -- Nem érvényes (FK) paraméter: _MandatorLabel
--* ukk_edit_voucher_type_005 -- Hiányzó paraméter: _ShortName
--* ukk_edit_voucher_type_006 -- Nem érvényes (FK) paraméter (érvénytelen kulcs): _UnitLabel
--* ukk_edit_voucher_type_007 -- Hiányzó paraméter: _IsOnceUsed
--* ukk_edit_voucher_type_008 -- Nem érvényes (FK) paraméter (érvénytelen kulcs): _PictureId
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_voucher_type(
--* 'ukk',
--* 'ukk_voucher_type',
--* 1,
--* NULL,
--* 1,
--* 1,
--* 'Puebla Sport',
--* 'Puebla Sportutalvány',
--* 'ft',
--* NULL,
--* NULL,
--* true,
--* 'http://puebla.hu/utalvanyaink/utalvany-fajtak',
--* NULL,
--* NULL,
--* 50000,
--* NULL
--* );
ukk.list_voucher_type()
- Utalványtípusok listázása
Utalványtípusok listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* mandator_label varchar -- kibocsátó
--* mandator_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* safety_notes varchar -- biztonsági jegyek, azonosítók szöveges ismertetése
--* picture_id integer -- jellemző kép (public.files)
--* warning_limit integer -- ezen névérték feletti ügylet risztást vált ki
--* description varchar -- megjegyzés
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* unit_label varchar -- mértékegység
--* unit_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* barcode varchar -- vonalkód
--* default_validity_date date -- a jövőben bejegyzendő utalványok alapértelmezett lejárati dátuma
--* is_once_used boolean -- egyszer felhasználható utalvány?
--* url varchar -- az utalványtípusra vonatkozó információk elérési útvonala
--* lnk_voucher_type_cashing_count integer -- hivatkozó utalvány-beváltóhelyek száma
--* pack_voucher_type_count integer -- hivatkozó érintett utalványtípusok száma
--* voucher_type_denomination_count integer -- hivatkozó lehetséges címletek száma
--*
--* Hibakódok:
--* ukk_list_voucher_type_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_voucher_type( now() );
ukk.read_voucher_type()
- Utalványtípus adatainak visszaadása
Utalványtípus adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota (draft, active, deleted)
--* mandator_label varchar -- kibocsátó
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* unit_label varchar -- mértékegység
--* barcode varchar -- vonalkód
--* default_validity_date date -- a jövőben bejegyzendő utalványok alapértelmezett lejárati dátuma
--* is_once_used boolean -- egyszer felhasználható utalvány?
--* url varchar -- az utalványtípusra vonatkozó információk elérési útvonala
--* safety_notes varchar -- biztonsági jegyek, azonosítók szöveges ismertetése
--* picture_id integer -- jellemző kép (public.files)
--* warning_limit integer -- ezen névérték feletti ügylet risztást vált ki
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_voucher_type_001 -- egyedazonosító megadása kötelező
--* ukk_read_voucher_type_002 -- nem megfelelő egyedazonosító
--* ukk_read_voucher_type_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_voucher_type( 1, now() );
ukk.set_voucher_type()
- Utalványtípus állapotának beállítása
Átírja a utalványtípus állapotát a kapott paraméternek megfelelően.
- TODO: Át kell tenni kézibe a tárolt eljárást, az alábbi változással:
- aktiváláskor (azaz ha a bemenő status 'active',) meg kell nézni, hogy tartozik-e hozzá címlet (ukk.voucher_type_denomination)
- ha igen, akkor aktív legyen az új status
- ha nem akkor draft legyen az új status
- a változásokat dokumentálni kell a tárolt eljárásban és a wiki oldalon is!
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (draft, active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_voucher_type_001 -- egyedazonosító megadása kötelező
--* ukk_set_voucher_type_002 -- nem létező utalványtípus
--* ukk_set_voucher_type_003 -- állapot megadása kötelező
--* ukk_set_voucher_type_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_voucher_type(
--* 'ukk',
--* 'ukk_voucher_type',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_voucher_type()
- Utalványtípusok egyszerűsített listázása
Utalványtípusok listázása az adott időpontban.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* mandator_label varchar -- kibocsátó
--* safety_notes varchar -- biztonsági jegyek, azonosítók szöveges ismertetése
--* picture_id integer -- jellemző kép (public.files)
--* warning_limit integer -- ezen névérték feletti ügylet risztást vált ki
--* description varchar -- megjegyzés
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* unit_label varchar -- mértékegység
--* barcode varchar -- vonalkód
--* default_validity_date date -- a jövőben bejegyzendő utalványok alapértelmezett lejárati dátuma
--* is_once_used boolean -- egyszer felhasználható utalvány?
--* url varchar -- az utalványtípusra vonatkozó információk elérési útvonala
--*
--* Hibakódok:
--* ukk_simplelist_voucher_type_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_voucher_type( now() );
utalványtípus lehetséges címlete (ukk.voucher_type_denomination
)
Mezők ismertetése:
- voucher_type_id - utalvány típus
- denomination_id - címlet
- safety_notes - biztonsági jegyek, azonosítók szöveges ismertetése (opcionális)
Szabályok:
- TODO: Ugyanaz a címlet nem lehet egy utalványtípushoz többször hozzárendelve.
- TODO: Címlet addig nem törölhető, amíg innen van rá hivatkozás.
- TODO: Utalványtípus törlésekor e kapcsolótábla kapcsolódó rekordjai is törlődnek.
- TODO: Ha a 'par' mező értéke nincs megadva, akkor az ukk.denomination.par mező alapján kap értéket.
- TODO: Ha a 'price' mező értéke nincs megadva, akkor az ukk.denomination.price mező alapján kap értéket.
ukk.create_voucher_type_denomination()
- Új utalványtípus címlete létrehozása
A utalványtípus címlete alapadatainak rögzítése, aktív státusszal.
--* - ukk_voucher_type_denomination_001: a gyenge egyed meghatározó tulajdonságai nem változhatnak
--* - ukk_voucher_type_denomination_002: a gyenge egyed meghatározó tulajdonságai egyediek kell legyenek
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _VoucherTypeId integer -- utalványtípus
--* _DenominationId integer -- címlet
--* _SafetyNotes varchar -- biztonsági jegyek leírása
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_voucher_type_denomination_001 --Hiányzó paraméter: _VoucherTypeId
--* ukk_create_voucher_type_denomination_002 --Nem érvényes (FK) paraméter: _VoucherTypeId
--* ukk_create_voucher_type_denomination_003 --Hiányzó paraméter: _DenominationId
--* ukk_create_voucher_type_denomination_004 --Nem érvényes (FK) paraméter: _DenominationId
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_voucher_type_denomination(
--* 'ukk',
--* 'ukk_voucher_type_denomination',
--* 1,
--* null,
--* 1,
--* 1,
--* NULL
--* );
ukk.edit_voucher_type_denomination()
- Létező utalványtípus címlete adatainak módosítása
Létező utalványtípus címlete adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _VoucherTypeId integer -- utalványtípus
--* _DenominationId integer -- címlet
--* _SafetyNotes varchar -- biztonsági jegyek leírása
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_voucher_type_denomination_001 -- egyedazonosító megadása kötelező
--* ukk_edit_voucher_type_denomination_002 -- nem létező lehetséges címlet
--* ukk_edit_voucher_type_denomination_003 -- Hiányzó paraméter: _VoucherTypeId
--* ukk_edit_voucher_type_denomination_004 -- Nem érvényes (FK) paraméter: _VoucherTypeId
--* ukk_edit_voucher_type_denomination_005 -- Hiányzó paraméter: _DenominationId
--* ukk_edit_voucher_type_denomination_006 -- Nem érvényes (FK) paraméter: _DenominationId
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_voucher_type_denomination(
--* 'ukk',
--* 'ukk_voucher_type_denomination',
--* 1,
--* NULL,
--* 1,
--* 1,
--* 1,
--* NULL
--* );
ukk.list_voucher_type_denomination()
- Utalványtípus címletek listázása
Utalványtípus címletek listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* -
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* voucher_type_id integer -- utalványtípus
--* voucher_type_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* denomination_id integer -- címlet
--* denomination_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* safety_notes varchar -- biztonsági jegyek leírása
--* pack_denomination_count integer -- hivatkozó érintett címletek száma
--* serial_interval_of_voucher_type_count integer -- hivatkozó érvényes sorszám intervallumok száma
--* voucher_count integer -- hivatkozó utalványok száma
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_voucher_type_denomination();
ukk.read_voucher_type_denomination()
- Utalványtípus címlete adatainak visszaadása
Utalványtípus címlete adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* voucher_type_id integer -- utalványtípus
--* denomination_id integer -- címlet
--* safety_notes varchar -- biztonsági jegyek leírása
--*
--* Hibakódok:
--* ukk_read_voucher_type_denomination_001 -- egyedazonosító megadása kötelező
--* ukk_read_voucher_type_denomination_002 -- nem megfelelő egyedazonosító
--* ukk_read_voucher_type_denomination_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_voucher_type_denomination( 1 );
ukk.set_voucher_type_denomination()
- Utalványtípus címlete állapotának beállítása
Átírja a utalványtípus címlete állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_voucher_type_denomination_001 -- egyedazonosító megadása kötelező
--* ukk_set_voucher_type_denomination_002 -- nem létező lehetséges címlet
--* ukk_set_voucher_type_denomination_003 -- állapot megadása kötelező
--* ukk_set_voucher_type_denomination_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_voucher_type_denomination(
--* 'ukk',
--* 'ukk_voucher_type_denomination',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_voucher_type_denomination()
- Utalványtípus címletek egyszerűsített listázása
Utalványtípus címletek listázása az adott időpontban.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota
--* voucher_type_id integer -- utalványtípus
--* denomination_id integer -- címlet
--* safety_notes varchar -- biztonsági jegyek leírása
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_voucher_type_denomination();
érvényes sorszám intervallum (ukk.serial_interval_of_voucher_type
)
Mezők ismertetése:
- voucher_type_denomination_id - utalványtípus címletének azonosítója
- year_of_release - kibocsátás éve (opcionális)
- validity_date - lejárati dátum
- prefix - előtag (opcionális)
- suffix - utótag (opcionális)
- start_number - kezdő sorszám
- end_number - záró sorszám
Szabályok:
- TODO: voucher_type_denomination_id nem változhat!
- Azonos címleten belül nem lehet átfedés.
- Azonos utalványtípuson belül nem lehet ütközés.
- Azonos Kibocsátón belül nem lehet ütközés.
ukk.create_serial_interval_of_voucher_type()
- Új lehetséges sorszám létrehozása
A lehetséges sorszám alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _VoucherTypeDenominationId integer -- utalványtípus címletének azonosítója
--* _YearOfRelease integer -- kibocsátás éve
--* _ValidityDate date -- lejárat dátuma
--* _Prefix varchar -- előtag
--* _Suffix varchar -- utótag
--* _StartNumber numeric -- kezdő sorszám
--* _EndNumber numeric -- záró sorszám
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_serial_interval_of_voucher_type_001 --Hiányzó paraméter: _VoucherTypeDenominationId
--* ukk_create_serial_interval_of_voucher_type_002 --Nem érvényes (FK) paraméter: _VoucherTypeDenominationId
--* ukk_create_serial_interval_of_voucher_type_003 --Hiányzó paraméter: _ValidityDate
--* ukk_create_serial_interval_of_voucher_type_004 --Hiányzó paraméter: _StartNumber
--* ukk_create_serial_interval_of_voucher_type_005 --Hiányzó paraméter: _EndNumber
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_serial_interval_of_voucher_type(
--* 'ukk',
--* 'ukk_serial_interval_of_voucher_type',
--* 1,
--* null,
--* 1,
--* NULL,
--* 2016-12-31,
--* NULL,
--* NULL,
--* 12220000000,
--* 12220009999
--* );
ukk.edit_serial_interval_of_voucher_type()
- Létező lehetséges sorszám adatainak módosítása
Létező lehetséges sorszám adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _VoucherTypeDenominationId integer -- utalványtípus címletének azonosítója
--* _YearOfRelease integer -- kibocsátás éve
--* _ValidityDate date -- lejárat dátuma
--* _Prefix varchar -- előtag
--* _Suffix varchar -- utótag
--* _StartNumber numeric -- kezdő sorszám
--* _EndNumber numeric -- záró sorszám
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_serial_interval_of_voucher_type_001 -- egyedazonosító megadása kötelező
--* ukk_edit_serial_interval_of_voucher_type_002 -- nem létező érvényes sorszám intervallum
--* ukk_edit_serial_interval_of_voucher_type_003 -- Hiányzó paraméter: _VoucherTypeDenominationId
--* ukk_edit_serial_interval_of_voucher_type_004 -- Nem érvényes (FK) paraméter: _VoucherTypeDenominationId
--* ukk_edit_serial_interval_of_voucher_type_005 -- Hiányzó paraméter: _ValidityDate
--* ukk_edit_serial_interval_of_voucher_type_006 -- Hiányzó paraméter: _StartNumber
--* ukk_edit_serial_interval_of_voucher_type_007 -- Hiányzó paraméter: _EndNumber
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_serial_interval_of_voucher_type(
--* 'ukk',
--* 'ukk_serial_interval_of_voucher_type',
--* 1,
--* NULL,
--* 1,
--* 1,
--* NULL,
--* 2016-12-31,
--* NULL,
--* NULL,
--* 12220000000,
--* 12220009999
--* );
ukk.list_serial_interval_of_voucher_type()
- Lehetséges sorszámok listázása
Lehetséges sorszámok listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* -
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* voucher_type_denomination_id integer -- utalványtípus címletének azonosítója
--* year_of_release integer -- kibocsátás éve
--* validity_date date -- lejárat dátuma
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* start_number numeric -- kezdő sorszám
--* end_number numeric -- záró sorszám
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_serial_interval_of_voucher_type();
ukk.read_serial_interval_of_voucher_type()
- Lehetséges sorszám adatainak visszaadása
Lehetséges sorszám adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* voucher_type_denomination_id integer -- utalványtípus címletének azonosítója
--* year_of_release integer -- kibocsátás éve
--* validity_date date -- lejárat dátuma
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* start_number numeric -- kezdő sorszám
--* end_number numeric -- záró sorszám
--*
--* Hibakódok:
--* ukk_read_serial_interval_of_voucher_type_001-- egyedazonosító megadása kötelező
--* ukk_read_serial_interval_of_voucher_type_002-- nem megfelelő egyedazonosító
--* ukk_read_serial_interval_of_voucher_type_003-- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_serial_interval_of_voucher_type( 1 );
ukk.set_serial_interval_of_voucher_type()
- Lehetséges sorszám állapotának beállítása
Átírja a lehetséges sorszám állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_serial_interval_of_voucher_type_001 -- egyedazonosító megadása kötelező
--* ukk_set_serial_interval_of_voucher_type_002 -- nem létező érvényes sorszám intervallum
--* ukk_set_serial_interval_of_voucher_type_003 -- állapot megadása kötelező
--* ukk_set_serial_interval_of_voucher_type_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_serial_interval_of_voucher_type(
--* 'ukk',
--* 'ukk_serial_interval_of_voucher_type',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_serial_interval_of_voucher_type()
- Lehetséges sorszámok egyszerűsített listázása
Lehetséges sorszámok listázása az adott időpontban.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota
--* voucher_type_denomination_id integer -- utalványtípus címletének azonosítója
--* year_of_release integer -- kibocsátás éve
--* validity_date date -- lejárat dátuma
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* start_number numeric -- kezdő sorszám
--* end_number numeric -- záró sorszám
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_serial_interval_of_voucher_type();
utalványtípus beváltóhelyei (ukk.lnk_voucher_type_cashing
)
Mezők ismertetése:
- voucher_type_id - utalvány típus
- cashing_site_id - beváltóhely
Szabályok:
- A voucher_type_id és a cashing_site_id mezők nem változhatnak.
ukk.create_lnk_voucher_type_cashing()
- Új utalvány beváltóhely létrehozása
A utalvány beváltóhely alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _VoucherTypeId integer -- utalványtípus
--* _CashingSiteId integer -- címlet
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_lnk_voucher_type_cashing_001 --Hiányzó paraméter: _VoucherTypeId
--* ukk_create_lnk_voucher_type_cashing_002 --Nem érvényes (FK) paraméter: _VoucherTypeId
--* ukk_create_lnk_voucher_type_cashing_003 --Hiányzó paraméter: _CashingSiteId
--* ukk_create_lnk_voucher_type_cashing_004 --Nem érvényes (FK) paraméter: _CashingSiteId
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_lnk_voucher_type_cashing(
--* 'ukk',
--* 'ukk_lnk_voucher_type_cashing',
--* 1,
--* null,
--* 1,
--* 1
--* );
ukk.edit_lnk_voucher_type_cashing()
- Létező utalvány beváltóhely adatainak módosítása
Létező utalvány beváltóhely adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _VoucherTypeId integer -- utalványtípus
--* _CashingSiteId integer -- címlet
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_lnk_voucher_type_cashing_001 -- egyedazonosító megadása kötelező
--* ukk_edit_lnk_voucher_type_cashing_002 -- nem létező lehetséges címlet
--* ukk_edit_lnk_voucher_type_cashing_003 -- Hiányzó paraméter: _VoucherTypeId
--* ukk_edit_lnk_voucher_type_cashing_004 -- Nem érvényes (FK) paraméter: _VoucherTypeId
--* ukk_edit_lnk_voucher_type_cashing_005 -- Hiányzó paraméter: _CashingSiteId
--* ukk_edit_lnk_voucher_type_cashing_006 -- Nem érvényes (FK) paraméter: _CashingSiteId
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_lnk_voucher_type_cashing(
--* 'ukk',
--* 'ukk_lnk_voucher_type_cashing',
--* 1,
--* NULL,
--* 1,
--* 1,
--* 1
--* );
ukk.list_lnk_voucher_type_cashing()
- Utalvány-beváltóhelyek listázása
Utalvány-beváltóhelyek listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* voucher_type_id integer -- utalványtípus
--* voucher_type_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* cashing_site_id integer -- címlet
--* cashing_site_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--*
--* Hibakódok:
--* ukk_list_lnk_voucher_type_cashing_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_lnk_voucher_type_cashing( now() );
ukk.read_lnk_voucher_type_cashing()
- Utalvány beváltóhely adatainak visszaadása
Utalvány beváltóhely adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* voucher_type_id integer -- utalványtípus
--* cashing_site_id integer -- címlet
--*
--* Hibakódok:
--* ukk_read_lnk_voucher_type_cashing_001 -- egyedazonosító megadása kötelező
--* ukk_read_lnk_voucher_type_cashing_002 -- nem megfelelő egyedazonosító
--* ukk_read_lnk_voucher_type_cashing_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_lnk_voucher_type_cashing( 1 );
ukk.set_lnk_voucher_type_cashing()
- Utalvány beváltóhely állapotának beállítása
Átírja a utalvány beváltóhely állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_lnk_voucher_type_cashing_001 -- egyedazonosító megadása kötelező
--* ukk_set_lnk_voucher_type_cashing_002 -- nem létező lehetséges címlet
--* ukk_set_lnk_voucher_type_cashing_003 -- állapot megadása kötelező
--* ukk_set_lnk_voucher_type_cashing_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_lnk_voucher_type_cashing(
--* 'ukk',
--* 'ukk_lnk_voucher_type_cashing',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_lnk_voucher_type_cashing()
- Utalvány-beváltóhelyek egyszerűsített listázása
Utalvány-beváltóhelyek listázása az adott időpontban.
--* INPUTS
--* _EID -- egyedazonosító
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota
--* voucher_type_id integer -- utalványtípus
--* cashing_site_id integer -- címlet
--*
--* Hibakódok:
--* ukk_simplelist_lnk_voucher_type_cashing_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_lnk_voucher_type_cashing( now() );
utalvány (ukk.voucher
)
Mezők ismertetése:
- voucher_type_denomination_id - utalvány típus (és névérték) meghatározása
- owner_id - tulajdonosa (opcionális)
- hypothetic_owner_id - nyilvántartott tulajdonosa (opcionális)
- validity_date - lejárati dátum
- barcode - vonalkód (opcionális)
- prefix - előtag (opcionális)
- suffix - utótag (opcionális)
- serial_num - sorszám
Szabályok:
- TODO: lejárati dátum meg kell egyezzen az utalványtípushoz rendelt érvényes sorszámok lejárati dátumával?
ukk.create_voucher()
- Új utalvány létrehozása
A utalvány alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _VoucherTypeDenominationId integer -- utalványtípus címletének azonosítója
--* _OwnerId integer -- nyilvántartott tulajdonosa
--* _HypotheticOwnerId integer -- nyilvántartott tulajdonosa
--* _ValidityDate date -- lejárat dátuma
--* _Barcode varchar -- vonalkód
--* _Prefix varchar -- előtag
--* _Suffix varchar -- utótag
--* _SerialNumber numeric -- sorszám
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_voucher_001 --Hiányzó paraméter: _VoucherTypeDenominationId
--* ukk_create_voucher_002 --Nem érvényes (FK) paraméter: _VoucherTypeDenominationId
--* ukk_create_voucher_003 --Hiányzó paraméter: _SerialNumber
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_voucher(
--* 'ukk',
--* 'ukk_voucher',
--* 1,
--* null,
--* 1,
--* 42,
--* 42,
--* 2016-12-31,
--* NULL,
--* NULL,
--* NULL,
--* 12220000001
--* );
ukk.edit_voucher()
- Létező utalvány adatainak módosítása
Létező utalvány adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _VoucherTypeDenominationId integer -- utalványtípus címletének azonosítója
--* _OwnerId integer -- nyilvántartott tulajdonosa
--* _HypotheticOwnerId integer -- nyilvántartott tulajdonosa
--* _ValidityDate date -- lejárat dátuma
--* _Barcode varchar -- vonalkód
--* _Prefix varchar -- előtag
--* _Suffix varchar -- utótag
--* _SerialNumber numeric -- sorszám
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_voucher_001 -- egyedazonosító megadása kötelező
--* ukk_edit_voucher_002 -- nem létező utalvány
--* ukk_edit_voucher_003 -- Hiányzó paraméter: _VoucherTypeDenominationId
--* ukk_edit_voucher_004 -- Nem érvényes (FK) paraméter: _VoucherTypeDenominationId
--* ukk_edit_voucher_005 -- Nem érvényes (FK) paraméter (érvénytelen kulcs): _OwnerId
--* ukk_edit_voucher_006 -- Nem érvényes (FK) paraméter (érvénytelen kulcs): _HypotheticOwnerId
--* ukk_edit_voucher_007 -- Hiányzó paraméter: _SerialNumber
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_voucher(
--* 'ukk',
--* 'ukk_voucher',
--* 1,
--* NULL,
--* 1,
--* 1,
--* 42,
--* 42,
--* 2016-12-31,
--* NULL,
--* NULL,
--* NULL,
--* 12220000001
--* );
ukk.list_voucher()
- Utalványok listázása
Utalványok listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* voucher_type_denomination_id integer -- utalványtípus címletének azonosítója
--* owner_id integer -- nyilvántartott tulajdonosa
--* hypothetic_owner_id integer -- nyilvántartott tulajdonosa
--* validity_date date -- lejárat dátuma
--* barcode varchar -- vonalkód
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* serial_number numeric -- sorszám
--*
--* Hibakódok:
--* ukk_list_voucher_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_voucher( now() );
ukk.read_voucher()
- Utalvány adatainak visszaadása
Utalvány adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota (active, deleted)
--* voucher_type_denomination_id integer -- utalványtípus címletének azonosítója
--* owner_id integer -- nyilvántartott tulajdonosa
--* hypothetic_owner_id integer -- nyilvántartott tulajdonosa
--* validity_date date -- lejárat dátuma
--* barcode varchar -- vonalkód
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* serial_number numeric -- sorszám
--*
--* Hibakódok:
--* ukk_read_voucher_001 -- egyedazonosító megadása kötelező
--* ukk_read_voucher_002 -- nem megfelelő egyedazonosító
--* ukk_read_voucher_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_voucher( 1, now() );
ukk.set_voucher()
- Utalvány állapotának beállítása
Átírja a utalvány állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_voucher_001 -- egyedazonosító megadása kötelező
--* ukk_set_voucher_002 -- nem létező utalvány
--* ukk_set_voucher_003 -- állapot megadása kötelező
--* ukk_set_voucher_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_voucher(
--* 'ukk',
--* 'ukk_voucher',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_voucher()
- Utalványok egyszerűsített listázása
Utalványok listázása az adott időpontban.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* voucher_type_denomination_id integer -- utalványtípus címletének azonosítója
--* owner_id integer -- nyilvántartott tulajdonosa
--* hypothetic_owner_id integer -- nyilvántartott tulajdonosa
--* validity_date date -- lejárat dátuma
--* barcode varchar -- vonalkód
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* serial_number numeric -- sorszám
--*
--* Hibakódok:
--* ukk_simplelist_voucher_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_voucher( now() );
ajánlatkérés típusa (ukk.offering_type
)
Mezők ismertetése:
- label - azonosító címke üzleti logika számára (kulcsmező)
- short_name - rövid név
- full_name - teljes név (opcionális)
- is_offered_voucher_type_single
- is_offered_voucher_identified
- is_offered_sum_requied
- is_for_voucher_type_single
- is_for_sum_requied
- is_bid_voucher_type_single
- is_bid_voucher_identified
- is_bid_sum_requied
- description - megjegyzés (opcionális)
Indulásnál lehetőségek (üzleti logika implementálása folyamatban):
címke |
Rövid név |
Teljes név |
Leírás |
search |
Keres |
Ismert mennyiségű utalványok keresése (meglévő utalványok cserére ajánlásával) |
Az ajánlatkérés a rendelkezésre álló utalványok feltöltésével és a keresett utalványtípus mennyiségének megadásával kezdeményezhető. |
exchange |
Cserél |
Konkrét utalványok cseréje |
Az ajánlatkérés konkrét (sorszámmal azonosított) utalványok megadásával és a kért utalványtípus kiválasztásával történik. |
offer |
Kínál |
Meglévő utalványok felajánlása az elfogadható utalványtípusok megadásával. |
Az ajánlatkérés meglévő utalványok felajánlásával és a cserére szóba jöhető utalványtípusok megadásával lehetséges. |
ukk.create_offering_type()
- Új ajánlatkérés típus létrehozása
A ajánlatkérés típus alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _IsOfferedVoucherTypeSingle boolean -- felajánlás egy utalványtípusra korlátozódik?
--* _IsOfferedVoucherIdentified boolean -- felajánlás konkrét utalványokra vonatkozik?
--* _IsOfferedSumRequied boolean -- felajánlás összegét meg kell adni?
--* _IsForVoucherTypeSingle boolean -- kérés egy utalványtípusra korlátozódik?
--* _IsForSumRequied boolean -- kérés összegét meg kell adni?
--* _IsBidVoucherTypeSingle boolean -- ajánlat egy utalványtípusra korlátozódik?
--* _IsBidVoucherIdentified boolean -- ajánlat konkrét utalványokra vonatkozik?
--* _IsBidSumRequied boolean -- ajánlat összegét meg kell adni?
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_offering_type_001 --Hiányzó paraméter: _Label
--* ukk_create_offering_type_002 --Hiányzó paraméter: _ShortName
--* ukk_create_offering_type_003 --Hiányzó paraméter: _IsOfferedVoucherTypeSingle
--* ukk_create_offering_type_004 --Hiányzó paraméter: _IsOfferedVoucherIdentified
--* ukk_create_offering_type_005 --Hiányzó paraméter: _IsOfferedSumRequied
--* ukk_create_offering_type_006 --Hiányzó paraméter: _IsForVoucherTypeSingle
--* ukk_create_offering_type_007 --Hiányzó paraméter: _IsForSumRequied
--* ukk_create_offering_type_008 --Hiányzó paraméter: _IsBidVoucherTypeSingle
--* ukk_create_offering_type_009 --Hiányzó paraméter: _IsBidVoucherIdentified
--* ukk_create_offering_type_010 --Hiányzó paraméter: _IsBidSumRequied
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_offering_type(
--* 'ukk',
--* 'ukk_offering_type',
--* 1,
--* null,
--* 'exchange',
--* 'Cserél',
--* 'Konkrét utalványok cseréje',
--* 'true',
--* 'true',
--* 'false',
--* 'true',
--* 'false',
--* 'true',
--* 'false',
--* 'true',
--* 'Az ajánlatkérés konkrét (sorszámmal azonosított) utalványok megadásával és a kért utalványtípus kiválasztásával történik.'
--* );
ukk.edit_offering_type()
- Létező ajánlatkérés típus adatainak módosítása
Létező ajánlatkérés típus adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _IsOfferedVoucherTypeSingle boolean -- felajánlás egy utalványtípusra korlátozódik?
--* _IsOfferedVoucherIdentified boolean -- felajánlás konkrét utalványokra vonatkozik?
--* _IsOfferedSumRequied boolean -- felajánlás összegét meg kell adni?
--* _IsForVoucherTypeSingle boolean -- kérés egy utalványtípusra korlátozódik?
--* _IsForSumRequied boolean -- kérés összegét meg kell adni?
--* _IsBidVoucherTypeSingle boolean -- ajánlat egy utalványtípusra korlátozódik?
--* _IsBidVoucherIdentified boolean -- ajánlat konkrét utalványokra vonatkozik?
--* _IsBidSumRequied boolean -- ajánlat összegét meg kell adni?
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_offering_type_001 -- egyedazonosító megadása kötelező
--* ukk_edit_offering_type_002 -- nem létező ajánlatkérés típusa
--* ukk_edit_offering_type_003 -- Hiányzó paraméter: _Label
--* ukk_edit_offering_type_004 -- Hiányzó paraméter: _ShortName
--* ukk_edit_offering_type_005 -- Hiányzó paraméter: _IsOfferedVoucherTypeSingle
--* ukk_edit_offering_type_006 -- Hiányzó paraméter: _IsOfferedVoucherIdentified
--* ukk_edit_offering_type_007 -- Hiányzó paraméter: _IsOfferedSumRequied
--* ukk_edit_offering_type_008 -- Hiányzó paraméter: _IsForVoucherTypeSingle
--* ukk_edit_offering_type_009 -- Hiányzó paraméter: _IsForSumRequied
--* ukk_edit_offering_type_010 -- Hiányzó paraméter: _IsBidVoucherTypeSingle
--* ukk_edit_offering_type_011 -- Hiányzó paraméter: _IsBidVoucherIdentified
--* ukk_edit_offering_type_012 -- Hiányzó paraméter: _IsBidSumRequied
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_offering_type(
--* 'ukk',
--* 'ukk_offering_type',
--* 1,
--* NULL,
--* 1,
--* 'exchange',
--* 'Cserél',
--* 'Konkrét utalványok cseréje',
--* 'true',
--* 'true',
--* 'false',
--* 'true',
--* 'false',
--* 'true',
--* 'false',
--* 'true',
--* 'Az ajánlatkérés konkrét (sorszámmal azonosított) utalványok megadásával és a kért utalványtípus kiválasztásával történik.'
--* );
ukk.list_offering_type()
- Ajánlatkérés típusok listázása
Ajánlatkérés típusok listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* is_bid_voucher_type_single boolean -- ajánlat egy utalványtípusra korlátozódik?
--* is_bid_voucher_identified boolean -- ajánlat konkrét utalványokra vonatkozik?
--* is_bid_sum_requied boolean -- ajánlat összegét meg kell adni?
--* description varchar -- megjegyzés
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* is_offered_voucher_type_single boolean -- felajánlás egy utalványtípusra korlátozódik?
--* is_offered_voucher_identified boolean -- felajánlás konkrét utalványokra vonatkozik?
--* is_offered_sum_requied boolean -- felajánlás összegét meg kell adni?
--* is_for_voucher_type_single boolean -- kérés egy utalványtípusra korlátozódik?
--* is_for_sum_requied boolean -- kérés összegét meg kell adni?
--* request_offer_count integer -- hivatkozó ajánlatkérések száma
--*
--* Hibakódok:
--* ukk_list_offering_type_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_offering_type( now() );
ukk.read_offering_type()
- Ajánlatkérés típus adatainak visszaadása
Ajánlatkérés típus adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota (active, deleted)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* is_offered_voucher_type_single boolean -- felajánlás egy utalványtípusra korlátozódik?
--* is_offered_voucher_identified boolean -- felajánlás konkrét utalványokra vonatkozik?
--* is_offered_sum_requied boolean -- felajánlás összegét meg kell adni?
--* is_for_voucher_type_single boolean -- kérés egy utalványtípusra korlátozódik?
--* is_for_sum_requied boolean -- kérés összegét meg kell adni?
--* is_bid_voucher_type_single boolean -- ajánlat egy utalványtípusra korlátozódik?
--* is_bid_voucher_identified boolean -- ajánlat konkrét utalványokra vonatkozik?
--* is_bid_sum_requied boolean -- ajánlat összegét meg kell adni?
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_offering_type_001 -- egyedazonosító megadása kötelező
--* ukk_read_offering_type_002 -- nem megfelelő egyedazonosító
--* ukk_read_offering_type_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_offering_type( 1, now() );
ukk.set_offering_type()
- Ajánlatkérés típus állapotának beállítása
Átírja a ajánlatkérés típus állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_offering_type_001 -- egyedazonosító megadása kötelező
--* ukk_set_offering_type_002 -- nem létező ajánlatkérés típusa
--* ukk_set_offering_type_003 -- állapot megadása kötelező
--* ukk_set_offering_type_004 -- status csak active vagy deleted lehet
--* ukk_set_offering_type_005 -- Nem törölhető, mert érvényes rekord hivatkozik rá: ajánlatkérés
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_offering_type(
--* 'ukk',
--* 'ukk_offering_type',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_offering_type()
- Ajánlatkérés típusok egyszerűsített listázása
Ajánlatkérés típusok listázása az adott időpontban.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* is_bid_voucher_type_single boolean -- ajánlat egy utalványtípusra korlátozódik?
--* is_bid_voucher_identified boolean -- ajánlat konkrét utalványokra vonatkozik?
--* is_bid_sum_requied boolean -- ajánlat összegét meg kell adni?
--* description varchar -- megjegyzés
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* is_offered_voucher_type_single boolean -- felajánlás egy utalványtípusra korlátozódik?
--* is_offered_voucher_identified boolean -- felajánlás konkrét utalványokra vonatkozik?
--* is_offered_sum_requied boolean -- felajánlás összegét meg kell adni?
--* is_for_voucher_type_single boolean -- kérés egy utalványtípusra korlátozódik?
--* is_for_sum_requied boolean -- kérés összegét meg kell adni?
--*
--* Hibakódok:
--* ukk_simplelist_offering_type_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_offering_type( now() );
utalvány-csomag (ukk.voucher_pack
)
Mezők ismertetése:
- description - megjegyzés (opcionális)
Szabályok:
- TODO: (SQL) Törléskor nem kell törölni az entitás tartalmát, a listázásnál figyelünk erre.
- TODO: (SQL) Vizsgálni kell, hogy egy csomagban ne lehessen többször ugyanaz a típus (aktív státusszal).
ukk.create_voucher_pack()
- Új utalványcsomag létrehozása
A utalványcsomag alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_voucher_pack(
--* 'ukk',
--* 'ukk_voucher_pack',
--* 1,
--* null,
--* 'Nincs semmi hozzáfűznivalóm.'
--* );
ukk.edit_voucher_pack()
- Létező utalványcsomag adatainak módosítása
Létező utalványcsomag adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_voucher_pack_001 -- egyedazonosító megadása kötelező
--* ukk_edit_voucher_pack_002 -- nem létező utalványcsomag
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_voucher_pack(
--* 'ukk',
--* 'ukk_voucher_pack',
--* 1,
--* NULL,
--* 1,
--* 'Nincs semmi hozzáfűznivalóm.'
--* );
ukk.list_voucher_pack()
- Utalványcsomagok listázása
Utalványcsomagok listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* description varchar -- megjegyzés
--* bid_demand_pack_id_count integer -- hivatkozó ajánlatok száma
--* bid_supply_pack_id_count integer -- hivatkozó ajánlatok száma
--* pack_voucher_type_count integer -- hivatkozó érintett utalványtípusok száma
--* request_offer_demand_pack_id_count integer -- hivatkozó ajánlatkérések száma
--* request_offer_supply_pack_id_count integer -- hivatkozó ajánlatkérések száma
--*
--* Hibakódok:
--* ukk_list_voucher_pack_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_voucher_pack( now() );
ukk.read_voucher_pack()
- Utalványcsomag adatainak visszaadása
Utalványcsomag adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota (draft, active, fail, deleted)
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_voucher_pack_001 -- egyedazonosító megadása kötelező
--* ukk_read_voucher_pack_002 -- nem megfelelő egyedazonosító
--* ukk_read_voucher_pack_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_voucher_pack( 1, now() );
ukk.set_voucher_pack()
- Utalványcsomag állapotának beállítása
Átírja a utalványcsomag állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (draft, active, fail, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_voucher_pack_001 -- egyedazonosító megadása kötelező
--* ukk_set_voucher_pack_002 -- nem létező utalványcsomag
--* ukk_set_voucher_pack_003 -- állapot megadása kötelező
--* ukk_set_voucher_pack_004 -- status csak active vagy deleted lehet
--* ukk_set_voucher_pack_005 -- Nem törölhető, mert érvényes rekord hivatkozik rá: ajánlat
--* ukk_set_voucher_pack_006 -- Nem törölhető, mert érvényes rekord hivatkozik rá: ajánlat
--* ukk_set_voucher_pack_007 -- Nem törölhető, mert érvényes rekord hivatkozik rá: ajánlatkérés
--* ukk_set_voucher_pack_008 -- Nem törölhető, mert érvényes rekord hivatkozik rá: ajánlatkérés
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_voucher_pack(
--* 'ukk',
--* 'ukk_voucher_pack',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_voucher_pack()
- Utalványcsomagok egyszerűsített listázása
Utalványcsomagok listázása az adott időpontban.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_simplelist_voucher_pack_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_voucher_pack( now() );
ajánlatkérés (ukk.request_offer
)
Mezők ismertetése:
- offering_type_id - ajánlatkérés típusa (opcionális)
- outer_person_id - kezdeményező személy
- office_id - bonyolító iroda (opcionális)
- demand_voucher_pack_id - a felajánlott utalványok vagy utalványtípusok
- supply_voucher_pack_id - a keresett utalványtípus(ok) (opcionális)
TODO: status változott, dokumentációba is át kell vezetni.
Szabályok:
- Azt a kérést tekintjük folyamatban lévőnek, ami aktív (lezáratlan) és tartozik hozzá elfogadott ajánlat!
- *RED%TODO: A kérés lezárásakor vizsgálni kell, hogy egy (és csak egy) érvényes ajánlatnak tartoznia kell hozzá.
- *RED%TODO: A kérés lezárásakor vizsgálni kell, hogy az elfogadott ajánlatcsomag fel van töltve sorszámokkal és a csomag érvényes.
ukk.create_request_offer()
- Új ajánlatkérés létrehozása
A ajánlatkérés alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _OfferingTypeId integer -- ajánlatkérés típusa
--* _OuterPersonId integer - kezdeményező személy
--* _OfficeId integer -- bonyolító iroda
--* _DemandVoucherPackId integer -- a felajánlott utalványok vagy utalványtípusok
--* _SupplyVoucherPackId integer -- a keresett utalványok vagy utalványtípusok
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_request_offer_001 --Hiányzó paraméter: _OfferingTypeId
--* ukk_create_request_offer_002 --Nem érvényes (FK) paraméter: _OfferingTypeId
--* ukk_create_request_offer_003 --Hiányzó paraméter: _OuterPersonId
--* ukk_create_request_offer_004 --Nem érvényes (FK) paraméter: _OuterPersonId
--* ukk_create_request_offer_005 --Hiányzó paraméter: _DemandVoucherPackId
--* ukk_create_request_offer_006 --Nem érvényes (FK) paraméter: _DemandVoucherPackId
--* ukk_create_request_offer_007 --Hiányzó paraméter: _SupplyVoucherPackId
--* ukk_create_request_offer_008 --Nem érvényes (FK) paraméter: _SupplyVoucherPackId
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_request_offer(
--* 'ukk',
--* 'ukk_request_offer',
--* 1,
--* null,
--* 1,
--* 42,
--* 1,
--* 1,
--* 2
--* );
ukk.edit_request_offer()
- Létező ajánlatkérés adatainak módosítása
Létező ajánlatkérés adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _OfferingTypeId integer -- ajánlatkérés típusa
--* _OuterPersonId integer - kezdeményező személy
--* _OfficeId integer -- bonyolító iroda
--* _DemandVoucherPackId integer -- a felajánlott utalványok vagy utalványtípusok
--* _SupplyVoucherPackId integer -- a keresett utalványok vagy utalványtípusok
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_request_offer_001 -- egyedazonosító megadása kötelező
--* ukk_edit_request_offer_002 -- nem létező ajánlatkérés
--* ukk_edit_request_offer_003 -- Hiányzó paraméter: _OfferingTypeId
--* ukk_edit_request_offer_004 -- Nem érvényes (FK) paraméter: _OfferingTypeId
--* ukk_edit_request_offer_005 -- Hiányzó paraméter: _OuterPersonId
--* ukk_edit_request_offer_006 -- Nem érvényes (FK) paraméter: _OuterPersonId
--* ukk_edit_request_offer_007 -- Nem érvényes (FK) paraméter (érvénytelen kulcs): _OfficeId
--* ukk_edit_request_offer_008 -- Hiányzó paraméter: _DemandVoucherPackId
--* ukk_edit_request_offer_009 -- Nem érvényes (FK) paraméter: _DemandVoucherPackId
--* ukk_edit_request_offer_010 -- Hiányzó paraméter: _SupplyVoucherPackId
--* ukk_edit_request_offer_011 -- Nem érvényes (FK) paraméter: _SupplyVoucherPackId
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_request_offer(
--* 'ukk',
--* 'ukk_request_offer',
--* 1,
--* NULL,
--* 1,
--* 1,
--* 42,
--* 1,
--* 1,
--* 2
--* );
ukk.list_request_offer()
- Ajánlatkérések listázása
Ajánlatkérések listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* offering_type_id integer -- ajánlatkérés típusa
--* offering_type_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* outer_person_id integer -- kezdeményező személy
--* office_id integer -- bonyolító iroda
--* office_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* demand_voucher_pack_id integer -- a felajánlott utalványok vagy utalványtípusok
--* supply_voucher_pack_id integer -- a keresett utalványok vagy utalványtípusok
--* bid_count integer -- hivatkozó ajánlatok száma
--*
--* Hibakódok:
--* ukk_list_request_offer_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_request_offer( now() );
ukk.read_request_offer()
- Ajánlatkérés adatainak visszaadása
Ajánlatkérés adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota (active, deleted)
--* offering_type_id integer -- ajánlatkérés típusa
--* outer_person_id integer -- kezdeményező személy
--* office_id integer -- bonyolító iroda
--* demand_voucher_pack_id integer -- a felajánlott utalványok vagy utalványtípusok
--* supply_voucher_pack_id integer -- a keresett utalványok vagy utalványtípusok
--*
--* Hibakódok:
--* ukk_read_request_offer_001 -- egyedazonosító megadása kötelező
--* ukk_read_request_offer_002 -- nem megfelelő egyedazonosító
--* ukk_read_request_offer_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_request_offer( 1, now() );
ukk.set_request_offer()
- Ajánlatkérés állapotának beállítása
Átírja a ajánlatkérés állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_request_offer_001 -- egyedazonosító megadása kötelező
--* ukk_set_request_offer_002 -- nem létező ajánlatkérés
--* ukk_set_request_offer_003 -- állapot megadása kötelező
--* ukk_set_request_offer_004 -- status csak active vagy deleted lehet
--* ukk_set_request_offer_005 -- Nem törölhető, mert érvényes rekord hivatkozik rá: ajánlat
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_request_offer(
--* 'ukk',
--* 'ukk_request_offer',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_request_offer()
- Ajánlatkérések egyszerűsített listázása
Ajánlatkérések listázása az adott időpontban.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* offering_type_id integer -- ajánlatkérés típusa
--* outer_person_id integer -- kezdeményező személy
--* office_id integer -- bonyolító iroda
--* demand_voucher_pack_id integer -- a felajánlott utalványok vagy utalványtípusok
--* supply_voucher_pack_id integer -- a keresett utalványok vagy utalványtípusok
--*
--* Hibakódok:
--* ukk_simplelist_request_offer_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_request_offer( now() );
olvasott ajánlatkérés (ukk.read_offer
)
Mezők ismertetése:
- request_offer_id - az ajánlatkérés, amire az ajánlat vonatkozik
- outer_person_id - az ajánlattevő személy
TODO: üzleti logika fogja írni (2. kör)
Szabályok:
- *RED%TODO: A két kulcs együtt egyedi
ajánlat (ukk.bid
)
Mezők ismertetése:
- request_offer_id - az ajánlatkérés, amire az ajánlat vonatkozik
- outer_person_id - az ajánlattevő személy
- demand_voucher_pack_id - a felajánlott utalványok vagy utalványtípusok
- supply_voucher_pack_id - az ajánlott utalvány-csomag
- is_read - igaz, ha a kérés kezdeményzője olvasta
TODO: status változott, dokumentációba is át kell vezetni.
TODO: az
is_read
mezőt üzleti logika fogja írni (2. kör)
Szabályok:
- *RED%TODO: A demand_voucher_pack_id megegyezhet az ajánlatkérés demand_voucher_pack_id értékével.
- *RED%TODO: A outer_person_id nem egyezhet meg a hivatkozott request_offer tábla outer_person_id mezőjével.
- *RED%TODO: Ajánlat elfogadásakor a testvér ajánlatokat el kell utasítani.
ukk.create_bid()
- Új ajánlat létrehozása
A ajánlat alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _RequestOfferId integer -- ajánlatkérés
--* _OuterPersonId integer -- kezdeményező személy
--* _DemandVoucherPackId integer -- a kért utalványok vagy utalványtípusok
--* _SupplyVoucherPackId integer -- az ajánlott utalványok vagy utalványtípusok
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_bid_001 --Hiányzó paraméter: _RequestOfferId
--* ukk_create_bid_002 --Nem érvényes (FK) paraméter: _RequestOfferId
--* ukk_create_bid_003 --Hiányzó paraméter: _OuterPersonId
--* ukk_create_bid_004 --Nem érvényes (FK) paraméter: _OuterPersonId
--* ukk_create_bid_005 --Hiányzó paraméter: _DemandVoucherPackId
--* ukk_create_bid_006 --Nem érvényes (FK) paraméter: _DemandVoucherPackId
--* ukk_create_bid_007 --Hiányzó paraméter: _SupplyVoucherPackId
--* ukk_create_bid_008 --Nem érvényes (FK) paraméter: _SupplyVoucherPackId
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_bid(
--* 'ukk',
--* 'ukk_bid',
--* 1,
--* null,
--* 1,
--* 41,
--* 1,
--* 2,
--* NULL
--* );
ukk.edit_bid()
- Létező ajánlat adatainak módosítása
Létező ajánlat adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _RequestOfferId integer -- ajánlatkérés
--* _OuterPersonId integer -- kezdeményező személy
--* _DemandVoucherPackId integer -- a kért utalványok vagy utalványtípusok
--* _SupplyVoucherPackId integer -- az ajánlott utalványok vagy utalványtípusok
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_bid_001 -- egyedazonosító megadása kötelező
--* ukk_edit_bid_002 -- nem létező ajánlat
--* ukk_edit_bid_003 -- Hiányzó paraméter: _RequestOfferId
--* ukk_edit_bid_004 -- Nem érvényes (FK) paraméter: _RequestOfferId
--* ukk_edit_bid_005 -- Hiányzó paraméter: _OuterPersonId
--* ukk_edit_bid_006 -- Nem érvényes (FK) paraméter: _OuterPersonId
--* ukk_edit_bid_007 -- Hiányzó paraméter: _DemandVoucherPackId
--* ukk_edit_bid_008 -- Nem érvényes (FK) paraméter: _DemandVoucherPackId
--* ukk_edit_bid_009 -- Hiányzó paraméter: _SupplyVoucherPackId
--* ukk_edit_bid_010 -- Nem érvényes (FK) paraméter: _SupplyVoucherPackId
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_bid(
--* 'ukk',
--* 'ukk_bid',
--* 1,
--* NULL,
--* 1,
--* 1,
--* 41,
--* 1,
--* 2,
--* NULL
--* );
ukk.list_bid()
- Ajánlatok listázása
Ajánlatok listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* request_offer_id integer -- ajánlatkérés
--* outer_person_id integer -- kezdeményező személy
--* demand_voucher_pack_id integer -- a kért utalványok vagy utalványtípusok
--* supply_voucher_pack_id integer -- az ajánlott utalványok vagy utalványtípusok
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_list_bid_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_bid( now() );
ukk.read_bid()
- Ajánlat adatainak visszaadása
Ajánlat adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota (draft, active, accepted, rejected, closed, deleted)
--* request_offer_id integer -- ajánlatkérés
--* outer_person_id integer -- kezdeményező személy
--* demand_voucher_pack_id integer -- a kért utalványok vagy utalványtípusok
--* supply_voucher_pack_id integer -- az ajánlott utalványok vagy utalványtípusok
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_bid_001 -- egyedazonosító megadása kötelező
--* ukk_read_bid_002 -- nem megfelelő egyedazonosító
--* ukk_read_bid_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_bid( 1, now() );
ukk.set_bid()
- Ajánlat állapotának beállítása
Átírja a ajánlat állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (draft, active, accepted, rejected, closed, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_bid_001 -- egyedazonosító megadása kötelező
--* ukk_set_bid_002 -- nem létező ajánlat
--* ukk_set_bid_003 -- állapot megadása kötelező
--* ukk_set_bid_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_bid(
--* 'ukk',
--* 'ukk_bid',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_bid()
- Ajánlatok egyszerűsített listázása
Ajánlatok listázása az adott időpontban.
--* INPUTS
--* _WhenTime timestamp with time zone -- a kért időpont
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* valid_from_time timestamp with time zone -- idősoros kezelés esetén az érvényesség kezdete
--* status varchar -- egyed állapota
--* request_offer_id integer -- ajánlatkérés
--* outer_person_id integer -- kezdeményező személy
--* demand_voucher_pack_id integer -- a kért utalványok vagy utalványtípusok
--* supply_voucher_pack_id integer -- az ajánlott utalványok vagy utalványtípusok
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_simplelist_bid_001 -- időpont megadása kötelező
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_bid( now() );
érintett utalványtípus (ukk.pack_voucher_type
)
Mezők ismertetése:
- voucher_pack_id - utalvány csomag
- voucher_type_id - utalványtípus
- par - érték (opcionális)
- quantity - mennyiség (opcionális)
Szabályok:
- TODO: A rekord állapota alapértelmezetten 'active', kivéve, ha az értéke ÉS a nevesített utalványok értéke (azaz a címletek és sorozatszámok) is meg vannak adva.
- Ha az érték változik, akkor vizsgálni kell a kapcsolódó 'pack_denomination.par' mező értékeit.
- Mindaddig 'draft', amíg a nevesített utalványok értéke ('pack_denomination.par' mező) meg nem egyezik jelen rekord 'par' mezőjének értékével.
ukk.create_pack_voucher_type()
- Új érintett utaványtípus létrehozása
A érintett utaványtípus alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _MandatorLabel varchar -- kibocsátó
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _UnitLabel varchar -- mértékegység
--* _Barcode varchar -- vonalkód
--* _DefaultValidityDate date -- a jövőben bejegyzendő utalványok alapértelmezett lejárati dátuma
--* _IsOnceUsed boolean -- egyszer felhasználható utalvány?
--* _Url varchar -- az utalványtípusra vonatkozó információk elérési útvonala
--* _SafetyNotes varchar -- biztonsági jegyek, azonosítók szöveges ismertetése
--* _PictureId integer -- jellemző kép (public.files)
--* _WarningLimit integer -- ezen névérték feletti ügylet riasztást vált ki
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_voucher_type_001 --Hiányzó paraméter: _MandatorLabel
--* ukk_create_voucher_type_002 --Nem érvényes (FK) paraméter: _MandatorLabel
--* ukk_create_voucher_type_003 --Hiányzó paraméter: _ShortName
--* ukk_create_voucher_type_004 --Hiányzó paraméter: _IsOnceUsed
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_voucher_type(
--* 'ukk',
--* 'ukk_voucher_type',
--* 1,
--* null,
--* 1,
--* 'Puebla Sport',
--* 'Puebla Sportutalvány',
--* 'ft',
--* NULL,
--* NULL,
--* true,
--* 'http://puebla.hu/utalvanyaink/utalvany-fajtak',
--* NULL,
--* NULL,
--* 50000,
--* NULL
--* );
ukk.edit_pack_voucher_type()
- Létező érintett utaványtípus adatainak módosítása
Létező érintett utaványtípus adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _VoucherPackId integer -- utalvány csomag
--* _VoucherTypeId integer -- utalványtípus
--* _Par numeric -- érték
--* _Quantity integer -- mennyiség
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_pack_voucher_type_001 -- egyedazonosító megadása kötelező
--* ukk_edit_pack_voucher_type_002 -- nem létező érintett utalványtípus
--* ukk_edit_pack_voucher_type_003 -- Hiányzó paraméter: _VoucherPackId
--* ukk_edit_pack_voucher_type_004 -- Nem érvényes (FK) paraméter: _VoucherPackId
--* ukk_edit_pack_voucher_type_005 -- Hiányzó paraméter: _VoucherTypeId
--* ukk_edit_pack_voucher_type_006 -- Nem érvényes (FK) paraméter: _VoucherTypeId
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_pack_voucher_type(
--* 'ukk',
--* 'ukk_pack_voucher_type',
--* 1,
--* NULL,
--* 1,
--* 1,
--* 1,
--* NULL,
--* NULL
--* );
ukk.list_pack_voucher_type()
- Érintett utaványtípusok listázása
Érintett utaványtípusok listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* -
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* voucher_pack_id integer -- utalvány csomag
--* voucher_type_id integer -- utalványtípus
--* voucher_type_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* par numeric -- érték
--* quantity integer -- mennyiség
--* pack_denomination_count integer -- hivatkozó érintett címletek száma
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_pack_voucher_type();
ukk.read_pack_voucher_type()
- Érintett utaványtípus adatainak visszaadása
Érintett utaványtípus adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* voucher_pack_id integer -- utalvány csomag
--* voucher_type_id integer -- utalványtípus
--* par numeric -- érték
--* quantity integer -- mennyiség
--*
--* Hibakódok:
--* ukk_read_pack_voucher_type_001 -- egyedazonosító megadása kötelező
--* ukk_read_pack_voucher_type_002 -- nem megfelelő egyedazonosító
--* ukk_read_pack_voucher_type_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_pack_voucher_type( 1 );
ukk.set_pack_voucher_type()
- Érintett utaványtípus állapotának beállítása
Átírja a érintett utaványtípus állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_pack_voucher_type_001 -- egyedazonosító megadása kötelező
--* ukk_set_pack_voucher_type_002 -- nem létező érintett utalványtípus
--* ukk_set_pack_voucher_type_003 -- állapot megadása kötelező
--* ukk_set_pack_voucher_type_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_pack_voucher_type(
--* 'ukk',
--* 'ukk_pack_voucher_type',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_pack_voucher_type()
- Érintett utaványtípusok egyszerűsített listázása
Érintett utaványtípusok listázása az adott időpontban.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota
--* voucher_pack_id integer -- utalvány csomag
--* voucher_type_id integer -- utalványtípus
--* par numeric -- érték
--* quantity integer -- mennyiség
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_pack_voucher_type();
érintett címlet (ukk.pack_denomination
)
Mezők ismertetése:
- pack_voucher_type_id - érintett utalványtípus
- voucher_type_denomination_id - lehetséges címlet
- par - érték (opcionális)
Szabályok:
- TODO: A
par
mező értékét trigger állítja (ha van utalvány azonosítva).
- TODO: Változás esetén vizsgálni kell a kapcsolódó 'pack_voucher_type.par' mező értékét, és a kapcsolódó rekord státuszát állítani.
- TODO: (SQL) Törléskor nem kell törölni az entitás tartalmát, a listázásnál figyelünk erre.
- TODO: (SQL) Vizsgálni kell, hogy egy utalványtípusban ne lehessen többször ugyanaz a címlet (aktív státusszal).
- TODO: (SQL) Törléskor törölni kell a befoglaló típust is, ha az üres maradna.
ukk.create_pack_denomination()
- Új érintett címlet létrehozása
A érintett címlet alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _PackVoucherTypeId integer -- érintett utalványtípus
--* _DenominationId integer -- címlet
--* _Par numeric -- érték
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_pack_denomination_001 --Hiányzó paraméter: _PackVoucherTypeId
--* ukk_create_pack_denomination_002 --Nem érvényes (FK) paraméter: _PackVoucherTypeId
--* ukk_create_pack_denomination_003 --Hiányzó paraméter: _DenominationId
--* ukk_create_pack_denomination_004 --Nem érvényes (FK) paraméter: _DenominationId
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_pack_denomination(
--* 'ukk',
--* 'ukk_pack_denomination',
--* 1,
--* null,
--* 1,
--* 1,
--* NULL
--* );
ukk.edit_pack_denomination()
- Létező érintett címlet adatainak módosítása
Létező érintett címlet adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _PackVoucherTypeId integer -- érintett utalványtípus
--* _DenominationId integer -- címlet
--* _Par numeric -- érték
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_pack_denomination_001 -- egyedazonosító megadása kötelező
--* ukk_edit_pack_denomination_002 -- nem létező érintett címlet
--* ukk_edit_pack_denomination_003 -- Hiányzó paraméter: _PackVoucherTypeId
--* ukk_edit_pack_denomination_004 -- Nem érvényes (FK) paraméter: _PackVoucherTypeId
--* ukk_edit_pack_denomination_005 -- Hiányzó paraméter: _DenominationId
--* ukk_edit_pack_denomination_006 -- Nem érvényes (FK) paraméter: _DenominationId
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_pack_denomination(
--* 'ukk',
--* 'ukk_pack_denomination',
--* 1,
--* NULL,
--* 1,
--* 1,
--* 1,
--* NULL
--* );
ukk.list_pack_denomination()
- Érintett címletek listázása
Érintett címletek listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* -
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* pack_voucher_type_id integer -- érintett utalványtípus
--* denomination_id integer -- címlet
--* denomination_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* par numeric -- érték
--* serial_interval_of_pack_count integer -- hivatkozó csomagban szereplő sorszám intervallumok száma
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_pack_denomination();
ukk.read_pack_denomination()
- Érintett címlet adatainak visszaadása
Érintett címlet adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* pack_voucher_type_id integer -- érintett utalványtípus
--* denomination_id integer -- címlet
--* par numeric -- érték
--*
--* Hibakódok:
--* ukk_read_pack_denomination_001 -- egyedazonosító megadása kötelező
--* ukk_read_pack_denomination_002 -- nem megfelelő egyedazonosító
--* ukk_read_pack_denomination_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_pack_denomination( 1 );
ukk.set_pack_denomination()
- Érintett címlet állapotának beállítása
Átírja a érintett címlet állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_pack_denomination_001 -- egyedazonosító megadása kötelező
--* ukk_set_pack_denomination_002 -- nem létező érintett címlet
--* ukk_set_pack_denomination_003 -- állapot megadása kötelező
--* ukk_set_pack_denomination_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_pack_denomination(
--* 'ukk',
--* 'ukk_pack_denomination',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_pack_denomination()
- Érintett címletek egyszerűsített listázása
Érintett címletek listázása az adott időpontban.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota
--* pack_voucher_type_id integer -- érintett utalványtípus
--* denomination_id integer -- címlet
--* par numeric -- érték
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_pack_denomination();
sorszám intervallum a csomagban (ukk.serial_interval_of_pack
)
Mezők ismertetése:
- pack_denomination_id - utalványcsomagban szereplő utalványtípus címlete (opcionális)
- year_of_release - kibocsátás éve (opcionális)
- validity_date - lejárati dátum
- prefix - előtag (opcionális)
- suffix - utótag (opcionális)
- start_number - kezdő sorszám
- end_number - záró sorszám
Szabályok:
- TODO: a pack_denomination_id nem változhat!
- TODO: (SQL) Törléskor törölni kell a befoglaló típust is, ha az üres maradna.
ukk.create_serial_interval_of_pack()
- Új sorszám intervallum a csomagban létrehozása
A sorszám intervallum a csomagban alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _PackDenominationId integer -- csomagban szereplő utalványtípus címletének azonosítója
--* _ValidityDate date -- lejárat dátuma
--* _Prefix varchar -- előtag
--* _Suffix varchar -- utótag
--* _StartNumber numeric -- kezdő sorszám
--* _EndNumber numeric -- záró sorszám
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_serial_interval_of_pack_001 --Hiányzó paraméter: _PackDenominationId
--* ukk_create_serial_interval_of_pack_002 --Nem érvényes (FK) paraméter: _PackDenominationId
--* ukk_create_serial_interval_of_pack_003 --Hiányzó paraméter: _StartNumber
--* ukk_create_serial_interval_of_pack_004 --Hiányzó paraméter: _EndNumber
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_serial_interval_of_pack(
--* 'ukk',
--* 'ukk_serial_interval_of_pack',
--* 1,
--* null,
--* 1,
--* 2016-12-31,
--* NULL,
--* NULL,
--* 12220000000,
--* 12220009999
--* );
ukk.edit_serial_interval_of_pack()
- Létező sorszám intervallum a csomagban adatainak módosítása
Létező sorszám intervallum a csomagban adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _PackDenominationId integer -- csomagban szereplő utalványtípus címletének azonosítója
--* _ValidityDate date -- lejárat dátuma
--* _Prefix varchar -- előtag
--* _Suffix varchar -- utótag
--* _StartNumber numeric -- kezdő sorszám
--* _EndNumber numeric -- záró sorszám
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_serial_interval_of_pack_001 -- egyedazonosító megadása kötelező
--* ukk_edit_serial_interval_of_pack_002 -- nem létező csomagban szereplő sorszám intervallum
--* ukk_edit_serial_interval_of_pack_003 -- Hiányzó paraméter: _PackDenominationId
--* ukk_edit_serial_interval_of_pack_004 -- Nem érvényes (FK) paraméter: _PackDenominationId
--* ukk_edit_serial_interval_of_pack_005 -- Hiányzó paraméter: _StartNumber
--* ukk_edit_serial_interval_of_pack_006 -- Hiányzó paraméter: _EndNumber
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_serial_interval_of_pack(
--* 'ukk',
--* 'ukk_serial_interval_of_pack',
--* 1,
--* NULL,
--* 1,
--* 1,
--* 2016-12-31,
--* NULL,
--* NULL,
--* 12220000000,
--* 12220009999
--* );
ukk.list_serial_interval_of_pack()
- Sorszám intervallumok a csomagban listázása
Sorszám intervallumok a csomagban listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* -
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* pack_denomination_id integer -- csomagban szereplő utalványtípus címletének azonosítója
--* validity_date date -- lejárat dátuma
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* start_number numeric -- kezdő sorszám
--* end_number numeric -- záró sorszám
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_serial_interval_of_pack();
ukk.read_serial_interval_of_pack()
- Sorszám intervallum a csomagban adatainak visszaadása
Sorszám intervallum a csomagban adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* pack_denomination_id integer -- csomagban szereplő utalványtípus címletének azonosítója
--* validity_date date -- lejárat dátuma
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* start_number numeric -- kezdő sorszám
--* end_number numeric -- záró sorszám
--*
--* Hibakódok:
--* ukk_read_serial_interval_of_pack_001 -- egyedazonosító megadása kötelező
--* ukk_read_serial_interval_of_pack_002 -- nem megfelelő egyedazonosító
--* ukk_read_serial_interval_of_pack_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_serial_interval_of_pack( 1 );
ukk.set_serial_interval_of_pack()
- Sorszám intervallum a csomagban állapotának beállítása
Átírja a sorszám intervallum a csomagban állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_serial_interval_of_pack_001 -- egyedazonosító megadása kötelező
--* ukk_set_serial_interval_of_pack_002 -- nem létező csomagban szereplő sorszám intervallum
--* ukk_set_serial_interval_of_pack_003 -- állapot megadása kötelező
--* ukk_set_serial_interval_of_pack_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_serial_interval_of_pack(
--* 'ukk',
--* 'ukk_serial_interval_of_pack',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_serial_interval_of_pack()
- Sorszám intervallumok a csomagban egyszerűsített listázása
Sorszám intervallumok a csomagban listázása az adott időpontban.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota
--* pack_denomination_id integer -- csomagban szereplő utalványtípus címletének azonosítója
--* validity_date date -- lejárat dátuma
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* start_number numeric -- kezdő sorszám
--* end_number numeric -- záró sorszám
--*
--* Hibakódok:
--* ukk_simplelist_serial_interval_of_pack_001 -- időpont megadása kötelező
eseménytípus (ukk.event_type
)
Mezők ismertetése:
- label - azonosító címke üzleti logika számára (kulcsmező)
- short_name - rövid név
- full_name - teljes név (opcionális)
- transaction_status - ügylet állapotát erre állítja
- is_close_transaction - lezárja a tranzakciót?
- color_code - színkód a felületen (opcionális)
- is_show - ha igaz, akkor a ügylet vagy utalvány eseménylistájában megjelenik
- description - megjegyzés (opcionális)
Szabályok:
- TODO: A
label
mező normalizált szöveg, kulcsként használjuk.
ukk.create_event_type()
- Új eseménytípus létrehozása
A eseménytípus alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _TransactionStatus varchar -- ügylet állapotát erre kell állítani
--* _IsCloseTransaction boolean -- lezárja a tranzakciót?
--* _ColorCode varchar -- színkód a felületen
--* _IsShow boolean -- ha igaz, akkor az ügyfél eseménylistájában megjelenik
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_event_type_001 --Hiányzó paraméter: _Label
--* ukk_create_event_type_002 --Hiányzó paraméter: _ShortName
--* ukk_create_event_type_003 --Hiányzó paraméter: _IsCloseTransaction
--* ukk_create_event_type_004 --Hiányzó paraméter: _IsShow
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_event_type(
--* 'ukk',
--* 'ukk_event_type',
--* 1,
--* null,
--* 'ft',
--* 'Ft',
--* 'Forint',
--* fail,
--* false,
--* #ff0000,
--* false,
--* NULL
--* );
ukk.edit_event_type()
- Létező eseménytípus adatainak módosítása
Létező eseménytípus adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _TransactionStatus varchar -- ügylet állapotát erre kell állítani
--* _IsCloseTransaction boolean -- lezárja a tranzakciót?
--* _ColorCode varchar -- színkód a felületen
--* _IsShow boolean -- ha igaz, akkor az ügyfél eseménylistájában megjelenik
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_event_type_001 -- egyedazonosító megadása kötelező
--* ukk_edit_event_type_002 -- nem létező eseménytípus
--* ukk_edit_event_type_003 -- Hiányzó paraméter: _Label
--* ukk_edit_event_type_004 -- Hiányzó paraméter: _ShortName
--* ukk_edit_event_type_005 -- Hiányzó paraméter: _IsCloseTransaction
--* ukk_edit_event_type_006 -- Hiányzó paraméter: _IsShow
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_event_type(
--* 'ukk',
--* 'ukk_event_type',
--* 1,
--* NULL,
--* 1,
--* 'ft',
--* 'Ft',
--* 'Forint',
--* fail,
--* false,
--* #ff0000,
--* false,
--* NULL
--* );
ukk.list_event_type()
- Eseménytípusok listázása
Eseménytípusok listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* -
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* transaction_status varchar -- ügylet állapotát erre kell állítani
--* is_close_transaction boolean -- lezárja a tranzakciót?
--* color_code varchar -- színkód a felületen
--* is_show boolean -- ha igaz, akkor az ügyfél eseménylistájában megjelenik
--* description varchar -- megjegyzés
--* event_count integer -- hivatkozó események száma
--* lnk_event_message_count integer -- hivatkozó utalvány-beváltóhelyek száma
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_event_type();
ukk.read_event_type()
- Eseménytípus adatainak visszaadása
Eseménytípus adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* transaction_status varchar -- ügylet állapotát erre kell állítani
--* is_close_transaction boolean -- lezárja a tranzakciót?
--* color_code varchar -- színkód a felületen
--* is_show boolean -- ha igaz, akkor az ügyfél eseménylistájában megjelenik
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_event_type_001 -- egyedazonosító megadása kötelező
--* ukk_read_event_type_002 -- nem megfelelő egyedazonosító
--* ukk_read_event_type_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_event_type( 1 );
ukk.set_event_type()
- Eseménytípus állapotának beállítása
Átírja a eseménytípus állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_event_type_001 -- egyedazonosító megadása kötelező
--* ukk_set_event_type_002 -- nem létező eseménytípus
--* ukk_set_event_type_003 -- állapot megadása kötelező
--* ukk_set_event_type_004 -- status csak active vagy deleted lehet
--* ukk_set_event_type_005 -- Nem törölhető, mert érvényes rekord hivatkozik rá: esemény
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_event_type(
--* 'ukk',
--* 'ukk_event_type',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_event_type()
- Eseménytípusok egyszerűsített listázása
Eseménytípusok listázása az adott időpontban.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* transaction_status varchar -- ügylet állapotát erre kell állítani
--* is_close_transaction boolean -- lezárja a tranzakciót?
--* color_code varchar -- színkód a felületen
--* is_show boolean -- ha igaz, akkor az ügyfél eseménylistájában megjelenik
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_event_type();
esemény (ukk.event
)
Mezők ismertetése:
- event_type_label - esemény-típus
- request_offer_id - ajánlatkérés
- user_id - felhasználó
- voucher_pack_id - utalványcsomag
- description - megjegyzés
Az ukk.event.voucher_pack_id és az ukk.bid.supply_voucher_pack_id mezők alapján közvetett kapcsolatban áll a két tábla.
ukk.create_event()
- Új esemény létrehozása
A esemény alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EventTypeLabel varchar -- eseménytípus
--* _RequestOfferId integer -- ajánlatkérés
--* _UserId integer -- felhasználó
--* _VoucherPackId integer -- utalványcsomag
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_event_001 --Hiányzó paraméter: _EventTypeLabel
--* ukk_create_event_002 --Nem érvényes (FK) paraméter: _EventTypeLabel
--* ukk_create_event_003 --Hiányzó paraméter: _RequestOfferId
--* ukk_create_event_004 --Nem érvényes (FK) paraméter: _RequestOfferId
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_event(
--* 'ukk',
--* 'ukk_event',
--* 1,
--* null,
--* 1,
--* 1,
--* NULL,
--* NULL,
--* NULL
--* );
ukk.edit_event()
- Létező esemény adatainak módosítása
Létező esemény adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _EventTypeLabel varchar -- eseménytípus
--* _RequestOfferId integer -- ajánlatkérés
--* _UserId integer -- felhasználó
--* _VoucherPackId integer -- utalványcsomag
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_event_001 -- egyedazonosító megadása kötelező
--* ukk_edit_event_002 -- nem létező esemény
--* ukk_edit_event_003 -- Hiányzó paraméter: _EventTypeLabel
--* ukk_edit_event_004 -- Nem érvényes (FK) paraméter: _EventTypeLabel
--* ukk_edit_event_005 -- Hiányzó paraméter: _RequestOfferId
--* ukk_edit_event_006 -- Nem érvényes (FK) paraméter: _RequestOfferId
--* ukk_edit_event_007 -- Nem érvényes (FK) paraméter (érvénytelen kulcs): _UserId
--* ukk_edit_event_008 -- Nem érvényes (FK) paraméter (érvénytelen kulcs): _VoucherPackId
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_event(
--* 'ukk',
--* 'ukk_event',
--* 1,
--* NULL,
--* 1,
--* 1,
--* 1,
--* NULL,
--* NULL,
--* NULL
--* );
ukk.list_event()
- Események listázása
Események listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* -
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* event_type_label varchar -- eseménytípus
--* event_type_name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* request_offer_id integer -- ajánlatkérés
--* user_id integer -- felhasználó
--* voucher_pack_id integer -- utalványcsomag
--* description varchar -- megjegyzés
--* serial_interval_of_event_count integer -- hivatkozó eseményhez kapcsolódó sorszám intervallumok száma
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_event();
ukk.read_event()
- Esemény adatainak visszaadása
Esemény adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* event_type_label varchar -- eseménytípus
--* request_offer_id integer -- ajánlatkérés
--* user_id integer -- felhasználó
--* voucher_pack_id integer -- utalványcsomag
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_event_001 -- egyedazonosító megadása kötelező
--* ukk_read_event_002 -- nem megfelelő egyedazonosító
--* ukk_read_event_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_event( 1 );
ukk.set_event()
- Esemény állapotának beállítása
Átírja a esemény állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_event_001 -- egyedazonosító megadása kötelező
--* ukk_set_event_002 -- nem létező esemény
--* ukk_set_event_003 -- állapot megadása kötelező
--* ukk_set_event_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_event(
--* 'ukk',
--* 'ukk_event',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_event()
- Események egyszerűsített listázása
Események listázása az adott időpontban.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota
--* event_type_label varchar -- eseménytípus
--* request_offer_id integer -- ajánlatkérés
--* user_id integer -- felhasználó
--* voucher_pack_id integer -- utalványcsomag
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_event();
üzenet séma (ukk.message_schema
)
Mezők ismertetése:
- recipient - címzett szerepkör (például: 'init_person', 'office_manager', 'system', 'group:ukk')
- channel - csatorna (például: 'ui', 'email', 'sms', 'log')
- title - üzenet címe
- body - üzenet szövege
- schema - Latex séma
lnk_event_message
Mezők ismertetése:
- event_type_id - eseménytípus
- message_schema_id - üzenet séma
ukk.create_message_schema()
- Új üzenet sáma létrehozása
A üzenet sáma alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_message_schema_001 --Hiányzó paraméter: _Label
--* ukk_create_message_schema_002 --Hiányzó paraméter: _ShortName
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_message_schema(
--* 'ukk',
--* 'ukk_message_schema',
--* 1,
--* null,
--* 'ft',
--* 'Ft',
--* 'Forint',
--* NULL
--* );
ukk.edit_message_schema()
- Létező üzenet sáma adatainak módosítása
Létező üzenet sáma adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _Label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* _ShortName varchar -- rövid név
--* _FullName varchar -- teljes név
--* _Description varchar -- megjegyzés
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_message_schema_001 -- egyedazonosító megadása kötelező
--* ukk_edit_message_schema_002 -- nem létező üzenetséma
--* ukk_edit_message_schema_003 -- Hiányzó paraméter: _Label
--* ukk_edit_message_schema_004 -- Hiányzó paraméter: _ShortName
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_message_schema(
--* 'ukk',
--* 'ukk_message_schema',
--* 1,
--* NULL,
--* 1,
--* 'ft',
--* 'Ft',
--* 'Forint',
--* NULL
--* );
ukk.list_message_schema()
- Üzenet sámák listázása
Üzenet sámák listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* -
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--* lnk_event_message_count integer -- hivatkozó utalvány-beváltóhelyek száma
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_message_schema();
ukk.read_message_schema()
- Üzenet sáma adatainak visszaadása
Üzenet sáma adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* name varchar -- név (a teljes név, ha az nincs, akkor a rövid név)
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* ukk_read_message_schema_001 -- egyedazonosító megadása kötelező
--* ukk_read_message_schema_002 -- nem megfelelő egyedazonosító
--* ukk_read_message_schema_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_message_schema( 1 );
ukk.set_message_schema()
- Üzenet sáma állapotának beállítása
Átírja a üzenet sáma állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_message_schema_001 -- egyedazonosító megadása kötelező
--* ukk_set_message_schema_002 -- nem létező üzenetséma
--* ukk_set_message_schema_003 -- állapot megadása kötelező
--* ukk_set_message_schema_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_message_schema(
--* 'ukk',
--* 'ukk_message_schema',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_message_schema()
- Üzenet sámák egyszerűsített listázása
Üzenet sámák listázása az adott időpontban.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota
--* label varchar -- azonosító címke üzleti logika számára (kulcsmező)
--* short_name varchar -- rövid név
--* full_name varchar -- teljes név
--* description varchar -- megjegyzés
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_message_schema();
érintett intervallum (ukk.serial_interval_of_event
)
Mezők ismertetése:
- event_id - esemény
- prefix - előtag (opcionális)
- suffix - utótag (opcionális)
- start_number - kezdő sorszám
- end_number - záró sorszám
Szabályok:
- TODO: event_id nem változhat!
ukk.create_serial_interval_of_pack()
- Új sorszám intervallum a csomagban létrehozása
A sorszám intervallum a csomagban alapadatainak rögzítése, aktív státusszal.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EventId integer -- esemény
--* _YearOfRelease integer -- kibocsátás éve
--* _ValidityDate date -- lejárat dátuma
--* _Prefix varchar -- előtag
--* _Suffix varchar -- utótag
--* _StartNumber numeric -- kezdő sorszám
--* _EndNumber numeric -- záró sorszám
--* RESULT
--* integer -- az új rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_create_serial_interval_of_event_001 --Hiányzó paraméter: _EventId
--* ukk_create_serial_interval_of_event_002 --Nem érvényes (FK) paraméter: _EventId
--* ukk_create_serial_interval_of_event_003 --Hiányzó paraméter: _ValidityDate
--* ukk_create_serial_interval_of_event_004 --Hiányzó paraméter: _StartNumber
--* ukk_create_serial_interval_of_event_005 --Hiányzó paraméter: _EndNumber
--* NOTES
--* Példa a használatára:
--* SELECT ukk.create_serial_interval_of_event(
--* 'ukk',
--* 'ukk_serial_interval_of_event',
--* 1,
--* null,
--* 1,
--* NULL,
--* 2016-12-31,
--* NULL,
--* NULL,
--* 12220000000,
--* 12220009999
--* );
ukk.edit_serial_interval_of_pack()
- Létező sorszám intervallum a csomagban adatainak módosítása
Létező sorszám intervallum a csomagban adatainak módosítása
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer -- egyedazonosító
--* _EventId integer -- esemény
--* _YearOfRelease integer -- kibocsátás éve
--* _ValidityDate date -- lejárat dátuma
--* _Prefix varchar -- előtag
--* _Suffix varchar -- utótag
--* _StartNumber numeric -- kezdő sorszám
--* _EndNumber numeric -- záró sorszám
--* RESULT
--* integer -- 'az új rekord azonosítója (id)'
--*
--* Hibakódok:
--* ukk_edit_serial_interval_of_event_001 -- egyedazonosító megadása kötelező
--* ukk_edit_serial_interval_of_event_002 -- nem létező eseményhez kapcsolódó sorszám intervallum
--* ukk_edit_serial_interval_of_event_003 -- Hiányzó paraméter: _EventId
--* ukk_edit_serial_interval_of_event_004 -- Nem érvényes (FK) paraméter: _EventId
--* ukk_edit_serial_interval_of_event_005 -- Hiányzó paraméter: _ValidityDate
--* ukk_edit_serial_interval_of_event_006 -- Hiányzó paraméter: _StartNumber
--* ukk_edit_serial_interval_of_event_007 -- Hiányzó paraméter: _EndNumber
--* NOTES
--*
--* Példa a használatára:
--* SELECT ukk.edit_serial_interval_of_event(
--* 'ukk',
--* 'ukk_serial_interval_of_event',
--* 1,
--* NULL,
--* 1,
--* 1,
--* NULL,
--* 2016-12-31,
--* NULL,
--* NULL,
--* 12220000000,
--* 12220009999
--* );
ukk.list_serial_interval_of_pack()
- Sorszám intervallumok a csomagban listázása
Sorszám intervallumok a csomagban listázása az adott időpontban, a kapcsolódó egyedek főbb tulajdonságaival.
--* INPUTS
--* -
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* creation_user_name varchar -- a rekord bejegyzését kezdeményező BOB felhasználó neve
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* modification_user_name varchar -- a rekord utolsó módosítását kezdeményező BOB felhasználó neve
--* status varchar -- egyed állapota
--* event_id integer -- esemény
--* year_of_release integer -- kibocsátás éve
--* validity_date date -- lejárat dátuma
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* start_number numeric -- kezdő sorszám
--* end_number numeric -- záró sorszám
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.list_serial_interval_of_event();
ukk.read_serial_interval_of_pack()
- Sorszám intervallum a csomagban adatainak visszaadása
Sorszám intervallum a csomagban adott időpontban érvényes adatainak visszaadása.
--* INPUTS
--* _EID -- egyedazonosító
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota (active, deleted)
--* event_id integer -- esemény
--* year_of_release integer -- kibocsátás éve
--* validity_date date -- lejárat dátuma
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* start_number numeric -- kezdő sorszám
--* end_number numeric -- záró sorszám
--*
--* Hibakódok:
--* ukk_read_serial_interval_of_event_001 -- egyedazonosító megadása kötelező
--* ukk_read_serial_interval_of_event_002 -- nem megfelelő egyedazonosító
--* ukk_read_serial_interval_of_event_003 -- időpont megadása kötelező
--*
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.read_serial_interval_of_event( 1 );
ukk.set_serial_interval_of_pack()
- Sorszám intervallum a csomagban állapotának beállítása
Átírja a sorszám intervallum a csomagban állapotát a kapott paraméternek megfelelően.
--* INPUTS
--* _LockAccountName varchar -- technikai mező: kezdeményező fiók neve
--* _LockModulLabel varchar -- technikai mező: kezdeményező modul neve
--* _LockUserId integer -- technikai mező: kezdeményező felhasználó azonosítója
--* _LockFormCode varchar -- technikai mező: űrlapazonosító a böngészőfrissítés általi újraküldések megelőzésére
--* _EID integer, -- a változtatandó egyed azonosítója
--* _Status, -- egyed állapota (active, deleted)
--* RESULT
--* _EID -- a rekord azonosítója (id)
--*
--* Hibakódok:
--* ukk_set_serial_interval_of_event_001 -- egyedazonosító megadása kötelező
--* ukk_set_serial_interval_of_event_002 -- nem létező eseményhez kapcsolódó sorszám intervallum
--* ukk_set_serial_interval_of_event_003 -- állapot megadása kötelező
--* ukk_set_serial_interval_of_event_004 -- status csak active vagy deleted lehet
--* NOTES
--* Példa a használatára:
--* SELECT ukk.set_serial_interval_of_event(
--* 'ukk',
--* 'ukk_serial_interval_of_event',
--* 1,
--* 'aaa123',
--* 3,
--* 'active'
--* );
ukk.simplelist_serial_interval_of_pack()
- Sorszám intervallumok a csomagban egyszerűsített listázása
Sorszám intervallumok a csomagban listázása az adott időpontban.
--* INPUTS
--*
--* RESULT
--* id integer -- rekordazonosító
--* eid integer -- egyed azonosítója (egyed létrehozásakor az értéke megegyezik a rekordazonosítóval)
--* creation_time timestamp with time zone -- érvényesség kezdete (megegyezik az előző állapot modification_time mezőjével)
--* creation_user_id integer -- létrehozó felhasználó (megegyezik az előző állapot modification_user_id mezőjével)
--* modification_time timestamp with time zone -- módosítás időpontja (megegyezik a következő állapot creation_time mezőjével)
--* modification_user_id integer -- módosító felhasználó (megegyezik a következő állapot creation_user_id mezőjével)
--* status varchar -- egyed állapota
--* event_id integer -- esemény
--* year_of_release integer -- kibocsátás éve
--* validity_date date -- lejárat dátuma
--* prefix varchar -- előtag
--* suffix varchar -- utótag
--* start_number numeric -- kezdő sorszám
--* end_number numeric -- záró sorszám
--*
--* Hibakódok:
--* -
--* NOTES
--* Példa a használatára:
--* SELECT * FROM ukk.simplelist_serial_interval_of_event();
Általános működési szabályok
Utalvánnyal kapcsolatos lehetséges események
Bejegyzés
Nyilvántartott tulajdonos bejegyzése