Создание источника данных

Раздел Источники данных предназначен для настройки получения данных в формате JSON и передачи этих данных формам и коллекциям приложения. Данные могут быть получены как из внутренних сервисов, так и из внешних. Без созданных в Системе источников данных не получится завершить создание форм и коллекций.

img

Для создания нового источника данных для смарт-папки необходимо выполнить следующие действия:

  1. В разделе Источники данных нажать кнопку img и выбрать действие «Добавить новый источник данных». Откроется форма создания источника данных.

    img

  2. В открывшейся форме создания источника данных заполнить поля:

    • Поле Код заполняется автоматически после регистрации источника данных в Системе и недоступно для редактирования.
    • Поле Описание заполняется вручную.
    • В поле Наименование (обязательно для заполнения) нужно написать наименование источника данных, которое будет начинаться с «kd-collection-smart-folder-».
    • В поле Тип возвращаемых данных оставить значение по умолчанию «Коллекция».
    • В поле Тип источника данных (обязательно для заполнения) выбрать значение «Внешний запрос».
    • В поле Тип эндпоинта (обязательно для заполнения) выбрать значение «collection».

    Тумблер Защита от обновления позволяет активировать дополнительную защиту для создаваемого источника данных, которая срабатывает при импорте сущностей одного типа.

    В блоке HTTP запрос (обязательно для заполнения) необходимо указать структуру запроса для автоматического получения необходимых данных. В первую очередь необходимо выбрать метод из выпадающего списка – «POST».

    Поле URL (обязательно для заполнения) включает в себя адрес сервера, сервис посредник, наименование сервиса, класс объекта и параметры, например, <host>/dh-gateway-api-service/dh-relations-service/v1/search.

    Тело запроса можно сформировать в разделе Конструктор запросов, а затем скопировать запрос на панели разработчика. Также для формирования тела запроса можно обратиться к разработчику Системы. Подробное описание формирования запроса приведено в документе Руководство администратора ЛДМ. ПЛАТФОРМА КОНТЕНТ-СЕРВИСОВ (ЛДМ.ПКС).

  3. После заполнения полей нажать кнопку img.

Появится уведомление, информирующее об успешном сохранении источника данных.

img

После сохранения в карточке источника данных для HTTP-запроса появится кнопка [SEND], нажатие которой позволяет протестировать данный запрос. После нажатия кнопки [SEND] вернется ответ на заданный запрос (статус 200).

Если форма создания источника данных не была сохранена или в карточке уже созданного источника данных есть несохраненные изменения, кнопка [SEND] отображаться не будет.

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

Создать источник данных для новой смарт-папки также можно путем копирования существующего, для этого нужно выполнить следующие действия:

  1. В разделе Источники данных нажать кнопку img и выбрать действие «Скопировать другой источник данных».
  2. В открывшемся окне выбрать нужный источник данных из существующих в Системе, отметив его чекбоксом.

  3. Нажать кнопку [Создать].

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

  4. Отредактировать поля формы создания и нажать кнопку img.

Появится уведомление, информирующее об успешном сохранении источника данных.