6. История изменений

Таблица 6.1 История изменений

Версия

Доработки

Изменения документа

2.11.0

  1. [PODD-3480] - Передача запросов с табличными параметрами в Витрину (обновление)

  2. [PODD-4413] - Расширение состава идентифицирующих атрибутов протокола ПОДД

  1. Требования к УВ актуализированы и распределены по разделам соответствующих обменов

    • 1.4.1.2, 1.4.2.2, 1.4.3.2 Требования к участникам взаимодействия

  2. Добавлена рекомендация по работе с новыми версиями Витрин и РЗ (предупреждение об автоматическом предоставлении доступа к новой версии)

    • 1.5.1. Модель данных Витрины Поставщика данных

    • 1.5.3. Определения Регламентированных запросов

  3. Актуализирован перечень заголовков

    • 2.3.1. Перечень заголовков сообщений в Apache Kafka

  4. Добавлен новый топик для передачи ТП в Витрину с бинарным разбиением на чанки (<мнемоника Витрины>.query.tp.bin)

    • 2.3.2. Перечень топиков брокера сообщений Apache Kafka

  5. Изменен порядок атрибутов в сообщении с табличными параметрами для Витрины

    • 2.3.5.3.1.2. Передача чанков табличных параметров (<мнемоника Витрины>.query.tp / <мнемоника Витрины>.query.tp.bin)

  6. Удален атрибут priority из запроса БЛОБ по ссылке

    • 2.3.5.3.2.1. Запрос на получение БЛОБ по ссылке от Витрины (<мнемоника Витрины>.blob.rq)

2.12.0

  1. [PODD-3480] - Реализация Rest для управления метаданными Витрин

  2. [PODD-4416] - Управление метаданными РЗ через ЛК УВ Q3

  3. [PODD-4735] - Корректировки протокола Агент-Витрина (передача идентифицирующих атрибутов)

  1. Добавлена информация о расширении модели данных Витрины массивом уникальных ключей

    • 1.5.1. Модель данных Витрины Поставщика данных

  2. Добавлены идентифицирующие атрибуты customerId, customerOgrn, queryMnemonic в структуру сообщений для взаимодействия с Поставщиком

    • 2.3.5.3.1.1. Запрос данных из Витрины (<мнемоника Витрины>.query.rq / <мнемоника Витрины>.procedure.query.rq)

    • 2.3.5.3.1.2. Передача чанков табличных параметров (<мнемоника Витрины>.query.tp / <мнемоника Витрины>.query.tp.bin)

  3. Актуализированы ограничения на загружаемые метаданные (на формат и бизнес ограничения)

    • 1.5.1. Поддерживаемые форматы

    • 1.5.2. Модель данных Витрины Поставщика данных

    • 1.5.4. Определения Регламентированных запросов

  4. Скорректирован пример выполнения РЗ (в рамках отказа от * в SQL РЗ): - 3.2.6. Регламентированные запросы

2.15.0

  1. [PODD-4927] - Не требуется timestamp перед датой в for_system_time

  2. [PODD-4928] - Прокидывать единицу времени (day и др) при операциях с датами

  1. Добавлена информация о поддержке FOR SYSTEM_TIME без TIMESTAMP и вычисления интервала в указанной единице времени, символ * удален из примеров поддерживаемых SQL-запросов

    • 3.1. Поддерживаемые возможности SQL-синтаксиса

  2. Актуализация информация о работе с моделью данных Витрины

    • 1.5.2. Модель данных Витрины Поставщика данных

  3. Добавлено исключение по использованию * внутри операторов для SQL-выражения РЗ

    • 1.5.4. Определения Регламентированных запросов

  4. Произвольные SQL-запросы доступны только для владельцев Витрин данных

  • 1.5.6.1. Полномочия на выполнение произвольных SQL-запросов

3.1.0

  1. [PODD-4932] - Передача вложений по API Gateway (запросы к REST-сервису ИС Ответчика) более 5 мб

  2. [PODD-4891] - Именованные параметры в Регламентированных SQL-запросах

  3. [PODD-4327] - Реализация распределенных подписок

  1. Добавлены требования к УВ для отправки запросов к REST-сервису ИС Ответчика более 5 Мб

    • 1.4.3.2.1. Требования к Ответчикам

    • 1.4.3.2.2. Требования к Инициаторам запросов

  2. Обновлена терминология по запросам к REST-сервису ИС Ответчика

    • 1.3. Участники информационного обмена с использованием ПОДД СМЭВ

    • 1.4.3. Обмен с использованием запросов к REST-сервису ИС Ответчика

    • 1.5. Метаданные ПОДД СМЭВ

  3. Добавлено описание механизма прохождения запросов к REST-сервису ИС Ответчика более 5 Мб

    • 1.4.3.3. Взаимодействие участников обмена

    • 1.4.3.4.3. Информационный обмен для механизма с возможностью отправки большого запроса

  4. Добавлена информация об именованных параметрах Регламентированных SQL-запросов

    • 1.5.4. Определения Регламентированных SQL-запросов

    • 3.3.3. Примеры вызова и преобразования исходного запроса

    • 3.3.4. Выполнение запроса с системным параметром

  5. Обновлено описание информационного обмена по рассылкам с учётом возможности распределённой подписки, применена согласованная терминология

    • 1.4.2. Обмен с использованием Рассылок

    • 1.5.3. Подписки Потребителей данных ПОДД СМЭВ

    • 1.5.6.4. Полномочия на Рассылку

    • 2.3. Протокол взаимодействия Агента СМЭВ4 и Витрины Поставщика данных

    • 2.5. Протокол взаимодействия Агента СМЭВ4 и Хранилища данных по подписке Потребителя данных

3.2.0

  1. [PODD-4890] - Доработка конфигурирования Агента ПОДД и схем Витрин (возможность использования общих топиков для нескольких схем Витрин)

  2. [PODD-5280] - Вызов РЗ с именованными параметрами для ЦА

  3. [PODD-5372] - Ошибка регистрации регламентированного запроса с мнемоникой, содержащей зарезервированное ключевое слово SQL

  1. Добавлена информация о возможности использования общего набора топиков протокола взаимодействия Агент СМЭВ4 -Витрина

    • 2.3. Протокол взаимодействия Агента СМЭВ4 и Витрины Поставщика данных

    • 2.5. Протокол взаимодействия Агента СМЭВ4 и Хранилища данных по подписке Потребителя данных

  2. Добавлена возможность вызова РЗ через CALL

    • 3.3. Выполнение регламентированных SQL-запросов

  3. Запрещено использование зарезервированных ключевых слов SQL в мнемонике Витрины и Регламентированного SQL-запроса

    • 1.5.1. Поддерживаемые форматы

3.3.0

  1. [PODD-4885] - Лимиты для запросов к REST-сервису ИС Ответчика

  1. Добавлены возможные коды возврата ПОДД при ошибках выполнения запроса к REST-сервису ИС Ответчика

    • 2.4.1.3. Выполнение запросов к REST-сервису ИС Ответчика

  2. Добавлена информация о работе и задании лимитов для запросов к REST-сервису ИС Ответчика

    • 1.4.3.2.1. Требования к Ответчикам

    • 1.4.3.4.3. Информационный обмен для механизма с возможностью отправки большого запроса

3.4.0

  1. [PODD-5435] – Использование диагностического запроса к Витрине данных

  2. [PODD-5470] – Обеспечение поддержки времени жизни запроса (таймаут)

  1. Добавлена информация о понятии Диагностический запрос и его использовании

    • 3.6. Использование диагностического запроса к Витрине данных

    • ТЕРМИНЫ И СОКРАЩЕНИЯ

  2. Добавлена информация о времени жизни запроса (таймауте) по умолчанию

    • 2.4.1.1.1. HTTP-запрос (метод POST) (синхронный режим)

    • 2.4.1.2.1.1. HTTP-запрос (метод POST) (асинхронный режим)

    • 2.4.1.2.1.2. HTTP-запрос с табличным параметром (метод POST) (асинхронный режим)

  3. Добавлены дополнительные сведения по использованию подписок на Рассылку:

    • 1.4.2.1. Общее описание информационного обмена (подписка не может быть поставлена на паузу)

    • 1.5.3. Подписки Потребителей данных ПОДД СМЭВ на регламентированный запрос типа «Рассылка» (При перерегистрации подписки требуется указывать новый идентификатор)

3.5.0

  1. [PODD-5459] - Конфигурирование функций агента ПОДД

  2. [PODD-5745] - Запрос BLOB по ссылке при взаимодействии ИС Потребителя с Агентом через REST-интерфейс

  3. [PODD-5598] - Сквозная идентификация запросов

  1. Добавлена информация о статической и динамической регистрации Витрин:

    • 2.3.3. Настройка Агента СМЭВ4 для работы с несколькими Витринами

  2. Добавлена информация по запросу BLOB по ссылке через REST-интерфейс:

    • 2.4.1. REST-интерфейс Агента СМЭВ4

    • 2.4.1.3. Выполнение запроса на получение BLOB по ссылке

    • 3.3.6. Получение двоичных объектов в результатах запроса

  3. Добавлена информация по запросам через REST-интерфейс при подключении к брокеру:

    • 2.4.1. REST-интерфейс Агента СМЭВ4

  4. Добавлено требование к использованию лимитов (limit), при вызове запросов не являющихся аналитическими:

    • 3.3.1. Правила выполнения

  5. Добавлены примеры вызова Регламентированных SQL-запросов с параметрами типов TIMESTAMP и DATE:

    • 3.3.3. Примеры вызова и преобразования исходного запроса

  6. Добавлена информация о сквозной идентификации запросов в ПОДД СМЭВ:

    • 3.7. Сквозная идентификация запросов

    • 2.4. Протокол взаимодействия Агента СМЭВ4 и ИС Потребителя данных (формат передачи клиентского идентификатора)

3.6.0

  1. [PODD-6320] - [3ЛП][ПОДД] При регистрации РЗ в ЕИП НСУД через REST пропали префиксы таблицы в атрибутах

  1. Добавлены требования к алиасам возвращаемого Потребителю атрибута:

    • 1.5.1. Поддерживаемые форматы

    • 1.5.4. Определения Регламентированных SQL-запросов

3.7.0

  1. [PODD-5442] – [Проектирование+Реализация] процесс управления подписками в ЛК УВ

  1. Обновлены метаданные подписки и инструменты для управления ими; термин «отмена подписки» заменён на «удаление подписки»; добавлены топики для удаления подписки на потребителе:

    • 1.4.2. Обмен с использованием Рассылок;

    • 1.5.3. Подписки Потребителей данных ПОДД СМЭВ на регламентированный запрос типа «Рассылка»;

    • 1.5.4. Определения Регламентированных SQL-запросов;

    • 2.5. Протокол взаимодействия Агента СМЭВ4 и Хранилища данных по подписке Потребителя данных;

    • Приложение 3 2.5. Удаление подписки.

  2. Расширено описание процесса получении двоичных объектов в результатах запросов:

    • 3.3.6. Получение двоичных объектов в результатах запроса

  3. Добавлен топик scl.signal для Хранилища данных по подписке и добавлены атрибуты для событий связанных с подписками:

    • 2.5.1. Перечень топиков брокера сообщений Apache Kafka

    • Приложение 2 - 3.6. Получение событий от Витрины

    • Приложение 3 - 2.6. Получение событий от Витрины

  4. Убрана информация о кодах событий СЦЛ в сообщениях Витрины, в связи с расширением их перечня и неконтролируемостью на стороне ПОДД СМЭВ:

    • Приложение 2. - 3.6. Получение событий от Витрины

3.8.0

  1. [PODD-7151] – Расширение перечня системных параметров

  2. [PODD-7039] – Доработка подписания запросов печатных форм

  3. [PODD-7161] – Реорганизация обработки запросов к REST-сервису Ответчика

  4. [PODD-6388] – Изменены значения таймаутов

  1. Добавлена информация о системных параметрах settings_for_system_time_started и settings_for_system_time_finished:

  2. Добавлена информация о запросах с получением печатной формы:

  3. Изменено максимальное значение таймаута, задаваемого в SQL-запросе, корректировка терминологии в части вызова запроса с надстройками и без надстроек:

  4. Изменено время хранения результата запроса, вызванного в асинхронном режиме:

  5. Корректировка процесса выполнения запросов к REST-сервису Ответчика: валидация осуществляется Ядром

  6. Оптимизация документа. Удалены разделы с описанием технических деталей:

    • 2.1. Протокол ПОДД СМЭВ

    • 2.3.1 Перечень заголовков сообщений в Apache Kafka

    • 2.3.4 Последовательность исполнения SQL-запроса в контуре Поставщика данных

    • 2.5.2 Структуры сообщений для взаимодействия с Потребителем данных

    • 3.3.2 Преобразование исходного запроса

    • 3.5. Формирование и передача статистики атрибутов Витрины данных Агенту СМЭВ4

    • Приложение 2 Структуры сообщений для взаимодействия с Поставщиком

    • Приложение 3 Структуры сообщений для взаимодействия с Потребителем данных

  7. Оптимизация документа. Подготовлено описание без технических деталей:

3.9.1

  1. [PODD-5671] – Добавлена возможность лимитирования регламентированных запросов Потребителя к информационным ресурсам Поставщика данных

  2. [PODD-6670] – Удалён механизм по управлению подписками через ВС

  1. Добавлена информация о лимитировании запросов в СМЭВ4:

  2. Убрана информация об управлении подписками через ВС:

  3. Доработка документа. Скорректировано описание типов атрибутов и параметров:

  4. Доработка документа. Указан заголовок с версией протокола REST-интерфейса Агента ПОДД для SQL-запросов:

  5. Удален раздел «Приложение 1 Пример проекта для реализации взаимодействия с Агентом СМЭВ4»

3.10.0

  1. [PODD-6979] – Ограничена возможность исполнения запросов с использованием SQL-РЗ с дополнительными условиями фильтрации и операциями над получаемыми данными (запросов с надстройками)

  2. [PODD-6930] – Для запросов, вызванных в асинхронном режиме и выполненных через транспорт RSocket, реализован возврат времени, до которого доступен результат выполнения запроса (ранее было доступно только при передаче через транспорт Pulsar)

  1. Добавлена информация об ограничении на использование запросов с надстройками:

  2. Оптимизация и актуализация документа:

    • Удалён раздел «Примеры реализации взаимодействия с Агентом ПОДД СМЭВ с использованием брокера сообщений Apache Kafka»

    • Введены термины право доступа и полномочие. Текст приведён в соответствие с этими терминами.

3.11.0

  1. [PODD-7345] – Обеспечена возможность приостановки и возобновления информационного обмена по подписке при возникновении сбое

  2. [PODD-9241] – Обеспечена возможность передачи мнемоники ИС Инициатора запроса Ответчику. При добавлении в Спецификацию OpenAPI REST-сервиса Ответчика специального заголовка, ПОДД осуществляет проверку соответствия мнемоники ИС, с которой пришёл запрос, и мнемоники ИС, указанной в заголовке

  3. [PODD-6347], [PODD-6370] – Ограничено время исполнения запросов на получение BLOB по ссылке и к REST-сервису ИС Ответчика.

  1. Добавлена информация о возможности приостановки обмена по подписке:

  2. Добавлена информация о возможности передачи мнемоники ИС Инициатора запроса Ответчику:

  3. Добавлена информация об ограничении времени исполнения запросов на получение BLOB по ссылке и к REST-сервису:

  4. Оптимизация и актуализация документа:

    • Удалён раздел «Настройка Агента СМЭВ4 для работы с Витринами данных»

3.12.0

  1. Обновлены схемы:

    • на схемах заменено название Агент ПОДД на Агент СМЭВ4

3.12.1

  1. [PODD-10175] - [3ЛП] Копится очередь на запись в lager

  1. Добавлена рекомендация по использованию запроса на удаление результата асинхронно вызванного запроса и его структура:

3.13.0

  1. [PODD-10022] - Контроль выполнения РЗ API GW на стороне Агента ПОДД

  2. [PODD-10087] - Поддержка системных именованных параметров, отвечающих за номер операции в Просторе

  3. [PODD-9539] - Хранилище запросов-ответов при запросах к REST-сервису Ответчика

  4. [PODD-7066] - Перенос профилей витрин в Ядро ПОДД

  1. Обновлено описание и схема процесса обработки запроса к REST-сервису Ответчика с учётом возможности проверки полномочий (см Раздел 1.4.3.4.3)

  2. Расширено описание поддерживаемых системных параметров с номерами операций (см Раздел 3.3.3)

  3. Добавлена спецификация REST-интерфейса Агента СМЭВ4 для выполнения запросов к Витринам Поставщиков данных, а также обновлены примеры запросов в формате curl (см Раздел 2.3.1)

  4. Добавлено описание возможности по сохранению запросов и ответов при запросах к REST-сервису Ответчика:

  5. Перечень типовых ошибок, коды возврата и пути решения вынесены отдельно в Раздел 5

  6. Добавлено описание профиля витрины

3.15.0

Оформление документа, минорные исправления