Сервис инкрементального обновления

Назначение

Сервис инкрементального обновления предназначен для получения информационными системами сведений Реестра об услуге (функции, органе власти), а также для осуществления информационного взаимодействия с ЕПГУ в части обеспечения полноты и достоверности данных.

Сценарии использования

Основной сценарий использования данного сервиса состоит в получении списка изменённых и удалённых объектов (услуг, функций, органов власти), и последующем получении полного описания для каждого изменённого объекта. Помимо этого сервис обеспечивает взаимодействие с ЕПГУ в рамках механизмов обратной связи и предпросмотра. Таким образом, для обеспечения обмена данными в рамках взаимодействия Реестра с внешними системами-потребителями реализованный веб-сервис содержит методы, обеспечивающие:

  • передачу перечня отозванных сущностей;
  • передачу перечня измененных сущностей;
  • поиск информации об услуге по ее идентификатору;
  • поиск информации об ОГВ по его идентификатору;
  • обновление статуса сущности;
  • прием сообщений от ЕПГУ в рамках обеспечения механизма обратной связи;
  • передача результатов обработки сообщений от ЕПГУ в рамках механизма обратной связи;
  • получение реквизитов страницы предпросмотра на ЕПГУ;
  • передачу перечня базовых справочников;
  • передачу значений заданного базового справочника.

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).

Руководство пользователя

скачать

0 Вложения
8557 Просмотров
Среднее (0 Голоса)
Средний рейтинг 0.0 звезд из 5.
Комментарии
Алексей Радионов
1) Подскажите, а какие сущности попадают в "перечень измененных сущностей"? А если точнее, сущности в каких статусах? По наблюдениям - только в статусе "опубликовано" (published). Так например услуга в статусе "опубликован, вносятся изменения" не попадает в этот список.
2) И второй вопрос. Как быть в случае если услугу Х изменили (Например указали телефон 8 800 800 8080), затем опубликовали, затем снова сняли с публикации и еще раз изменили (на телефон 8 900 900 9090), но не опубликовали? При запросе данных методом getChanges в список должна попать услуга Х (по логике данные должны были обновится), но какие данные отдаст нам потом сервис в методе getPsPassport? С тем телефоном который был на момент публикации услуги (80), или с текущим состоянием услуги (90)?
Отправлено в 16.08.16 20:12.
Anastasiya Dus
1)Подскажите, а какие сущности попадают в "перечень измененных сущностей"? А если точнее, сущности в каких статусах? По наблюдениям - только в статусе "опубликовано" (published). Так например услуга в статусе "опубликован, вносятся изменения" не попадает в этот список.

Ответ: Метод getChanges возвращает объекты в ствтусах 'PUBLISHED','PUBLISHED_LOCAL_NEW','PUBLISHED_LOCAL_EDITED','PUBLISHED_REMARKS_NE­W','PUBLISHED_REMARKS_EDITED','PUBLISHED_UPLINK_NEW','PUBLISHED_UPLINK_EDITED'

Ме­тод getRevokation возвращает объекты в статусах
'PUBLISH_RENOUNCED','DELETED','DELETED_PUBLISHED','DELETED_NEW'

2)И второй вопрос. Как быть в случае если услугу Х изменили (Например указали телефон 8 800 800 8080), затем опубликовали, затем снова сняли с публикации и еще раз изменили (на телефон 8 900 900 9090), но не опубликовали? При запросе данных методом getChanges в список должна попать услуга Х (по логике данные должны были обновится), но какие данные отдаст нам потом сервис в методе getPsPassport? С тем телефоном который был на момент публикации услуги (80), или с текущим состоянием услуги (90)?

Ответ: Сервис отдаст данные с текущим состоянием услуги ( телефон 90 ) исторические данные хранятся в усеченном виде и сервисом не возвращаются
Отправлено в 17.08.16 18:29 в ответ на Алексей Радионов.
Юрий Юрьевич Рягин
Добрый день, подскажите пожалуйста почему перестал быть доступен сервис ФРГУ по адресу http://frgu.gosuslugi.ru/ws-services/externalSystemService?wsdl ? Как теперь можно им воспользоваться ?
Отправлено в 20.10.16 15:17.