PROCEDURE Error_NoService(iServiceID PLS_INTEGER);

Вызывает exception “Сервис ... не найден”.

PROCEDURE Error_NoSvcOperation(iOperationID PLS_INTEGER);

Вызывает exception “Операция сервиса ... не найдена”.

PROCEDURE Error_NoOrganization(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception “Организация ... не найдена”.

PROCEDURE Error_NoSystem(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception “Информационная система ... не найдена”.

PROCEDURE Error_NoRequest(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception “Запрос ... не существует”.

PROCEDURE Error_RequestLocked(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception “Запрос ... заблокирован”.

PROCEDURE Error_RequestDataEmpty(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception “Данные для запроса ... отсутствуют”.

PROCEDURE Error_NoRequestSisHcsGuid(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception “У запроса ... отсутствует идентификатор в ГИС ЖКХ”.

PROCEDURE Error_NoRequestCall(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception “Запись отправки запроса ... не существует”.

PROCEDURE Error_RequestCallLocked(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception “Запись отправки запроса ... заблокирована”.

PROCEDURE Error_CallIsNotDelivered(iRegionID PLS_INTEGER, iCallID PLS_INTEGER);

Вызывает exception “Запрос не был доставлен...”.

PROCEDURE Error_ReplyDataEmpty(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception “Данные ответа ... отсутствуют”.

PROCEDURE Error_CallIsNotAPoll(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception “Запись отправки запроса ... не является опросом состояния”.

FUNCTION GetUserGroupServicePrivs(iUserGroupID PLS_INTEGER, iServiceID PLS_INTEGER, iIsPermission PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает привилегии группы пользователей на сервис ГИС ЖКХ.
Параметры:

• iUserGroupID - ID группы пользователей;
  
• iServiceID - ID сервиса;
  
• iIsPermission - какой вид привилегий требуется получить: 0 - запрещение, 1 - разрешение.
  

Возвращает набор указанных привилегий в виде битовой маски. Если привилегии отсутствуют, возвращает 0.

PROCEDURE SetUserGroupServicePrivs(iUserGroupID PLS_INTEGER, iServiceID PLS_INTEGER, iPermittedPrivs PLS_INTEGER, iRestrictedPrivs PLS_INTEGER);

Устанавливает привилегии группы пользователей на сервис ГИС ЖКХ.
Параметры:

• iUserGroupID - ID группы пользователей;
  
• iServiceID - ID сервиса;
  
• iPermittedPrivs - набор разрешений в виде битовой маски;
  
• iRestrictedPrivs - набор запрещений в виде битовой маски.

FUNCTION GetServiceUserPrivs(iServiceID PLS_INTEGER, sUserName VARCHAR2 := USER) RETURN PLS_INTEGER;

Возвращает привилегии указанного пользователя на сервис ГИС ЖКХ в виде битовой маски.
Параметры:

• iServiceID - ID сервиса;
  
• sUserName - имя пользователя СУБД.

PROCEDURE CheckServicePriv(iServiceID PLS_INTEGER, iPriv PLS_INTEGER);

Проверяет, что у текущего пользователя есть все указанные привилегии на сервис ГИС ЖКХ.
Параметры:

• iServiceID - ID сервиса;
  
• iPriv - сумма битовых флагов проверяемых привилегий.

FUNCTION GetServiceName(iServiceID PLS_INTEGER, iNameKind PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Возвращает наименование сервиса ГИС ЖКХ.
Параметры:

• iServiceID - ID сервиса;
  
• iNameKind - вид наименование: 0 - техническое, 1 - отображаемое;
  
• iStrict - поведение при отсутствии указанного сервиса.

FUNCTION GetSvcOperationName(iOperationID PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Возвращает наименование операции сервиса ГИС ЖКХ.
Параметры:

• iOperationID - ID операции;
  
• iStrict - поведение при отсутствии операции.

FUNCTION GetISSlurpKey(iRegionID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает Slurp-ключ информационной системы ГИС ЖКХ из региональных настроек экземпляра Системы.
Параметры:

• iRegionID - ID района, для которого необходимо получить значение настройки;
  
• iStrict - определяет поведение при отсутствии значения настройки.

PROCEDURE GetISKey(iRegionID PLS_INTEGER, iStrict PLS_INTEGER, iSystemRgnID OUT PLS_INTEGER, iSystemID OUT PLS_INTEGER);

Возвращает районный ключ информационной системы ГИС ЖКХ из региональных настроек экземпляра Системы.
Входные параметры:

• iRegionID - ID района, для которого необходимо получить значение настройки;
  
• iStrict - определяет поведение при отсутствии значения настройки.
  

Выходные параметры:

• iSystemRgnID, iSystemID - ключ информационной системы или null.

PROCEDURE GetISOperatorKey(iSystemRgnID PLS_INTEGER, iSystemID PLS_INTEGER, iStrict PLS_INTEGER, iOperatorRgnID OUT PLS_INTEGER, iOperatorID OUT PLS_INTEGER);

Возвращает районный ключ оператора ИС ГИС ЖКХ.
Входные параметры:

• iSystemRgnID, iSystemID - ключ ИС, для которой необходимо получить оператора;
  
• iStrict - определяет поведение при отсутствии ИС.
  

Выходные параметры:

• iOperatorRgnID, iOperatorID - ключ оператора ИС или null.

FUNCTION GetOrganizationName(iRegionID PLS_INTEGER, iID PLS_INTEGER, iStrict PLS_INTEGER, iDisplayMode PLS_INTEGER := 0) RETURN VARCHAR2;

Возвращает наименование организации, зарегистрированной в ГИС ЖКХ.
Параметры:

• iRegionID, iID - ключ организации;
  
• iStrict - поведение при отсутствии указанной организации;
  
• iDisplayMode - способ вывода результата, как для pkGen.FormatNameWithRKey.

FUNCTION GetOrganizationPPAGUID(iRegionID PLS_INTEGER, iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN RAW;

Возвращает PPAGUID организации, зарегистрированной в ГИС ЖКХ.
Параметры:

• iRegionID, iID - ключ организации;
  
• iStrict - поведение при отсутствии указанной организации.

PROCEDURE GetOrganizationSigCertInfo(iOrganizationRgnID PLS_INTEGER, iOrganizationID PLS_INTEGER, sKeyContainerName OUT VARCHAR2, iGostVersion OUT PLS_INTEGER);

Возвращает информацию о сертификате подписи организации, зарегистрированной в ГИС ЖКХ.
Входные параметры:

• iOrganizationRgnID, iOrganizationID - ключ организации.
  

Выходные параметры:

• sKeyContainerName - наименование ключевого контейнера;
  
• iGostVersion - идентификатор версии ГОСТ ЭП.
  

Если организация не существует или для неё не задан сертификат ЭП, возникает exception.

FUNCTION GetISName(iRegionID PLS_INTEGER, iID PLS_INTEGER, iNameKind PLS_INTEGER, iStrict PLS_INTEGER, iDisplayMode PLS_INTEGER := 0) RETURN VARCHAR2;

Возвращает наименование информационной системы, зарегистрированной в ГИС ЖКХ.
Параметры:

• iRegionID, iID - ключ информационной системы;
  
• iNameKind - вид наименования: 1 - полное, 2 - краткое;
  
• iStrict - поведение при отсутствии указанной информационной системы;
  
• iDisplayMode - способ вывода результата, как для pkGen.FormatNameWithRKey.

FUNCTION GetISGUID(iRegionID PLS_INTEGER, iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN RAW;

Возвращает GUID информационной системы, зарегистрированной в ГИС ЖКХ.
Параметры:

• iRegionID, iID - ключ информационной системы;
  
• iStrict - поведение при отсутствии указанной информационной системы.

FUNCTION GetUserGUID(iOrgRgnID PLS_INTEGER, iOrgID PLS_INTEGER, sUsername VARCHAR2, iUseDefault PLS_INTEGER, iStrict PLS_INTEGER) RETURN RAW;

Возвращает GUID пользователя ГИС ЖКХ.
Параметры:

• iOrgRgnID, iOrgID - ключ организации ГИС ЖКХ;
  
• sUsername - имя пользователя Системы;
  
• iUseDefault - использовать ли пользователя по умолчанию, если указанный пользователь не является пользователем данной организации;
  
• iStrict - определяет поведение при отсутствии значения.

FUNCTION GetServiceBaseURL(iStrict PLS_INTEGER) RETURN VARCHAR2;

Возвращает префикс URL для отправки запросов к сервисам.
Значение берётся из настройки SIS_HCS_SERVICE_URL.
Параметры:

• iStrict - поведение в случае, если значение настройки не задано.

FUNCTION GetServiceRequestURL(iServiceID PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Возвращает URL для отправки запросов к сервису.
Параметры:

• iServiceID - ID сервиса;
  
• iStrict - поведение в случае, если сервис не существует или значение настройки SIS_HCS_SERVICE_URL не задано.

FUNCTION EncodeIdentityDocType(iInternalKey PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

Перекодировка вида ДУЛ из iSZN в ГИС ЖКХ.

PROCEDURE FormatIdentitySerNum(iDocType PLS_INTEGER, iDocClassID PLS_INTEGER, sSeries IN OUT VARCHAR2, sNumber IN OUT VARCHAR2);

Форматирует серию и номер ДУЛ в соответствии с требованиями ГИС ЖКХ.
Параметры:

• iDocType - код документа по ГИС ЖКХ;
  
• iDocClassID - ID класса документа в iSZN (игнорируется, если соответствие однозначное);
  
• sSeries - серия документа в iSZN;
  
• sNumber - номер документа в iSZN.

FUNCTION AllocateNewRequestID(iRegionID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает новый ID записи запроса в заданном районе.

FUNCTION AllocateNewCallID(iRegionID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает новый ID записи отправки запроса в заданном районе.

FUNCTION AllocateNewCallProcID(iRegionID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает новый ID записи обработки ответа на запрос в заданном районе.

FUNCTION AllocateNewExpDataID(iRegionID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает новый ID записи выгруженных сведений в заданном районе.

PROCEDURE LockRequest(iRegionID PLS_INTEGER, iRequestID PLS_INTEGER);

Устанавливает эксклюзивную блокировку на запрос в ГИС ЖКХ.
Параметры:

• iRegionID, iRequestID - ключ сообщения.
  

Если запрос не существует или заблокирован, возникает exception.

PROCEDURE CheckRequestServicePriv(iRegionID PLS_INTEGER, iRequestID PLS_INTEGER, iPriv PLS_INTEGER);

Проверяет привилегии пользователя на работу с сервисом ГИС ЖКХ для указанного запрос.
Параметры:

• iRegionID, iRequestID - ключ запроса;
  
• iPriv - битовая маска проверяемых привилегий.
  

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

FUNCTION ScheduleRequest(
  iRegionID PLS_INTEGER, iOperationID PLS_INTEGER, iSenderRgnID PLS_INTEGER, iSenderID PLS_INTEGER,
  cData CLOB, sDataAttribs VARCHAR2, sVersion VARCHAR2, iPostpone PLS_INTEGER, iCompressData PLS_INTEGER) RETURN PLS_INTEGER;

Создаёт и ставит в очередь на отправку запрос к сервису ГИС ЖКХ.
Параметры:

• iRegionID - ID района сообщения;
  
• iOperationID - ID операции сервиса;
  
• iSenderRgnID, iSenderID - ключ отправителя запроса; если null, запрос отправляется от имени оператора ИС;
  
• cData - предметные данные запроса;
  
• sDataAttribs - дополнительные атрибуты для предметных данных запроса;
  
• sVersion - версия сервиса для атрибута base:version; если null, атрибут не добавляется;
  
• iPostpone - отложить ли отправку (0/1);
  
• iCompressData - сжимать ли данные (0/1).
  

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

FUNCTION ScheduleCall(iRegionID PLS_INTEGER, iRequestID PLS_INTEGER, dNewTime DATE) RETURN DATE;

Задаёт время отправки или опроса состояния обработки для существующего запроса.
Возвращает предыдущее значение времени отправки.
Параметры:

• iRegionID, iRequestID - ключ запроса;
  
• dNewTime - желаемая дата и время отправки.
  

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

FUNCTION UnscheduleRequest(iRegionID PLS_INTEGER, iRequestID PLS_INTEGER) RETURN DATE;

Отменяет отправку запроса или опроса состояния обработки запроса.
Параметры:

• iRegionID, iRequestID - ключ запроса.
  

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

FUNCTION GetCallToProcessKeys(iiRegionIDs uszn.TIntegerList, iMaxRecordCount PLS_INTEGER) RETURN uszn.TRgnKeyList;

Возвращает список ключей записей об отправке запроса, подлежащих обработке.
Параметры:

• iiRegionIDs - список ID рабочих районов;
  
• iMaxRecordCount - максимальное допустимое количество записей, которое возвращает функция.
  

Возвращается список ключей только тех записей, на обработку которых текущий пользователь имеет право.

FUNCTION GetPollIndex(iRegionID PLS_INTEGER, iCallID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает порядковый номер записи опроса состояния обработки запроса, начиная с 1.
Учитываются только записи, доставленные в ГИС ЖКХ.
Параметры:

• iRegionID, iCallID - ключ опроса состояния обработки запроса.
  

Если запись не является записью опроса состояния или не существует, возникает exception.

FUNCTION ProcessResult(iRegionID PLS_INTEGER, iCallID PLS_INTEGER, iAudOriginID PLS_INTEGER, sAudNotes VARCHAR2 := NULL) RETURN PLS_INTEGER;

Обрабатывает результат отправки запроса.
Параметры:

• iRegionID, iCallID - ключ записи об отправке;
  
• iAudOriginID - источник события для аудита;
  
• sAudNotes - примечания для аудита.
  

Возвращает ID созданной записи об обработке.

PROCEDURE SetExportedDataRequest(iRegionID PLS_INTEGER, iRequestID PLS_INTEGER, iiDataIDs uszn.TIntegerList);

Привязывает отправленные данные к запросу к сервису ГИС ЖКХ.
Параметры:

• iRegionID, iRequestID - ключ запроса;
  
• iiDataIDs - ID отправленных в составе запроса данных.

FUNCTION NsiCommon_ExportNsiList(iRegionID PLS_INTEGER) RETURN PLS_INTEGER;

Отправляет запрос exportNsiListRequest.
Параметры:

• iRegionID - ID рабочего района, в котором будет создан запрос.
  

Возвращает ID созданного запроса.

FUNCTION GetSubsidyAsgIDs104(iRegionID PLS_INTEGER) RETURN uszn.pkGen.TIntegers;

Возвращает список ID назначений для выгрузки сведений о получателях субсидий ЖКУ (ДСЗН ЯНАО).
Параметры:

• iRegionID - ID района.

PROCEDURE PrepareImportCitizenSubsidy104(
  iRegionID PLS_INTEGER, iAsgID PLS_INTEGER,
  cTag OUT CLOB, iiDataIDs OUT uszn.pkGen.TIntegers);
-- Возвращает ключ объекта для выгрузки сведений о получателях ЖКВ (ДСЗН ЯНАО).
-- Параметры:
--   iAsgID  - ID назначения;
--   iCollID - ID коллектива, для которого рассчитано назначение.
-- В качестве ключа используется To_Char(<ID назначения>)-To_Char(<ID коллектива class_id=46>).
FUNCTION  GetCompensationObjKey104(iAsgID PLS_INTEGER, iCollID PLS_INTEGER) RETURN VARCHAR2;

Готовит данные для операции “Импорт сведений о гражданине, получающем субсидии” (ДСЗН ЯНАО).
Входные параметры:

• iRegionID, iAsgID - ключ назначенной выплаты “Субсидия на оплату жилья и коммунальных услуг” (000-127).
  

Выходные параметры:

• cTag - содержимое тега;
  
• iiDataIDs - список ID выгружаемых объектов.
  

Если назначение не существует или данные выгружать не требуется, cTag будет null.
Если выгрузка требуется, в cTag помещается заполненный тег <importCitizenSubsidy>, а соответствующие записи о
выгрузке сведений в ГИС ЖКХ рекурсивно добавляются/обновляются и их ID добавляются в iiDataIDs.
Если при формировании сведений недостаточно обязательных данных, возникает exception.

FUNCTION GetCompensationObjKey104(iAsgID PLS_INTEGER, iCollID PLS_INTEGER) RETURN VARCHAR2;

Возвращает ключ объекта для выгрузки сведений о получателях ЖКВ (ДСЗН ЯНАО).
Параметры:

• iAsgID - ID назначения;
  
• iCollID - ID коллектива, для которого рассчитано назначение.
  

В качестве ключа используется To_Char(<ID назначения>)-To_Char(<ID коллектива class_id=46>).

PROCEDURE ParseCompensationObjKey104(sObjKey VARCHAR2, iAsgID OUT PLS_INTEGER, iCollID OUT PLS_INTEGER);

Разбирает ключ объекта для выгрузки сведений о получателях ЖКВ (ДСЗН ЯНАО).
Входные параметры:

• sObjKey - ключ объекта.
  

Выходные параметры:

• iAsgID - ID назначения;
  
• iCollID - ID коллектива, для которого рассчитано назначение.
  

Если ключ пустой, возвращает null. Если ключ некорректен, возникает exception.

FUNCTION GetCompensationObjKeys104(iRegionID PLS_INTEGER) RETURN uszn.pkGen.TStrings255;

Возвращает список ключей объектов для выгрузки сведений о получателях ЖКВ (ДСЗН ЯНАО).
Параметры:

• iRegionID - ID района.

PROCEDURE PrepareImportCitizenCompens104(
  iRegionID PLS_INTEGER, iAsgID PLS_INTEGER, iCollID PLS_INTEGER,
  cTag OUT CLOB, iiDataIDs OUT uszn.pkGen.TIntegers);
 
/*********************************************************************************************************************
 Разное
*********************************************************************************************************************/
 
-- Возвращает список ID выгруженных объектов, непосредственно или косвенно связанных с запросом к сервису.
-- Параметры:
--   iRegionID, iRequestID - ключ запроса.
FUNCTION  GetRequestRelatedExpDataIDs(iRegionID PLS_INTEGER, iRequestID PLS_INTEGER) RETURN uszn.TIntegerList;

Готовит данные для операции “Импорт сведений о гражданах, получающих компенсации расходов” (ДСЗН ЯНАО).
Входные параметры:

• iRegionID, iAsgID - ключ назначенной выплаты “Возмещение расходов оплаты жилья, коммунальных услуг и топлива (ЖКВ)” (104-29);
  
• iCollID - ID коллектива, для которого будет браться адрес.
  

Выходные параметры:

• cTag - содержимое тега;
  
• iiDataIDs - список ID выгружаемых объектов.

FUNCTION GetRequestRelatedExpDataIDs(iRegionID PLS_INTEGER, iRequestID PLS_INTEGER) RETURN uszn.TIntegerList;

Возвращает список ID выгруженных объектов, непосредственно или косвенно связанных с запросом к сервису.
Параметры:

• iRegionID, iRequestID - ключ запроса.