СМЭВ QL сервер

Содержание

• 1. Назначение СМЭВ QL сервера
  • 1.1. О системе
  • 1.2. Цели СМЭВ QL сервера
  • 1.3. Задачи СМЭВ QL сервера
  • 1.4. Место СМЭВ QL сервера в ИТ-ландшафте
  • 1.5. Язык и синтаксис
    • 1.5.1. Моделирование
    • 1.5.2. Запросы и ответы
  • 1.6. Типизация
    • 1.6.1. Типы данных в модели и приведение типов
  • 1.7. Моделирование данных
  • 1.8. Метрики
• 2. Быстрый старт
  • 2.1. Создание и конфигурация
  • 2.2. Запуск и управление
  • 2.3. Работа с сервером
    • 2.3.1. Генераторы
  • 2.4. Сборка проекта
• 3. Процесс установки
  • 3.1. Предусловия выполнения первого запуска новой версии SMEVQL
  • 3.2. Настройка конфигурации
  • 3.3. Загрузка JAR-файла на сервер
• 4. Проверки и валидации
• 5. Основные понятия СМЭВ QL
  • 5.1. Ресурс
  • 5.2. Машина состояний
  • 5.3. Базовая модель данных
  • 5.4. Модель данных
  • 5.5. Распределённый запрос
  • 5.6. Регламентированный СМЭВ QL запрос
• 6. Функции СМЭВ QL Сервера
  • 6.1. Администрирование и конфигурирование
    • 6.1.1. Создание СМЭВ QL Сервера
    • 6.1.2. Конфигурирование СМЭВ-QL сервер
    • 6.1.3. Запуск, остановка, перезапуск приложения СМЭВ QL сервер
    • 6.1.4. OpenAPI СМЭВ-QL
    • 6.1.5. Регистрация OpenAPI СМЭВ QL в СМЭВ4
  • 6.2. Работа с моделями
    • 6.2.1. Создание базовой модели
    • 6.2.2. Генерация модели данных
    • 6.2.3. Автоматическое создание модели данных на основе схемы БД
    • 6.2.4. Создание новой версии модели данных
    • 6.2.5. Проверка валидности модели данных
    • 6.2.6. Маппинг типов данных СМЭВ QL - Prostore
  • 6.3. Работа с источниками данных
    • 6.3.1. Создание модели источников
    • 6.3.2. Создание новой версии модели источников
    • 6.3.3. Проверка доступности источников
  • 6.4. Работа с картами машин состояний
    • 6.4.1. Создание карты машины-состояний
    • 6.4.2. Создание новой версии карты машины-состояний
  • 6.5. Обработка запроса к витрине
    • 6.5.1. Запрос получения данных из витрины (POST/data)
    • 6.5.2. Запрос изменения данных витрины через события машины состояний (POST/states/{model}/{event})
    • 6.5.3. Обработка запроса получения данных витрины
    • 6.5.4. Асинхронное получение данных клиентом
    • 6.5.5. Обработка запроса изменения данных витрины через машину состояний
    • 6.5.6. Обработка регламентированного СМЭВ QL запроса
  • 6.6. Уведомления при изменении данных витрины (push-сервис)
    • 6.6.1. Регистрация получателя уведомлений
    • 6.6.2. Удаление получателя уведомлений
    • 6.6.3. Запрос списка получателей уведомлений
    • 6.6.4. Запрос данных об отслеживаемых ресурсах
    • 6.6.5. Передача уведомления при вызове события машины-состояний
    • 6.6.6. Регистрация метода для получения уведомлений на стороне клиента
    • 6.6.7. Передача уведомления на основе сообщения топика Prostore
  • 6.7. Работа с Регламентированными СМЭВ QL запросами
    • 6.7.1. Создание СМЭВ QL РЗ
    • 6.7.2. Создание новой версии СМЭВ QL РЗ
    • 6.7.3. Проверка валидности СМЭВ QL РЗ
• 7. Компонентная модель СМЭВ QL сервера
  • 7.1. Общее представление
  • 7.2. Схема
  • 7.3. Описание компонентов
• 8. Конфигурирование сервера
  • 8.1. Конфигурация файла application.yml
    • 8.1.1. Секция ktor
    • 8.1.2. Секция sources
    • 8.1.3. Секция swagger
    • 8.1.4. Секция storage
    • 8.1.5. Секция access
    • 8.1.6. Секция request
    • 8.1.7. Секция delta
    • 8.1.8. Секция state
    • 8.1.9. Секция index_recommendations
    • 8.1.10. Секция standalone-tables
    • 8.1.11. Секция proxy-tables
    • 8.1.12. Секция push
    • 8.1.13. Секция agent
    • 8.1.14. Секция signature
    • 8.1.15. Секция cls
    • 8.1.16. Секция component-info
  • 8.2. Конфигурация файла credentials.yml
  • 8.3. Общий сценарий выполнения
• 9. Стейт-машина СМЭВ QL
  • 9.1. Конфигурирование Стейт-машины
  • 9.2. Удаление записи через Стейт-машину
  • 9.3. Передача данных без изменения статуса (статичный ивент)
  • 9.4. Обновление объектов через Стейт-машину
  • 9.5. Обогащение payload запроса дополнительными атрибутами
  • 9.6. Методы API Стейт-машины
  • 9.7. Спецификация интерфейса Стейт-машины
    • 9.7.1. Выполнение операций обновления данных в витрине
    • 9.7.2. Обновление объектов через Стейт-машину
• 10. Запросы
  • 10.1. Блок Credentials
  • 10.2. Блок Query
    • 10.2.1. Условия фильтрации Conditions
    • 10.2.2. Сортировка и пагинация
  • 10.3. Эксплуатационные запросы
  • 10.4. Обработка запросов
    • 10.4.1. Логирование мета-данных
    • 10.4.2. Исполнение плана запроса
• 11. Ответы
• 12. Описание эндпоинтов
  • 12.1. GET /ping
  • 12.2. GET /states
  • 12.3. GET /states/{model}
  • 12.4. POST /states/{model}/{event}
  • 12.5. GET /model
  • 12.6. GET /model/{model}
  • 12.7. GET /model/{model}/{version}
  • 12.8. GET /sources
  • 12.9. POST /data
    • 12.9.1. Правила задания условий
    • 12.9.2. Варианты определения условий фильтрации
    • 12.9.3. Подробное описание блока fetch
  • 12.10. GET /server/indexes/required
  • 12.11. GET /regulated-query
• 13. Ошибки
  • 13.1. Базовые ошибки СМЭВ Ql