Документация iSZN

Местоположение: guide => design => api => server => packages

pkPCAddr.sql

Сообщения об ошибках

Error_NoPCAddressKind

PROCEDURE Error_NoPCAddressKind(iID PLS_INTEGER);

Описание

Генерирует exception «Вид адреса человека/коллектива не существует».

Error_NoPCAddress

PROCEDURE Error_NoPCAddress(iRegionID PLS_INTEGER, iPCAddressID PLS_INTEGER);

Описание

Генерирует exception «Адрес человека/коллектива не существует».

Описание объектов

GetPCAddressKindName

FUNCTION GetPCAddressKindName(iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Описание

Возвращает наименование вида адреса человека/коллектива.
Параметры:

  • iID - ID вида адреса;
  • iStrict - определяет поведение при отсутствии объекта (0 - возвращает null, 1 - возникает exception).

Расчёт адресов

AllocateNewPCAddressID

FUNCTION AllocateNewPCAddressID(iRegionID PLS_INTEGER) RETURN PLS_INTEGER;

Описание

Возвращает новый свободный ID в r_pc_addresses.

AllocateNewPCAddressPeriodID

FUNCTION AllocateNewPCAddressPeriodID(iRegionID PLS_INTEGER) RETURN PLS_INTEGER;

Описание

Возвращает новый свободный ID в r_pc_address_periods.

ComputePCAddresses

PROCEDURE ComputePCAddresses(iRegionID PLS_INTEGER, iPCID PLS_INTEGER);

Описание

Выполняет расчёт адресов человека/коллектива.
Параметры:

  • iRegionID - ID района;
  • iPCID - ID человека/коллектива.

Получение адресных данных людей/коллективов

GetPCAddressID

FUNCTION GetPCAddressID(iRegionID PLS_INTEGER, iPCID PLS_INTEGER, iAddressKindID PLS_INTEGER, dDate DATE, iImmediateOnly PLS_INTEGER) RETURN PLS_INTEGER;

Описание

Возвращает ID адреса человека/коллектива. Если адрес не найден, возвращает null.
Параметры:

  • iRegionID, iPCID - ключ человека/коллектива;
  • iAddressKindID - вид адреса из справочника видов адресов людей/коллективов (null - любой вид адреса);
  • dDate - дата, на которую производится поиск (null - без учёта сроков действия адреса);
  • iImmediateOnly - искать ли только у самого человека/коллектива (1) или у членов коллективов с родственными отношениями, если непосредственно у заданного человека/коллектива адрес не найден (0).

Если имеется несколько подходящих по критериям адресов, возвращается адрес с максимальной датой «с»,
а если и таких несколько, то из них выбирается адрес с минимальным ID.

GetAddressID

FUNCTION GetAddressID(iRegionID PLS_INTEGER, iPCAddressID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

Описание

Возвращает ID адреса для указанного адреса человека/коллектива. Если адрес человека/коллектива не существует, поведение определяется параметром iStrict.

GetPCAddress

FUNCTION GetPCAddress(iRegionID PLS_INTEGER, iPCID PLS_INTEGER, iMode PLS_INTEGER, iAddressKindID PLS_INTEGER, dDate DATE, iImmediateOnly PLS_INTEGER) RETURN VARCHAR2;

Описание

Возвращает адрес или часть адреса человека/коллектива.
Параметры:

  • iRegionID, iPCID - ключ человека/коллектива;
  • iMode - вид адресных данных: 0 - полный адрес; 1 - наименование населённого пункта; 2 - наименование улицы; 3 - дом; 4 - корпус; 5 - квартира; 6 - ID населённого пункта; 7 - ID улицы;
  • iAddressKindID - вид адреса из справочника видов адресов людей/коллективов (null - любой вид адреса);
  • dDate - дата, на которую производится поиск (null - без учёта сроков действия адреса).
  • iImmediateOnly - искать ли только у самого человека/коллектива (1) или у членов коллективов с родственными отношениями, если непосредственно у заданного человека/коллектива адрес не найден (0).

Если имеется несколько подходящих по критериям адресов, возвращается адрес с максимальной датой «с»,
а если и таких несколько, то из них выбирается адрес с минимальным ID.