PROCEDURE ValidateUniquePDocReqs(iRegionID PLS_INTEGER, iDIID PLS_INTEGER, iForEntireRegion PLS_INTEGER := 0, iPerOwnerClass PLS_INTEGER := 0);

Проверяет, что экземпляр документа - единственный с таким набором реквизитов, отмеченных атрибутом
PDCA_REQ_UNIQUE_KEY. В противном случае возникает exception.
Параметры:

• iRegionID, iDIID - ключ экземпляра документа;
  
• iForEntireRegion - проверять ли уникальность в пределах всего района (1) или только у владельца (0);
  
• iPerOwnerClass - искать в пределах класса владельца (0/1); учитывается только при iForEntireRegion=1.

PROCEDURE CheckPDocUsedForPayout(iRegionID PLS_INTEGER, iDIID PLS_INTEGER);

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

PROCEDURE CheckPKPrivsForPayoutDoc(iRegionID PLS_INTEGER, iDIID PLS_INTEGER, iPKPrivs PLS_INTEGER);

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

PROCEDURE CheckPDocIsMainIdentity(iRegionID PLS_INTEGER, iDIID PLS_INTEGER);

Проверяет, не используется ли документ в качестве основного ДУЛ, и если да, возникает exception о невозможности удаления экземпляра документа.

FUNCTION DoesReqValueExistInRgn(iRgnID PLS_INTEGER, iClassID PLS_INTEGER, sValue VARCHAR2, iExceptDIID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает 1, если в пределах района iRgnID есть реквизит с заданным iClassID, имеющий значение sValue, иначе 0. При этом из поиска исключаются все реквизиты экземпляра документа с ID равным iExceptDIID. Если iExceptDIID=null, проверяются все документы.

FUNCTION DoReqValuesExistInRgn(iRgnID PLS_INTEGER, iClassID1 PLS_INTEGER, sValue1 VARCHAR2, iClassID2 PLS_INTEGER,  sValue2 VARCHAR2, iClassID3 PLS_INTEGER,  sValue3 VARCHAR2, iClassID4 PLS_INTEGER,  sValue4 VARCHAR2,  iExceptDIID PLS_INTEGER) RETURN PLS_INTEGER;

То же, но для сочетания реквизитов с заданными iClassID# и значениями sValue# (до четырёх, обязательны первые два).

PROCEDURE CheckReqValueNotExistsInRgn(iRgnID PLS_INTEGER, iClassID PLS_INTEGER, sValue VARCHAR2, iExceptDIID PLS_INTEGER, sCustomErrorMessage VARCHAR2 := NULL);

Проверяет, что в пределах района iRgnID нет реквизита с заданным iClassID, имеющего значение sValue. При этом из поиска исключаются все реквизиты экземпляра документа с ID равным iExceptDIID. Если iExceptDIID=null, проверяются все документы.

PROCEDURE CheckReqValuesNotExistInRgn(iRgnID PLS_INTEGER, iClassID1 PLS_INTEGER, sValue1 VARCHAR2, iClassID2 PLS_INTEGER, sValue2 VARCHAR2, iClassID3 PLS_INTEGER := NULL, sValue3 VARCHAR2 := NULL, iClassID4 PLS_INTEGER := NULL, sValue4 VARCHAR2 := NULL, iExceptDIID PLS_INTEGER := NULL, sCustomErrorMessage VARCHAR2 := NULL);

То же, но для сочетания реквизитов с заданными iClassID#, имеющих значения sValue# (до четырёх, обязательны первые два).

PROCEDURE CheckPDocSNUnique(iRegionID PLS_INTEGER, iPDocID PLS_INTEGER);

Проверяет уникальность серии и номера.

PROCEDURE CheckTransportCardNumUniq6601(iRgnID PLS_INTEGER, iCardDIID PLS_INTEGER);

Проверяет уникальность номера заданной транспортной карты (документа с ClassID 6601).

PROCEDURE CheckUniq5673(iRegionID PLS_INTEGER, iPCID PLS_INTEGER, iCurDIID PLS_INTEGER);

Проверяет уникальность карточки учёта предоставления социальной выплаты на приобретение (строительство) жилья по году участия.

FUNCTION PCHasActiveDpkInDateRange(iRegionID PLS_INTEGER, iPCID PLS_INTEGER, dDateFrom DATE, dDateTo DATE, iDocKinds uszn.TIntegerList) RETURN PLS_INTEGER;

Поиск записей в ДПК: проверяет, имеется ли у человека/коллектива iPCID активная хотя бы в течение одного из дней периода dDateFrom...dDateTo запись

• о документе одного из имеющихся в переданном списке iSearchKinds видов.
  

Возвращает kind_id последнего (по order_num) из совпадающих со списком iDPKKinds документов.
Если совпадений не найдено, возвращает null.

FUNCTION PCHasActiveDpkOnDate(iRegionID PLS_INTEGER, iPCID PLS_INTEGER, dDate DATE, iDocKinds uszn.TIntegerList) RETURN PLS_INTEGER;

Поиск записей в ДПК: проверяет, имеется ли у человека/коллектива iPCID активная на дату dDate запись

• о документе одного из имеющихся в переданном списке iSearchKinds видов.
  

Возвращает kind_id последнего (по order_num) из совпадающих со списком iDPKKinds документов.
Если совпадений не найдено, возвращает null.

PROCEDURE ProcessPDoc5810Change(iRegionID PLS_INTEGER, iPCID PLS_INTEGER, iOriginID PLS_INTEGER, sNotes VARCHAR2 := NULL);

Вызывается при изменении документа человека «Заявление гражданина на регистрацию обращений для определения статуса

• «малоимущая семья» и обновляет информацию в документе коллектива «Заявление коллектива на регистрацию обращений
  
• для определения статуса «малоимущая семья», в который входит данный человек.
  

Параметры:

• iOriginID - ID источника события;
  
• sNotes - примечания для аудита.

PROCEDURE ComputePDoc6035(iRegionID PLS_INTEGER, iDIID PLS_INTEGER, iOriginID PLS_INTEGER, sNotes VARCHAR2);

Расчёт документа «Сведения о продукции ЛПХ»
Параметры:

• iRegionID, iDIID - ключ обрабатываемого экземпляра документа;
  
• iOriginID - ID источника события;
  
• sNotes - примечания для аудита.

PROCEDURE BlockTransportCard6601(iRegionID PLS_INTEGER, iDIID PLS_INTEGER, dBlockDate DATE, iBlockReason PLS_INTEGER, iOriginID PLS_INTEGER, sNotes VARCHAR2 := NULL);

Выполняет блокировку «Транспортной карты» (ID=6601).
Параметры:

• iRegionID, iDIID - ключ обрабатываемого экземпляра документа;
  
• dBlockDate - дата, с которой выполняется блокировка;
  
• iBlockReason - ID причины блокировки;
  
• iOriginID - ID источника события;
  
• sNotes - примечания для аудита.

FUNCTION FormatPassportNum(sValue VARCHAR2) RETURN VARCHAR2 deterministic;

Форматирует номер паспорта РФ и иностранного паспорта. Для иностранного паспорта значение возвращается в исходном виде, для российского дополняется слева от 0 до 6 знаков. Вид паспорта определяется по количеству знаков в номере.

FUNCTION FormatPassportIssuerCode(sValue VARCHAR2) RETURN VARCHAR2 deterministic;

Форматирует код подразделения для паспорта РФ: при необходимости добавляет разделитель.

FUNCTION CorrectBirthCertSeries(sInput VARCHAR2, iStrict PLS_INTEGER := 0) RETURN VARCHAR2 deterministic;

Преобразует значение серии свидетельства о рождении к корректному виду. iStrict определяет поведение функции при невозможности преобразования.

FUNCTION CorrectPassportRFSeries(sInput VARCHAR2, iStrict PLS_INTEGER := 0) RETURN VARCHAR2 deterministic;

Преобразует значение серии паспорта гражданина РФ к корректному виду «dd dd», где «d» - цифры от 0 до 9. iStrict определяет поведение функции при невозможности преобразования.

FUNCTION CorrectPensInsuranceNum(sInput VARCHAR2, iStrict PLS_INTEGER := 0) RETURN VARCHAR2 deterministic;

Форматирует номер СНИЛС в виде «nnn-nnn-nnn nn», убирая все нечисловые символы и при необходимости дополняя слева нулями. iStrict определяет поведение функции при невозможности преобразования.

FUNCTION IsValidPensInsuranceNum(sValue VARCHAR2, iValidateChecksum PLS_INTEGER) RETURN PLS_INTEGER deterministic;

Возвращает 1, если значение является валидным номером страхового пенсионного удостоверения (СНИЛС), иначе 0.
Параметры:

• sValue - проверяемое значение;
  
• iValidateChecksum - сверять ли значение контрольной суммы (0/1).

FUNCTION GetPureSNILS(sFormattedValue VARCHAR2, iStrict PLS_INTEGER) RETURN VARCHAR2;

Возвращает “чистый” номер СНИЛС без символов форматирования, содержащий ровно 11 цифр.
Параметры:

• sFormattedValue - отформатированное значение;
  
• iStrict - определяет поведение при некорректном значении.
  

Значение контрольной суммы при этом не проверяется, только соответствие формату «nnn-nnn-nnn nn».
Если исходное значение равно null, возвращает null.

FUNCTION IsValidPersonInn(sValue VARCHAR2, iValidateChecksum PLS_INTEGER) RETURN PLS_INTEGER deterministic;

Возвращает 1, если значение является валидным ИНН физического лица.
Параметры:

• sValue - проверяемое значение;
  
• iValidateChecksum - сверять ли значение контрольной суммы (0/1).

FUNCTION IsValidLegalInn(sValue VARCHAR2, iValidateChecksum PLS_INTEGER) RETURN PLS_INTEGER deterministic;

Возвращает 1, если значение является валидным ИНН юридического лица.
Параметры:

• sValue - проверяемое значение;
  
• iValidateChecksum - сверять ли значение контрольной суммы (0/1).

FUNCTION IsValidPaymentCardNum(sValue VARCHAR2) RETURN PLS_INTEGER deterministic;

Возвращает 1, если значение является валидным номером банковской карты.
Параметры:

• sValue - проверяемое значение.

FUNCTION GetDefaultPDocDesc(iRegionID PLS_INTEGER, iDocInstanceID PLS_INTEGER, iStrict PLS_INTEGER, iMode PLS_INTEGER) RETURN VARCHAR2;

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

• iStrict - в случае ошибки возвращать null (0) или exception (1);
  
• iMode - режим вывода описания: 0 - значения реквизитов без их наименований; 1 - значения реквизитов с краткими наименованиями реквизитов; 2 - значения реквизитов с полными наименованиями реквизитов.

FUNCTION GetBankBookDesc(iRegionID PLS_INTEGER, iDocInstanceID PLS_INTEGER, iStrict PLS_INTEGER, iMode PLS_INTEGER) RETURN VARCHAR2;

Возвращает описание экземпляра счёта в банке:

• iStrict - в случае ошибки возвращать null (0) или exception (1);
  
• iMode - режим вывода описания: 0 - значения реквизитов без их наименований; 1 - значения реквизитов с краткими наименованиями реквизитов; 2 - значения реквизитов с полными наименованиями реквизитов.

FUNCTION GetMirCardDesc(iRegionID PLS_INTEGER, iDocInstanceID PLS_INTEGER, iStrict PLS_INTEGER, iMode PLS_INTEGER) RETURN VARCHAR2;

Возвращает описание экземпляра карты МИР:

• iStrict - в случае ошибки возвращать null (0) или exception (1);
  
• iMode - режим вывода описания: 0 - значения реквизитов без их наименований; 1 - значения реквизитов с краткими наименованиями реквизитов; 2 - значения реквизитов с полными наименованиями реквизитов.

FUNCTION GetCourtDecision3127Desc(iRegionID PLS_INTEGER, iDocInstanceID PLS_INTEGER, iStrict PLS_INTEGER, iMode PLS_INTEGER) RETURN VARCHAR2;

Возвращает описание экземпляра решения суда о взыскании сумм с гражданина (class_id=3127):

• iStrict - в случае ошибки возвращать null (0) или exception (1);
  
• iMode - режим вывода описания: 0 - значения реквизитов без их наименований; 1 - значения реквизитов с краткими наименованиями реквизитов; 2 - значения реквизитов с полными наименованиями реквизитов.

FUNCTION GetCommitteeDecision7284Desc(iRegionID PLS_INTEGER, iDocInstanceID PLS_INTEGER, iStrict PLS_INTEGER, iMode PLS_INTEGER) RETURN VARCHAR2;

Возвращает описание экземпляра решения комиссии об удержании переплаты с гражданина (class_id=7284):

• iStrict - в случае ошибки возвращать null (0) или exception (1);
  
• iMode - режим вывода описания: 0 - значения реквизитов без их наименований; 1 - значения реквизитов с краткими наименованиями реквизитов; 2 - значения реквизитов с полными наименованиями реквизитов.

FUNCTION GetDeathCert3132Desc(iRegionID PLS_INTEGER, iDocInstanceID PLS_INTEGER, iStrict PLS_INTEGER, iMode PLS_INTEGER) RETURN VARCHAR2;

Возвращает описание экземпляра документа «Справка о гибели члена семьи при прохождении военной службы (Военный

• комиссариат)» (class_id=3132):
  
• iStrict - в случае ошибки возвращать null (0) или exception (1).
  
• iMode - режим вывода описания: 0 - значения реквизитов без их наименований; 1 - значения реквизитов с краткими наименованиями реквизитов; 2 - значения реквизитов с полными наименованиями реквизитов.

FUNCTION GetDeathNotification3573Desc(iRegionID PLS_INTEGER, iDocInstanceID PLS_INTEGER, iStrict PLS_INTEGER, iMode PLS_INTEGER) RETURN VARCHAR2;

Возвращает описание экземпляра документа «Извещение члену семьи погибшего (пропавшего без вести) военнослужащего»

• (class_id=3573):
  
• iStrict - в случае ошибки возвращать null (0) или exception (1);
  
• iMode - режим вывода описания: 0 - значения реквизитов без их наименований; 1 - значения реквизитов с краткими наименованиями реквизитов; 2 - значения реквизитов с полными наименованиями реквизитов.

FUNCTION GetTransportCardDesc6601(iRegionID PLS_INTEGER, iDIID PLS_INTEGER, iStrict PLS_INTEGER, iMode PLS_INTEGER) RETURN VARCHAR2;

Возвращает описание «Транспортной карты Тюменской области» (class_id документа 6601).

• iMode - режим вывода описания: 0 - значения реквизитов без их наименований; 1 - значения реквизитов с краткими наименованиями реквизитов; 2 - значения реквизитов с полными наименованиями реквизитов.
  

Если реквизиты документа содержат ошибочные значения, поведение определяется параметром iStrict.

FUNCTION GetTransportCardDIID6601(iRegionID PLS_INTEGER, iPeopleID PLS_INTEGER, dDate DATE, iStrict PLS_INTEGER := 0) RETURN PLS_INTEGER;

Возвращает ID экземпляра «Транспортной карты Тюменской области» (class_id документа 6601), действующей на дату dDate, для человека iRegionID-iPeopleID. При отсутствии транспортной карты или при наличии более одной действующей транспортной карты поведение определяется параметром iStrict.

FUNCTION GetTransportCardNum6601(iRegionID PLS_INTEGER, iDIID PLS_INTEGER, iFormatValue PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Возвращает номер «Транспортной карты Тюменской области» (class_id документа 6601).
iFormatValue - определяет форматирование номера:

• 0 - не выполнять форматирование;
  
• 1 - добавлять пробелы между перед префиксом BB и после префикса CC.
  

Если реквизиты документа содержат ошибочные значения, поведение определяется параметром iStrict.

FUNCTION CSO_GetContractSvcForm_104(iRegionID PLS_INTEGER, iPDocID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает ключ формы социального обслуживания для договора на оказание гарантированных социальных услуг на основании
индивидуальной программы.
Параметры:

• iRegionID, iPDocID - ключ документа договора (ID класса = 8729).
  

Если договор не существует, не содержит реквизита “Индивидуальная программа” или индивидуальная программа не
содержит реквизита “Форма обслуживания”, возвращает null. Также возвращает null, если любой из этих реквизитов
содержит некорректное значение.

FUNCTION CSO_GetContractPlannedCost_104(iRegionID PLS_INTEGER, iPDocID PLS_INTEGER, dDate DATE) RETURN NUMBER;

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

• iRegionID, iPDocID - ключ документа договора (ID класса = 8729);
  
• dDate - дата, на которую ищется основание для планирования услуг.
  

Если документ не существует, не действует на указанную дату или не содержит сведений на эту дату, возвращает null.

FUNCTION CSO_GetContractComputedAmt_104(iRegionID PLS_INTEGER, iPDocID PLS_INTEGER, dDate DATE) RETURN NUMBER;

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

• iRegionID, iPDocID - ключ документа договора (ID класса = 8729);
  
• dDate - дата, на которую ищется основание для планирования услуг.
  

Если документ не существует, не действует на указанную дату или не содержит сведений на эту дату, возвращает null.

FUNCTION CSO_GetContractPlanTariff_104(iRegionID PLS_INTEGER, iPDocID PLS_INTEGER, iSubitemKeySlurp PLS_INTEGER, dDate DATE) RETURN NUMBER;

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

• iRegionID, iPDocID - ключ документа договора (ID класса = 8729);
  
• iSubitemKeySlurp - Slurp-ключ подуслуги;
  
• dDate - дата, на которую ищется основание для планирования услуг.
  

Если документ не существует, не действует на указанную дату или не содержит сведений на эту дату, возвращает null.

FUNCTION CSO_GetContrPayPlanTariff_104(iRegionID PLS_INTEGER, iPDocID PLS_INTEGER, iSubitemKeySlurp PLS_INTEGER, dDate DATE) RETURN NUMBER;

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

• iRegionID, iPDocID - ключ документа договора (ID класса = 8785);
  
• iSubitemKeySlurp - Slurp-ключ подуслуги;
  
• dDate - дата, на которую ищется основание для планирования услуг.
  

Если документ не существует, не действует на указанную дату или не содержит сведений на эту дату, возвращает null.

FUNCTION IsRehabActionAvailable(iRehabActionKeySlurp PLS_INTEGER, Restrictions uszn.TIntegerWithIDList) RETURN PLS_INTEGER;

Возвращает наличие у человека права на мероприятие социальной реабилитации (0/1).
Параметры:

• iRehabActionKeySlurp - Slurp-ключ вида мероприятия (справочник «Реабилитационные мероприятия», ID=771);
  
• Restrictions - список степеней ограничения способностей; iID=ID вида способности, iValue - ID степени ограничения.

PROCEDURE PDoc17627CompMaskCount(iRegionID PLS_INTEGER,
  iPCID PLS_INTEGER, iPDocID PLS_INTEGER, iOriginID PLS_INTEGER, sAudNotes VARCHAR2 := '');
 
/*********************************************************************************************************************
 Сведения о принадлежности к федеральному/региональному регистру
*********************************************************************************************************************/
 
-- Объединяет стыкующиеся и пересекающиеся периоды, содержащие одинаковые сведения, в таблицах
-- «Право на ГСП» и «Получение ГСП» в документе «Сведения о принадлежности к федеральному/региональному регистру»,
-- ID класса документа 11366.
-- Параметры:
--   iRegionID, iPDocID - ключ экземпляра документа;
--   iOriginID          - ID источника события;
--   sNotes             - примечания для аудита.
PROCEDURE PDoc11366CollapsePeriods(iRegionID PLS_INTEGER, iPDocID PLS_INTEGER, iOriginID PLS_INTEGER, sNotes VARCHAR2 := NULL);
 
/*********************************************************************************************************************
 Разное
*********************************************************************************************************************/
 
-- Создаёт человеку экземпляр СНИЛС. Возвращает ID созданного документа.

PROCEDURE PDoc11366CollapsePeriods(iRegionID PLS_INTEGER, iPDocID PLS_INTEGER, iOriginID PLS_INTEGER, sNotes VARCHAR2 := NULL);

Объединяет стыкующиеся и пересекающиеся периоды, содержащие одинаковые сведения, в таблицах
«Право на ГСП» и «Получение ГСП» в документе «Сведения о принадлежности к федеральному/региональному регистру»,
ID класса документа 11366.
Параметры:

• iRegionID, iPDocID - ключ экземпляра документа;
  
• iOriginID - ID источника события;
  
• sNotes - примечания для аудита.

FUNCTION CreateSNILS(iRegionID PLS_INTEGER, iPCID PLS_INTEGER, sValue VARCHAR2, iOriginID PLS_INTEGER, sNotes VARCHAR2 := NULL) RETURN PLS_INTEGER;

Создаёт человеку экземпляр СНИЛС. Возвращает ID созданного документа.
Параметры:

• iRegionID, iPCID - ключ человека;
  
• sValue - значение СНИЛС в формате “xxx-xxx-xxx xx”;
  
• iOriginID - ID источника события для аудита;
  
• sNotes - комментарии для аудита.
  

Если СНИЛС создать не удалось (человек не существует, недостаточно привилегий пользователя, некорректный номер
СНИЛС, СНИЛС у человека уже имеется, дубликат номера СНИЛС в БД) - возникает exception.

FUNCTION CreatePersonINN(iRegionID PLS_INTEGER, iPCID PLS_INTEGER, sValue VARCHAR2, iOriginID PLS_INTEGER, sNotes VARCHAR2 := NULL) RETURN PLS_INTEGER;

Создаёт человеку экземпляр документа «Свидетельство о постановке на учёт в налоговом органе физического лица по
месту жительства на территории РФ (ИНН)».
Возвращает ID созданного документа.
Параметры:

• iRegionID, iPCID - ключ человека;
  
• sValue - значение ИНН;
  
• iOriginID - ID источника события для аудита;
  
• sNotes - комментарии для аудита.
  

Если ИНН создать не удалось (человек не существует, недостаточно привилегий пользователя, некорректный номер
ИНН, документ у человека уже имеется) - возникает exception.

FUNCTION GetTempAccount(iRegionID PLS_INTEGER, iClassID PLS_INTEGER) RETURN VARCHAR2;

Возвращает новый временный лицевой счёт для класса iClassID в виде ВрNNNNNN.

FUNCTION GetKMNS104AppRegNum(iRegionID PLS_INTEGER, iPDocID PLS_INTEGER, iNumClassID PLS_INTEGER, iDateClassID PLS_INTEGER, iTerritoryClassID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает новый номер заявления для Департамента КМНС ЯНАО. Используется сквозная нумерация в пределах МО за год.
Параметры:

• iRegionID, iPDocID - ключ документа, для которого генерируется номер;
  
• iNumClassID - ID класса реквизита номера заявления;
  
• iDateClassID - ID класса реквизита даты обращения;
  
• iTerritoryClassID - ID класса реквизита МО.
  

Если значение реквизита номера обращения уже задано, возвращает его.
Если документ не существует или реквизиты даты обращения и МО не заполнены, возвращает null.