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

5.Эксплуатация.

5.1.Работа с сервисами.

5.1.5.Редактирование сервиса.

5.1.5.2.Конфигурация источника.

Перед конфигурацией источника необходимо проверить наличие требуемой системы в справочнике «Системы» (раздел 6.3. Управление справочником «Системы»), попасть в который можно через меню (раздел 3.4, рисунок 3, позиция 1; раздел 3.4, таблица 3, пункт 1). Конфигурация осуществляется в блоке «Источник» (рисунок 20).

Рисунок 20Блок с основной информацией о процессе свёрнут, блок источника — раскрыт.
Блок с основной информацией о процессе свёрнут, блок источника — раскрыт.

При заполнении поля «Наименование» источника появляется выпадающий список (рисунок 21) из всех систем справочника «Системы» (раздел 6.3. Управление справочником «Системы»).

Рисунок 21Выпадающий список с перечнем систем.
Выпадающий список с перечнем систем.

Если введённое наименование источника не совпадает ни с одной из систем справочника, то при сохранении сервиса возникнет ошибка (рисунок 22).

Рисунок 22Сообщение при сохранении сервиса с ошибкой наименования.
Сообщение при сохранении сервиса с ошибкой наименования.

После выбора системы, источник нужно сохранить находящейся в блоке источника рядом с наименованием кнопкой «Сохранить» (рисунок 23).

Рисунок 23Поле «Наименование» заполнено.
Поле «Наименование» заполнено.

После сохранения станет доступен блок создания объекта данных (рисунок 24).

Рисунок 24Изменение сохранены.
Изменение сохранены.

Для создания объекта необходимо развернуть блок «Объект» и нажать кнопку «Создать» (рисунок 25).

Рисунок 25Доступно создание объекта данных.
Доступно создание объекта данных.

После нажатия кнопки «Создать» блок заполнится полями ввода значений (рисунок 26, таблица 11).

Рисунок 26Начальный вид блока объекта данных (рисунок 26).
Начальный вид блока объекта данных (
Таблица 12Ввод информации об источнике (рисунок 26).
Поле Комментарий
Флажок аудита Включает ведение аудита — отправку обработанного сообщения в отдельный лог для просмотра.
Таймаут ожидания ответа Время ожидания ответа на запрос, мсек
Наименование объекта данных Поле ввода и кнопка выбора наименования базового объекта данных из списка.
Блок связанных объектов данных Блок для указания связанных с главным объектом данных дополнительных объектов данных.
Тип объекта данных Содержит выбираемый из выпадающего списка тип объекта данных, от которого зависит наличие дополнительных полей ввода в блоке объекта данных.
Рисунок 27Начальный вид блока объекта данных типа JSON.
Начальный вид блока объекта данных типа JSON.
Рисунок 28Начальный вид блока объекта данных типа SQL.
Начальный вид блока объекта данных типа SQL.
Таблица 13Начальный вид блока объекта данных типа SQL (рисунок 28).
Поле Комментарий
Флажок resultset Получить данные из запроса.
Флажок call/exec Получить данные из вызова хранимой процедуры.
Флажок «Использовать алиасы» Предписывает использовать псевдонимы.
Поле «Максимальное количество строк» Ограничивает размер запроса.
Строка SQL-запроса Содержит запрос SQL-запрос к базе данных.
Рисунок 29Начальный вид блока объекта данных типа TEXT.
Начальный вид блока объекта данных типа TEXT.
Рисунок 30Начальный вид блока объекта данных типа XML.
Начальный вид блока объекта данных типа XML.
Таблица 14Начальный вид блока объекта данных типа XML (рисунок 30).
Поле Комментарий
Поле «Пространство имён» Задаёт пространство имён элементов документа XML.
Поле «Префикс имён элементов» Задаёт префикс имён элементов документа XML.

После заполнения всех необходимых полей объект данных будет готов к сохранению (рисунок 31 и рисунок 33).

Рисунок 31Описание объекта данных заполнено для объекта данных.
Описание объекта данных заполнено для объекта данных.

После выбора типа объекта данных нужно сохранить объект данных кнопкой «Сохранить объект данных». После сохранения появятся кнопки редактирования объекта данных (рисунок 32).

Рисунок 32Описание объекта данных сохранено для объекта данных.
Описание объекта данных сохранено для объекта данных.

Для базового объекта сохранение происходит сразу, одновременно с автоматическим заполнением.

Рисунок 33Описание объекта данных заполнено для базового объекта.
Описание объекта данных заполнено для базового объекта.

Кнопка «Выбрать базовые объекты».

Кнопка «Выбрать базовые объекты» находится справа от поля «Наименование» объекта данных (рисунок 26, позиция 3; таблица 12, пункт 3) и предназначена для быстрого выбора готовых шаблонов объектов из библиотеки базовых объектов системы.

Условия отображения кнопки

Кнопка отображается только при выполнении ВСЕХ условий:

  • Объект данных не является дочерним (не имеет родительского объекта).
  • Режим редактирования активен.
  • Объект данных не является базовым объектом.

Поведение при нажатии

  1. По умолчанию система находится в режиме ручного ввода:
    • поле «Наименование» позволяет вводить текст вручную;
    • внутри поля текст-подсказка (placeholder): «Введите наименование».
    • справа отображается кнопка «Выбрать базовые объекты»
  2. При нажатии — кнопка мгновенно скрывается.
  3. Текст-подсказка меняется на «Введите или выберите из списка базовых объектов».
  4. Поле «Наименование» переходит в режим интеллектуального поиска.
    • в этом режиме работает фильтрация в реальном времени;
    • при вводе каждого символа система фильтрует список;
    • отображаются только объекты, название которых начинается с введенного текста с точным соответствием начала строки;
    • поиск регистронезависимый;
    • каждый объект отображается в формате «ИмяОбъекта (ТипОбъекта)», например: testdo_12(JSON).
  5. При нажатии на поле курсором, под полем появляется выпадающий список с доступными базовыми объектами (при их наличии).

Выбор объекта из списка

  1. При выборе объекта из выпадающего списка происходит полное копирование объекта: все свойства выбранного шаблона копируются в текущий объект;
  2. Автоматически заполняются:
    • наименование объекта;
    • тип объекта (JSON, SQL, XML, TEXT);
    • все предустановленные настройки;
    • поля параметров (если есть в шаблоне).
  3. Для очистки поля поиска объекта необходимо нажать кнопку «Отключить базовый объект» — кнопка «Выбрать базовые объекты» снова появится автоматически.

Выбор базовых объектов недоступен (кнопка деактивирована):

  • при уровне доступа < 3 (только просмотр);
  • в режиме просмотра сервиса;
  • для дочерних объектов;
  • если объект уже является базовым шаблоном;
  • для сервисов в статусах «Заменён» и «Эксплуатация».

Эта функция является важным инструментом для ускорения разработки и стандартизации объектов данных в системе. При правильном использовании она позволяет сократить время конфигурации в 3-5 раз за счет повторного использования проверенных шаблонов.

Важно: при выборе базового объекта из списка данные заполняются автоматически. Повторного сохранения не требуется.

При ручном вводе данных базового объекта сервис активирует блок кнопок, в том числе кнопки «Сохранить объект данных» и «Удалить объект данных».

После создания объекта данных можно создать связанный объект данных (рисунок 34).

Рисунок 34Доступно создание связанного объекта данных.
Доступно создание связанного объекта данных.

Тип связанного объекта данных заполняется автоматически и всегда совпадает с типом объекта данных (рисунок 35).

Рисунок 35Связанный объект данных создан.
Связанный объект данных создан.

После заполнения наименования и сохранения появляется возможность редактирования связанного объекта данных (рисунок 36). Связанный объект данных преобразовать в базовый объект нельзя.

Рисунок 36Связанный объект данных сохранён.
Связанный объект данных сохранён.

Можно создать любое количество связанных объектов данных. Для создания следующего связанного объекта данных, необходимо сохранить сервис кнопкой «Сохранить» (раздел 5.1.5, рисунок 16, позиция 2; раздел 5.1.5, таблица 9, пункт 2) и повторить создание связанного объекта данных (рисунок 37).

Рисунок 37Доступно создание следующего связанного объекта данных.
Доступно создание следующего связанного объекта данных.

Контрагенты указывают, в каком порядке будет происходить запись в приёмники. В блоке «Контрагенты» (рисунок 38) можно добавить систему-источник из справочника «Системы» (раздел 6.3. Управление справочником «Системы»).

Рисунок 38Настройка списка контрагентов.
Настройка списка контрагентов.

После нажатия на кнопку «Добавить» выводится окно выбора системы-источника (рисунок 39).

Рисунок 39Выбор контрагента.
Выбор контрагента.

Выбранная система появится в списке контрагентов (рисунок 40).

Рисунок 40Система добавлена в список контрагентов.
Система добавлена в список контрагентов.

Для источника данных типа SQL можно заполнить входные и выходные параметры автоматически на основании указанного в поле «Строка SQL-запроса» выражения при помощи кнопки «Заполнить из SQL запроса». Для хранимых процедур можно выполнить предварительные действия для упрощения SQL-выражения:

Рисунок 41Подготовка для заполнения параметров из SQL-запроса.
Подготовка для заполнения параметров из SQL-запроса.

Необходимо сохранить объект данных и нажать на кнопку «Запросить из SQL-запроса». В диалоговом окне надо ввести необходимые для соединения с базой данных параметры и нажать на кнопку «Выполнить».

Рисунок 42Указание данных для генерации полей объекта данных.
Указание данных для генерации полей объекта данных.

В результате выполнения операции будут автоматически заполнены входные и выходные параметры.

Рисунок 43Результат генерации полей объекта данных (параметров).
Результат генерации полей объекта данных (параметров).

Поля объекта данных можно удалить полностью кнопкой «Очистить» (рисунок 43).