Документация iSZN
pkEgissoExp.sql
Ошибки
Error_NoExportKind
PROCEDURE Error_NoExportKind(iID PLS_INTEGER);
Описание
Вызывает exception “Вид экспорта не определён”.
Error_NoProvider
PROCEDURE Error_NoProvider(iRegionID PLS_INTEGER, iID PLS_INTEGER);
Описание
Вызывает exception “Поставщик информации не существует”.
Error_NoParticipant
Описание
Вызывает exception “Участник взаимодействия не найден”.
Error_NoPtcpForAgent
PROCEDURE Error_NoPtcpForAgent(iAgentRegID PLS_INTEGER, iAgentID PLS_INTEGER);
Описание
Вызывает exception “Участник взаимодействия для агента ... не найден”.
Error_NoExport
PROCEDURE Error_NoExport(iRegionID PLS_INTEGER, iID PLS_INTEGER);
Описание
Вызывает exception “Запись экспорта не найдена...”.
Error_NoPacket
PROCEDURE Error_NoPacket(iRegionID PLS_INTEGER, iID PLS_INTEGER);
Описание
Вызывает exception “Запись пакета экспорта не найдена...”.
Error_PacketIsLocked
PROCEDURE Error_PacketIsLocked(iRegionID PLS_INTEGER, iID PLS_INTEGER);
Описание
Вызывает exception “Запись пакета экспорта заблокирована...”.
Error_NoLocalMSZ
Описание
Вызывает exception “Локальная МСЗ не найдена”.
Error_NoPresencePoint
Описание
Вызывает exception “Точка присутствия ОНМСЗ не найдена”.
Справочники
GetExportKindName
FUNCTION GetExportKindName(iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;
Описание
Возвращает наименование вида экспорта.
Параметры:
- iID - ID вида экспорта;
- iStrict - определяет поведение при отсутствии вида экспорта.
GetProviderAgentName
FUNCTION GetProviderAgentName(iRegionID PLS_INTEGER, iID PLS_INTEGER, iMode PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;
Описание
Возвращает наименование агента поставщика информации ЕГИССО.
Параметры:
- iRegionID, iID - ключ поставщика информации;
- iMode - способ вывода имени (см. uszn.pkGen.FormatNameWithRKey);
- iStrict - определяет поведение при отсутствии поставщика.
GetAsgFactChangeActionName
FUNCTION GetAsgFactChangeActionName(iID PLS_INTEGER) RETURN VARCHAR2;
Описание
Возвращает наименование действия по изменению факта назначения.
Параметры:
- iID - ID действия (записи в справочнике).
Если такого действия в справочнике нет, возникает exception.
Работа с выгрузками и пакетами
CheckExportExists
PROCEDURE CheckExportExists(iRegionID PLS_INTEGER, iID PLS_INTEGER);
Описание
Проверяет существование записи экспорта.
CreateExport
FUNCTION CreateExport(iRegionID PLS_INTEGER, iProviderRegionID PLS_INTEGER, iProviderID PLS_INTEGER, iExportKindID PLS_INTEGER, iRecordsPerPacket PLS_INTEGER, dExportDate DATE, sDescription VARCHAR2) RETURN PLS_INTEGER;
Описание
Создаёт запись экспорта и возвращает его ID.
Параметры:
- iRegionID - ID района экспорта;
- iProviderRegionID, iProviderID - ключ поставщика информации;
- iExportKindID - ID вида экспорта;
- iRecordsPerPacket - максимальное количество записей в пакете;
- dExportDate - дата экспорта;
- sDescription - дополнительное описание экспорта.
CreateExportPacket
FUNCTION CreateExportPacket(iRegionID PLS_INTEGER, iExportID PLS_INTEGER, sRangeStart VARCHAR2, sRangeEnd VARCHAR2) RETURN PLS_INTEGER;
Описание
Создаёт запись пакета экспорта и возвращает его ID.
Параметры:
- iRegionID, iExportID - ключ записи экспорта;
- sRangeStart - начальное значение диапазона выгрузки;
- sRangeEnd - конечное значение диапазона выгрузки.
CloseExport
PROCEDURE CloseExport(iRegionID PLS_INTEGER, iID PLS_INTEGER);
Описание
Закрывает выгрузку по ключу. Если выгрузка уже закрыта, ничего не происходит. Если выгрузка не существует, возникает exception.
CancelExport
PROCEDURE CancelExport(iRegionID PLS_INTEGER, iID PLS_INTEGER, iDelete PLS_INTEGER);
Описание
Отменяет закрытие выгрузки с заданным ID.
Параметры:
- iRegionID, iID - ключ записи экспорта;
- iDelete - удалять ли запись экспорта после отмены (0/1).
Если выгрузка не закрыта, ничего не происходит.
Если выгрузка не существует, возникает exception.
ExportCleanup
PROCEDURE ExportCleanup(iRegionID PLS_INTEGER, iProviderRegionID PLS_INTEGER, iProviderID PLS_INTEGER, iExportKindID PLS_INTEGER, iDeleteExportedFacts PLS_INTEGER := 1);
Описание
Удаляет все незакрытые выгрузки.
Параметры:
- iRegionID - ID района экспорта;
- iProviderRegionID, iProviderID - ключ поставщика информации;
- iExportKindID - ID вида экспорта;
- iDeleteExportedFacts - удалять ли выгруженные факты назначения, связанные с пакетами выгрузки (0/1); имеет смысл только для выгрузки фактов назначения.
Если при этом будут удаляться факты назначения, загруженные в ЕГИССО (в том числе с ошибками), вызывает exception.
ExpPacket_Delete
PROCEDURE ExpPacket_Delete(iRegionID PLS_INTEGER, iID PLS_INTEGER, iIgnoreDeliveryState PLS_INTEGER, iDeleteExportedFacts PLS_INTEGER);
Описание
Удаляет пакет выгрузки.
Параметры:
- iRegionID, iID - ключ пакета;
- iIgnoreDeliveryState - игнорировать ли состояние доставки (0/1);
- iDeleteExportedFacts - удалять ли выгруженные факты назначения, связанные с пакетами выгрузки (0/1); имеет смысл только для выгрузки фактов назначения.
При выполнении возникает exception в следующих случаях:
- пакет не существует;
- пакет доставлен в ЕГИССО и iIgnoreDeliveryState=0;
- iDeleteFacts=1 и пакет содержит факты, загруженные в ЕГИССО (успешно либо со сбоем).
ExpPacket_SetFactsFailed
PROCEDURE ExpPacket_SetFactsFailed(iRegionID PLS_INTEGER, iID PLS_INTEGER);
Описание
Помечает пакет как доставленный в ЕГИССО (если он ещё не отмечен таким) и все факты с незаполненным статусом помечает как загруженные с ошибкой. Если пакет не существует или выгрузка не является выгрузкой фактов назначения, возникает exception.
GetExportPkgCount
FUNCTION GetExportPkgCount(iRegionID PLS_INTEGER, iExportID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;
Описание
Возвращает количество пакетов в выгрузке.
Если выгрузка не существует, поведение определяется параметром iStrict:
- либо возвращает 0, либо возникает exception.
GetExportByPacketGUID
FUNCTION GetExportByPacketGUID(rPkgGUID RAW, iStrict PLS_INTEGER := 1) RETURN uszn.r_egisso_exports%ROWTYPE;
Описание
Возвращает свойства выгрузки по GUID пакета, входящего в её состав. Если выгрузка с таким пакетом отсутствует, поведение определяется параметром iStrict.
Функции общего назначения
GetLocalMSZGUID
FUNCTION GetLocalMSZGUID(iRegionID PLS_INTEGER, iPKAFRegionID PLS_INTEGER, iPKAFID PLS_INTEGER, iItemRegionID PLS_INTEGER, iItemID PLS_INTEGER, iFinSrcRegionID PLS_INTEGER, iFinSrcID PLS_INTEGER) RETURN RAW;
Описание
Возвращает GUID локальной МСЗ.
Параметры:
- iRegionID - ID района, для которого ищется локальная МСЗ;
- iPKAFRegionID, iPKAFID - ключ признака учёта;
- iItemRegionID, iItemID - ключ предмета назначения;
- iFinSrcRegionID, iFinSrcID - ключ источника финансирования.
Поиск осуществляется с учётом иерархии районов вверх от заданного района.
Если соответствующей локальной МСЗ не найдено, возвращает null.
GetLocalMSZ
FUNCTION GetLocalMSZ(iRegionID PLS_INTEGER, iPKAFRegionID PLS_INTEGER, iPKAFID PLS_INTEGER, iItemRegionID PLS_INTEGER, iItemID PLS_INTEGER, iFinSrcRegionID PLS_INTEGER, iFinSrcID PLS_INTEGER) RETURN uszn.dic_egisso_local_measures%ROWTYPE;
Описание
Возвращает свойства локальной МСЗ.
Параметры:
- iRegionID - ID района, для которого ищется локальная МСЗ;
- iPKAFRegionID, iPKAFID - ключ признака учёта;
- iItemRegionID, iItemID - ключ предмета назначения;
- iFinSrcRegionID, iFinSrcID - ключ источника финансирования.
Поиск осуществляется с учётом иерархии районов вверх от заданного района.
Если соответствующей локальной МСЗ не найдено, возвращает null.
GetActualLmszGuid
FUNCTION GetActualLmszGuid(rGUID RAW, iStrict PLS_INTEGER) RETURN RAW;
Описание
Возвращает актуальный GUID меры с учётом истории изменения GUID.
Параметры:
- rGUID - GUID ЛМСЗ;
- iStrict - определяет поведение при отсутствии соответствия.
GetLocalCategoryGUID
FUNCTION GetLocalCategoryGUID(iPKAFRegionID PLS_INTEGER, iPKAFID PLS_INTEGER) RETURN RAW;
Описание
Возвращает GUID локальной льготной категории.
Параметры:
- iPKAFRegionID, iPKAFID - ключ признака учёта.
Если соответствующего признака учёта нет, возвращает null.
GetLocalMSZPeriodicity
FUNCTION GetLocalMSZPeriodicity(iPKindRegionID PLS_INTEGER, iPKindID PLS_INTEGER) RETURN VARCHAR2;
Описание
Возвращает код периодичности локальной МСЗ по справочнику ЕГИССО (двузначное число).
Параметры:
- iPKindRegionID, iPKindID - ключ вида выплаты.
Если такой вид выплаты отсутствует или периодичность определить невозможно, возвращает null.
GetLocalMSZNPAList
FUNCTION GetLocalMSZNPAList(iFilterRgnID PLS_INTEGER, rMeasureGUID RAW, dCheckDate DATE) RETURN CLOB;
Описание
Возвращает список НПА для указанной ЛМСЗ. Формат вывода - для таблицы “Информация о проведенной работе по выверке локального реестра мер социальной защиты (поддержки) и категории получателей МСЗ”.
GetOrgGUIDByUsername
Описание
#DEPRECATED Возвращает GUID организации, назначающей МСЗ, по имени пользователя. Если организацию определить не удалось, возвращает null.
GetOrgCode
FUNCTION GetOrgCode(iOrgRgnID PLS_INTEGER, iOrgID PLS_INTEGER) RETURN VARCHAR2;
Описание
Возвращает код участника ЕГИССО для организации, назначающей МСЗ, по ключу организации. Если организация не существует, возвращает null.
GetOrgCodeByUsername
Описание
#DEPRECATED Возвращает код участника ЕГИССО для организации, назначающей МСЗ, по имени пользователя. Если организацию определить не удалось, возвращает null.
GetOrgCodeByAgent
FUNCTION GetOrgCodeByAgent(iAgentRgnID PLS_INTEGER, iAgentID PLS_INTEGER) RETURN VARCHAR2;
Описание
Возвращает код участника ЕГИССО для организации, назначающей МСЗ, по ключу агента. Если организацию определить не удалось, возвращает null.
GetOrgKeyByUsername
Описание
Возвращает ключ участника ЕГИССО по имени пользователя. Если организацию определить не удалось, возвращает null.
GetOrgKeyByCode
FUNCTION GetOrgKeyByCode(sCode VARCHAR2, iStrict PLS_INTEGER) RETURN uszn.TRgnKey;
Описание
Возвращает ключ участника ЕГИССО по его коду.
Параметры:
- sCode - код участника, присвоенный ему в ЕГИССО;
- iStrict - определяет поведение при отсутствии участника с таким кодом.
GetOrgKeyByAgent
FUNCTION GetOrgKeyByAgent(iAgentRgnID PLS_INTEGER, iAgentID PLS_INTEGER, iProviderID PLS_INTEGER, iStrict PLS_INTEGER) RETURN uszn.TRgnKey;
Описание
Возвращает ключ участника ЕГИССО по ключу агента.
Параметры:
- iAgentRgnID, iAgentID - ключ агента;
- iProviderID - ID поставщика информации ЕГИССО (район совпадает с районом агента);
- iStrict - определяет поведение при отсутствии участника с таким ключом агента.
GetSMEV3ParticipantKey
FUNCTION GetSMEV3ParticipantKey(iProviderRgnID PLS_INTEGER, iProviderID PLS_INTEGER, iCheckScheduled PLS_INTEGER, iStrict PLS_INTEGER) RETURN uszn.TRgnKey;
Описание
Возвращает ключ участника взаимодействия СМЭВ-3 для указанного поставщика информации.
Параметры:
- iProviderRgnID, iProviderID - ключ поставщика информации ЕГИССО;
- iCheckScheduled - учитывать ли включённый вызов операций сервиса СМЭВ-3 (0/1);
- iStrict - определяет поведение при отсутствии соответствия и при неоднозначном соответствии.
Факты назначений
AllocateNewAsgFactID
FUNCTION AllocateNewAsgFactID(iRegionID PLS_INTEGER) RETURN PLS_INTEGER;
Описание
Возвращает новый ID записи выгруженного факта назначения.
AsgFact_GetExportVersion
FUNCTION AsgFact_GetExportVersion(sRootNSURI VARCHAR2, iStrict PLS_INTEGER) RETURN PLS_INTEGER;
Описание
Возвращает версию формата выгрузки по URi пространства имён корневого тега.
Возвращаемые значения - константы из числа IAsgExpVersion_xxx.
Параметры:
- sRootNSURI - URI пространства имён корневого тега выгрузки; должно начинаться с “urn://egisso-ru/msg/10.06.S/”;
- iStrict - определяет поведение в случае, если версия формата некорректна или не поддерживается.
AsgFact_GetPkgNSInfo
FUNCTION AsgFact_GetPkgNSInfo(iVersion PLS_INTEGER) RETURN TAsgFactPkgNSInfo;
Описание
Возвращает атрибуты и теги пакета с фактами назначения в зависимости от версии формата выгрузки.
Параметры:
- iVersion - ID версии формата выгрузки; константа из числа IAsgExpVersion_xxx.
Если формат не поддерживается, возникает exception.
AsgFact_GetTags
FUNCTION AsgFact_GetTags(iVersion PLS_INTEGER) RETURN TAsgFactTags;
Описание
Возвращает данные тегов факта назначения в зависимости от версии формата выгрузки.
Параметры:
- iVersion - ID версии формата выгрузки; константа из числа IAsgExpVersion_xxx.
Если формат не поддерживается, возникает exception.
AsgFact_PrepareExport
PROCEDURE AsgFact_PrepareExport( iRegionID PLS_INTEGER, iExportID PLS_INTEGER, iFactsPerPkg PLS_INTEGER, sNSPrefix_Pack VARCHAR2, sNSPrefix_Fact VARCHAR2, sNSPrefix_Pers VARCHAR2, sNSPrefix_Comm VARCHAR2, dForcePriorDate DATE := NULL); -- Возвращает стандартное имя файла пакета фактов назначения. -- Параметры: -- iRegionID - ID района выгрузки; -- iPkgIndex - порядковый номер пакета в выгрузке; -- rPkgGUID - GUID пакета; -- iAddFileExt - добавлять ли расширение файла (0/1). FUNCTION AsgFact_GetPkgFileName(iRegionID PLS_INTEGER, iPkgIndex PLS_INTEGER, rPkgGUID RAW, iAddFileExt PLS_INTEGER) RETURN VARCHAR2;
Описание
Готовит выгрузку фактов назначения:
- создаёт по необходимости пакеты;
- добавляет факты назначения, связанные с этими пакетами;
- добавляет во временную таблицу теги для созданных фактов назначения.
Параметры:
- iRegionID, iExportID - ключ выгрузки;
- iFactsPerPkg - количество фактов в одном пакете;
- sNSPrefix_Pack - префикс пространства имён пакета выгрузки;
- sNSPrefix_Fact - префикс пространства имён факта назначения;
- sNSPrefix_Pers - префикс пространства имён персональных данных ПФ РФ;
- sNSPrefix_Comm - префикс пространства имён общих вспомогательных данных СМЭВ.
- dForcePriorDate - принудительно заданная дата предыдущей выгрузки; применяется, если указана и раньше фактической даты предыдущей выгрузки, вычисленной по таблице выгрузок.
AsgFact_GetPkgFileName
FUNCTION AsgFact_GetPkgFileName(iRegionID PLS_INTEGER, iPkgIndex PLS_INTEGER, rPkgGUID RAW, iAddFileExt PLS_INTEGER) RETURN VARCHAR2;
Описание
Возвращает стандартное имя файла пакета фактов назначения.
Параметры:
- iRegionID - ID района выгрузки;
- iPkgIndex - порядковый номер пакета в выгрузке;
- rPkgGUID - GUID пакета;
- iAddFileExt - добавлять ли расширение файла (0/1).
AsgFact_SendPackets
FUNCTION AsgFact_SendPackets( iRegionID PLS_INTEGER, iProviderRegionID PLS_INTEGER, iProviderID PLS_INTEGER, iFactsPerPkg PLS_INTEGER, sDescription VARCHAR2, LOG IN OUT NOCOPY uszn.pkServerOps.TServerOpLog, iTaskRecID PLS_INTEGER, iLogLevel PLS_INTEGER, iErrorCount IN OUT NOCOPY PLS_INTEGER, dForcePriorDate DATE := NULL) RETURN PLS_INTEGER;
Описание
Отправляет в СМЭВ выгрузку фактов назначения.
Параметры:
- iRegionID - ID района выгрузки;
- iProviderRegionID, iProviderID - ключ поставщика информации;
- iFactsPerPkg - количество фактов в одном пакете;
- sDescription - описание выгрузки (необязательное);
- Log - протокол серверной операции;
- iTaskRecID - ID задачи (серверной операции); null, если выполняется не в составе серверной операции;
- iLogLevel - стартовый уровень протоколирования;
- iErrorCount - счётчик количества сбоев;
- dForcePriorDate - принудительно заданная дата предыдущей выгрузки; применяется, если указана и раньше фактической даты предыдущей выгрузки, вычисленной по таблице выгрузок.
Возвращает ID выгрузки или null, если данных для выгрузки нет либо в процессе выгрузки произошёл сбой.
AsgFact_ParseFactID
FUNCTION AsgFact_ParseFactID(iVersion PLS_INTEGER, iFactTagID PLS_INTEGER) RETURN RAW;
Описание
Выполняет разбор тега идентификации факта назначения из разобранных XML-данных.
Параметры:
- iVersion - ID версии формата выгрузки; константа из числа IAsgExpVersion_xxx;
- iFactTagID - ID тега <fact>.
Если тег не содержит необходимых данных, возникает exception.
AsgFact_ParseFact
PROCEDURE AsgFact_ParseFact(iVersion PLS_INTEGER, iFactTagID PLS_INTEGER, fact OUT uszn.r_egisso_exported_facts%ROWTYPE);
Описание
Выполняет разбор данных тега факта назначения из разобранных XML-данных.
Входные параметры:
- iVersion - ID версии формата выгрузки; константа из числа IAsgExpVersion_xxx;
- iFactTagID - ID тега <fact>.
Выходные параметры:
- fact - данные факта назначения.
Если тег не содержит необходимых данных, возникает exception.
AsgFact_ProcessRecord
PROCEDURE AsgFact_ProcessRecord( Rec TErrorRecord, LOG IN OUT NOCOPY uszn.pkServerOps.TServerOpLog, iTaskRecID PLS_INTEGER, iLogLevel PLS_INTEGER, iErrorCount IN OUT NOCOPY PLS_INTEGER, iWarnCount IN OUT NOCOPY PLS_INTEGER, iSavedOkCount IN OUT NOCOPY PLS_INTEGER, iSavedPrevCount IN OUT NOCOPY PLS_INTEGER, iNotSavedCount IN OUT NOCOPY PLS_INTEGER, iNotFoundCount IN OUT NOCOPY PLS_INTEGER, iNotActualCount IN OUT NOCOPY PLS_INTEGER, iDelCount IN OUT NOCOPY PLS_INTEGER, iUpdCount IN OUT NOCOPY PLS_INTEGER); -- Применяет результаты загрузки реестра фактов назначения в ЕГИССО. -- Параметры: -- iRegionID - ID обрабатываемого района; -- Log - данные протокола серверной операции; -- iTaskRecID - ID задачи (серверной операции); null, если выполняется не в составе серверной операции; -- iLogLevel - стартовый уровень протоколирования; -- iUpdAmtCount - количество назначенных сумм с обновлённым GUID; -- iUpdFactCount - количество обновлённых фактов назначения; -- iDelFactCount - количество удалённых фактов назначения. PROCEDURE AsgFact_ApplyLoadResults( iRegionID PLS_INTEGER, LOG IN OUT NOCOPY uszn.pkServerOps.TServerOpLog, iTaskRecID PLS_INTEGER, iLogLevel PLS_INTEGER, iUpdAmtCount IN OUT NOCOPY PLS_INTEGER, iUpdFactCount IN OUT NOCOPY PLS_INTEGER, iDelFactCount IN OUT NOCOPY PLS_INTEGER); /********************************************************************************************************************* Реестр локальных МСЗ
Описание
Обрабатывает данные, извлечённые из протокола загрузки данных факта назначения в ЕГИССО.
Параметры:
- Rec - разобранные результаты загрузки факта назначения в ЕГИССО;
- Log - данные протокола серверной операции;
- iTaskRecID - ID задачи (серверной операции); null, если выполняется не в составе серверной операции;
- iLogLevel - стартовый уровень протоколирования;
- iErrorCount - счётчик количества сбоев;
- iWarnCount - счётчик количества предупреждений;
- iSavedOkCount - количество успешно сохранённых в ЕГИССО фактов назначения;
- iSavedPrevCount - количество фактов назначения, которые были сохранены ранее;
- iNotSavedCount - количество несохранённых фактов назначения, в том числе:
- iNotFoundCount - количество фактов назначения, которые не были найдены в ЕГИССО;
- iNotActualCount - количество фактов назначения, которые находятся в ЕГИССО в неактуальном состоянии;
- iDelCount - количество выгруженных фактов назначения, которые были удалены в процессе обработки;
- iUpdCount - количество выгруженных фактов назначения, которые были обновлены в процессе обработки.
AsgFact_ApplyLoadResults
PROCEDURE AsgFact_ApplyLoadResults( iRegionID PLS_INTEGER, LOG IN OUT NOCOPY uszn.pkServerOps.TServerOpLog, iTaskRecID PLS_INTEGER, iLogLevel PLS_INTEGER, iUpdAmtCount IN OUT NOCOPY PLS_INTEGER, iUpdFactCount IN OUT NOCOPY PLS_INTEGER, iDelFactCount IN OUT NOCOPY PLS_INTEGER); /********************************************************************************************************************* Реестр локальных МСЗ *********************************************************************************************************************/ -- Помечает локальную МСЗ к выгрузке, устанавливая у неё статус добавления или изменения. -- При необходимости генерируется новый GUID. -- Если запись уже помечена как изменённая или добавленная, ничего не происходит. -- Если запись не существует или помечена для удаления, возникает exception. -- Возвращает 1, если запись была обновлена, иначе 0. FUNCTION LmszChg_ScheduleExport(rGUID RAW) RETURN PLS_INTEGER;
Описание
Применяет результаты загрузки реестра фактов назначения в ЕГИССО.
Параметры:
- iRegionID - ID обрабатываемого района;
- Log - данные протокола серверной операции;
- iTaskRecID - ID задачи (серверной операции); null, если выполняется не в составе серверной операции;
- iLogLevel - стартовый уровень протоколирования;
- iUpdAmtCount - количество назначенных сумм с обновлённым GUID;
- iUpdFactCount - количество обновлённых фактов назначения;
- iDelFactCount - количество удалённых фактов назначения.
Реестр локальных МСЗ
LmszChg_ScheduleExport
FUNCTION LmszChg_ScheduleExport(rGUID RAW) RETURN PLS_INTEGER;
Описание
Помечает локальную МСЗ к выгрузке, устанавливая у неё статус добавления или изменения. При необходимости генерируется новый GUID. Если запись уже помечена как изменённая или добавленная, ничего не происходит. Если запись не существует или помечена для удаления, возникает exception. Возвращает 1, если запись была обновлена, иначе 0.
LmszChg_GetLocalMSZTag
FUNCTION LmszChg_GetLocalMSZTag(rGUID RAW, iExportRegionID PLS_INTEGER, dExportDate DATE, sNSPrefix_Packet VARCHAR2, sNSPrefix_LMZ VARCHAR2, sSchemaNSURI VARCHAR2) RETURN CLOB;
Описание
Возвращает тег локальной меры соцзащиты для выгрузки «Изменения реестра локальных МСЗ».
Параметры:
- rGUID - GUID локальной МСЗ;
- iExportRegionID - ID района, для которого производится экспорт;
- dExportDate - дата экспорта;
- sNSPrefix_Packet - префикс пространства имён схемы пакета;
- sNSPrefix_LMZ - префикс пространства имён схемы ЛМСЗ;
- sSchemaNSURI - URI пространства имён схемы “urn://egisso-ru/msg/10.05.I/xxx”.
Если локальная МСЗ не существует, возникает exception.
Если данные локальной МСЗ заполнены не полностью (нет обязательных данных), возвращает null.
LmszChg_GetLmszGuids
FUNCTION LmszChg_GetLmszGuids( iExportRegionID PLS_INTEGER, iProviderRegionID PLS_INTEGER, iProviderID PLS_INTEGER, dPriorDate DATE, dExportDate DATE, iSelectMode PLS_INTEGER, rMinKey RAW := NULL, rMaxKey RAW := NULL) RETURN uszn.TGuidList;
Описание
Возвращает список GUID локальных мер соцзащиты, подлежащих выгрузке.
Параметры:
- iExportRegionID - ID района выгрузки;
- iProviderRegionID, iProviderID - ключ поставщика информации ЕГИССО;
- dPriorDate - дата предыдущей выгрузки;
- dExportDate - дата текущей выгрузки;
- iSelectMode - режим выгрузки: 1 - все; 2 - только те, которые загрузились в ЕГИССО с ошибкой; 3 - только помеченные к добавлению; 4 - только помеченные к обновлению; 5 - только помеченные к удалению;
- rMinKey, rMaxKey - диапазон возвращаемых значений; null означает отсутствие фильтрации.
Если таких МСЗ не найдено, возвращает пустой список.
Реестр организаций
OrgPptChg_GetPresencePointTag
FUNCTION OrgPptChg_GetPresencePointTag(rGUID RAW, iExportRegionID PLS_INTEGER, dExportDate DATE, sNSPrefix_Packet VARCHAR2, sNSPrefix_PPT VARCHAR2) RETURN CLOB;
Описание
Возвращает тег точки присутствия ОНМСЗ.
Параметры:
- rGUID - GUID локальной МСЗ;
- iExportRegionID - ID района, для которого производится экспорт;
- dExportDate - дата экспорта;
- sNSPrefix_Packet - префикс пространства имён схемы пакета;
- sNSPrefix_PPT - префикс пространства имён схемы точек присутствия.
Если точки присутствия ОНМСЗ не существует, возникает exception.
Если данные точки присутствия ОНМСЗ заполнены не полностью (нет обязательных данных), возвращает null.
Актуальная версия классификатора ЕГИССО
ActualClsfr_SendRequest
FUNCTION ActualClsfr_SendRequest( iRegionID PLS_INTEGER, iSenderRgnID PLS_INTEGER, iSenderID PLS_INTEGER, iClassifierCode PLS_INTEGER, LOG IN OUT NOCOPY uszn.pkServerOps.TServerOpLog, iTaskRecID PLS_INTEGER, iLogLevel PLS_INTEGER, iErrorCount IN OUT NOCOPY PLS_INTEGER) RETURN PLS_INTEGER;
Описание
Отправляет в СМЭВ запрос на получение актуальной версии классификатора ЕГИССО.
Параметры:
- iRegionID - ID района исходящего сообщения СМЭВ-3;
- iSenderRgnID, iSenderID - ключ участника взаимодействия, от имени которого отправляется запрос;
- iClassifierCode - код классификатора (согласно ВС); на данный момент доступны следующие коды: 10 - Классификатор МСЗ (полный); 22 - Справочник периодичности предоставления МСЗ; 23 - Классификатор единиц измерения;
- Log - протокол серверной операции;
- iTaskRecID - ID задачи (серверной операции); null, если выполняется не в составе серверной операции;
- iLogLevel - стартовый уровень протоколирования;
- iErrorCount - количество сбоев, произошедших в процессе выполнения операции.
Возвращает ID исходящего сообщения СМЭВ-3 или null, если сообщение отправить не удалось.
Обработка протоколов
Msg_ParseProtocol
PROCEDURE Msg_ParseProtocol(iRootTagID PLS_INTEGER, Protocol OUT TProtocol, iExportKind PLS_INTEGER);
Описание
Выполняет разбор протокола обработки сообщения из разобранных XML-данных.
Параметры:
- iRootTagID - ID корневого тега предметных данных сообщения (тега <response>);
- Protocol - результат разбора;
- iExportKind - предполагаемый вид выгрузки, ответом на которую является протокол; константа из числа IExpKindID_xxx.
Если тег не содержит необходимых данных, возникает exception.
Msg_LogProtocolStatus
PROCEDURE Msg_LogProtocolStatus(Protocol TProtocol, LOG IN OUT NOCOPY uszn.pkServerOps.TServerOpLog, iLogLevel PLS_INTEGER);
Описание
Выводит в протокол информацию о разобранном протоколе загрузки данных в ЕГИССО.
Параметры:
- Protocol - результат разбора протокола загрузки данных в ЕГИССО;
- Log - протокол серверной операции;
- iLogLevel - стартовый уровень протоколирования.
Msg_Facts_GetLoadStatus
FUNCTION Msg_Facts_GetLoadStatus(Rec TErrorRecord) RETURN PLS_INTEGER;
Описание
Возвращает статус загрузки записи (константу из числа IFact_LoadStatus_xxx) по результатам обработки записи в ЕГИССО.