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

pkPCSearch.sql

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

Error_PersonNotFound

PROCEDURE Error_PersonNotFound(sSearchConditions VARCHAR2);

Описание

Вызывает ошибку «Человек не найден».

Error_TooManyPersons

PROCEDURE Error_TooManyPersons(sSearchConditions VARCHAR2);

Описание

Вызывает ошибку «Неоднозначное соответствие при поиске человека».

Error_InvalidSearchParams

PROCEDURE Error_InvalidSearchParams(sMessage VARCHAR2);

Описание

Вызывает ошибку «Неверные параметры поиска».

Error_RequiredReqNotSpecified

PROCEDURE Error_RequiredReqNotSpecified(sReqName VARCHAR2);

Описание

Вызывает ошибку «Отсутствует обязательный поисковый реквизит».

Error_InvalidSearchReqValue

PROCEDURE Error_InvalidSearchReqValue(sReqName VARCHAR2, sReqValue VARCHAR2);

Описание

Вызывает ошибку «Недопустимое значение поискового реквизита».

Функции для поиска людей по различным реквизитам

FindPersonByName

FUNCTION FindPersonByName(
    iRegionID PLS_INTEGER, sLastName VARCHAR2, sFirstName VARCHAR2, sMiddleName VARCHAR2, dBirthDate DATE,
    iPeopleID OUT PLS_INTEGER,
    iStrict PLS_INTEGER, iIgnoreNotFound PLS_INTEGER := 0, iIgnoreDuplicates PLS_INTEGER := 0,
    iYeEqualsYo PLS_INTEGER := 0) RETURN PLS_INTEGER;

Описание

Поиск человека в заданном районе по Ф.И.О. и дате рождения.
Параметры:

  • iRegionID - ID района поиска;
  • sLastName, sFirstName, sMiddleName - фамилия, имя и отчество (фамилия и имя - обязательные реквизиты);
  • dBirthDate - дата рождения (обязательный реквизит);
  • iPeopleID - ID найденного человека (при неудаче null);
  • iStrict - поведение при неудачном поиске (0/1);
  • iIgnoreNotFound - не вызывать exception при отсутствии совпадения (при iStrict=0 значение параметра игнорируется);
  • iIgnoreDuplicates - не вызывать exception при неоднозначном соответствии (при iStrict=0 значение параметра игнорируется);
  • iYeEqualsYo - считать ли буквы «Е» и «Ё» взаимозаменяемыми (0/1).

Возвращает:

  • 1 - при успешном поиске;
  • 0 - при отсутствии совпадения (только при iStrict=0 или iIgnoreNotFound!=0);
  • 2 - при неоднозначном соответствии (только при iStrict=0 или iIgnoreDuplicates!=0);
  • -1 - при прочих ошибках (только при iStrict=0).

FindPersonByName

FUNCTION FindPersonByName(iRegionID PLS_INTEGER, sLastName VARCHAR2, sFirstName VARCHAR2, sMiddleName VARCHAR2, dBirthDate DATE, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

Описание

Поиск человека в заданном районе по Ф.И.О. и дате рождения.
Параметры:

  • iRegionID - ID района поиска;
  • sLastName, sFirstName, sMiddleName - фамилия, имя и отчество (фамилия и имя - обязательные реквизиты);
  • dBirthDate - дата рождения (если null, поиск осуществляется без учёта даты рождения);
  • iStrict - поведение при неудачном поиске (0/1).

Возвращает ID найденного человека или null, если человек не найден (только при iStrict=0).

FindPersonByIdentity

FUNCTION FindPersonByIdentity(
    iRegionID PLS_INTEGER, iDocClassID PLS_INTEGER, sSeries VARCHAR2, sNumber VARCHAR2,
    iPeopleID OUT PLS_INTEGER, iDocInstanceID OUT PLS_INTEGER,
    iStrict PLS_INTEGER, iIgnoreNotFound PLS_INTEGER := 0, iIgnoreDuplicates PLS_INTEGER := 0) RETURN PLS_INTEGER;

Описание

Поиск человека в заданном районе по серии и номеру документа, удостоверяющего личность.
Параметры:

  • iRegionID - ID района поиска;
  • iDocClassID - ID класса документа, удостоверяющего личность, в Системе;
  • sSeries - серия документа;
  • sNumber - номер документа;
  • iPeopleID - ID найденного человека (при неудаче null);
  • iDocInstanceID - ID документа, удостоверяющего личность, по которому произошло совпадение (при неудаче null);
  • iStrict - поведение при неудачном поиске (0/1);
  • iIgnoreNotFound - не вызывать exception при отсутствии совпадения (при iStrict=0 значение параметра игнорируется);
  • iIgnoreDuplicates - не вызывать exception при неоднозначном соответствии (при iStrict=0 значение параметра игнорируется).

Возвращает:

  • 1 - при успешном поиске;
  • 0 - при отсутствии совпадения (только при iStrict=0 или iIgnoreNotFound!=0);
  • 2 - при неоднозначном соответствии (только при iStrict=0 или iIgnoreDuplicates!=0);
  • -1 - при прочих ошибках (только при iStrict=0).

FindPersonByNameAndAddress

FUNCTION FindPersonByNameAndAddress(
    iRegionID PLS_INTEGER, iAddrKindID PLS_INTEGER, sLastName VARCHAR2, sFirstName VARCHAR2, sMiddleName VARCHAR2,
    iCityID PLS_INTEGER, iStreetID PLS_INTEGER, sBldg VARCHAR2, sBulk VARCHAR2, sApt VARCHAR2,
    iPeopleID OUT PLS_INTEGER,
    iStrict PLS_INTEGER, iIgnoreNotFound PLS_INTEGER := 0, iIgnoreDuplicates PLS_INTEGER := 0) RETURN PLS_INTEGER;

Описание

Поиск человека в заданном районе по Ф.И.О. и адресу.
Параметры:

  • iRegionID - ID района поиска;
  • iAddrKindID - ID вида адреса из справочника видов адресов людей/коллективов;
  • sLastName, sFirstName, sMiddleName - фамилия, имя и отчество (фамилия и имя - обязательные реквизиты);
  • iCityID - ID населённого пункта (обязательный реквизит);
  • iStreetID - ID улицы (обязательный реквизит);
  • sBldg - дом (обязательный реквизит);
  • sBulk - корпус;
  • sApt - квартира;
  • iPeopleID - ID найденного человека (при неудаче null);
  • iStrict - поведение при неудачном поиске (0/1);
  • iIgnoreNotFound - не вызывать exception при отсутствии совпадения (при iStrict=0 значение параметра игнорируется);
  • iIgnoreDuplicates - не вызывать exception при неоднозначном соответствии (при iStrict=0 значение параметра игнорируется).

Возвращает:

  • 1 - при успешном поиске;
  • 0 - при отсутствии совпадения (только при iStrict=0 или iIgnoreNotFound!=0);
  • 2 - при неоднозначном соответствии (только при iStrict=0 или iIgnoreDuplicates!=0);
  • -1 - при прочих ошибках (только при iStrict=0).

FindPersonByPensInsurance

FUNCTION FindPersonByPensInsurance(
    iRegionID PLS_INTEGER, sInsurance VARCHAR2,
    iPeopleID OUT PLS_INTEGER, iDocInstanceID OUT PLS_INTEGER,
    iStrict PLS_INTEGER, iIgnoreNotFound PLS_INTEGER := 0, iIgnoreDuplicates PLS_INTEGER := 0) RETURN PLS_INTEGER;

Описание

Поиск человека в заданном районе по номеру страхового пенсионного свидетельства.
Параметры:

  • iRegionID - ID района поиска;
  • sInsurance - номер страхового пенсионного свидетельства;
  • iPeopleID - ID найденного человека (при неудаче null);
  • iDocInstanceID - ID документа, удостоверяющего личность, по которому произошло совпадение (при неудаче null);
  • iStrict - поведение при неудачном поиске (0/1);
  • iIgnoreNotFound - не вызывать exception при отсутствии совпадения (при iStrict=0 значение параметра игнорируется);
  • iIgnoreDuplicates - не вызывать exception при неоднозначном соответствии (при iStrict=0 значение параметра игнорируется).

Возвращает:

  • 1 - при успешном поиске;
  • 0 - при отсутствии совпадения (только при iStrict=0 или iIgnoreNotFound!=0);
  • 2 - при неоднозначном соответствии (только при iStrict=0 или iIgnoreDuplicates!=0);
  • -1 - при прочих ошибках (только при iStrict=0).

FindCollByOGRN

FUNCTION FindCollByOGRN(
    iRegionID PLS_INTEGER, iCollClassID PLS_INTEGER, sOGRN VARCHAR2,
    iCollID OUT PLS_INTEGER, iDocInstanceID OUT PLS_INTEGER,
    iStrict PLS_INTEGER, iIgnoreNotFound PLS_INTEGER := 0, iIgnoreDuplicates PLS_INTEGER := 0) RETURN PLS_INTEGER;

Описание

Поиск коллектива-юридического лица в заданном районе по ОГРН.
Параметры:

  • iRegionID - ID района поиска;
  • iCollClassID - ID класса коллектива;
  • sOGRN - ОГРН;
  • iCollID - ID найденного коллектива (при неудаче null);
  • iDocInstanceID - ID документа-свидетельства о регистрации юридического лица (при неудаче null);
  • iStrict - поведение при неудачном поиске (0/1);
  • iIgnoreNotFound - не вызывать exception при отсутствии совпадения (при iStrict=0 значение параметра игнорируется);
  • iIgnoreDuplicates - не вызывать exception при неоднозначном соответствии (при iStrict=0 значение параметра игнорируется).

Возвращает:

  • 1 - при успешном поиске;
  • 0 - при отсутствии совпадения (только при iStrict=0 или iIgnoreNotFound!=0);
  • 2 - при неоднозначном соответствии (только при iStrict=0 или iIgnoreDuplicates!=0);
  • -1 - при прочих ошибках (только при iStrict=0).