Документация iSZN
pkPrivRegistry.sql
Сообщения об ошибках
Error_NoPrivRegCategory
PROCEDURE Error_NoPrivRegCategory(iRegionID PLS_INTEGER, iID PLS_INTEGER);
Описание
Генерирует exception «Категория регистра не существует».
Error_NoPrivRegCatCode
PROCEDURE Error_NoPrivRegCatCode(iPrivCategoryCode PLS_INTEGER, iRegionID PLS_INTEGER := NULL);
Описание
Генерирует exception «Не найдена категория регистра с кодом ...». Если iRegionID!=null, то к сообщению добавляется также информация о районе.
Error_TooManyPrivRegCats
PROCEDURE Error_TooManyPrivRegCats(iPrivCategoryCode PLS_INTEGER, iRegionID PLS_INTEGER := NULL);
Описание
Генерирует exception «Неоднозначное соответствие категории регистра с кодом ...». Если iRegionID!=null, то к сообщению добавляется также информация о районе.
Error_PrivRegCatComputeFail
PROCEDURE Error_PrivRegCatComputeFail(iPrivRegCatRegionID PLS_INTEGER, iPrivRegCatID PLS_INTEGER, iPCRegionID PLS_INTEGER, iPCID PLS_INTEGER, nCode NUMBER, sMessage VARCHAR2);
Описание
Генерирует exception «Ошибка при расчёте периодов обладания категорией регистра».
Error_InvalidCatPresenceWhile
Описание
Генерирует exception «Ошибочное значение периода обладания категорией».
Преобразование ключи <-> коды категорий
GetPrivRegCategoryCode
FUNCTION GetPrivRegCategoryCode(iRegionID PLS_INTEGER, iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;
Описание
Возвращает код категории федерального/регионального регистра по её ключу. При отсутствии записи поведение определяется параметром iStrict.
GetPrivRegCategoryID
FUNCTION GetPrivRegCategoryID(iPrivCategoryCode PLS_INTEGER, iRegionID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;
Описание
Возвращает ID категории федерального/регионального регистра по коду категории регистра для района iRegionID. При отсутствии записи и при неоднозначном соответствии поведение определяется параметром iStrict.
GetPrivRegCategoryKey
FUNCTION GetPrivRegCategoryKey(iPrivCategoryCode PLS_INTEGER, iRegionID PLS_INTEGER, iKeyRgnID OUT PLS_INTEGER, iKeyID OUT PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;
Описание
Получает ключ категории федерального/регионального регистра по коду категории регистра.
Поиск производится с проверкой вверх по районной ветке от района iRegionID.
Возвращает:
при iStrict=0:
- 0 - при отсутствии соответствия;
- 1 - в случае успешного получения;
- 2 - в случае неоднозначного соответствия;
при iStrict=1:
- 1 - случае успешного получения;
- иначе возникает Exception.
Если функция вернула значение, отличное от 1, значения Out параметров не определены.
Получение наименований категорий
GetPrivRegCategoryName
FUNCTION GetPrivRegCategoryName(iRegionID PLS_INTEGER, iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;
Описание
Возвращает наименование категории федерального/регионального регистра по её ключу. При отсутствии записи поведение определяется параметром iStrict.
GetPrivRegCatNameByCode
FUNCTION GetPrivRegCatNameByCode(iPrivCategoryCode PLS_INTEGER, iRegionID PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;
Описание
Возвращает наименование категории федерального/регионального регистра по коду категории регистра для района iRegionID. При отсутствии записи и при неоднозначном соответствии поведение определяется параметром iStrict.
GetPrivRegCatNameByCodeEx
FUNCTION GetPrivRegCatNameByCodeEx(iPrivCategoryCode PLS_INTEGER, iRegionID PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;
Описание
То же самое, но поиск производится вверх от района iRegionID.
Расчёт периодов потенциального обладания категорией
CatEnablingDocReqToStr
Описание
Преобразует запись о документе, дающем (подтверждающем) право на категорию, в строковое представление.
CatPresenceWhileToStr
Описание
Преобразует типизированную запись периода обладания категорией в строковое представление.
CatPresenceWhileListToStr
FUNCTION CatPresenceWhileListToStr(cpwl IN TCategoryPresenceWhileList) RETURN VARCHAR2 deterministic;
Описание
Список типизированных записей периодов обладания категорией в строковое представление.
StrToCatPresenceWhile
Описание
Преобразует строковое представление периода обладания категорией в типизированную запись.
StrToCatPresenceWhileList
FUNCTION StrToCatPresenceWhileList(sWhileList VARCHAR2) RETURN TCategoryPresenceWhileList deterministic;
Описание
Преобразует строковое представление списка периодов обладания категорией в таблицу типизированных записей.
ComputeWhiles
FUNCTION ComputeWhiles(iPrivRegCatRegionID PLS_INTEGER, iPrivRegCatID PLS_INTEGER, iPCRegionID PLS_INTEGER, iPCID PLS_INTEGER, iStrict PLS_INTEGER) RETURN TCategoryPresenceWhileList;
Описание
Выполняет расчёт потенциальных периодов обладания данной категорией регистра для человека.
Параметры:
- iPrivRegCatRegionID, iPrivRegCatID - ключ категории регистра;
- iPCRegionID, iPCID - ключ человека;
- iStrict - определяет поведение при возникновении сбоев;
Возвращает список периодов (пустой, если периодов нет).
При iStrict=0 при наличии сбоев также возвращает пустой список периодов.