Was this article helpful?

Спасибо за вашу оценку!

Оставляя более подробный отзыв, вы помогаете нам улучшать документацию

Практикум. Система учета заявок на канцтовары. Инструменты интеграции.

Общие сведения об инструментах интеграции

На платформе Greendata доступны различные инструменты для интеграции. В этом практикуме будет рассмотрен импорт данных из структурированных файлов формата XLS.

Настройка процесса загрузки данных состоит из следующих этапов:

  1. Настройка шаблона загрузки справочника из XLS;

  2. Настройка отображения кнопки для загрузки данных;

  3. Загрузка данных пользователем.

Описание модуля

Необходимо разработать функционал, позволяющий загружать данные о канцтоварах из xls файлов. Таблица должна содержать в себе данные:

  • Код;

  • Наименование;

  • Категория;

  • Описание товара;

  • Цена(руб.).

Перед началом настройки на платформе, сформируйте Таблицу в MS Excel или скачайте готовую (используемая в практикуме таблица приложена к нему).

image662

Для решения поставленной бизнес-задачи необходимо разработать шаблон загрузки данных и привязать его к кнопке на визуале реестра Список канцтоваров для Сотрудника АХР, а затем заполнить реестр данными.

image664

Перед настройкой модуля «Инструменты интеграции» необходимо предварительно реализовать настройки, описанные в главах:

Создание индекса для типа объектов

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

Индекс – набор атрибутов (столбцов) сущности, который однозначно идентифицирует экземпляр.

После настройки индекса в процессе поиска нужной записи в реестре «Канцтовары» сначала найдет требуемое значение по индексу, а затем будет обрабатывать информацию по остальным столбцам реестра.

Создайте индекс для типа объектов «Справочник канцтоваров». Для этого на стартовой странице на виджете «Типы объектов» найдите его с помощью поиска и откройте его для настройки.

image

В настройках типа объектов перейдите на вкладку «Индексы». Создайте новый по кнопке создания.

image

В модальном окне заполните поля: Наименование«Поиск по товарам», Атрибуты – «Наименование».

image

Создание и настройка шаблона

Перейдите к настройке шаблона загрузки файлов для типа объектов «Лимит на командировку».

Со стартовой страницы перейдите к реестру типов объектов в главном меню: «Администрирование» -«Управление объектами» - «Типы объектов».

image671

С помощью поиска найдите тип «Шаблон загрузки xls-файлов для типов объектов» [SYS_XLS_TEMPLATE] – это настроенный загрузчик, который работает со структурированными файлами только в формате xls.

Выбрав тип объектов из списка, перейдите к реестру экземпляров этого типа, выбрав на панели управления кнопку «Открыть реестр».

image672

Добавьте новый экземпляр с помощью кнопки добавления на панели управления.

Заполните поле Наименование – «Шаблон загрузки канцтоваров», группу «Параметры объекта» оставьте пустой. Сохраните и перейдите к настройке шаблона с помощью кнопки «Редактор Excel шаблона».

image

В редакторе шаблона необходимо загрузить существующий файл с наполнением, структура которого будет использоваться в дальнейшем. Для этого раскройте список действий, выберите в нем «Выбрать новый файл» и загрузите шаблон.

image

В результате вы увидите шаблон файла в правой части редактора.

image678

Далее необходимо разделить шаблон на разные разделы для загрузки. Для этого выберите тип объектов, атрибуты которого будут заполняться значениями из шаблона — раскройте список, укажите тип «Справочник канцтоваров» и добавьте его по кнопке «Добавить».

image

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

image

Настройте начало раздела: в поле «Поиск по» установите значение «Значению в направлении загрузки», для создания экземпляров, данные в шаблоне для которых располагаются по вертикали ниже выбранной ячейки.

image684

Настройте конец раздела: установите значение «Первая пустая ячейка» и свяжите с первой пустой ячейкой первого столбца шаблона.

image686

Сделайте неактивным переключатель «Пропускать пустые строки/столбцы». Ниже в группе «Сопоставление записей» заполните поле значением «Обновление», для реализации обновления существующих экземпляров и создания новых, а также укажите ключ для сопоставления объектов и выберите «Поиск по товарам».

Ниже расположены группы для настройки атрибутов. Настройте атрибуты следующим образом:

  • Категория: создайте связь с ячейкой наименования столбца «Категория», заполните поле «Сопоставление по атрибуту» - «Наименование»;

image

  • Наименование: создайте связь с ячейкой наименования столбца «Наименование»;

  • Описание товара: создайте связь с ячейкой наименования столбца «Описание товара»;

  • Цена (руб.): создайте связь с ячейкой наименования столбца «Цена (руб.)».

Сохраните настройки шаблона по кнопке в группе настройки наименования шаблона.

image

Создание кнопки в реестре

В реестре типа объектов «Справочник канцтоваров» создайте кнопку для реализации загрузки объектов из файла. Для реализации функционала необходимо создать действие, а затем связать его с необходимым реестром.

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

image

Создайте новый экземпляр «Загрузить канцтовары» [LOAD_SUPP_ACTION], модуль пользовательского интерфейса – «Загрузка локальных объектов из Excel».

image

В группе «Дополнительные параметры действия» по кнопке «Создать» настройте параметры действия: укажите родительский шаблон «Шаблон загрузки канцтоваров». Поле с наименованием можно оставить – система автоматически сформирует его при сохранении. Сохраните параметры по кнопке «Ок».

image

В разделе «Область видимости» в поле «Отображать в реестре» установите значение «Да», в остальных полях раздела – «Нет».

image700

В разделе «Связанные типы объектов» создайте новый экземпляр связи «Загрузить список канцтоваров», укажите Связь с типом объекта – Справочник канцтоваров.

image

Загрузка данных

Для настройки отображения кнопки в реестре Канцтовары, вернитесь на стартовую страницу и откройте настройки типа объекта «Справочник канцтоваров». Перейдите в реестр типа и откройте настройки реестра. На вкладке «Кнопки» добавьте новую кнопку:

  1. НазначениеКнопка-пиктограмма;

  2. ПодсказкаЗагрузить канцтовары;

  3. ДействиеЗагрузить канцтовары.

image

ССохраните изменения и вернитесь к реестру типа объекта «Справочник канцтоваров».

image706

Нажмите на кнопку «Загрузить канцтовары», выберите файл xls со списком товаров, запустите процесс по кнопке «Начать загрузку» и Система отобразит ход выполнения загрузки данных.

image708

В случае успешной загрузки данных Система отобразит статус процесса и реестр наполнится значениями.

Загрузите для каждой записи изображение. Для этого откройте объект двойным нажатием на него, на виджете загрузите изображение с помощью кнопки загрузки.

image

Сохраните объект и вернитесь к реестру: в нем появится миниатюра загруженного изображения в столбце «Изображение».

image712