Документация Webitel

Импорт данных из CSV файлов

1. Описание

Предназначены для создания заранее настроенных шаблонов (маппинг полей) для импорта данных, например, импорт данных об абонентах. Шаблоны дают возможность не настраивать импорт данных при каждой загрузке.

Состоит из таких элементов:

  1. Инструмент создания (Рис.1 (1));

  2. Поле поиска (Рис.1 (2));

  3. Инструмент обновления реестра записей (Рис.1 (3));

  4. Реестр записей (Рис.1 (4)) ;

  5. Пагинация (Рис.1 (5)).

Страница Импорт данных из CSV файлов.png
Рис. 1. Страница "Импорты CSV файлов"

1.1. Инструмент создания

Для создания нового объекта служит кнопка "Добавить" (Рис.1 (1)), после нажатия на которую открывается доступ к деталям. Открыть доступ к деталям уже существующего импорта можно через инструмент редактирования записи (см. пункт. 1.4.5)

Детали:

1.2. Поле поиска

Поиск производится по колонке "Имя".

Состоит из поля ввода и кнопки закрытия ( image-20241213-101535.png ), которая отображается, когда в поле ввода установлен курсор.  Для поиска по части слова, или номера, используется символ *. Можно использовать символ * и для замены любого количества символов.

1.3. Инструмент обновления реестра записей 

Обновление таблицы реестра записей выполняется нажатием на кнопку обновления - image-20241213-115639.png .

1.4. Реестр записей 

Реестр представляет собой список записей существующих объектов этого раздела, каждая из которых состоит из набора полей:

  1. Чекбокс;

  2. Колонка "Имя";

  3. Колонка "Назначение импорта";

  4. Инструмент загрузки;

  5. Инструмент редактирования;

  6. Инструмент удаления.

Если на странице нет ни одной записи, то в реестре записей отображается дополнительная кнопка “Добавить”, функционал которой дублирует кнопку “Добавить” в п. 1.1.

1.4.1. Чекбокс

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

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

После выбора одной или нескольких записей сверху реестра появляется дополнительный инструмент удаления, который позволяет удалить все выбранные записи. При наведении курсора на инструмент удаления появляется информация о количестве выбранных для удаления записей. При нажатии на него появляется модальное окно подтверждения. В нем находятся кнопки "Да", "Нет" и закрытия - image-20250624-092210.png

  • Нажатие кнопки "Да" удаляет записи.

  • Нажатие кнопки "Нет" закрывает модальное окно, записи не удаляются.

Модальное окно Подтвердить удаление.png


Рис. 2. Удаление нескольких записей

1.4.2. Колонка "Имя"

Здесь отображаются названия шаблонов импорта данных.

1.4.3. Колонка "Назначение импорта"

Отображается очередь, для которой предназначен данный шаблон.

1.4.4. Инструмент загрузки

Для загрузки данных из файла CSV, воспользуйтесь кнопкой импорт файла CSV - 91f3ef3e-039c-4454-abf3-5c3444d0eab5.png При наведении курсора на эту кнопку отображается надпись "Загрузить". При нажатии на кнопку image2024-2-7_15-3-31.png  открывается окно выбора файла.

Важно!

При сохранении убедитесь, что установлено "CSV-файл", как тип файла. 

Выберите нужный файл на вашем устройстве и нажмите кнопку "Открыть" (в зависимости от ОС окно выбора файла может отличаться) (Рис.3). 

Окно выбора файла.png
Рис. 3. Окно выбора файла

Открывается модальное окно "Импортировать CSV" (Рис.5).

В документе для импорта должны быть заголовки, которые указаны в детали "Настройки". Пример файла для импорта можно посмотреть на Рис.4.

Пример файла для импорта.png

Рис. 4. Пример файла для импорта

1.4.4.1. Модальное окно Import CVS

Отображает первые строки импортированного файла (Рис.5).

Модальное окно Импортировать CSV - Импорт данных из CSV файлов.png
Рис. 5. Модальное окно "Импортировать CSV"

 Нажатие кнопки "Сохранить" импортирует данные из файла. Нажатие на кнопку "Закрыть" закрывает модальное окно, данные не импортируются.

Важно!

Если импортированный файл не содержит заголовков колонок, которые указаны в шаблоне, то импортирование не произойдет.

1.4.5. Инструмент редактирования

Нажатие на кнопку редактирования ( Screenshot 2024-11-29 113414.png ) открывает доступ к деталям, в которых можно изменить данные объекта. При наведении курсором на кнопку отображается информация с названием инструмента.

1.4.6. Инструмент удаления

Используется для удаления объекта с подтверждением через модальное окно. При наведении на кнопку удаления ( image-20250624-091835.png ) отображается информация с названием инструмента.  После нажатия кнопки удаления появляется модальное окно с подтверждениемНажатие кнопки "Да" удаляет объект и запись о нем. Нажатие кнопки "Нет" закрывает модальное окно, объект не удаляется. 

Модальное окно Подтвердить удаление.png


Рис. 6. Модальное окно подтверждения удаления 

1.5. Пагинация

Состоит из поля "Записей на странице", в котором указывается количество записей (возможно задать от 1 до 1000) на одну страницу и кнопок вперед  image-20241213-095758.png и назад  image-20241213-095901.png для переключения страниц.

2. Возможности

2.1. Создание нового шаблона для импорта

Цель

Создать новый шаблон для импорта

Предусловия

  1.  Доступ к приложению Admin;

  2.  Доступ к разделу "Импорт данных из CSV файла" в приложении Admin;

  3.  Разрешение на создание в разделе "Импорт данных из CSV файла".

Сценарий:


  1. Нажать кнопку "Добавить". Открывается страница детали "Общее".

  2. Внести данные.

  3. Перейти в деталь "Настройки".

  4. Внести необходимые данные. Кнопка "Сохранить" становится активной.

  5. Нажать на кнопку "Сохранить"

Результат

Данные сохранены. Шаблон создан.

2.2. Удаление шаблона для импорта

Цель

Удалить шаблон для импорта

Предусловия

  1. Доступ к приложению Admin;

  2.  Доступ к разделу "Импорт данных из CSV файла" в приложении Admin;

  3.  Разрешение на удаление в разделе "Импорт данных из CSV файла".

  4. Наличие записи в реестре

Сценарий:


  1. Найти запись шаблона, который необходимо удалить.

  2. Нажать на кнопку удаления -  image2024-2-7_15-16-30.png . Открывается модальное окно для подтверждения удаления.

  3. Нажать кнопку "Да".

Результат

Модальное окно закрывается. Выбранный шаблон удален.

2.3. Удаление нескольких шаблонов

Цель

Удалить несколько шаблонов

Предусловия

  1. Доступ к приложению Admin;

  2.  Доступ к разделу "Импорт данных из CSV файла" в приложении Admin;

  3.  Разрешение на удаление в разделе "Импорт данных из CSV файла".

  4. Наличие записей в реестре.

Сценарий:


  1. Найти шаблоны, которые необходимо удалить. Выбрать их с помощью чекбокса.

  2. Нажать на кнопку удаления вверху реестра записей. Открывается модальное окно для подтверждения удаления.

  3. Нажать кнопку "Да".

Результат

Модальное окно закрывается. Выбранные шаблоны удалены.

2.4. Редактирование шаблона

Цель

Редактировать шаблона

Предусловия

  1. Доступ к приложению Admin;

  2.  Доступ к разделу "Импорт данных из CSV файла" в приложении Admin;

  3.  Разрешение на редактирование в разделе "Импорт данных из CSV файла".

  4. Наличие записи в реестре.

Сценарий:


  1. Найти шаблон, который необходимо редактировать.

  2. Нажать на кнопку редактирования в записи шаблона. Открывается страница детали "Общее".

  3. Внести необходимые изменения. Кнопка "Сохранить" становится активной.

  4. Нажать кнопку "Сохранить".

Результат

Выбранный шаблон отредактирован.

2.5. Импортирование данные по шаблону

Цель

Импортировать данные по шаблону

Предусловия

  1. Доступ к приложению Admin;

  2.  Доступ к разделу "Импорт данных из CSV файла" в приложении Admin;

  3.  Разрешение на добавление в разделе в который будут импортироваться данные.

  4. Наличие записи в реестре.

Сценарий:


  1. Найти шаблон, который необходимо импортировать.

  2. Нажать на кнопку загрузки image2024-2-7_15-16-47.png  в записи шаблона. Открывается окно выбора файла.

  3. Выбрать файл (Рис.2).

  4. Нажать кнопку "Открыть". Открывается модальное окно "Импортировать CSV".

  5. Нажать кнопку "Сохранить".

Результат

Данные импортированы.