Сервис инкрементального обновления
Назначение
Сервис инкрементального обновления предназначен для получения информационными системами сведений Реестра об услуге (функции, органе власти), а также для осуществления информационного взаимодействия с ЕПГУ в части обеспечения полноты и достоверности данных.
Сценарии использования
Основной сценарий использования данного сервиса состоит в получении списка изменённых и удалённых объектов (услуг, функций, органов власти), и последующем получении полного описания для каждого изменённого объекта. Помимо этого сервис обеспечивает взаимодействие с ЕПГУ в рамках механизмов обратной связи и предпросмотра. Таким образом, для обеспечения обмена данными в рамках взаимодействия Реестра с внешними системами-потребителями реализованный веб-сервис содержит методы, обеспечивающие:
- передачу перечня отозванных сущностей;
- передачу перечня измененных сущностей;
- поиск информации об услуге по ее идентификатору;
- поиск информации об ОГВ по его идентификатору;
- обновление статуса сущности;
- прием сообщений от ЕПГУ в рамках обеспечения механизма обратной связи;
- передача результатов обработки сообщений от ЕПГУ в рамках механизма обратной связи;
- получение реквизитов страницы предпросмотра на ЕПГУ;
- передачу перечня базовых справочников;
- передачу значений заданного базового справочника.
getRevokationList
Наименование: Запрос отозванных сущностей Принимает электронное сообщение с SSN и возвращает перечень отозванных сущностей
getChanges
Наименование: Запрос измененных сущностей Принимает электронное сообщение с SSN и возвращает перечень изменных сущностей
getPsPassport
Наименование: Поиск информации об услуге/функции по ее идентификатору Принимает электронное сообщение с идентификатором услуги/функции и возвращает описание услуги/функции
getRStateStructure
Наименование: Поиск информации об органе власти по его идентификатору Принимает электронное сообщение с идентификатором органа власти и возвращает описание органа власти
updateStatus
Наименование: Обновление статуса сущности Принимает электронное сообщение с описанием статуса и сущности для обновления и возвращает результат операции
registerFeedBack
Наименование: Прием сообщений от ЕПГУ в рамках обратной связи Принимает электронное сообщение с описанием найденной ошибки в данных на ЕПГУ и возвращает идентификатор заведенной в ФРГУ ошибки
getFeedBack
Наименование: Передача результатов обработки сообщений от ЕПГУ в рамках обратной связи Принимает электронное сообщение от ЕПГУ с идентификатором заведенной в Реестре ошибки (см. метод registerFeedBack) и возвращает результат обработки сообщений от ЕПГУ
psPassportPreview
Наименование: Прием реквизитов страницы предпросмотра на ЕПГУ Принимает электронное сообщение с реквизитами сформированной на ЕПГУ страницы предпросмотра
getDictionary
Наименование: Поиск информации о базовом справочнике по его наименованию Принимает электронное сообщение с наименованием базового справочника и возвращает состав значений справочника
getListDictionary
Наименование: Запрос перечня базовых справочников. Принимает электронное сообщение и возвращает перечень базовых справочников
Методы getChanges и getRevokationList используются для получения списка изменённых либо удалённых объектов. Метод getChanges возвращает список объектов, в которые вносились какие-то изменения. Метод getRevokationList возвращает список объектов, которые снимались с публикации либо удалялись.
Для актуализации данных в Реестре и внешней системе используется значение SSN (system state number). Начальное значение SSN=0. При каждом изменении в объектах Реестра (услуги, функции, органы власти) значение SSN в базе Реестра увеличивается. Сервис возвращает изменения начиная с переданного SSN и до текущего момента. Помимо списка изменённых объектов методы возвращают значение SSN соответствующее этим изменениям. Внешней системе необходимо сохранить это значение, и в следующий раз запросить изменения с этим SSN, чтобы получить список изменений с момента последней синхронизации.
Поддерживается также и получение всех объектов реестра. В этом случае в качестве параметра SSN можно передать значение 0. Данный метод можно возвращать значительный объем информации, что должно учитываться при принятии решения о его применении в каждом конкретном случае.
В Реестре существуют два вида основных вида объектов: услуги/функции и органы власти. Методы getPsPassport и getRStateStructure используются для получения полного описания услуги/функции и органа власти по его идентификатору, полученному из методов getChanges/getRevokationList.
Органы власти и услуги/функции могут содержать перекрестные ссылки, потому рекомендуется сначала полностью получить все изменения, и лишь после этого осуществить проверку ссылочной целостности.
Второй вариант использования данного сервиса состоит в получении от ЕПГУ сообщений о найденных на портале ошибках в сведениях о услугах (функциях) и органах власти (метод registerFeedBack) и отправке обратно по запросу от ЕПГУ результатов обработки сообщений (метод getFeedBack).
Третий вариант использования данного сервиса состоит в получении от ЕПГУ реквизитов сформированной в нем страницы предпросомотра (метод psPassportPreview). Четвертый вариант использования данного сервиса состоит в получении перечня базовых справочников (метод getListDictionary) и последующем получении значений выбранного базового справочника (метод getDictionary).