Документация 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

PROCEDURE Error_InvalidCatPresenceWhile(sValue VARCHAR2);

Описание

Генерирует 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

FUNCTION CatEnablingDocReqToStr(Doc IN TCategoryEnablingDocRec) RETURN VARCHAR2 deterministic;

Описание

Преобразует запись о документе, дающем (подтверждающем) право на категорию, в строковое представление.

CatPresenceWhileToStr

FUNCTION CatPresenceWhileToStr(cpw IN TCategoryPresenceWhile) RETURN VARCHAR2 deterministic;

Описание

Преобразует типизированную запись периода обладания категорией в строковое представление.

CatPresenceWhileListToStr

FUNCTION CatPresenceWhileListToStr(cpwl IN TCategoryPresenceWhileList) RETURN VARCHAR2 deterministic;

Описание

Список типизированных записей периодов обладания категорией в строковое представление.

StrToCatPresenceWhile

FUNCTION StrToCatPresenceWhile(sWhile VARCHAR2) RETURN TCategoryPresenceWhile deterministic;

Описание

Преобразует строковое представление периода обладания категорией в типизированную запись.

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 при наличии сбоев также возвращает пустой список периодов.